Anatoly,

But having all the documentation linkable in a single CHM, not
necessarily by default, would be of benefit to non-newbies though.

I accept that the indexing issues within MS's CHM is pretty poor. Maybe
it is worth taking a serious look at using a PHP +GTK app? Not the best
idea, maybe.

I think though, when the livedocs system goes live, it should include
ALL PHP documentation (PHP, PEAR, PECL, Zend) and allow the option to
have it ALL searched. Rather than have all these different manuals.

 

-----Original Message-----
From: anatoly techtonik [mailto:[EMAIL PROTECTED] 
Sent: 08 June 2005 18:42
To: Gabor Hojtsy
Cc: Richard A. Quadling; [EMAIL PROTECTED]; [email protected]
Subject: Re: [PHP-DOC] Re: [PHP-DOC-CHM] Getting PEAR documentation into
the PHP Extended CHM Manual.

||*()*|| Hi, Gabor.

>> Are there any plans to provide a means for people downloading the XML

>> sources via CVS to be able to build a COMPLETE PHP Manual?
>>
>> By complete, I mean, PHP, PEAR, ZendAPI, etc, the whole lot. All 
>> documentation associated with PHP.
>>
>> I understand that most users would only want the PHP part, though, I 
>> think the PEAR documentation should be included also.
>>
>> Currently, I can ...
>>
>> ./configure --with-chm=yes --with-source=./../php-src 
>> --with-pecl-source=./../pecl --with-pear-source=./../pear>> 
>> ../conf.log
>>
>> The PEAR source doesn't seem to produce any output.
>>
>> The PECL documentation produces a single section with 4 subsections 
>> (HTML parser extension, EXIF tag access library, MDB data file access

>> library and UUID extension). The level of documentation here is
brief.

GH> CHM building uses interesting tricks, but it is still a good 
GH> question, whether we can make it possible to build a complete 
GH> PEAR+PHP manual. Could someone from the peardoc front comment on
this?

PEAR manual already renders in CHM and it takes about 2.4Mb additional
load. ZendAPI is not included in xCHM, but present in standart CHM
version. I guess it is possible to link these CHM's together, but I
doubt somebody will benefit from this if Index and Search capabilities
merge. PEAR index can greatly confuse users who learn PHP. Search
results make it even worse producing informational garbage gathered from
all three files rather than displaying only relevant info. I don't know
a way to limit search scope and it seems to me, that having three
separate manuals is the best solution.


t
-- 

Reply via email to