From eb2281089ea2ad1381d17c0613c2a1ff867ac859 Mon Sep 17 00:00:00 2001 From: Jan Lehnardt Date: Sat, 24 Nov 2001 17:24:06 +0000 Subject: [PATCH] clearification, grammar, spelling and information improvement added note about using grep and the windows search system for offline searching. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@63164 c90b9560-bf6c-de11-be94-00142212c4b1 --- appendices/about.xml | 44 +++++++++++++++++++++++++------------------- 1 file changed, 25 insertions(+), 19 deletions(-) diff --git a/appendices/about.xml b/appendices/about.xml index 7a38a60532..ae6078edf9 100644 --- a/appendices/about.xml +++ b/appendices/about.xml @@ -1,5 +1,5 @@ - + More about this Manual @@ -33,7 +33,7 @@ from many different formats we provide. What you choose depends on your operating system, and your personal reading style. If you are interested, how we can generate - these many formats, read on the technical part of this + these various formats, read on the technical part of this appendix named How we generate the formats. @@ -46,15 +46,17 @@ or text version is not ideal for day to day work, although full text search is easy in such files. Note, that the compressed file with several HTML - files contain more than 2000 files. Using - that you face the lack of offline search, but - you gain the fast access to information anytime. + files contain more than 2000 files. You can serach in + these files using your OS search capabilities such as the + global search dialog on Windows or grep on unix like + systems. Since it is not very comfortable using these tools, + avail yourself of the online search as often as needed. PDF is also a popular cross platform format. This is the best for printing, although we do not - recommend printing out the manual in a whole, as - it can take so much reqources. As the manual + recommend printing out the manual on the whole, as + it can take so much resources. As the manual changes from day to day, think twice before you print out the whole manual. Viewing PDF, you have the full text search ability. Note, that @@ -77,13 +79,15 @@ At last, but not least, we have a Windows HTML Help version of the PHP Manual. It is actually a spiced up HTML package. The biggest - advantage of HTML Help (also known as CHM) - is that the viewer provides full text search, - search in search results, full index, and - bookmarking. This format also kindly integrates - with many popular PHP IDEs on Windows. + advantage of the Compiled HTML (also known as + CHM) version is that the viewer + provides full text search, search in search results, + full index, and bookmarking. This format also kindly + integrates with many popular PHP IDEs on Windows. The biggest disadvantage is that it is only - available on Windows operating systems. + available on Windows operating systems. You also + need the MS Internet Explorer 4.0 or newer to access the + CHM version, if you are on an older Windows system @@ -121,15 +125,15 @@ &url.php.books;. We do not recommend you to buy a reprint of the PHP Manual, because these are commonly quite outdated. - Consider, that the PHP manual is changing from day + Consider that the PHP manual is changing from day to day. - If you think someone already faced the exact problem, + If you think someone already faced the exact problem and you are stuggling, you can ask your questions on one of our popular mailing lists. There are plenty of them grouped by subject. You may receive an answer - for your question in minutes in the busyest hours. + for your question in minutes in the busiest hours. You can subscribe to one mailing list at &url.php.support;. You can also find IRC channels linked on this @@ -146,17 +150,19 @@ How to help improve the documentation Of course you can help to improve our documentation. - There are basically to ways of doing this. + There are basically two ways of doing this. - If you find any errors in this manual, in any language, + If you find any errors within this manual, in any language, please report them using the bug system at: &url.php.bugs;. Classify the bug as "Documentation Problem". This way we can follow every bug and track the things done to eliminate them from the documentation. You can also submit format problems (eg. PHP Manual PDF displayed - incorrectly). + incorrectly). Please don't abuse the bug system by submitting + requests for help, use the mailing lists or community sites + mentioned above, instead. By adding annotations to pages, you can provide more