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

ID: 7888 Updated by: jah Reported By: jgoulooze@thinktoo.nl Status: Assigned Bug Type: Documentation problem Old Operating System: NT & win98 using apache (phptria Operating System: All Old PHP Version: 4.0.2 PHP Version: N/A Assigned To: hholzgra New Comment: 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... Previous Comments: ------------------------------------------------------------------------ [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. ------------------------------------------------------------------------ [2001-09-23 08:48:52] jeroen@php.net The same goes for myself by the way: Now I recall where I read about that hack, it's in this very bug report... :-/ But that hack isn't in repository, Hartmut, is it okay for me to see wether I can add it in the repo? ------------------------------------------------------------------------ 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