Nut upsdev - Nov 2014 - building NUT on Mac OS X Yosemite (website/documentation)

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,
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
@JeanPerriault could you please test the above snippet? (apply using 'patch
-p0 < /path/to/patch', from within the 'nut' (not -website)
top-level source directory
@clepple btw, where / how do you exactly get this error?

@clepple
@aquette when building the nut-website repository on OS X. At the moment, it
does not show up in Buildbot because we are only building nut-website on Debian.
I would rather that we not apply that patch to the repository, since it just
masks the problem.

@JeanPerriault
ok make done; I think I will redo everything from scratch to see if libraries
updates or @aquette fix did fix

regards,
jean
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.alioth.debian.org/pipermail/nut-upsdev/attachments/20141120/a74f1b36/attachment.html>

On Nov 20, 2014, at 7:11 AM, Jean Perriault (GM TAF) <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
> 
> @JeanPerriault
> I've found msort on macports
(https://trac.macports.org/browser/trunk/dports/textproc/msort/Portfile,
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

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/20141120/641f0286/attachment.html>

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>