FAQ
Edit report at http://pear.php.net/bugs/bug.php?id=12704&edit=1

ID: 12704
Updated by: demon.gene@gmail.com
Reported By: pear at laurent-laville dot org
Summary: XML/Beautifier removed comment in XML Docbook
peardoc2 converter template
-Status: Open
+Status: Verified
Type: Bug
Package: PhpDocumentor
Operating System: windows xp
Package Version: 1.4.1
PHP Version: 5.2.5
Roadmap Versions:
New Comment:

-Status: Open
+Status: Verified



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

[2009-07-21 17:32:03] ashnazg

-Roadmap Versions:
+Roadmap Versions: 1.4.3


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

[2007-12-16 15:31:25] farell

Description:
------------
While trying to generate API doc for PEAR manual in DocBook format, I
found that with XML/Beautifier (1.1) installed I got all comment tags
dropped to final result : xml files

For example, with a config file to generate PEAR_Info package API in
command line

pear_info.ini content :

[Parse Data]
title = PEAR_Info Manual
hidden = false
parseprivate = off
javadocdesc = off
defaultcategoryname = PEAR
defaultpackagename = PEAR_Info
target = C:\php5\phpdoc\PEAR_Info
readmeinstallchangelog = README, INSTALL, FAQ, LICENSE
directory = c:/php/pear/PEAR_Info
ignore = CVS/*
output=XML:DocBook/peardoc2:default
sourcecode = on


Test script:
---------------
phpdoc -c pear_info.ini

Expected result:
----------------
<!-- $Revision: 1.3 $ -->
<refentry id="package.pear.pear-info.pear-info.display">

... more xml tags ...

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->



Actual result:
--------------
<refentry id="package.pear.pear-info.pear-info.display">

... more xml tags ...

</refentry>

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

Search Discussions

  • Demon Gene at Oct 12, 2009 at 9:08 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=12704&edit=1

    ID: 12704
    Updated by: demon.gene@gmail.com
    Reported By: pear at laurent-laville dot org
    Summary: XML/Beautifier removed comment in XML Docbook
    peardoc2 converter template
    -Status: Verified
    +Status: Closed
    Type: Bug
    Package: PhpDocumentor
    Operating System: windows xp
    Package Version: 1.4.1
    PHP Version: 5.2.5
    -Assigned To:
    +Assigned To: ashnazg
    Roadmap Versions:
    New Comment:

    -Status: Verified
    +Status: Closed
    -Assigned To:
    +Assigned To: ashnazg
    Found issue in Converters/XML/DocBook/peardoc2/Tokenizer.php. When
    XML_Beautifier is available, this local Tokenizer extends its Tokenizer
    and makes a call to XML_Beautifier_Tokenizer::_handleXMLDefault(), which
    takes only one arg. However, the call to it passes two args, the first
    of which is *always* "false". This resulted in the comment data not
    even being seen.

    Committed fix to SVN.


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

    [2009-10-12 17:47:53] ashnazg

    -Status: Open
    +Status: Verified


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

    [2009-07-21 17:32:03] ashnazg

    -Roadmap Versions:
    +Roadmap Versions: 1.4.3


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

    [2007-12-16 15:31:25] farell

    Description:
    ------------
    While trying to generate API doc for PEAR manual in DocBook format, I
    found that with XML/Beautifier (1.1) installed I got all comment tags
    dropped to final result : xml files

    For example, with a config file to generate PEAR_Info package API in
    command line

    pear_info.ini content :

    [Parse Data]
    title = PEAR_Info Manual
    hidden = false
    parseprivate = off
    javadocdesc = off
    defaultcategoryname = PEAR
    defaultpackagename = PEAR_Info
    target = C:\php5\phpdoc\PEAR_Info
    readmeinstallchangelog = README, INSTALL, FAQ, LICENSE
    directory = c:/php/pear/PEAR_Info
    ignore = CVS/*
    output=XML:DocBook/peardoc2:default
    sourcecode = on


    Test script:
    ---------------
    phpdoc -c pear_info.ini

    Expected result:
    ----------------
    <!-- $Revision: 1.3 $ -->
    <refentry id="package.pear.pear-info.pear-info.display">

    ... more xml tags ...

    </refentry>
    <!-- Keep this comment at the end of the file
    Local variables:
    mode: sgml
    sgml-omittag:t
    sgml-shorttag:t
    sgml-minimize-attributes:nil
    sgml-always-quote-attributes:t
    sgml-indent-step:1
    sgml-indent-data:t
    sgml-parent-document:nil
    sgml-default-dtd-file:"../../../../../manual.ced"
    sgml-exposed-tags:nil
    sgml-local-catalogs:nil
    sgml-local-ecat-files:nil
    End:
    vim600: syn=xml fen fdm=syntax fdl=2 si
    vim: et tw=78 syn=sgml
    vi: ts=1 sw=1
    -->



    Actual result:
    --------------
    <refentry id="package.pear.pear-info.pear-info.display">

    ... more xml tags ...

    </refentry>

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

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
grouppear-bugs @
categoriesphp
postedOct 12, '09 at 3:48p
activeOct 12, '09 at 9:08p
posts2
users1
websitepear.php.net

1 user in discussion

Demon Gene: 2 posts

People

Translate

site design / logo © 2022 Grokbase