Re: Re: weekly doc builds

On Mon, Sep 1, 2014 at 3:08 PM, Chris Wright <daverandom@php.net> wrote: > On 1 September 2014 14:52, Richard Quadling <rquadling@gmail.com> wrote: >> >> >> >> On 29 August 2014 17:34, Ferenc Kovacs <tyra3l@gmail.com> wrote: >>> >>> >>> 2014.08.29. 18:23 ezt írta ("Peter Cowburn" <petercowburn@gmail.com>): >>> >>> >>> > >>> > >>> > >>> > >>> > On 29 August 2014 17:11, Hannes Magnusson <hannes.magnusson@gmail.com> >>> > wrote: >>> >> >>> >> On Fri, Aug 29, 2014 at 9:05 AM, Ferenc Kovacs <tyra3l@gmail.com> >>> >> wrote: >>> >> > Hi, >>> >> > >>> >> > yesterday I had to rebuild the docs on rsync.php.net so we got some >>> >> > php >>> >> > 5.6.0 related doc fixed out sooner than the weekly build today, and >>> >> > I'm just >>> >> > wondering if there is still a reason to only rebuild the >>> >> > documentation on >>> >> > once a week. >>> >> > a successful build seems to take about 40 minutes, and we currently >>> >> > have 11 >>> >> > active languages, so the full rebuild (when all langs can be built >>> >> > successfuly, yesterday we had 6 broken lang, pt_BR, zh, de, it, ru, >>> >> > tr) >>> >> > takes about 7.3 hours. >>> >> > >>> >> > and here comes my question: is there any reason why should we just >>> >> > rebuild >>> >> > the docs every day? >>> >> > http://docs.php.net/ seems to be able to >>> >> > handle that just fine for >>> >> > years >>> >> > now. >>> >> >>> >> >>> >> >>> >> The rsync server isn't exactly state-of-the-art, also pushing out gb >>> >> of updates every day will amplify the bandwidth issue it already has.. >>> > >>> > >>> > Wasn't there also a plan to move the actual building of the docs off of >>> > the rsync box? We could stick it on a nice, beefy docs build server.... >>> > assuming there's such a machine just lying around doing nothing. >>> >>> Good idea, we could even use the result of the build from the docs.php.net >>> server, that would even end up saving time and processing power. >> >> >> Considering we also need a Windows machine to build the CHMs, is it worth >> (and I truly feel your collective shivers) that the Doc building box be >> windows? That way, only 1 box to build all the doxs? > > I say this knowing very little of the subject matter but... is there > really no way to build the CHMs on *nix? I'd be happy to look into > this if it's simply a case of someone putting the time in to make it > work. No, you can do it on linux too. Christian Weiske did that for pear at some point. We just don't want that toolchain to contaminate the rest of the system. > > Looking round the net I can find a few unofficial but comprehensive > documents detailing the file format. Is there a blocker to this other > than simply not having a tool for the job at present? hhc.exe works just fine, no need to spend time on a new tool for it. This thread took a unexpected turn, as if people are under the impression we are dropping CHM or Windows boxes. That is not the case. The Windows box at OmniTI was however decommissioned a while ago as they no longer had space for it. Yoshinari Takaoka mumumu@ took over the job and has a server building the CHMs regularly since and they are then published on the rsync box just like we always have. -Hannes