bug-texinfo
[Top][All Lists]

## glyphs, unindentex examples, screenshots

 From: Eduardo Ochs Subject: glyphs, unindentex examples, screenshots Date: Tue, 27 Jun 2006 16:33:06 -0300

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
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...

reply via email to