Hello list, I'm trying to convert to TeXinfo some of the docs for an Emacs package that I wrote (eev), but they turned out to be quite tricky to TeXinfo-ize, so I decided to ask for advice...
The current HTML version of the text that I'm trying to convert is here: http://angg.twu.net/eev-article.html There are three main problems: (1) Glyphs. When eev is loaded some entries in Emacs's display table are set in special ways; for example, position 15 is set to a "*" with the face `eev-glyph-face-red'; this makes Emacs display "\^O"s as red stars, see <http://angg.twu.net/eev-article.html#glyphs>. Those "char 15"'s should appear as "char 15"s - no translation - both in the .info and in the .tex output; the best way that I've found to get TeX to typeset them nicely is to use this: \def\myttbox#1{{\setbox0=\hbox{\texttt{a}}% \hbox to \wd0{\hss#1\hss}}} \catcode`=13 \def{\myttbox{$\bullet$}} to make TeX display them as "$\bullet$" adjusted to the width of the characters in the typewriter font. I'm not sure if using "char 15"s in TeXinfo/info files is ok, though... (2) Unindented examples. I would like to make most of the examples runnable from inside *info* buffers, but some of the examples will only work if they are not indented - see <http://angg.twu.net/eev-article.html#delimited-regions>. Maybe we would need to define "@uexample ... #end uexample" environments, that would be like "@example ... @end example" but "uexamples" wouldn't be indented in the info output... unindented examples might look ugly, I know, but examples that don't work, or that need to be pasted to other buffers and then unindented, can confuse and frustrate users... (3) Screenshots. The text has some screenshots, and for each of them I have both an asciified version, like <http://angg.twu.net/eev-article.html#channels>, and a PNG, like <http://angg.twu.net/eev-current/article/ss-f9.png>. I don't understand well the status of the support for images in TeXinfo... What is the correct way to handle cases like those? Any suggestions? Hints? Cheers, thanks in advance, Eduardo Ochs [EMAIL PROTECTED] http://angg.twu.net/ P.S.: The (BlogMe) source for <http://angg.twu.net/eev-article.html> is here: <http://angg.twu.net/TH/eev-article.blogme>; my plan is to patch BlogMe to make it generate both the .html and the .texi outputs from the same .blogme source... The docs for BlogMe are at <http://angg.twu.net/blogme.html>, but beware - as far as I know no use uses BlogMe except for me, and its docs were written in a single (insomniac) night... _______________________________________________ Texinfo home page: http://www.gnu.org/software/texinfo/ [email protected] http://lists.gnu.org/mailman/listinfo/bug-texinfo
