latex2e BUGS TODOS and other animals
------------------------------------

for processing tools/test.txt use pdflatex because it will handle png-images.


:Author: engelbert gruber
:Contact: grubert@users.sourceforge.net
:Date: $Date$

To do
~~~~~

* dedication is centered italic in html (test.txt).

* term: html puts classifier in italic and newline after classifier,
  latex in parentheses and no newline after it (test.txt).

* field lists are indented in latex (test.txt).

* literal block is indented in html (test.txt).

* doctest block is indented in html.

* footnotes donot link back in latex.

* rubric, sidebar, ...

* citation references and bibtex: could we learn or use something ?

  e.g. contemplating about persistence storage of references or
  the like reminds me of latex generating toc,lot,lof files.

* quotes for german: {\glqq} {\grqq} {\glq} {\grq} {\dq}.

* support embed-stylesheet.

* the ^-sign is problematic: using mathmode wedge is usually the wrong font.

* sidebar handling.

* Maybe add end of line after term in definition list. see
    http://roundup.sf.net/doc-0.5/features.pdf

* In tools.txt the option tables right column, there should be some more spacing
  between the description and the next paragraph "Default:".

  Paragraph separation in tables is hairy. 
  see http://www.tex.ac.uk/cgi-bin/texfaq2html?label=struttab

  - The strut solution did not work.
  - setting extrarowheight added ad top of row not between paragraphs in
    a cell. ALTHOUGH i set it to 2pt because, text is too close to the topline.
  - baselineskip/stretch does not help.

* two hlines after table head and on table end ?

* table: multicol cells are always {l}.

* pdfbookmark level 4 (and greater) does not work (might be settable but OTOH).

* center subsection{Abstract} gives a latex error here.
  ``! LaTeX Error: Something's wrong--perhaps a missing \item.``
  Committed a HACK: centering by hfill

* document errors are also too silent.

* use optionlist for docinfo.

* the title "table of contents" is centered too.

* consider peter funk's hooks for TeXpert:
  
  * Define his own document preamble (including the choice to
    choose his own documentclass.  That would make the ``--documentclass``
    option superfluous).  I suggest to call this option ``--preamble``

  * Use two additional hooks to put additional stuff just behind the 
    ``\begin{document}`` and just before the ``\end{document}`` macros.
    Typical uses would be ``\tableofcontents``, ``\listoffigures`` and
    ``\appendix``, ``\makeindex``, ``\makeglossary`` and some such 
    for larger documents.

* hyphens: co-developers should be co--developers ?

* table heads and footer for longtable (firstpage lastpage ..)

* longtable does not work with multirow

* tabularx says "do not use any multicolmn which spans any X column.
  maybe use ltxtable instead of tabularx (Longtable combined with tabularx).
  but ltxtable disables longtable's multicolumn.

* multiple author entries in docinfo (same thing as in html).

* the indentional problematic error in test.txt is not referring anywhere.

* table cells with multirow and multicolumn

* tables have borders, and the border is missing in empty cells.

* footnotes are not all on the same page (as in tools/test.txt) and do not link back
  and forth.

* no link to system errors.	

* hyperlinks are not hyphenated this leads to bad spacing. see tools/test.txt 
  2.14 directives directives

* meta keywords into pdf ?

* pagestyle headings does not work, when sections are starred.

* additional docinfo items: the field_body is inserted as text.

ATTENTION
~~~~~~~~~
* put labeling inside (after the begin) environments.
* me (e.g.) uses textwidth, julien linewidth see what is what.

  textwidth: is the normal width of the text on a page. It should generally 
  be changed only in the preamble. 

  linewidth: is the width of lines in the current environment. Normally equal to
    \textwidth, it may be different within an environment such as list or quote 
    environments.

Done
~~~~

* HACK --snap-footnote-refs=1 to strip trailing blanks from item preceeding a footnote-ref.
* add a LaTeX-nbsp (~) before a LaTeX-newline to avoid "LaTeX-Error no line to end here".
* line_blocks without use of mbox, to allow markups span over line ends.
* add french to babel support.
* double quotes by dq inside literal if language is de.
* no quote mangling in literal blocks.
* enumertated list with pre- and postfix.
* support stylesheet and stylesheet-path.
* FIX: QUICK: for latex error on abstract.
* FIX: ^ by mathmode wedge (verb|^| did not work in mbox). 
* admonitions are not so visible as in html (make a border a bigger title, indent
  text) thanks to g.schwant.
* FIX: protection of braces: formerly literal blocks were verbatim.
  Now that they are no longer verbatim braces are dangerous.
* literal_block no longer verbatim to allow inline markup, no longer intended.
* Always emit empty date and author entries.
* FIX: descriptions without docinfo (self.docinfo not initialized).
* footnotes are spread vertically (not with juliens style.tex) include it in python.
* add handling (do nothing) for title-reference.
* setlength extrarowheight 2pt too get a little space between text in tables
  and the lines above them.
* table: multicol rows have no vertical lines.
* --use-latex-toc: so we get pagenumbers.
* reduce table width to 0.93 of linewidth.
* decrement pdfbookmark levels. now 0 to 3.
* use subsubsection for deeper ones.
* all spaces in line-blocks are nonbreakable (~). 	
* newenvironment optionlist for option-lists.
* append ":" onto definition list terms.
* long option-groups use multicolumn.
* remove borders from option-lists.
* lists that donot start at one donot work.
* ordered list numbering style is taken from latex a.,b. in source
  gives 1., .. in document.
* enumeration too deep: latex goes up to four.
* abstract title should be centered. 
* docinfo table centered and narrower.
* bibliographic field names have a ":".
* german (de*) quotes.
* colspec for tables without heads.
* multipage table
* field lists as description inside quote.
* literal blocks are inside a quote environment (means indented).
