Re: [O] [RFC] Org version of the Org manual

[Achim Gratz]

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 $@ address@hidden address@hidden
--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 
"address@hidden@address@hidden(arg1,arg2)@address@hidden@}}" 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