On Sun, Mar 14, 2010 at 02:21, Philip Olson <phi...@roshambo.org> wrote: > Hello everyone, > > Let's talk about pman (PHP man pages) and eventually post their existence > online here: > > - http://php.net/download-docs.php
We could run doc.php.net as a PEAR channel and add the XX[2].php.net as "mirrors". That way people can still fetch it from their "nearest mirror" and 'pear upgrade' whenever they want. I've never configured a pear mirror, so we would need help from the PEAR guys. The other option is just to make it downloadable like the other formats, but then the user will have to 'install it manually', which could be relatively painful - and will not be able to update the manual via pear. > A few questions: > > 1. Where should detailed 'how to install pman' be documented? Probably > within the PHP manual itself. The "Extended CHM" install instructions are in phpweb, not phpdoc. I'm game with either way, but we need to have it consistent. > 2. Can people install it without PEAR? How? Download, extract, move 'pman' into $PATH and modify the script to point to correct folder. I can't say I recommend that procedure though. Making it possible to track updates and remove it via pear is very handy. > 3. How exactly do we manage releases for the pman channel? Currently its just "whenever we remember to do it". I would like to add it to the weekly docbuilder cron on the rsync box, but that could get relatively annoying to download it all weekly. We could have it exclusively on doc.php.net (then we dont need any mirrors or rsync), and just add a monthly cron to update it? -Hannes
