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

Sun Nov 23 20:19:47 UTC 2014

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

Configuration summary:
======================
build serial drivers: yes 
build USB drivers: yes 
build SNMP drivers: yes 
build neon based XML driver: yes 
enable Avahi support: no 
build Powerman PDU client driver: no
build IPMI driver: no
build Mac OS X meta-driver: yes
build i2c based drivers: no
enable SSL support: yes (OpenSSL)
enable libwrap (tcp-wrappers) support: no
enable libltdl (Libtool dlopen abstraction) support: no
build nut-scanner: no
build CGI programs: no
build and install documentation: no
build and install the development files: no

>>>>>> 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.

>>>>>> then make command ends correctly without issues.

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?

Configuration summary:
======================
build serial drivers: yes
build USB drivers: yes
build SNMP drivers: yes
build neon based XML driver: yes
enable Avahi support: no
build Powerman PDU client driver: no
build IPMI driver: no
build Mac OS X meta-driver: yes
build i2c based drivers: no
enable SSL support: yes (OpenSSL)
enable libwrap (tcp-wrappers) support: no
enable libltdl (Libtool dlopen abstraction) support: no
build nut-scanner: no
build CGI programs: no
build and install documentation: no
build and install the development files: no

>>>>>> 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 apply aquette patch in 'nut-website/nut/configure.ac’, then apply 'make' command
>>>>>> no more 'sort: stray character in field spec: invalid field specification `4.1,4.5rV’ error... is it because I need to clean something?
>>>>>> then it is taking long..minutes (near an hour right now) generating man page:

/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=. ivtscd.txt
a2x: WARNING: --destination-dir option is only applicable to HTML based outputs

regards,
jean

> Le 20 nov. 2014 à 15:10, Charles Lepple <clepple at gmail.com> a écrit :
> 
> On Nov 20, 2014, at 7:11 AM, Jean Perriault (GM TAF) <jpweb.taf at gmail.com <mailto:jpweb.taf at gmail.com>> wrote:
> 
>> Hello,
>> Here is a summary of discussions around NUT builds on Mac OS X 10.10.
>> 
>> Starting from https://github.com/networkupstools/nut-website/issues/7 <https://github.com/networkupstools/nut-website/issues/7>
>> 
>> @JeanPerriault
>> I've found msort on macports (https://trac.macports.org/browser/trunk/dports/textproc/msort/Portfile <https://trac.macports.org/browser/trunk/dports/textproc/msort/Portfile>, http://billposer.org/Software/Downloads/ <http://billposer.org/Software/Downloads/>
>> msort.pdf), but I'm not sure where to implement it, should I replace all sort ocurrences I find in code?
>> 
>> @clepple
>> I think checking for gsort in the configure script would be better (since that is what is used when 'sort' is invoked on Linux), and then sort would get replaced with @GSORT@ or whatever. However, when I mentioned via email that the website doesn't build on OS X, I wasn't thinking that it needed to be solved soon - we can build the website and documentation on Linux systems for now.
>> 
>> @aquette
>> considering the context and limited impact, we could simply check for gsort first, and then sort.
>> --- a/configure.ac
>> +++ b/configure.ac
>> @@ -101,6 +101,7 @@ AC_PROG_CXX
>> AC_PROG_INSTALL
>> AC_PROG_EGREP
>> AC_PATH_PROG(AR, ar)
>> +AC_CHECK_PROGS(SORT, gsort sort)
>> AC_CHECK_TOOL(RANLIB, ranlib, :)
>> dnl Postpone call to AC_PROG_LIBTOOL to allow disabling static lib
>> AC_C_BIGENDIAN
> 
> Just to clarify, the sort error is only when building nut-website:
> 
> 	sort: stray character in field spec: invalid field specification `4.1,4.5rV'
> 
> Also, you had mentioned dependencies for building documentation. This affects NUT non-website builds as well, but the list looks something like this:
> 
> 	• asciidoc
> 	• asciidoc-a2x (if packaged separately)
> 	• docbook-xsl (symptom for Debian bug #635347; xsltproc will otherwise try to download DocBook files from the net)
> 	• dblatex
> 
> We are trying to reduce the dependencies needed to build the .tar.gz snapshots, so you might want to try one of them:
> 
> http://buildbot.networkupstools.org/snapshots <http://buildbot.networkupstools.org/snapshots>
> 
> The snapshots include some HTML rendered versions of the documentation. (I think we are missing the PDF files.) They are generated from Git commits to branches in the main GitHub repository. If you have a branch you want to test, let us know and we can push it over.
> 
> -- 
> Charles Lepple
> clepple at gmail

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