Re: comments on build 12 of CHM

Gabor Hojtsy <[email protected]>
Newsgroups gmane.comp.php.documentation.windows
Message-ID <[email protected]>
Hi Grant!

> 1. Most of the time I see ">>" in the documentation for external links, but
> on the opening page, I see "&raquo" (see below).

Yes, this is a known issue... Since it is not critical, a new release 
was not made...

> 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.

The first two are identically named, since we had some problem with 
getting the name of the table of contents section if I can remember 
correctly. This might be a bit different in the next edition to be more 
user friendly.

> 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.

Since the "copy to clipboard" links are all above the examples, it seems 
to be clear to me (as well as many others) that their task is to copy 
the contents of examples to the clipboard. We have introduced this 
feature for user request, since selecting the needed example, and 
pressing "ctrl-c" takes more time, then clicking on that link...

Goba

-- 
PHP CHM Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
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.