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

ID: 15891
Updated by: kevin@vanzonneveld.net
Reported By: ifeghali at php dot net
Summary: End User Docs
Status: Open
Type: Documentation Problem
Package: System_Daemon
PHP Version: 5.2.8
-Assigned To:
+Assigned To: kvz
Roadmap Versions:
New Comment:

<div id="changeset">
<span class="removed">-Assigned To:</span>
<span class="added">+Assigned To: kvz</span>
</div>



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

[2009-02-12 01:58:46] doconnor

As a temporary fix, I just added
http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/ to
the external documentation link of the package.

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

[2009-02-11 16:49:13] ifeghali

By the way I just found your blog:

http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/

That definitely would be a great addition to PEAR docs :)

Please let me know if you need help "porting" it to here.

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

[2009-02-11 16:39:55] ifeghali

Description:
------------
It would be super to have some end user docs. The examples at
"docs/examples" are not clear enough on basic program usage for the
newbie user. Some important points are unclear, like what all those
die()s are doing along the code, how to correctly loops your code etc.

For instance, in "logparser.php" one's code (line 107) is outside the
loop (line 120). so how is that supposed to work ? newbie users to
parallel programming and threads might not get the idea behind the
package without proper end user documentation.

Maybe some prose just about the basic concepts can be enough.

Test script:
---------------


Expected result:
----------------


Actual result:
--------------

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

Search Discussions

  • Kevin at Feb 15, 2009 at 12:29 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=15891&edit=1

    ID: 15891
    Updated by: kevin@vanzonneveld.net
    Reported By: ifeghali at php dot net
    Summary: End User Docs
    Status: Assigned
    Type: Documentation Problem
    Package: System_Daemon
    PHP Version: 5.2.8
    Assigned To: kvz
    Roadmap Versions:
    New Comment:

    I wonder, do I need to strip layout & place that external document
    somewhere else as well?

    I would rather not because of duplication (it will be a drag to keep
    multiple places up to date) & the ability for users to place comments as
    it is.

    Let me know


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

    [2009-02-15 12:23:13] kvz

    <div id="changeset">
    <span class="removed">-Assigned To:</span>
    <span class="added">+Assigned To: kvz</span>
    </div>

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

    [2009-02-12 01:58:46] doconnor

    As a temporary fix, I just added
    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/ to
    the external documentation link of the package.

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

    [2009-02-11 16:49:13] ifeghali

    By the way I just found your blog:

    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/

    That definitely would be a great addition to PEAR docs :)

    Please let me know if you need help "porting" it to here.

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

    [2009-02-11 16:39:55] ifeghali

    Description:
    ------------
    It would be super to have some end user docs. The examples at
    "docs/examples" are not clear enough on basic program usage for the
    newbie user. Some important points are unclear, like what all those
    die()s are doing along the code, how to correctly loops your code etc.

    For instance, in "logparser.php" one's code (line 107) is outside the
    loop (line 120). so how is that supposed to work ? newbie users to
    parallel programming and threads might not get the idea behind the
    package without proper end user documentation.

    Maybe some prose just about the basic concepts can be enough.

    Test script:
    ---------------


    Expected result:
    ----------------


    Actual result:
    --------------

    ------------------------------------------------------------------------
  • Ifeghali at Feb 15, 2009 at 1:41 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=15891&edit=1

    ID: 15891
    Updated by: ifeghali@php.net
    Reported By: ifeghali at php dot net
    Summary: End User Docs
    Status: Assigned
    Type: Documentation Problem
    Package: System_Daemon
    PHP Version: 5.2.8
    Assigned To: kvz
    Roadmap Versions:
    New Comment:

    Yeh we have a repository for package specific documentation here:

    http://cvs.php.net/viewvc.cgi/peardoc/en/package/

    Not sure whether its just fine to keep the docs outside of PEAR
    infra-structure though. I recall some thread discouraging outside docs
    some time ago but as far as I remember it was just a suggestion. I
    believe you can keep it this way. If you want to be sure you should ask
    at pear-qa@.


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

    [2009-02-15 12:29:32] kvz

    I wonder, do I need to strip layout & place that external document
    somewhere else as well?

    I would rather not because of duplication (it will be a drag to keep
    multiple places up to date) & the ability for users to place comments as
    it is.

    Let me know

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

    [2009-02-15 12:23:13] kvz

    <div id="changeset">
    <span class="removed">-Assigned To:</span>
    <span class="added">+Assigned To: kvz</span>
    </div>

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

    [2009-02-12 01:58:46] doconnor

    As a temporary fix, I just added
    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/ to
    the external documentation link of the package.

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

    [2009-02-11 16:49:13] ifeghali

    By the way I just found your blog:

    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/

    That definitely would be a great addition to PEAR docs :)

    Please let me know if you need help "porting" it to here.

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

    [2009-02-11 16:39:55] ifeghali

    Description:
    ------------
    It would be super to have some end user docs. The examples at
    "docs/examples" are not clear enough on basic program usage for the
    newbie user. Some important points are unclear, like what all those
    die()s are doing along the code, how to correctly loops your code etc.

    For instance, in "logparser.php" one's code (line 107) is outside the
    loop (line 120). so how is that supposed to work ? newbie users to
    parallel programming and threads might not get the idea behind the
    package without proper end user documentation.

    Maybe some prose just about the basic concepts can be enough.

    Test script:
    ---------------


    Expected result:
    ----------------


    Actual result:
    --------------

    ------------------------------------------------------------------------
  • Kevin at Feb 20, 2009 at 4:57 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=15891&edit=1

    ID: 15891
    Updated by: kevin@vanzonneveld.net
    Reported By: ifeghali at php dot net
    Summary: End User Docs
    Status: Assigned
    Type: Documentation Problem
    Package: System_Daemon
    PHP Version: 5.2.8
    Assigned To: kvz
    Roadmap Versions:
    New Comment:

    So I've asked pear-qa and they really do like to have that document as
    a part of peardoc.

    It will probably need some attention, but the basis is here:
    http://cvs.php.net/viewvc.cgi/peardoc/en/package/system/system-daemon/

    I will further perfect it (with the help of cweiske) and close this bug
    if that's allright with you.


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

    [2009-02-15 13:41:06] ifeghali

    Yeh we have a repository for package specific documentation here:

    http://cvs.php.net/viewvc.cgi/peardoc/en/package/

    Not sure whether its just fine to keep the docs outside of PEAR
    infra-structure though. I recall some thread discouraging outside docs
    some time ago but as far as I remember it was just a suggestion. I
    believe you can keep it this way. If you want to be sure you should ask
    at pear-qa@.

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

    [2009-02-15 12:29:32] kvz

    I wonder, do I need to strip layout & place that external document
    somewhere else as well?

    I would rather not because of duplication (it will be a drag to keep
    multiple places up to date) & the ability for users to place comments as
    it is.

    Let me know

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

    [2009-02-15 12:23:13] kvz

    <div id="changeset">
    <span class="removed">-Assigned To:</span>
    <span class="added">+Assigned To: kvz</span>
    </div>

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

    [2009-02-12 01:58:46] doconnor

    As a temporary fix, I just added
    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/ to
    the external documentation link of the package.

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

    [2009-02-11 16:49:13] ifeghali

    By the way I just found your blog:

    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/

    That definitely would be a great addition to PEAR docs :)

    Please let me know if you need help "porting" it to here.

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

    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://pear.php.net/bugs/bug.php?id=15891
  • Kevin at Feb 20, 2009 at 4:58 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=15891&edit=1

    ID: 15891
    Updated by: kevin@vanzonneveld.net
    Reported By: ifeghali at php dot net
    Summary: End User Docs
    -Status: Assigned
    +Status: Closed
    Type: Documentation Problem
    Package: System_Daemon
    PHP Version: 5.2.8
    Assigned To: kvz
    Roadmap Versions:
    New Comment:

    <div id="changeset">
    <span class="removed">-Status: Assigned</span>
    <span class="added">+Status: Closed</span>
    </div>
    This bug has been fixed in CVS.

    If this was a documentation problem, the fix will appear on
    pear.php.net by the end of next Sunday (CET).

    If this was a problem with the pear.php.net website, the change should
    be live shortly.

    Otherwise, the fix will appear in the package's next release.

    Thank you for the report and for helping us make PEAR better.




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

    [2009-02-20 16:57:49] kvz

    So I've asked pear-qa and they really do like to have that document as
    a part of peardoc.

    It will probably need some attention, but the basis is here:
    http://cvs.php.net/viewvc.cgi/peardoc/en/package/system/system-daemon/

    I will further perfect it (with the help of cweiske) and close this bug
    if that's allright with you.

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

    [2009-02-15 13:41:06] ifeghali

    Yeh we have a repository for package specific documentation here:

    http://cvs.php.net/viewvc.cgi/peardoc/en/package/

    Not sure whether its just fine to keep the docs outside of PEAR
    infra-structure though. I recall some thread discouraging outside docs
    some time ago but as far as I remember it was just a suggestion. I
    believe you can keep it this way. If you want to be sure you should ask
    at pear-qa@.

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

    [2009-02-15 12:29:32] kvz

    I wonder, do I need to strip layout & place that external document
    somewhere else as well?

    I would rather not because of duplication (it will be a drag to keep
    multiple places up to date) & the ability for users to place comments as
    it is.

    Let me know

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

    [2009-02-15 12:23:13] kvz

    <div id="changeset">
    <span class="removed">-Assigned To:</span>
    <span class="added">+Assigned To: kvz</span>
    </div>

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

    [2009-02-12 01:58:46] doconnor

    As a temporary fix, I just added
    http://kevin.vanzonneveld.net/techblog/article/create_daemons_in_php/ to
    the external documentation link of the package.

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

    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://pear.php.net/bugs/bug.php?id=15891

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
grouppear-bugs @
categoriesphp
postedFeb 15, '09 at 12:23p
activeFeb 20, '09 at 4:58p
posts5
users2
websitepear.php.net

2 users in discussion

Kevin: 4 posts Ifeghali: 1 post

People

Translate

site design / logo © 2022 Grokbase