Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
On Sun, 21 Mar 2010, Hannes Magnusson wrote: > Do note that I added the phd_php package as a requirement in the > comments in build.sh ah, quite right. but why not just enhance the build.sh script to make it bulletproof, along the lines of: = #!/bin/sh # svn co http://svn.php.net/repository/phpdoc/modules/doc-en # pear install doc.php.net/phd # pear install doc.php.net/phd_php # cd doc-en pear info doc.php.net/PhD > /dev/null 2>&1 if [ $? > 0 ] ; then echo "You need to install the PEAR package PhD first, exiting." exit fi pear info doc.php.net/PhD_PHP > /dev/null 2>&1 if [ $? > 0 ] ; then echo "You need to install the PEAR package PhD_PHP first, exiting." exit fi ... etc etc ... = rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
On Sun, Mar 21, 2010 at 16:23, Robert P. J. Day wrote: > On Sun, 21 Mar 2010, Hannes Magnusson wrote: > >> On Sun, Mar 21, 2010 at 14:27, Robert P. J. Day >> wrote: >> > >> > a short report on the latest attempt to checkout and build the >> > manual from SVN. checkout worked fine, i installed phd, then ran >> > build.sh, several lines of what looked like reasonable output, then: >> >> svn up and try again, there were couple of bugs in that script :] >> See http://svn.php.net/viewvc?view=revision&revision=296477 > > just FYI: > > $ pear remote-list -c doc.php.net > Channel doc.php.net Available packages: > === > Package Version > PhD 1.0.0 > PhD_Generic 1.0.0 > PhD_PHP 1.0.0 > PhD_PEAR 1.0.0 > PhD_GeSHi 1.0.0 > PhD_GeSHi11x 1.0.0 > PhD_IDE -n/a- $ pear list-all -c doc.php.net is more useful as it prints your installed packages too Do note that I added the phd_php package as a requirement in the comments in build.sh -Hannes
Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
On Sun, 21 Mar 2010, Hannes Magnusson wrote: > On Sun, Mar 21, 2010 at 14:27, Robert P. J. Day wrote: > > > > a short report on the latest attempt to checkout and build the > > manual from SVN. checkout worked fine, i installed phd, then ran > > build.sh, several lines of what looked like reasonable output, then: > > svn up and try again, there were couple of bugs in that script :] > See http://svn.php.net/viewvc?view=revision&revision=296477 just FYI: $ pear remote-list -c doc.php.net Channel doc.php.net Available packages: === Package Version PhD 1.0.0 PhD_Generic 1.0.0 PhD_PHP 1.0.0 PhD_PEAR 1.0.0 PhD_GeSHi1.0.0 PhD_GeSHi11x 1.0.0 PhD_IDE -n/a- $ rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
On Sun, 21 Mar 2010, Hannes Magnusson wrote: > On Sun, Mar 21, 2010 at 14:27, Robert P. J. Day wrote: > > > > a short report on the latest attempt to checkout and build the > > manual from SVN. checkout worked fine, i installed phd, then ran > > build.sh, several lines of what looked like reasonable output, then: > > svn up and try again, there were couple of bugs in that script :] > See http://svn.php.net/viewvc?view=revision&revision=296477 just "svn up"ed, at rev 296477, same error: [11:17:36 - E_USER_ERROR ] /usr/share/pear/phpdotnet/phd/BuildOptionsParser.php:134 Invalid Package [rpj...@localhost phpdoc-en]$ Couldn't get a file descriptor referring to the console this is on a reasonably up-to-date version of fedora 12. rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
On Sun, Mar 21, 2010 at 14:27, Robert P. J. Day wrote: > > a short report on the latest attempt to checkout and build the > manual from SVN. checkout worked fine, i installed phd, then ran > build.sh, several lines of what looked like reasonable output, then: svn up and try again, there were couple of bugs in that script :] See http://svn.php.net/viewvc?view=revision&revision=296477 -Hannes
Re: [PHP-DOC] random observations on online PHP manual
On Sat, 20 Mar 2010, Philip Olson wrote: > On Mar 20, 2010, at 8:00 AM, Robert P. J. Day wrote: > > * very early on, i might be tempted to have a short section > > explaining how readers can examine the current state of PHP on > > their system, mostly from the command line. when i was starting > > out, i was thrilled to discover "php -m". a short page walking > > readers through something like: > > > > $ php --help > > $ php -v > > $ php -m > > $ php -i > > > > and so on would probably not hurt, and it's something they could > > do with no further background, just to verify that they have a > > working and properly-configured PHP setup. > > Sounds useful, and the command line part was restructured recently > so sections like this can be easily found (and pointed to) without > getting lost. > > - http://php.net/manual/features.commandline > > So early on, this can be referenced. It's difficult to know where a > tutorial should go but we lean towards having them within their > specific topics, as opposed to being lumped together in the "Getting > Started" tutorial. Although there really aren't many tutorials > currently, eventually a tutorial index feels useful. i wasn't suggesting reproducing the entire command-line section. i was more thinking along the lines of something early in the installation section, maybe a very first section, "how can you tell if you have PHP installed already?" if people are truly beginners, they may not even *know* if PHP is on their system. so a simple sequence of commands they can run, with a rationale for them, such as: $ type php# is it here and where is it? $ php -v # what version is it? $ php -m # what modules are loaded? $ php -h # get general help not only would this get a new reader at least typing a few commands, but you can recommend that if they *do* need to install, they can re-use this list as a sanity check to verify the install went well. you might also mention that when they eventually ask for help, people will ask them these very questions, "what version are you running? what modules are loaded?" rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
[PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error
a short report on the latest attempt to checkout and build the manual from SVN. checkout worked fine, i installed phd, then ran build.sh, several lines of what looked like reasonable output, then: [09:25:09 - E_USER_ERROR ] /usr/share/pear/phpdotnet/phd/BuildOptionsParser.php:134 Invalid Package $ Couldn't get a file descriptor referring to the console am i just missing a required package? if so, that should be mentioned in the comments section of the build.sh script. or did i just do something dumb? rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
Re: [PHP-DOC] random observations on online PHP manual
On Sat, 20 Mar 2010, Philip Olson wrote: > On Mar 20, 2010, at 8:00 AM, Robert P. J. Day wrote: > > "... extends the feature set adding SimpleXML and XMLReader support." > > > > - is there a reason to mention XMLReader but not XMLWriter? (what > >*is* the state of XML support in PHP these days? must keep > >reading.) > > That section is a bit outdated and easily forgotten. Please file a > bug report about this being outdated. http://bugs.php.net/bug.php?id=51343 is that the proper format? rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday
[PHP-DOC] Notes Status, 23262 total
Following are the top 20 pages of the manual, sorted by the number of user notes contributed. These sections could use a polish, those notes represent 6.7% of the 23262 total user notes. Notes | Page ---+- 100 | http://php.net/manual/en/function.date.php 93 | http://php.net/manual/en/function.curl-setopt.php 85 | http://php.net/manual/en/function.session-start.php 85 | http://php.net/manual/en/function.strtotime.php 82 | http://php.net/manual/en/function.array-merge.php 80 | http://php.net/manual/en/features.http-auth.php 80 | http://php.net/manual/en/function.serialize.php 79 | http://php.net/manual/en/function.number-format.php 78 | http://php.net/manual/en/function.array-search.php 77 | http://php.net/manual/en/function.mail.php 74 | http://php.net/manual/en/function.array-unique.php 74 | http://php.net/manual/en/install.windows.php 73 | http://php.net/manual/en/features.file-upload.php 73 | http://php.net/manual/en/function.xml-parse-into-struct.php 73 | http://php.net/manual/en/function.session-set-save-handler.php 72 | http://php.net/manual/en/features.commandline.php 72 | http://php.net/manual/en/function.fsockopen.php 72 | http://php.net/manual/en/function.substr.php 71 | http://php.net/manual/en/function.exec.php 71 | http://php.net/manual/en/language.oop5.patterns.php