From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: [RFC] Org version of the Org manual Date: Mon, 25 Feb 2013 22:21:46 +0100 Message-ID: <337453A8-BFC0-4EF5-998A-39D3B8ECACF4@gmail.com> References: Mime-Version: 1.0 (Mac OS X Mail 6.2 \(1499\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:49352) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UA5Ue-0006wH-Lt for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 16:21:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UA5Ud-0007WS-BK for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 16:21:52 -0500 Received: from mail-ee0-f43.google.com ([74.125.83.43]:34865) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UA5Ud-0007W0-4z for emacs-orgmode@gnu.org; Mon, 25 Feb 2013 16:21:51 -0500 Received: by mail-ee0-f43.google.com with SMTP id c50so1683452eek.30 for ; Mon, 25 Feb 2013 13:21:49 -0800 (PST) In-Reply-To: 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: "Thomas S. Dye" Cc: Org-mode Hi Tom, wow, a daring project. This would indeed be a testimony to the quality = of the exporter if this works and gives proper output! I am curious and = looking forward to seeing the results. - Carsten On 25.2.2013, at 21:21, Thomas S. Dye wrote: > Aloha all, >=20 > 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: >=20 > https://github.com/tsdye/orgmanual.git >=20 > 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.=20 >=20 > 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. >=20 > 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. >=20 > 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. >=20 > 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. >=20 > 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. >=20 > 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. >=20 > All the best, > Tom >=20 > --=20 > 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 >=20