Bug #7888 Updated: decrement syntax should be -- instead of -

ID: 7888 Updated by: hholzgra Reported By: jgoulooze@thinktoo.nl Old Status: Assigned Status: Closed Bug Type: Documentation problem Operating System: All PHP Version: N/A Assigned To: hholzgra New Comment: i have just successfully created a TeX manual with a patched version of openjade-1.3 the following patch has been submitted to the openjade project --- openjade-1.3/jade/TeXFOTBuilder.cxx Fri Aug 13 22:28:29 1999 +++ openjade-1.3.hholzgra/jade/TeXFOTBuilder.cxx Tue Oct 9 06:24:59 2001 @@ -1828,6 +1828,7 @@ #endif void TeXFOTBuilder::characters(const Char *s, size_t n) { + static int l=-1; for (; n > 0; n--, s++) { // Since TeX has only 256 characters // by default, two-byte characters @@ -1842,6 +1843,11 @@ // Otherwise, check for special // TeX escapes. switch(*s) { + case '-': + case '<': + case '>': + if(l==*s) os() << "\\-"; + // fallthru default: os() << char(*s); #ifdef OUTLINES @@ -1891,6 +1898,7 @@ break; } } + l=*s; } } Previous Comments: ------------------------------------------------------------------------ [2001-09-26 03:25:14] hholzgra@php.net > Unless someone actually knows how to fix TeX, > jade or something... TeX does what it should do as documented and i do not know how to fix 'something' but i think i have found a simple solution to deal with it in openjade sources ------------------------------------------------------------------------ [2001-09-25 15:43:54] jah@php.net I'll try to find some solution. Could be that the solution is switching to Fop. In the meanwhile, it's going to be dirty hacks. Unless someone actually knows how to fix TeX, jade or something... ------------------------------------------------------------------------ [2001-09-23 09:34:54] jeroen@php.net This is still a documentation problem, since in the PDF version it shows $i- instead of $i--, and that is wrong. It's not about the tools, it's about the result! (and we are providing a PDF version, if it were users generating PDF files, it would indeed not have been a doc problem, but since WE are doing it, it IS a doc problem.) It is not a problem in the XML files, but a bug c.q. feature sowewhere between dvi -> pdf (since the dvi is okay with my dvi-viewer). Also ps file seem to be okay. (hey, I see there is no download available in PS, why is that?) ------------------------------------------------------------------------ [2001-09-23 09:29:43] hholzgra@php.net as long as we produce manual versions with missleading output of '--' this *is* a documentation bug it is not our fault that it shows up as the real cause for it is a shortcoming of Jade which doesn't take in account that '--' has a special meaning in TeX and doesn't add escape characters or sequences to prevent this, but as we prodcude the wrong output with the current toolchain it *is* a documentation bug, problem, misfeature ... whatever ... after all so this report should not be closed unless we get a non-ugly solution for it whe can talk about 'suspended' with jah's dirty hack in place, but definetly not about 'closed' as the problem isn't solved yet! ------------------------------------------------------------------------ [2001-09-23 09:17:48] goba@php.net I think Egon meant: | This means, you cannot write a "<" character | __outside__ a CDATA section of any XML file. | Only ">" is allowed. Extract from: http://www.w3.org/TR/2000/REC-xml-20001006#sec-cdata-sect | Within a CDATA section, only the CDEnd string is | recognized as markup, so that left angle brackets and | ampersands may occur in their literal form; they need | not (and cannot) be escaped using "&lt;" and "&amp;". So people can use < in CDATA. Outside CDATA, they can't. -- Goba ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/?id=7888 Edit this bug report at http://bugs.php.net/?id=7888&edit=1