Req #51678 [Com]: Bring xCHM download back for historical purpose
| From: | techtonik@php.net | Date: | Sun, 08 May 2011 12:31:01 +0000 |
| Subject: | Req #51678 [Com]: Bring xCHM download back for historical purpose | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-6365@lists.php.net to get a copy of this message | ||
Edit report at http://bugs.php.net/bug.php?id=51678&edit=1
ID: 51678
Comment by: techtonik@php.net
Reported by: techtonik@php.net
Summary: Bring xCHM download back for historical purpose
Status: Closed
Type: Feature/Change Request
Package: Documentation problem
PHP Version: Irrelevant
Assigned To: rquadling
Block user comment: N
Private report: N
New Comment:
I believe xCHM manual significantly contributed to making PHP4 popular
on Windows.
Yes, it got heavy and outdated with time, and it is no more actual
nowadays. I
spend a lot of time trying to resurrect it, and for me it would be nice
to have it
zipped online for the history.
Previous Comments:
------------------------------------------------------------------------
[2011-05-08 14:16:46] techtonik@php.net
> As for including it in the museum, I'd be very worried about
including
> it due to the very outdated information contained in it.
Lol. What kind of information do you expect in museum? =)
------------------------------------------------------------------------
[2011-05-08 11:59:12] rquadling@php.net
I don't think it was CHM size limitations, but the download size issues
(though
broadband is certainly more prevalent now). The underlying technology
hasn't
changed and the user notes only increases the CHM file size by 230%. As
for
including it in the museum, I'd be very worried about including it due
to the very
outdated information contained in it. Also, the mechanism used for
styling removed
any found search results. It wasn't ideal and I was unable to find a
solution to
preserve the found/highlighted search terms as well as allowing the
custom
styling. So, flawed and outdated. Not an ideal candidate for the museum.
------------------------------------------------------------------------
[2011-05-07 02:55:00] techtonik@php.net
I'd still place it into museum for PHP4. CSS styling was awesome. IIRC
comments
were split, because of CHM size limitations.
------------------------------------------------------------------------
[2011-05-07 00:16:45] rquadling@php.net
The new enhanced chm format includes the user notes, like the old
"extended" chm
file. It does not include ability for the
end user to create alternative "skins" for the CHM file.
It was also a lot easier to simply incorporate the user notes into the
main body
of the HTML than to have 2 separate CHM
files (manual and notes) and then to use JavaScript to merge the content
like
the old extended CHM files.
As it stands, there is nothing else to be done new enhanced format with
regard
to the user notes.
When the new PHP website re-styling is complete, the finalised styling
will be
incorporated into the CHM files. This is
all ready to go. If you are in a position to build your own CHM files,
then you
take a look at
http://svn.php.net/viewvc/phpdoc/doc-base/trunk/scripts/build-chms.php?
revision=310810&view=markup#l187 to see how to
include the current styling into the CHM files.
------------------------------------------------------------------------
[2011-05-06 21:44:21] bjori@php.net
Seems like Richard took the trouble and re-implemented the extended CHM
into PhD.
We are having some trouble with copying it over to the rsync box so it
can be
synced to the mirrors though.. Looking into it at
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/bug.php?id=51678
--
Edit this bug report at http://bugs.php.net/bug.php?id=51678&edit=1