[Nut-upsdev] building NUT on Mac OS X Yosemite (website/documentation)
clepple at gmail.com
Mon Nov 24 13:59:58 UTC 2014
On Nov 23, 2014, at 3:19 PM, Jean Perriault (GM TAF) <jpweb.taf at gmail.com> wrote:
> After a fresh ‘nut' (version 188.8.131.52) 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="184.108.40.206" --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.
clepple at gmail
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Nut-upsdev