comments on build 12 of CHM

"Grant, John A" <[email protected]>
Newsgroups gmane.comp.php.documentation.windows
Message-ID <[email protected]>
I just downloaded build 12 of the CHM edition of the manual. For reference,
these are the files:
    2002-12-26  20:14             1,729 context.ini
    2003-09-06  18:20             3,653 mirrors.ini
    2002-12-26  20:14             4,150 php_manual.ico
    2003-09-06  18:21         3,586,244 php_manual_en.chm
    2003-09-06  18:22         4,324,534 php_manual_notes.chm
    2002-08-30  12:15            57,344 php_manual_prefs.exe
    2003-09-06  18:25               536 php_manual_prefs.js
    2002-12-26  20:14             1,282 php_quickref.hta

1. Most of the time I see ">>" in the documentation for external links, but
on the opening page, I see "&raquo" (see below).
 
2. I also note that the first 2 chapters are both called "PHP Manual". The
first is the screen you see below, but the second is actually "Table of
Contents" when you click on it.
 
3. I'm not sure I see the need for "copy to clipboard" links for 2 reasons:
(a) You can easily select what you want and hit "ctrl-C". What is the point
of duplicating elements of the system-provided interface? If you're going to
do that, why not also provide "print this page" in the body of the text?
Where do you stop?
 
(b) It's not clear just what is being copied to the clipboard - the whole
page or just one section or just the examples. I know it's the example code
- I'm trying to make a point about the ambiguity of the "copy to clipboard"
link. Perhaps it should say "copy this example code to the clipboard". But
that's unnecessarily verbose.
 
John A. Grant
Ottawa
 <http://news.com.com/2100-1023-946952.html?tag=nl>
http://news.com.com/2100-1023-946952.html?tag=nl
"34 percent of interoffice e-mail is useless"
 

Example 3.8. A simple HTML form


PHP Manual


Stig Sæther Bakken


Alexander Aulbach


Egon Schmid


Jim Winstead


Lars Torben Wilson


Rasmus Lerdorf


Andrei Zmievski


Jouni Ahto


Edited by


Stig Sæther Bakken


Egon Schmid


Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 the PHP Documentation
Group

Copyright

Copyright © 1997 - 2003 by the PHP Documentation Group. This material may be
distributed only subject to the terms and conditions set forth in the Open
Publication License, v1.0 or later (the latest version is presently
available at  <http://www.opencontent.org/openpub/> &raquo;
http://www.opencontent.org/openpub/). 

Distribution of substantively modified versions of this document is
prohibited without the explicit permission of the copyright holder. 

Distribution of the work or derivative of the work in any standard (paper)
book form is prohibited unless prior permission is obtained from the
copyright holder. 

The members of the PHP Documentation Group are listed on the front page of
this manual. In case you would like to contact the group, please write to
<mailto:[email protected]> &raquo; [email protected]. 

The 'Extending PHP 4.0' section of this manual is copyright © 2000 by Zend
Technologies, Ltd. This material may be distributed only subject to the
terms and conditions set forth in the Open Publication License, v1.0 or
later (the latest version is presently available at
<http://www.opencontent.org/openpub/> &raquo;
http://www.opencontent.org/openpub/). 

2003-09-06
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.