RE: Printer Unfriendly Tomcat 5 Documentation
Hi, 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. Bah, everyone has their favorites, and they're all fairly similar. I use WinCVS. The Eclipse CVS explorer isn't too bad. 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. See the tomcat build file: it has targets that do this. They use Anakia and style tasks. What you would do is checkout the CVS module, make your XML changes, and run the tomcat doc generation tasks (they're in jakarta-tomcat-catalina/webapps/docs/build.xml, probably just use the dist target). Yoav This e-mail, including any attachments, is a confidential business communication, and may contain information that is confidential, proprietary and/or privileged. This e-mail is intended only for the individual(s) to whom it is addressed, and may not be saved, copied, printed, disclosed or used by anyone else. If you are not the(an) intended recipient, please immediately delete this e-mail from your computer system and notify the sender. Thank you. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Printer Unfriendly Tomcat 5 Documentation
Hi, We'd be thrilled if you submit documentation fixes. What you would do is: - Get the source for the docs, which is at http://cvs.apache.org/viewcvs.cgi/jakarta-tomcat-catalina/webapps/docs/, - Modify the file locally on your machine as you see fit, - Open a Bugzilla (http://nagoya.apache.org/bugzilla/) enhancement issue, - Attach a diff (produced by CVS ideally, so you'd download a CVS client and use its diff function, but you can submit diffs made with other tools) to the Bugzilla item. That's it. We'll evaluate and commit the fixes into the repository, and they'll be available with the next tomcat release. If you're interested, the general contribution process is covered at http://jakarta.apache.org/site/source.html#Patches and http://jakarta.apache.org/site/getinvolved.html. Yoav Shapira Millennium Research Informatics -Original Message- From: Lance D Bader [mailto:[EMAIL PROTECTED] Sent: Friday, June 04, 2004 1:56 PM To: [EMAIL PROTECTED] Subject: Printer Unfriendly Tomcat 5 Documentation 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.htm l -Lance Bader - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] This e-mail, including any attachments, is a confidential business communication, and may contain information that is confidential, proprietary and/or privileged. This e-mail is intended only for the individual(s) to whom it is addressed, and may not be saved, copied, printed, disclosed or used by anyone else. If you are not the(an) intended recipient, please immediately delete this e-mail from your computer system and notify the sender. Thank you. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Printer Unfriendly Tomcat 5 Documentation
I found the cause of the unfriendly documentation. Certain examples, imbedded between pre /pre 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]
Re: Printer Unfriendly Tomcat 5 Documentation
At 12:41 AM 6/5/2004 -0400, you wrote: I found the cause of the unfriendly documentation. Certain examples, imbedded between pre /pre 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. http://www.tortoisecvs.org/ Jake 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] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]