On Mar 14, 2010, at 7:33 AM, Hannes Magnusson wrote: > 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.
I don't think we need a mirror system and am thinking download-docs could simply mention that pman exists, then link to its information. I doubt it'll receive enough traffic to justify the complexities of a mirror system so how about we wait and see? >> 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. Good point, although the 'Extended CHM' page no longer exists. Let's think about this further because adding this to the appendix is an option but our appendix has grown out of control... but that's another topic. >> 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. We'll recommend 'pear' but it'll be good to at least have an option for non-pear users. Let's add this to the upcoming docs, along with how to build and install with PhD. >> 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? I think the 'doc.php.net only' option is reasonable, but I'm unsure how best to automate the pear channel and package information updates with each new version. Thoughts? Regards, Philip
