Re: Printer Unfriendly Tomcat 5 Documentation

2004-06-04 Thread Lance D Bader
I found the cause of the unfriendly documentation.  Certain examples,
imbedded between   tags are consuming too much horizontal space.
Not only does this cause truncation on the right margin while printing, it
also causes unnecessary horizontal scrolling.

The obvious fix is to reformat the examples, placing a single attribute on
each line.  Not only does this fix my problem, it also improves the
productivity of administrators who use the examples as templates (copy,
paste, modify, repeat as needed).

I am happy to do the work, but I need two more hints.

1) Please point me to a good CVS client or Diff utility that will generate a
suitable Diff file on my Windows XP Pro workstation.  My web search found
too many choices and insufficient information for making a choice.

2) Please tell me how to generate the HTML files from the documentation XML
source.  I would like to test my changes before I submit the updates.


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Printer Unfriendly Tomcat 5 Documentation

2004-06-04 Thread Lance D Bader
I have found that some of Tomcat 5 documentation is not printer friendly.
Printing from the Windows Internet Explorer V6, even after using the link to
the print-friendly version, an aggravating amount of data is truncated at
the right margin on my HP Laserjet using PostScript.  My web search for a
circumvention has proved fruitless.

What causes this problem and what can I do to fix the documentation
repository?  I would be happy to contribute fixes to the master repository
if that has some value, just point me in the right direction.

Here are three document references that demonstrate this problem.

http://jakarta.apache.org/tomcat/tomcat-5.0-doc/printer/jndi-resources-howto.html

http://jakarta.apache.org/tomcat/tomcat-5.0-doc/printer/jndi-datasource-examples-howto.html

http://jakarta.apache.org/tomcat/tomcat-5.0-doc/printer/realm-howto.html

-Lance Bader


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]