From mboxrd@z Thu Jan 1 00:00:00 1970 From: Achim Gratz Subject: Re: [RFC] Org version of the Org manual Date: Mon, 04 Mar 2013 22:28:05 +0100 Message-ID: <87ehfuonx6.fsf@Rainer.invalid> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([208.118.235.92]:56179) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UCcvl-0002bc-BV for emacs-orgmode@gnu.org; Mon, 04 Mar 2013 16:28:22 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UCcvj-0008TC-Sk for emacs-orgmode@gnu.org; Mon, 04 Mar 2013 16:28:21 -0500 Received: from plane.gmane.org ([80.91.229.3]:60062) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UCcvj-0008Sz-LZ for emacs-orgmode@gnu.org; Mon, 04 Mar 2013 16:28:19 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1UCcw2-0008Tb-EQ for emacs-orgmode@gnu.org; Mon, 04 Mar 2013 22:28:38 +0100 Received: from pd9eb48e0.dip.t-dialin.net ([217.235.72.224]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 04 Mar 2013 22:28:38 +0100 Received: from Stromeko by pd9eb48e0.dip.t-dialin.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 04 Mar 2013 22:28:38 +0100 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: emacs-orgmode@gnu.org Thomas S. Dye writes: […] > 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. Hi Tom, this looks good. I've implemented a rough draft of a Makefile that integrates with the build system (a clean target is still missing, etc.pp.). To use, clone orgmanual.git in the Org worktree (don't add it, or add as a submodule), then drop this Makefile into orgmanual/: --8<---------------cut here---------------start------------->8--- BEXP=$(BATCH) \ --eval '(add-to-list '"'"'load-path "../lisp")' \ --eval '(setq org-footnote-auto-adjust nil)' \ -l ox-texinfo \ --eval '(add-to-list '"'"'org-export-snippet-translation-alist '"'"'("info" . "texinfo"))' ORG2TEXI=-f org-texinfo-export-to-texinfo ORG2INFO=--eval "(org-texinfo-compile \"./$<\")" orgmanual.texi: orgmanual.org $(BEXP) $< $(ORG2TEXI) orgmanual.info: orgmanual.texi # $(BEXP) $< $(ORG2INFO) $(MAKEINFO) --no-split $< -o $@ orgmanual.pdf: LC_ALL=C # work around a bug in texi2dvi orgmanual.pdf: LANG=C # work around a bug in texi2dvi orgmanual.pdf: orgmanual.texi $(TEXI2PDF) $< --8<---------------cut here---------------end--------------->8--- Also make a link (for now) to ../doc/org-version.inc and add this to local.mk: --8<---------------cut here---------------start------------->8--- .PHONY: orgmanual orgmanual: $(MAKE) -C $@ $@.info $@.pdf --8<---------------cut here---------------end--------------->8--- A "make orgmanual" then exports to orgmanual.texi (slowly) and an info file is produced by makeinfo, but texi2dvi does not want to produce a PDF yet and errors out. The info file contains a few easily spotted mistakes in the macro section like "~@{@{@{name(arg1,arg2)@~@}@}}" that are quite probably the source of some of these errors. Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ Wavetables for the Terratec KOMPLEXER: http://Synth.Stromeko.net/Downloads.html#KomplexerWaves