Re: [RFC] Org version of the Org manual

[Achim Gratz <Stromeko@nexgo.de>]

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