Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 97751 invoked from network); 2 Apr 2004 21:29:34 -0000 Received: from daedalus.apache.org (HELO mail.apache.org) (208.185.179.12) by minotaur-2.apache.org with SMTP; 2 Apr 2004 21:29:34 -0000 Received: (qmail 89576 invoked by uid 500); 2 Apr 2004 21:29:13 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 89555 invoked by uid 500); 2 Apr 2004 21:29:13 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 89531 invoked by uid 500); 2 Apr 2004 21:29:13 -0000 Delivered-To: apmail-httpd-site-cvs@apache.org Received: (qmail 89520 invoked from network); 2 Apr 2004 21:29:13 -0000 Received: from unknown (HELO minotaur.apache.org) (209.237.227.194) by daedalus.apache.org with SMTP; 2 Apr 2004 21:29:13 -0000 Received: (qmail 97684 invoked by uid 1173); 2 Apr 2004 21:29:24 -0000 Date: 2 Apr 2004 21:29:24 -0000 Message-ID: <20040402212924.97683.qmail@minotaur.apache.org> From: slive@apache.org To: httpd-site-cvs@apache.org Subject: cvs commit: httpd-site/xdocs/docs-project docsformat.xml X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N slive 2004/04/02 13:29:23 Modified: docs/docs-project docsformat.html xdocs/docs-project docsformat.xml Log: Add a note about character escaping. Revision Changes Path 1.29 +9 -1 httpd-site/docs/docs-project/docsformat.html Index: docsformat.html =================================================================== RCS file: /home/cvs/httpd-site/docs/docs-project/docsformat.html,v retrieving revision 1.28 retrieving revision 1.29 diff -u -d -b -u -r1.28 -r1.29 --- docsformat.html 2 Apr 2004 20:54:17 -0000 1.28 +++ docsformat.html 2 Apr 2004 21:29:22 -0000 1.29 @@ -186,7 +186,7 @@ complex stuff (like spanning rows or columns) will not work.

In addition, pdflatex does not know how to incorporate GIF files. So any graphics must be available in PNG format.

-

Finally, there are various other restrictive assumptions embedded +

There are various other restrictive assumptions embedded in the XSLT that work for the current docs, but may need to be modified in the future. For example, the code that transforms HTML-style links to LaTeX cross-references will work only with the @@ -194,6 +194,14 @@ <pre> sections are very likely not to work well in LaTeX because of differences in escaping and formatting rules in verbatim sections.

+

Finally, there are various differences in escaping rules between +XML/HTML and LaTeX. Some characters need to be backslash-escaped in +LaTeX, and all XML entitites (&whatever;) must be converted to +LaTeX equivalents. This is currently handled for a limitted set of +characters using a big ugly search-replace in the XSLT. But this may +need to be modified in the future, especially to handle translations. +Perhaps pre-processing with a perl script and a substitution table +would be better.

1.17 +11 -1 httpd-site/xdocs/docs-project/docsformat.xml Index: docsformat.xml =================================================================== RCS file: /home/cvs/httpd-site/xdocs/docs-project/docsformat.xml,v retrieving revision 1.16 retrieving revision 1.17 diff -u -d -b -u -r1.16 -r1.17 --- docsformat.xml 2 Apr 2004 20:54:19 -0000 1.16 +++ docsformat.xml 2 Apr 2004 21:29:23 -0000 1.17 @@ -124,7 +124,7 @@

In addition, pdflatex does not know how to incorporate GIF files. So any graphics must be available in PNG format.

-

Finally, there are various other restrictive assumptions embedded +

There are various other restrictive assumptions embedded in the XSLT that work for the current docs, but may need to be modified in the future. For example, the code that transforms HTML-style links to LaTeX cross-references will work only with the @@ -132,6 +132,16 @@ <pre> sections are very likely not to work well in LaTeX because of differences in escaping and formatting rules in verbatim sections.

+ +

Finally, there are various differences in escaping rules between +XML/HTML and LaTeX. Some characters need to be backslash-escaped in +LaTeX, and all XML entitites (&whatever;) must be converted to +LaTeX equivalents. This is currently handled for a limitted set of +characters using a big ugly search-replace in the XSLT. But this may +need to be modified in the future, especially to handle translations. +Perhaps pre-processing with a perl script and a substitution table +would be better.

+