[Nut-upsdev] building NUT on Mac OS X Yosemite (website/documentation)

[Charles Lepple]

On Nov 23, 2014, at 3:19 PM, Jean Perriault (GM TAF) <jpweb.taf at gmail.com> wrote:

> After a fresh ‘nut' (version 2.7.2.5) clone on Yosemite,

The version number is simply a placeholder, indicating that the Git tree has changes beyond v2.7.2, and is not yet released as v2.7.3. After we start making changes, you may want to use "git describe --tags" or the Git commit ID.

[...]
> >>>>>> Then make command looks ok, until:
> 
> Making all in docs
> Making all in man
> /opt/local/bin/a2x --doctype manpage --format manpage --attribute mansource="Network UPS Tools" --attribute manversion="2.7.2.5" --attribute manmanual="NUT Manual" --destination-dir=. nut.conf.txt
> a2x: WARNING: --destination-dir option is only applicable to HTML based outputs
> 
> >>>>>> At this stage, the process is kind of hanging, it takes 1 hour to generate the man pages.

If you have internet access while building, your a2x/Docbook toolchain might still be trying to download additional components (and it is probably not caching them between runs). The OS X Buildbot slave sets "ASCIIDOC_VERBOSE=-v" in the environment to print out the exact commands being invoked (although this only seems to work for the HTML documentation, rather than the man pages).

Also, a2x accepts an XSLTPROC_OPTS environment variable that you can set to "--nonet". I suppose we could add that to the makefiles.

> Regarding 'nut-website’, after fresh clone on Yosemite:
> 
> >>>>>> ./autogen.sh automatically clone nut and nut-dll in nut-website.
> >>>>>> can I use my own clones here?

Should be possible. Again, I appreciate the effort here, but for a basic OS X build of NUT, we don't need to build nut-website (yet).

> >>>>>> then make command. I have this one dozen of times:
> 
> sort: stray character in field spec: invalid field specification `4.1,4.5rV
> 
> >>>>>> and it ends with:
> 
> /opt/local/bin/asciidoc --backend=xhtml11 --conf-file=./web-layout.conf --attribute icons --attribute linkcss --attribute=badges --attribute=website --attribute=quirks --attribute=revision=2.7.2 --attribute tree_version=2.7 --attribute localdate=`TZ=UTC date +%Y-%m-%d` --attribute localtime=`TZ=UTC date +%H:%M:%S` --attribute=date="`TZ=UTC date`" --attribute iconsdir=./images --attribute scriptsdir=./scripts -o projects.html -a toc projects.txt
> make: *** No rule to make target `-eindex.html', needed by `ups-html.txt'.  Stop.

I see that on OS X as well.

Jean, I CC'd Dan, who wrote the build rules for nut-website. Dan, what I would like to do is split some of the sort pipelines up into intermediate files so we can debug this better - I tried using gsort on my local copy, and it did not work the same as the last time I tried it.

-- 
Charles Lepple
clepple at gmail



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alioth.debian.org/pipermail/nut-upsdev/attachments/20141124/b1708105/attachment.html>