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

ID: 7888 Updated by: hholzgra Reported By: jgoulooze@thinktoo.nl Status: Assigned Bug Type: Documentation problem Operating System: All PHP Version: N/A Assigned To: hholzgra New Comment: > 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 Previous Comments: ------------------------------------------------------------------------ [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 ------------------------------------------------------------------------ [2001-09-23 09:06:42] eschmid@php.net This "bug" is not a documentation problem. Building PostScript or PDF manuals with xml files renders two dashes into a long dash. This is a problem with Jade because it uses TeX. The "<" is another case. It is the first character for an element name in XML. This means, you cannot write a "<" character in the CDATA section of any XML file. Only ">" is allowed. Please use the mailinglist archives, it was discussed several times. ------------------------------------------------------------------------ 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