Looking for TeX/LaTeX gurus help

[Patrice Dumas]

Hello,

This is a request for help for texi2html/makeinfo in perl. Since it
will be merged very soon to texinfo, I ask here. Also I know that
there are some mighty TeX/LaTeX wizards on this list ;-).

I would like to do some conversion from texinfo to LaTeX/TeX, with a
short term goal to have all the texinfo relevant in @math converted
to TeX/LaTeX (when @math is used by some converter that don't now about
texinfo, like <math> in mediawiki, latex2html) and a conversion to LaTeX
as a long-term goal. For the @math conversion, I would prefer some 
conversion compatible with both plain TeX and LaTeX. Outside @math, the 
emphasize is more on LaTeX (no need to redo texinfo.tex). I will list 
the @-commands I would like to have a conversion both in math mode 
(in @math) and in normal mode first, and after that I'll turn to 
commands that shouldn't appear in @math. Please write next to the 
command what it should be in @math, and outside. If the construct 
requires a specific LaTeX document style, or a \usepackage, or some 
\command definition in the preamble, please say so, too.

In case it matters, I plan to use 'report' for normal texinfo documents, 
and 'article' for documents that have only one section.

Whan I have a proposal I put it, tell if you disagree. As you can see, 
I know LaTeX (and use it quite a lot), but I am, by far, not an expert ;-)



@ringaccent
@'               \acute   \'
@,
@^               \hat     \^
@`               \grave   \`
@~               \tilde
@"
@=               \bar
@H
@dotaccent       \dot
@u               \breve
@ubaraccent
@udotaccent
@v
@ogonek
@tieaccent
@dotless

@*
@  (@<SPACE>)
@        (@<TAB>)
@
  (@<NEWLINE>)
@-
@|
@/
@:
@?
@.
@@
@}  \}  \}
@{  \{  \{

@\ (only in math)

               'TeX'               ?      \TeX
               'LaTeX'             ?      \LaTeX
               'bullet'
               'copyright'
               'registeredsymbol'
               'dots'
               'enddots'
               'equiv'
               'error'
               'expansion'
               'arrow'
               'minus'
               'point'
               'print'
               'result'
               'today'
               'aa'
               'AA'
               'ae'
               'oe'
               'AE'
               'OE'
               'o'
               'O'
               'ss'
               'l'
               'L'
               'DH'
               'dh'
               'TH'
               'th'
               'exclamdown'
               'questiondown'
               'pounds'
               'ordf'
               'ordm'
               'comma'
               'euro'
               'geq'
               'leq'
               'tie'
               'textdegree'
               'quotedblleft'
               'quotedblright'
               'quoteleft'
               'quoteright'
               'quotedblbase'
               'quotesinglbase'
               'guillemetleft'
               'guillemetright'
               'guillemotleft'
               'guillemotright'
               'guilsinglleft'
               'guilsinglright'

      'asis'
      'b'
      'clicksequence'
      'click'
      'code'
      'command'
      'dfn'
      'emph'
      'env'
      'file'
      'i'
      'slanted'
      'sansserif'
      'kbd'
      'key'
      'option'
      'r'
      'samp'
      'sc'
      'strong'
      't'
      'var'
      'w'



And for the following, if you have an idea about how they should be
rendered in LaTeX normal text, please say. When I have an idea, I put
it next to the command name. For complex formats, like @multitable,
you can just point me to the LaTeX package you think is relevant, with
hints if needed, and I can do the remaining.


characters protected by a backslash in normal text: $ & % # _

\ $backslash$
 
For the following commands, also tell if the arguments should not
be protected normally (for example first @uref argument):

      'cite'
      'dmn'
      'ctrl'
      'hyphenation'
      'verb'
      'titlefont'
      'uref'
      'url'
      'indicateurl'
      'email'
'acronym'
'abbr'

      'math' $ ... $

      'anchor' label
      footnote footnote
I know about \ref to do some cross ref, but I am not sure that it fits with
all the @*ref texinfo commands.
      @*ref 

a punctuation mark followed by @. in normal text.

for @example, @display and so on:
\fancyvrb with commandchars=\\\{\}, fontfamily=?, fontsize=\small if needed.
If you know what to use for fontfamily for the different possibilities 
(like @example and like @format), please say.

@titlepage
@copying
@insertcopying

@raggedright
@group

itemize       \begin{itemize}
enumerate     \begin{enumerate}
table         \begin{description}

@multitable    \tabular, but I don't know exactly how, since it is
  possible to have some complicate things in @multitable in texinfo
  I am not sure \tabular can handle (in fact, texi2html handle almost any 
  nesting in @multitable, including @multitable in @multitable since 
  HTML also accept them, but texinfo.tex doesn't accept everything).
      'headitemfont'

@center
@flushleft
@flushright

@def*

@printindex
@?index

@quotation
@smallquotation
@*quotation with arg

@image

@float  I don't know if there is a generic float command, but we could
have some specific float types, for example 
 @float Table   @table
@caption   \caption
@shortcaption

@c,@comment depending on the situation, either % or removed

raisesections
lowersections
        'contents'
        'shortcontents'
        'summarycontents'
        'setcontentsaftertitlepage'
        'setshortcontentsaftertitlepage'
        'clickstyle'
        'novalidate'
        'dircategory'
        'pagesizes'
        'finalout'
        'paragraphindent'
        'firstparagraphindent'
        'frenchspacing'
        'fonttextsize'
        'allowcodebreaks'
        'exampleindent'
        'footnotestyle'
        'afourpaper'
        'afivepaper'
        'afourlatex'
        'afourwide'
        'headings'
        'setchapternewpage'
        'everyheading'
        'everyfooting'
        'evenheading'
        'evenfooting'
        'oddheading'
        'oddfooting'
        'smallbook'
        'setfilename'
        'shorttitle'
        'shorttitlepage'
        'settitle'
        'author'
        'subtitle'
        'title'
        'syncodeindex'
        'synindex'
        'defindex'
        'defcodeindex'
        'documentlanguage'
        'kbdinputstyle'
        'everyheadingmarks'
        'everyfootingmarks'
        'evenheadingmarks'
        'oddheadingmarks'
        'evenfootingmarks'
        'oddfootingmarks'
        'sp'
        'page'
        'refill'
        'noindent'
        'indent'
        'need'
        'exdent'
        'vskip'
        'cropmarks'
        'verbatiminclude'
        'documentencoding'
        'filbreak'


--
Pat