[PHP-DOC] Bug #9549 Updated: Add Note problem From: jeroen <email protected>
Date: 07/04/01

ID: 9549
Updated by: jeroen
Reported By: wls <email protected>
Old-Status: Open
Status: Bogus
Bug Type: Documentation problem
Operating system:
PHP Version: 4.0.4pl1
Assigned To:
Comments:

This is not a PHP-bug, but a website bug. Send to webmaster <email protected> if still valid.

Previous Comments:
---------------------------------------------------------------------------

[2001-03-04 13:26:02] wls <email protected>

In reference to your Add Note code on the annotatated PHP pages:

The current set of note restrictions is actually too limiting and a little more effort need to be focused on what's allowable in a user submitted note.

A) I had a very small snipped of PHP code I was trying to include, however preceeding spaces of the indentation were trimmed out, and thus the context was completely lost. My code sample suffered when <PRE>...</PRE> would have resolved it.

B) A line in my code read as echo "$value<P>n"; however this caused the line to break. Allowing <P> or <BR> at the very end of a line would be appropiate to do the logical break.

C) I tried entering in "$value&lt;P&gt;n" instead, only the ampersands were literally translated. Thus there was no way to express the actual literal that was needed.

The solution seems to lie in more rigourous parsing -or- creating a special stripped down meta-markup.

In all cases, a "I'm including a code snippet, please express the content literally, without translation, and preserving spaces" would solve the problem.

A possible solution, instead of all HTML tags, allow just <CODE> ... </CODE>. The defined behavior is that all characters, including spaces and line brakes and angle brackets and ampersands are included as-is. An open code must be followed by a close code, and they can not be nested. If the note doesn't conform to that, do not allow it to be submitted.

...hope this helps!

---------------------------------------------------------------------------

ATTENTION! Do NOT reply to this email!
To reply, use the web interface found at http://bugs.php.net/?id=9549&edit=2