From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: texinfo export advice Date: Wed, 05 Dec 2012 06:22:24 -1000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:48593) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TgQKN-0007R1-Qp for emacs-orgmode@gnu.org; Wed, 05 Dec 2012 20:32:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TgQKL-0006vN-TW for emacs-orgmode@gnu.org; Wed, 05 Dec 2012 20:32:39 -0500 Received: from oproxy11-pub.bluehost.com ([173.254.64.10]:34057) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1TgQKL-0006uW-9Y for emacs-orgmode@gnu.org; Wed, 05 Dec 2012 20:32:37 -0500 Received: from [98.155.255.145] (port=62314 helo=poto.myhome.westell.com) by box472.bluehost.com with esmtpsa (TLSv1:CAMELLIA128-SHA:128) (Exim 4.76) (envelope-from ) id 1TgHjw-00061g-KP for emacs-orgmode@gnu.org; Wed, 05 Dec 2012 09:22:30 -0700 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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Org-mode Aloha all, I'm trying to find a good Org representation for a common construct in org.texi and need some help. Here is the construct in org.texi: @table @asis @orgcmd{C-u C-u @key{TAB},org-set-startup-visibility} Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and @samp{VISIBILITY} properties in individual entries. @end table It displays a key command and the Org function that it runs, then has a description of the function. In the info manual it looks like this: `C-u C-u ' (`org-set-startup-visibility') Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and `VISIBILITY' properties in individual entries. I can export this with the texinfo exporter with a lot of wrapping: @@info:@table @asis@@ @@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@ Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and @@info:@samp{VISIBILITY}@@ properties in individual entries. @@info:@end table@@ This is fine, but the Org mode buffer doesn't look much like Org mode after a few of these. My idea is to use a description list, like so: - @@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@ :: Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and @@info:@samp{VISIBILITY}@@ properties in individual entries. This almost works. However, it inserts an @index command that gets in the way: @table @samp @item @orgcmd{C-u C-u @key{TAB},org-set-startup-visibility} Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and @samp{VISIBILITY} properties in individual entries. @end table This is the view from info: ` `C-u C-u (`org-set-startup-visibility')' ' Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and `VISIBILITY' properties in individual entries. Note the extra open and close quotes and newlines. I'm thinking something like this might be a useful addition: #+attr_texinfo :item nil - @@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@ :: Switch back to the startup visibility of the buffer, i.e.: whatever is requested by startup options and @@info:@samp{VISIBILITY}@@ properties in individual entries. Ideas? All the best, Tom -- T.S. Dye & Colleagues, Archaeologists 735 Bishop St, Suite 315, Honolulu, HI 96813 Tel: 808-529-0866, Fax: 808-529-0884 http://www.tsdye.com