From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eric Abrahamsen Subject: Re: setting local variables Date: Fri, 04 Aug 2017 18:06:42 -0700 Message-ID: <87poca4ycd.fsf@ericabrahamsen.net> References: <871sotiqld.fsf@ericabrahamsen.net> <87r2wsly88.fsf@nicolasgoaziou.fr> <877eykbpho.fsf@ericabrahamsen.net> <87a83gl382.fsf@nicolasgoaziou.fr> <87wp6kxo50.fsf@ericabrahamsen.net> <87y3r0go4d.fsf@ericabrahamsen.net> <87pocbibtf.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:50438) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ddnYg-00082B-Em for emacs-orgmode@gnu.org; Fri, 04 Aug 2017 21:07:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ddnYa-0001DN-LE for emacs-orgmode@gnu.org; Fri, 04 Aug 2017 21:07:14 -0400 Received: from [195.159.176.226] (port=58649 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ddnYa-0001BP-E7 for emacs-orgmode@gnu.org; Fri, 04 Aug 2017 21:07:08 -0400 Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1ddnYL-0007aY-Mr for emacs-orgmode@gnu.org; Sat, 05 Aug 2017 03:06:53 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org Nicolas Goaziou writes: > Hello, > > Eric Abrahamsen writes: > >> And regarding the lists of commands and keys, what would be the >> recommended way of making a list of @deffns and corresponding index >> entries? > > I don't know what is a list of @deffns. In any case, you can something > like this: > > #+attr_texinfo: :options category name arguments... > > #+begin_deffn > ... > #+end_deffn > > AFAIU, @deffn takes care of indexing "name". I just meant that it's very common when writing manuals to have lists of commands, keys, user options, etc. The texinfo-plus output doesn't quite look like the Emacs manuals, but it produces something that works. For example, the below looks like something you'd find in an Emacs manual. #+BEGIN_SRC texinfo @table @kbd @item C-x C-f @kindex C-x C-f @findex find-file Visit a file (@code{find-file}). @item C-x C-r @kindex C-x C-r @findex find-file-read-only Visit a file for viewing, without allowing changes to it (@code{find-file-read-only}). @end table #+END_SRC This gets me some of the way: #+BEGIN_SRC org #+ATTR_TEXINFO: :options @kbd #+begin_table - C-x C-f #+KINDEX: C-x C-f Visit a file (@code{find-file}). - C-x C-r #+KINDEX: C-x C-r #+FINDEX: find-file-read-only Visit a file for viewing, without allowing changes to it #+end_table #+END_SRC But the items are exported incorrectly, with each list item in its own itemize environment. How would I get something closer to the texinfo output above? >> Perhaps it would be enough to expand the example document in >> the texinfo section of the Org manual. > > The point of the example document in the Org manual is to be the exact > equivalent to the example in the Texinfo example. The latter doesn't use > "@deffn" commands. Okay, I see. On the one hand, it isn't Org's job to teach people how to write Emacs manuals. On the other hand, if there's a nice solution Thanks, Eric