[PHP-DOC] A thought or two on the early part of the PHP manual.

2010-05-02 Thread Robert P. J. Day
a note i made to myself a while back when first going thru the online PHP manual, so i thought i'd put it out there and let others ignore it at their leisure. i find the order of the two early sections -- "getting started" and "installation and configuration" -- a bit backwards since th

Re: [PHP-DOC] "Hello world" in PHP

2010-04-30 Thread Robert P. J. Day
Quoting "Robert P. J. Day" : Quoting Daniel Brown : On Fri, Apr 30, 2010 at 10:47, Robert P. J. Day wrote:  first part was cut and paste error, argh.  and, yes, i embarrassed myself as i was ssh'ed into the wrong test box which didn't even have the PHP package

Re: [PHP-DOC] "Hello world" in PHP

2010-04-30 Thread Robert P. J. Day
Quoting Daniel Brown : On Fri, Apr 30, 2010 at 10:47, Robert P. J. Day wrote:  first part was cut and paste error, argh.  and, yes, i embarrassed myself as i was ssh'ed into the wrong test box which didn't even have the PHP package installed.  and that, people, is the danger o

Re: [PHP-DOC] "Hello world" in PHP

2010-04-30 Thread Robert P. J. Day
Quoting Philip Olson : On Apr 30, 2010, at 7:35 AM, Robert P. J. Day wrote: probably about to embarrass myself but i'm looking at the PHP manual page "Your first PHP-enabled page", which suggests this as an initial PHP program: PHP Test Hello World'; ?>

[PHP-DOC] "Hello world" in PHP

2010-04-30 Thread Robert P. J. Day
probably about to embarrass myself but i'm looking at the PHP manual page "Your first PHP-enabled page", which suggests this as an initial PHP program: PHP Test Hello World'; ?> but if i enter, then browse to that page, i get as browser output: = hi world '; ?> =

Re: [PHP-DOC] User commentary in docs

2010-04-06 Thread Robert P. J. Day
comment should not suggest that they *must* comment. and, more importantly, they should try to comment on the appropriate page so that their comment makes sense. rday -- ================ Robert P. J. Day Waterloo

Re: [PHP-DOC] User commentary in docs

2010-04-06 Thread Robert P. J. Day
garbage, and incorporate the reasonable comments into the documentation proper. just leaving the comments there in perpetuity is, IMHO, a terrible idea. rday -- ================ Robert P. J. Day Waterloo, Ontar

Re: [PHP-DOC] What to do with PHP 6

2010-03-31 Thread Robert P. J. Day
towards (d) for most cases. Thoughts? call it "PHP NG", with a huge early disclaimer that you're not sure what the number will be. rday -- Robert P. J. Day Waterloo, Ont

[PHP-DOC] install page for openbsd could use some updating

2010-03-22 Thread Robert P. J. Day
age devoted to PHP 5: http://www.openbsd.org/4.4_packages/powerpc/php5-core-5.2.6.tgz-contents.html rday -- ================ Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and K

Re: [PHP-DOC] random observations on online PHP manual

2010-03-22 Thread Robert P. J. Day
On Mon, 22 Mar 2010, Christopher Jones wrote: > On 03/22/2010 04:42 AM, Robert P. J. Day wrote: > > >and regarding installation, i would *strongly* encourage > > readers to install from packages if they can, leaving downloading > > and building the source as a last

Re: [PHP-DOC] random observations on online PHP manual

2010-03-22 Thread Robert P. J. Day
On Mon, 22 Mar 2010, Richard Quadling wrote: > On 21 March 2010 14:15, Robert P. J. Day wrote: > >  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 ve

Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error

2010-03-21 Thread Robert P. J. Day
t/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

Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error

2010-03-21 Thread Robert P. J. Day
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, severa

Re: [PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error

2010-03-21 Thread Robert P. J. Day
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, severa

Re: [PHP-DOC] random observations on online PHP manual

2010-03-21 Thread Robert P. J. Day
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.

[PHP-DOC] building svn checkout of manual: "BuildOptionsParser.php" error

2010-03-21 Thread Robert P. J. Day
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

2010-03-21 Thread Robert P. J. Day
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*

Re: [PHP-DOC] random observations on online PHP manual

2010-03-20 Thread Robert P. J. Day
On Sat, 20 Mar 2010, Philip Olson wrote: > On Mar 20, 2010, at 8:00 AM, Robert P. J. Day wrote: > > * not sure if this is covered further into the manual than i've > > read so far, but i learned quickly that on some versions of linux > > (in my case, fedora), a *l

Re: [PHP-DOC] random observations on online PHP manual

2010-03-20 Thread Robert P. J. Day
first short reply before i must dash for a bit ... On Sat, 20 Mar 2010, Philip Olson wrote: > On Mar 20, 2010, at 8:00 AM, Robert P. J. Day wrote: > > it's not clear what version of PHP the online manual refers to. > > i would *guess* that it's the output of a fairl

Re: [PHP-DOC] svn co and build of PHP manual could be clearer

2010-03-20 Thread Robert P. J. Day
On Sat, 20 Mar 2010, Philip Olson wrote: > > On Mar 20, 2010, at 9:04 AM, Robert P. J. Day wrote: > > > On Sat, 20 Mar 2010, Philip Olson wrote: > > > >> The trouble with only downloading en/ (due to the incorrect svn > >> checkout reference), you'

Re: [PHP-DOC] svn co and build of PHP manual could be clearer

2010-03-20 Thread Robert P. J. Day
ild the docs from the checkout. rday -- ============ Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter:

Re: [PHP-DOC] random observations on online PHP manual

2010-03-20 Thread Robert P. J. Day
On Sat, 20 Mar 2010, Robert P. J. Day wrote: > - it might be worth telling the reader about "php --ini" here, and > perhaps other ini-related php CLI options. i found the above > comment really useful early on. bah ... i meant the above "comman

[PHP-DOC] random observations on online PHP manual

2010-03-20 Thread Robert P. J. Day
hat they have a working and properly-configured PHP setup. * http://www.php.net/manual/en/configuration.file.php - it might be worth telling the reader about "php --ini" here, and perhaps other ini-related php CLI options. i found the above comment really useful early on.

[PHP-DOC] svn co and build of PHP manual could be clearer

2010-03-20 Thread Robert P. J. Day
tions for how to simply generate the manual HTML? rday -- ================ Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse

[PHP-DOC] Re: [PEAR-DOC] DocBook tags: versus

2010-02-25 Thread Robert P. J. Day
i just need to know the proper recipe for submitting them here. if there's a web page that explains that, all i need is the link. thanks. rday -- ==== Robert P. J. Day Waterloo,