> to become more intimate with LilyPond, I've revised
> reference-manual.yo completely -- well, I haven't added more info
> to it, but I tried to improve its appearance -- it now looks
> quite nice in both DVI and HTML format.
Thanks, I'll have a look. Btw, you should make a unified diff and
send that, rather than the new file, ie, do something like:
diff -u refman.yo-1.2 refman.yo > refman.diff
Changes are always examined carefully before they're applied.
I've touched almost everything, thus a unified diff has about
200kByte! So I thought it is better to send the full source.
> Nevertheless, a lot of examples still look bad, and I don't know
> how to improve them (or rather not interested in reading source
> code). Most notably, the spacing in some code snippets is
> extremely bad. So please fix this.
Which ones? (Add a comment or TODO list in refman.yo)
Too many! If you convert reference-manual.yo to a DVI file, you'll
notice it immediately. I will go into detail perhaps in the next
days if time permits.
* We want to support quite some doc formats, and generate them
from one source language:
- latex for high quality hard copy; include .ps images
- html for www, and to provide searchable doc; include .png
images
Basically, the produced results for LaTeX and HTML from refman are OK
with yodl now IMHO.
- plain text for README, INSTALL etc.
- texinfo for structured, well searchable doc; no images
I'll test refman + yodl2texinfo soon.
- unix man format; for executables only, no images
At the time (we'll have to check again)
* Latex2html was no option for producing fine html output from
latex.
Check it again. I believe it has improved considerably in the last
two years.
* Texinfo2html was not available (how good is it now?).
I'll test it soon also.
* Preprocess to texinfo
- is texinfo2dvi an option for producing high-quality hard copy
doco (ie, is it better than yodl2latex?)
Yes.
- awkward typing?
You must get used to it :-)
- manual node structure maintenance or be forced to use emacs?
A good question!
- node names cannot contain , : . ? ! \ ' ` { } -- ---
- how to generate unix manual pages?
Maybe we should contact Karl Berry...
Werner
