glyphs, unindentex examples, screenshots

[Eduardo Ochs]

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
 address@hidden
 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...