From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: [RFC] Org version of the Org manual Date: Mon, 25 Feb 2013 10:21:54 -1000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:49487) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UA4Z7-0008QW-FW for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 15:22:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UA4Z5-0005x9-Rb for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 15:22:25 -0500 Received: from oproxy7-pub.bluehost.com ([67.222.55.9]:49779) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1UA4Z5-0005wl-J0 for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 15:22:23 -0500 Received: from [98.155.255.145] (port=64019 helo=poto.local) by box472.bluehost.com with esmtpsa (TLSv1:CAMELLIA128-SHA:128) (Exim 4.80) (envelope-from ) id 1UA4Yh-0006Ou-20 for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 13:22:00 -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, An experiment to see if it is possible to convert the Org manual to Org is now (hopefully) at the "proof of concept" stage and I would like to determine whether or not the approach is viable. The experiment is here: https://github.com/tsdye/orgmanual.git The file orgmanual.org has a heading, * Instructions for use, that explains how to set up asynchronous export with the new exporter. The repo also contains orgmanual.info in case you don't want to hassle with exporting the org file and just want to see what it looks like in info. I'm able to generate an info file without makeinfo raising any errors or warnings. There is also a heading, * Improvements and fixes, that includes a list of problems that either need to be fixed or are in the process of being fixed. Obviously, the file is not perfect, but I do believe it is good enough to judge whether success will be possible. At any rate, I need to pull myself away from this project for a week or so to do other things and can't get caught up making editorial changes or working on the (to me) thorny issues that remain. Sections with problems have been given FIXME keywords. In some cases, problem text (especially in macros) has been replaced with `XXX'. Proposed fixes for these nagging issues will be greatly appreciated. By way of background, my initial goal was to replicate the Org manual precisely. This goal was abandoned when I realized that the various contributors to the manual (including me a few years ago) had different ideas about what a .texi file should look like and had created a somewhat eclectic product. The goal now is to have a "functional equivalent" of the manual. The ultimate goal is to maintain the Org manual in Org, rather than .texi, and to have the infrastructure in place in time to support the major revisions required by the forthcoming release of version 8.0. Many thanks to Nicolas Goaziou and to Jonathan Leech-Pepin for their excellent work on the new exporter framework and the texinfo exporter, and for their patience with my sometimes exasperated (and exasperating) queries. Jonathan showed me the way forward at an early stage and devised most of the macros. I look forward to picking this project up again in a week or so, or learning from my Org colleagues that the project ought to be scuttled. 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