[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-pear
Subject:    [PHP-PEAR] Another pear/PHPDoc bug
From:       "Jesus M. Castagnetto" <jcastagnetto () yahoo ! com>
Date:       2001-02-21 19:39:00
[Download RAW message or body]

Another bug, multiline descriptions of classes get
scrunched together w/o a space in between, this causes
that lines like:

/**
 * This class defines a PDB Atom
 * with fields from the Protein Databank 
 * atom record specs
... (etc.)

Renders as:

This class defines a PDB Atom
with fields from the Protein Databankatom record specs

I.e. the first and second line get the <br> OK the
rest just get appended to the second one w/o
intervining spaces.

Also, I think that tags such as <ul>, <ol>, <li>, <a>,
<br>, etc. in the documentation should not be mangled.
Javadoc lets them pass w/o changes, but PHPDoc uses
htmlspecialchars() in
renderer/html/PhpdocHTMLRenderer.php for that purpose.
If this is a design feature, then it should respect
the explicit line breaks, so text lists can be made
w/o them getting scrunched together as the above
example show



=====
--- Jesus M. Castagnetto (jcastagnetto@yahoo.com)

__________________________________________________
Do You Yahoo!?
Yahoo! Auctions - Buy the things you want at great prices! http://auctions.yahoo.com/

-- 
PHP Extension and Add-on Repository (PEAR) mailing list.
Documentation can be found at http://pear.php.net/doc/pear.html
To unsubscribe, e-mail: php-pear-unsubscribe@lists.php.net from the
mail address you subscribed with.

[prev in list] [next in list] [prev in thread] [next in thread]