Req #51678 [Csd]: Bring xCHM download back for historical purpose

From: Date: Sun, 08 May 2011 09:59:13 +0000
Subject: Req #51678 [Csd]: Bring xCHM download back for historical purpose
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-6363@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 Updated by: rquadling@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 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. Previous Comments: ------------------------------------------------------------------------ [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 ------------------------------------------------------------------------ [2010-04-28 10:50:31] techtonik@php.net Let me disagree with you. I think it deserves to be placed at least at http://museum.php.net/ ------------------------------------------------------------------------ [2010-04-28 10:00:59] bjori@php.net It contains severely outdated information and does us more harm then good. If you really really want it, then you'll need to look into some archives, but we cannot and will not advocate using several years old documentations. ------------------------------------------------------------------------ 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

« previous php.doc.bugs (#6363) next »