1. Forum
  2. Usenet
  3. COMP.LANG.PHP

  • phpdoc: @uses and @usesby

    From fictitious@21:1/5 to All on Mon Apr 26 10:37:33 2021
    ++ cat phpdoc.dist.xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <phpdocumentor
    configVersion="3"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="https://www.phpdoc.org"

    xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd"

    <paths>
    <output>build/api</output>
    <cache>build/cache</cache>
    </paths>
    <version number="3.0.0">
    <api>
    <source dsn=".">
    <path>src</path>
    </source>
    </api>
    </version>
    </phpdocumentor>
    ++ cat src/uses.php
    <?php

    class Client {
    /**
    * @uses Server::method2()
    */
    function method1(){}
    }

    class Server {
    function method2(){}
    }
    ++ phpdoc # making documentation...
    ++ cd build/api/classes
    ++ firefox Client.html # OUTPUT: https://pasteboard.co/JZ5l756.png
    ++ firefox Server.html # OUTPUT: https://pasteboard.co/JZ5mB8t.png

    If Server::method2() appears in the Tags -> uses section of Client documentation page (https://pasteboard.co/JZ5l756.png),
    Client::method1() should appear in the Server documentation page (https://pasteboard.co/JZ5mB8t.png).
    Why not compare?

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From fictitious@21:1/5 to All on Mon Apr 26 12:03:59 2021
    Il 26/04/21 10:37, fictitious ha scritto:
    ++ cat phpdoc.dist.xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <phpdocumentor
    ������� configVersion="3"
    ������� xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    ������� xmlns="https://www.phpdoc.org"

    xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd"

    ��� <paths>
    ������� <output>build/api</output>
    ������� <cache>build/cache</cache>
    ��� </paths>
    ��� <version number="3.0.0">
    ������� <api>
    ����������� <source dsn=".">
    ��������������� <path>src</path>
    ����������� </source>
    ������� </api>
    ��� </version>
    </phpdocumentor>
    ++ cat src/uses.php
    <?php

    class Client {
    ��� /**
    ���� * @uses Server::method2()
    ���� */
    ��� function method1(){}
    }

    class Server {
    ��� function method2(){}
    }
    ++ phpdoc # making documentation...
    ++ cd build/api/classes
    ++ firefox Client.html # OUTPUT: https://pasteboard.co/JZ5l756.png
    ++ firefox Server.html # OUTPUT: https://pasteboard.co/JZ5mB8t.png

    If Server::method2() appears in the Tags -> uses section of Client documentation page (https://pasteboard.co/JZ5l756.png),
    Client::method1() should appear in the Server documentation page (https://pasteboard.co/JZ5mB8t.png).
    Why not compare?

    Of course hoping to have understood what is written here https://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.uses.pkg.html

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From fictitious@21:1/5 to All on Tue Apr 27 09:30:49 2021
    Il 26/04/21 12:03, fictitious ha scritto:
    Il 26/04/21 10:37, fictitious ha scritto:
    ++ cat phpdoc.dist.xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <phpdocumentor
    �������� configVersion="3"
    �������� xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    �������� xmlns="https://www.phpdoc.org"

    xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd"

    ���� <paths>
    �������� <output>build/api</output>
    �������� <cache>build/cache</cache>
    ���� </paths>
    ���� <version number="3.0.0">
    �������� <api>
    ������������ <source dsn=".">
    ���������������� <path>src</path>
    ������������ </source>
    �������� </api>
    ���� </version>
    </phpdocumentor>
    ++ cat src/uses.php
    <?php

    class Client {
    ���� /**
    ����� * @uses Server::method2()
    ����� */
    ���� function method1(){}
    }

    class Server {
    ���� function method2(){}
    }
    ++ phpdoc # making documentation...
    ++ cd build/api/classes
    ++ firefox Client.html # OUTPUT: https://pasteboard.co/JZ5l756.png
    ++ firefox Server.html # OUTPUT: https://pasteboard.co/JZ5mB8t.png

    If Server::method2() appears in the Tags -> uses section of Client
    documentation page (https://pasteboard.co/JZ5l756.png),
    Client::method1() should appear in the Server documentation page
    (https://pasteboard.co/JZ5mB8t.png).
    Why not compare?

    Of course hoping to have understood what is written here https://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.uses.pkg.html


    Nothing?

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)