[PHP-DOC] Bug #7888 Updated: decrement syntax should be -- instead of - From: hholzgra <email protected>
Date: 09/26/01

ID: 7888
Updated by: hholzgra
Reported By: jgoulooze <email protected>
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 <email protected>

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 <email protected>

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 <email protected>

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 <email protected>

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 <email protected>

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