[Ns-bugs] [Bug 76] New: new documentation templates needed
bugzilla-daemon at nsnam-www.ece.gatech.edu
Sun Sep 16 21:51:55 PDT 2007
Summary: new documentation templates needed
AssignedTo: ns-bugs at isi.edu
ReportedBy: tomh at tomh.org
The current documentation system is based on Latex with perl-based pre-process
and post-process script, and then relies on latex2html to generate HTML. This
system was inherited (and tweaked) from the ns-2 manual.
The goal is to write documentation that produces both clean looking PDF and
clean, easily navigable web pages with hyperlinks and styles for pasting in
The current system is fragile in a number of ways, but the main problem is the
HTML that is generated:
- images are not converted correctly when latex2html is run
- latex2html does not know how to handle many Latex environments and also
specialized macros defined for ns-3
- specifying URLs that render correctly in both PDF and HTML is challenging, as
witnessed by this example post from another forum:
Two alternatives to consider are GNU Texinfo and Doxygen (using it more than
just for APIs, such as Mathieu's tracing documentation).
Configure bugmail: http://www.nsnam.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
More information about the Ns-bugs