From auerswal at unix-ag.uni-kl.de  Sun Oct  9 12:17:11 2011
From: auerswal at unix-ag.uni-kl.de (Erik Auerswald)
Date: Sun, 09 Oct 2011 20:17:11 +0200
Subject: [Nas] Malformed man pages
In-Reply-To: <20111009175047.GC1042@einval.com>
References: <20111009175047.GC1042@einval.com>
Message-ID: <4E91E527.60801@unix-ag.uni-kl.de>

Hi,

On 10/09/2011 07:50 PM, Steve McIntyre wrote:
> I've had a weird bug reported (http://bugs.debian.org/639543) against
> nas in Debian. Looking at the details, it's clearly caused by cpp
> processing of the manual pages.
>
> In a build where I have already installed the libaudio-dev package,
> then cpp finds audio/audiolib.h and includes its contents in the man
> page output.

I could not reproduce this with debian/unstable and an up-to-date svn 
checkout.

> If not, then the #include in the man page fails and
> (using older cpp versions) is simply excluded from the man page output
> or (using newer cpp) the man page is truncated at that point.

I could not reproduce this (using debian/unstable) with my svn checkout. 
The man page of AuStartFlow (example from the bug report) was build just 
fine.

> Is anybody else seeing this problem? I've tried tweaking settings in
> the nas build so that imake etc. won't preprocess the man pages, but
> to no avail thus far...

I use make distclean && xmkmf && make World to build NAS, just as the 
docs say.

Erik


From jon at radscan.com  Sun Oct  9 12:45:58 2011
From: jon at radscan.com (Jon Trulson)
Date: Sun, 9 Oct 2011 12:45:58 -0600 (MDT)
Subject: [Nas] Malformed man pages
In-Reply-To: <4E91E527.60801@unix-ag.uni-kl.de>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
Message-ID: <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>

On Sun, 9 Oct 2011, Erik Auerswald wrote:

> Hi,
>
> On 10/09/2011 07:50 PM, Steve McIntyre wrote:
>> I've had a weird bug reported (http://bugs.debian.org/639543) against
>> nas in Debian. Looking at the details, it's clearly caused by cpp
>> processing of the manual pages.
>> 
>> In a build where I have already installed the libaudio-dev package,
>> then cpp finds audio/audiolib.h and includes its contents in the man
>> page output.
>
> I could not reproduce this with debian/unstable and an up-to-date svn 
> checkout.
>

I did not see this either on an up to date kubuntu 11.04 system.

[...]
>> Is anybody else seeing this problem? I've tried tweaking settings in
>> the nas build so that imake etc. won't preprocess the man pages, but
>> to no avail thus far...
>
> I use make distclean && xmkmf && make World to build NAS, just as the docs 
> say.
>

Same here.

-- 
Jon Trulson

Q:  How many IBM CPU's does it take to do a logical right shift?
A:  33.  1 to hold the bits and 32 to push the register.


From jon at radscan.com  Sun Oct  9 11:09:06 2011
From: jon at radscan.com (Jon Trulson)
Date: Sun, 9 Oct 2011 11:09:06 -0600 (MDT)
Subject: [nas] Mailing list switching to GNU Mailman
Message-ID: <Pine.LNX.4.64.1110091108420.28688@nomad.radscan.com>


This is just to inform you that I am switching this mailing list to GNU
Mailman rather than continue fighting with the obsolete and no longer
maintained Majordomo software we've been using.  Plus, I have a fast new
mailserver :)

Toward that end, you will be recieving an email from GNU Mailman welcoming
you to the list and providing information you can use to modify your
subscription information.

As of yet, there does not appear to be a way to 'port' mailing list
achives into mailman, so those will probably be kept at their current
locations.  Mailman has it's own archiving system that you can access from
the list's homepage (which will be sent in your welcome message).

Thanks, and good luck. :)



From steve at einval.com  Wed Oct 12 16:15:27 2011
From: steve at einval.com (Steve McIntyre)
Date: Wed, 12 Oct 2011 23:15:27 +0100
Subject: [Nas] Malformed man pages
In-Reply-To: <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
Message-ID: <20111012221527.GE1042@einval.com>

On Sun, Oct 09, 2011 at 12:45:58PM -0600, Jon Trulson wrote:
>On Sun, 9 Oct 2011, Erik Auerswald wrote:
>
>>Hi,
>>
>>On 10/09/2011 07:50 PM, Steve McIntyre wrote:
>>>I've had a weird bug reported (http://bugs.debian.org/639543) against
>>>nas in Debian. Looking at the details, it's clearly caused by cpp
>>>processing of the manual pages.
>>>
>>>In a build where I have already installed the libaudio-dev package,
>>>then cpp finds audio/audiolib.h and includes its contents in the man
>>>page output.
>>
>>I could not reproduce this with debian/unstable and an up-to-date
>>svn checkout.
>
>I did not see this either on an up to date kubuntu 11.04 system.
>
>[...]
>>>Is anybody else seeing this problem? I've tried tweaking settings in
>>>the nas build so that imake etc. won't preprocess the man pages, but
>>>to no avail thus far...
>>
>>I use make distclean && xmkmf && make World to build NAS, just as
>>the docs say.
>
>Same here.

I've just done exactly that and looked again. Looking right at the end
of the build process, I'm seeing:

========================================================================
.....
if test -z "true" ; then \
           cd `dirname SoWrFile` && \
           ln -s `basename SoWrFile.man` `basename SoWrFile._man`; \
        else \
                     cpp -undef -traditional  -D__apploaddir__=/etc/X11/app-defaults -D__filemansuffix__=5x -D__osfilemansuffix__=5 -D__libmansuffix__=3x -D__oslibmansuffix__=3 -D__mansuffix__=1x -D__osmansuffix__=1 -D__syscallmansuffix__=2x -D__ossysmansuffix__=2 -D__gamemansuffix__=6x -D__osgamemansuffix__=6 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__admmansuffix__=8x -D__osadmmansuffix__=8 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__drivermansuffix__=4x -D__osdrivermansuffix__=4 -D__adminmansuffix__=8 -D__projectroot__=/usr -D__xconfigfile__=xorg.conf -D__xconfigdir__=/usr/lib/X11 -D__xlogfile__=Xorg -D__xservername__=Xorg -D__appmansuffix__=1x -D__xorgversion__="\"`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'`\" \"X Version 11\"" -D__vendorversion__="`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'` X.Org"  \
             < SoWrFile.man | sed -e '/^#  *[0-9][0-9]*  *.*$/d'                        -e '/^#line  *[0-9][0-9]*  *.*$/d'                        -e '/^[         ]*XCOMM$/s/XCOMM/#/'                    -e '/^[         ]*XCOMM[^a-zA-Z0-9_]/s/XCOMM/#/'                  -e '/^[         ]*XHASH/s/XHASH/#/'                     -e '/\@\@$/s/\@\@$/\\/' >SoWrFile._man; \
        fi
<stdin>:30:0: fatal error: audio/audiolib.h: No such file or directory
compilation terminated.
rm -f Sound._man
if test -z "true" ; then \
           cd `dirname Sound` && \
           ln -s `basename Sound.man` `basename Sound._man`; \
        else \
                     cpp -undef -traditional  -D__apploaddir__=/etc/X11/app-defaults -D__filemansuffix__=5x -D__osfilemansuffix__=5 -D__libmansuffix__=3x -D__oslibmansuffix__=3 -D__mansuffix__=1x -D__osmansuffix__=1 -D__syscallmansuffix__=2x -D__ossysmansuffix__=2 -D__gamemansuffix__=6x -D__osgamemansuffix__=6 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__admmansuffix__=8x -D__osadmmansuffix__=8 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__drivermansuffix__=4x -D__osdrivermansuffix__=4 -D__adminmansuffix__=8 -D__projectroot__=/usr -D__xconfigfile__=xorg.conf -D__xconfigdir__=/usr/lib/X11 -D__xlogfile__=Xorg -D__xservername__=Xorg -D__appmansuffix__=1x -D__xorgversion__="\"`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'`\" \"X Version 11\"" -D__vendorversion__="`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'` X.Org"  \
             < Sound.man | sed -e '/^#  *[0-9][0-9]*  *.*$/d'                   -e '/^#line  *[0-9][0-9]*  *.*$/d'                        -e '/^[         ]*XCOMM$/s/XCOMM/#/'                    -e '/^[         ]*XCOMM[^a-zA-Z0-9_]/s/XCOMM/#/'                  -e '/^[         ]*XHASH/s/XHASH/#/'                     -e '/\@\@$/s/\@\@$/\\/' >Sound._man; \
        fi
<stdin>:30:0: fatal error: audio/audiolib.h: No such file or directory
compilation terminated.
make[4]: Leaving directory `/home/steve/debian/nas/upstream/trunk/doc/man/lib'
rm -f nas._man
if test -z "true" ; then \
           cd `dirname nas` && \
           ln -s `basename nas.man` `basename nas._man`; \
        else \
                     cpp -undef -traditional  -D__apploaddir__=/etc/X11/app-defaults -D__filemansuffix__=5x -D__osfilemansuffix__=5 -D__libmansuffix__=3x -D__oslibmansuffix__=3 -D__mansuffix__=1x -D__osmansuffix__=1 -D__syscallmansuffix__=2x -D__ossysmansuffix__=2 -D__gamemansuffix__=6x -D__osgamemansuffix__=6 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__admmansuffix__=8x -D__osadmmansuffix__=8 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__drivermansuffix__=4x -D__osdrivermansuffix__=4 -D__adminmansuffix__=8 -D__projectroot__=/usr -D__xconfigfile__=xorg.conf -D__xconfigdir__=/usr/lib/X11 -D__xlogfile__=Xorg -D__xservername__=Xorg -D__appmansuffix__=1x -D__xorgversion__="\"`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'`\" \"X Version 11\"" -D__vendorversion__="`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'` X.Org"  \
             < nas.man | sed -e '/^#  *[0-9][0-9]*  *.*$/d'                
========================================================================

Looking through the Makefiles, the 'test -z "true"' is coming from lines like

   if test -z "$(PREPROCESSMANPAGES)" ; then

so the files *._man are being created by pre-processing the man
pages. Unfortunately, later on if I run "make install.man" I can see
that those *._man files are what's installed into place:

$ make install.man DESTDIR=/tmp/nas
...
install -c -m 0444 SoOpFFRd._man /tmp/nas/usr/share/man/man3/SoundOpenFileForReading.3x
mv -f tmp.man SoOpFFRd.man
install -c -m 0444 SoOpFFWr._man /tmp/nas/usr/share/man/man3/SoundOpenFileForWriting.3x
mv -f tmp.man SoOpFFWr.man
...

Checking those files, I can see the truncated / broken man pages I
mentioned. Does nobody else see this at all?

-- 
Steve McIntyre, Cambridge, UK.                                steve at einval.com
  Armed with "Valor": "Centurion" represents quality of Discipline,
  Honor, Integrity and Loyalty. Now you don't have to be a Caesar to
  concord the digital world while feeling safe and proud.


From jon at radscan.com  Wed Oct 12 19:00:00 2011
From: jon at radscan.com (Jon Trulson)
Date: Wed, 12 Oct 2011 19:00:00 -0600 (MDT)
Subject: [Nas] Malformed man pages
In-Reply-To: <20111012221527.GE1042@einval.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
 <20111012221527.GE1042@einval.com>
Message-ID: <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>

On Wed, 12 Oct 2011, Steve McIntyre wrote:

> On Sun, Oct 09, 2011 at 12:45:58PM -0600, Jon Trulson wrote:
>> On Sun, 9 Oct 2011, Erik Auerswald wrote:
>>
>>> Hi,
>>>
>>> On 10/09/2011 07:50 PM, Steve McIntyre wrote:
>>>> I've had a weird bug reported (http://bugs.debian.org/639543) against
>
> I've just done exactly that and looked again. Looking right at the end
> of the build process, I'm seeing:
>
> ========================================================================
> .....
> if test -z "true" ; then \
>           cd `dirname SoWrFile` && \
>           ln -s `basename SoWrFile.man` `basename SoWrFile._man`; \
>        else \
>                     cpp -undef -traditional
>-D__apploaddir__=/etc/X11/app-def
[...]

I think you are right Steve something is wrong here.  I do not see you
symptoms, but I see other oddities.  For reference, I will include a
snippet that I see:

=============
if test -z "true" ; then \
            cd `dirname Sound` && \
            ln -s `basename Sound.man` `basename Sound._man`; \
         else \
                      cpp -undef -traditional  -D__apploaddir__=/etc/X11/app-defaults -D__filemansuffix__=5x -D__osfilemansuffix__=5 -D__libmansuffix__=3x -D__oslibmansuffix__=3 -D__mansuffix__=1x -D__osmansuffix__=1 -D__syscallmansuffix__=2x -D__ossysmansuffix__=2 -D__gamemansuffix__=6x -D__osgamemansuffix__=6 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__admmansuffix__=8x -D__osadmmansuffix__=8 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__drivermansuffix__=4x -D__osdrivermansuffix__=4 -D__adminmansuffix__=8 -D__projectroot__=/usr -D__xconfigfile__=xorg.conf -D__xconfigdir__=/usr/lib/X11 -D__xlogfile__=Xorg -D__xservername__=Xorg -D__appmansuffix__=1x -D__xorgversion__="\"`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'`\" \"X Version 11\"" -D__vendorversion__="`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'` X.Org"  \
              < Sound.man | sed -e '/^#  *[0-9][0-9]*  *.*$/d'                   -e '/^#line  *[0-9][0-9]*  *.*$/d'                        -e '/^[         ]*XCOMM$/s/XCOMM/#/'     -e '/^[  ]*XCOMM[^a-zA-Z0-9_]/s/XCOMM/#/'                        -e '/^[         ]*XHASH/s/XHASH/#/'                       -e '/\@\@$/s/\@\@$/\\/' >Sound._man; \
         fi
make[4]: Leaving directory `/home/jon/src/nas/doc/man/lib'
rm -f nas._man
if test -z "true" ; then \
            cd `dirname nas` && \
            ln -s `basename nas.man` `basename nas._man`; \
         else \
                      cpp -undef -traditional  -D__apploaddir__=/etc/X11/app-defaults -D__filemansuffix__=5x -D__osfilemansuffix__=5 -D__libmansuffix__=3x -D__oslibmansuffix__=3 -D__mansuffix__=1x -D__osmansuffix__=1 -D__syscallmansuffix__=2x -D__ossysmansuffix__=2 -D__gamemansuffix__=6x -D__osgamemansuffix__=6 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__admmansuffix__=8x -D__osadmmansuffix__=8 -D__miscmansuffix__=7x -D__osmiscmansuffix__=7 -D__drivermansuffix__=4x -D__osdrivermansuffix__=4 -D__adminmansuffix__=8 -D__projectroot__=/usr -D__xconfigfile__=xorg.conf -D__xconfigdir__=/usr/lib/X11 -D__xlogfile__=Xorg -D__xservername__=Xorg -D__appmansuffix__=1x -D__xorgversion__="\"`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'`\" \"X Version 11\"" -D__vendorversion__="`echo 7 6 0 | sed -e 's/ /./g' -e 's/^/Version\\\ /'` X.Org"  \
              < nas.man | sed -e '/^#  *[0-9][0-9]*  *.*$/d'                     -e '/^#line  *[0-9][0-9]*  *.*$/d'                        -e '/^[         ]*XCOMM$/s/XCOMM/#/'     -e '/^[  ]*XCOMM[^a-zA-Z0-9_]/s/XCOMM/#/'                        -e '/^[         ]*XHASH/s/XHASH/#/'                       -e '/\@\@$/s/\@\@$/\\/' >nas._man; \
         fi

=============

An indeed, looking at doc/man/lib/AuStFlow._man shows the included
header file (i have the dev bits installed of course).

A 'man AuStartFlow' (after a 'make install.man' shows just this:

===============
AuStartFlow(3)                                                           AuStartFlow(3)



Name
        AuStartFlow - start a flow.

Synopsis
audioutil                                 1.2                            AuStartFlow(3)

===============

And that's it.

So, yes, sonething is screwed up.  This is a new machine, so I will
try it on an older one to compare.  To be honest, I am not quite sure
why we bother running the man pages through the preprocessor anyway.
It's not like the API changes depending on what kind of system you
build for.

Also, during the make install.man, I see this:

....
install -c -m 0444 SoRwFile._man /usr/share/man/man3/SoundRewindFile.3x
mv -f tmp.man SoRwFile.man
install -c -m 0444 SoSkFile._man /usr/share/man/man3/SoundSeekFile.3x
mv -f tmp.man SoSkFile.man
install -c -m 0444 SoStrTFF._man /usr/share/man/man3/SoundStringToFileFormat.3x
mv -f tmp.man SoStrTFF.man
install -c -m 0444 SoTlFile._man /usr/share/man/man3/SoundTellFile.3x
mv -f tmp.man SoTlFile.man
install -c -m 0444 SoWrFile._man /usr/share/man/man3/SoundWriteFile.3x
mv -f tmp.man SoWrFile.man
install -c -m 0444 Sound._man /usr/share/man/man3/Sound.3x
mv -f tmp.man Sound.man
.....

WTF is going on there? Specifically with these 'mv -f tmp.man
Sound.man' commands?  So, some investigation is needed.  Might not get
to it this week, maybe the weekend, if you'd like me to take a look at
it.  Imake makes my eyes bleed. :)


>
> Looking through the Makefiles, the 'test -z "true"' is coming from lines like
>
>   if test -z "$(PREPROCESSMANPAGES)" ; then
>
> so the files *._man are being created by pre-processing the man
> pages. Unfortunately, later on if I run "make install.man" I can see
> that those *._man files are what's installed into place:

   Yep.  Perhaps some new xorg Imake changes?  I'm on an up to date
   kubuntu 11.04 on x86_64.

[...]
>
> Checking those files, I can see the truncated / broken man pages I
> mentioned. Does nobody else see this at all?
>
>

I do now.  Anyone else?

-- 
Jon Trulson

Q:  How many IBM CPU's does it take to do a logical right shift?
A:  33.  1 to hold the bits and 32 to push the register.

From jon at radscan.com  Wed Oct 12 19:27:49 2011
From: jon at radscan.com (Jon Trulson)
Date: Wed, 12 Oct 2011 19:27:49 -0600 (MDT)
Subject: [Nas] Malformed man pages
In-Reply-To: <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
 <20111012221527.GE1042@einval.com>
 <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>
Message-ID: <alpine.DEB.2.02.1110121917070.5801@l5.radscan.com>

On Wed, 12 Oct 2011, Jon Trulson wrote:

> On Wed, 12 Oct 2011, Steve McIntyre wrote:
>
>> On Sun, Oct 09, 2011 at 12:45:58PM -0600, Jon Trulson wrote:
>>> On Sun, 9 Oct 2011, Erik Auerswald wrote:
>>> 
>>>> Hi,
>>>> 
>>>> On 10/09/2011 07:50 PM, Steve McIntyre wrote:
>>>>> I've had a weird bug reported (http://bugs.debian.org/639543) against
>> 
>> I've just done exactly that and looked again. Looking right at the end
>> of the build process, I'm seeing:
>> 
>> ========================================================================
>> .....
>> if test -z "true" ; then \
>>           cd `dirname SoWrFile` && \
>>           ln -s `basename SoWrFile.man` `basename SoWrFile._man`; \
>>        else \
>>                     cpp -undef -traditional
>> -D__apploaddir__=/etc/X11/app-def
> [...]
>
> I think you are right Steve something is wrong here.  I do not see you
> symptoms, but I see other oddities.  For reference, I will include a
> snippet that I see:
>

Ok, so I didn't want to wait for the weekend :)  Two issues (at least
for me):

1. man pages being preprocessed.  Not sure when this changed, but it
seems xorg's imake rules do this by default on linux now.  Lazy
programmers, sigh.  Attached is a patch for nas that should make them
stop.  Please try it.

2.  After I made this change, the man pages were generated properly
again.  However, I also had the kubuntu nas-devel package installed,
which supplies gzip compressed (and broken) man pages.  I removed this
package.  Then after building nas:

man install
then 
make install.man

'man AuStartFlow' and friends look correct again.

And to be sure, I then rebuilt nas again from scratch with the
installed dev bits I'd just compiled and installed.  Man pages seem
fine still.  Yay.

Let me know what you find.

-- 
Jon Trulson

Q:  How many IBM CPU's does it take to do a logical right shift?
A:  33.  1 to hold the bits and 32 to push the register.
-------------- next part --------------
Index: config/NetAudio.tmpl
===================================================================
--- config/NetAudio.tmpl	(revision 281)
+++ config/NetAudio.tmpl	(working copy)
@@ -53,6 +53,10 @@
 /* CDEBUGFLAGS=/Zi */
 #endif /* WIN32 */
 
+/* Some recent xorg breakage? We do not need to preprocess man pages. */
+#undef DontPreprocessManPages
+#define DontPreprocessManPages YES
+
 /*
  * Older X11 systems used to define SharedLibX and friends if the
  * installed X11 system was built with shared libs.   Newer X11's use

From steve at einval.com  Thu Oct 13 11:01:15 2011
From: steve at einval.com (Steve McIntyre)
Date: Thu, 13 Oct 2011 18:01:15 +0100
Subject: [Nas] Malformed man pages
In-Reply-To: <alpine.DEB.2.02.1110121917070.5801@l5.radscan.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
 <20111012221527.GE1042@einval.com>
 <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>
 <alpine.DEB.2.02.1110121917070.5801@l5.radscan.com>
Message-ID: <20111013170115.GD26544@einval.com>

On Wed, Oct 12, 2011 at 07:27:49PM -0600, Jon Trulson wrote:
>On Wed, 12 Oct 2011, Jon Trulson wrote:
>>On Wed, 12 Oct 2011, Steve McIntyre wrote:
>>>
>>>I've just done exactly that and looked again. Looking right at the end
>>>of the build process, I'm seeing:
>>>
>>>========================================================================
>>>.....
>>>if test -z "true" ; then \
>>>          cd `dirname SoWrFile` && \
>>>          ln -s `basename SoWrFile.man` `basename SoWrFile._man`; \
>>>       else \
>>>                    cpp -undef -traditional
>>>-D__apploaddir__=/etc/X11/app-def
>>[...]
>>
>>I think you are right Steve something is wrong here.  I do not see you
>>symptoms, but I see other oddities.  For reference, I will include a
>>snippet that I see:
>
>Ok, so I didn't want to wait for the weekend :)  Two issues (at least
>for me):
>
>1. man pages being preprocessed.  Not sure when this changed, but it
>seems xorg's imake rules do this by default on linux now.  Lazy
>programmers, sigh.  Attached is a patch for nas that should make them
>stop.  Please try it.

Yup, that fixes the problem for me.

>2.  After I made this change, the man pages were generated properly
>again.  However, I also had the kubuntu nas-devel package installed,
>which supplies gzip compressed (and broken) man pages.  I removed this
>package.  Then after building nas:

nas-devel, or libaudio-dev? I'd expect the ubuntu/kubuntu packages to
follow the Debian packages I maintain...

>man install
>then make install.man
>
>'man AuStartFlow' and friends look correct again.
>
>And to be sure, I then rebuilt nas again from scratch with the
>installed dev bits I'd just compiled and installed.  Man pages seem
>fine still.  Yay.
>
>Let me know what you find.

Yup, looks good now. I've just committed it into svn and I'll be
uploading a new Debian package shortly.

-- 
Steve McIntyre, Cambridge, UK.                                steve at einval.com
"The problem with defending the purity of the English language is that
 English is about as pure as a cribhouse whore. We don't just borrow words; on
 occasion, English has pursued other languages down alleyways to beat them
 unconscious and rifle their pockets for new vocabulary."  -- James D. Nicoll


From jon at radscan.com  Thu Oct 13 11:26:34 2011
From: jon at radscan.com (Jon Trulson)
Date: Thu, 13 Oct 2011 11:26:34 -0600 (MDT)
Subject: [Nas] Malformed man pages
In-Reply-To: <20111013170115.GD26544@einval.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
 <20111012221527.GE1042@einval.com>
 <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>
 <alpine.DEB.2.02.1110121917070.5801@l5.radscan.com>
 <20111013170115.GD26544@einval.com>
Message-ID: <alpine.DEB.2.02.1110131125100.8121@l5.radscan.com>

On Thu, 13 Oct 2011, Steve McIntyre wrote:

[...]
>
> nas-devel, or libaudio-dev? I'd expect the ubuntu/kubuntu packages to
> follow the Debian packages I maintain...
>

libaudio-dev of course ) Sorry.

[...]

>> Let me know what you find.
>
> Yup, looks good now. I've just committed it into svn and I'll be
> uploading a new Debian package shortly.

Ok.  Thanks!

-- 
Jon Trulson

Q:  How many IBM CPU's does it take to do a logical right shift?
A:  33.  1 to hold the bits and 32 to push the register.

From steve at einval.com  Thu Oct 13 16:11:05 2011
From: steve at einval.com (Steve McIntyre)
Date: Thu, 13 Oct 2011 23:11:05 +0100
Subject: [Nas] Malformed man pages
In-Reply-To: <alpine.DEB.2.02.1110131125100.8121@l5.radscan.com>
References: <20111009175047.GC1042@einval.com>
 <4E91E527.60801@unix-ag.uni-kl.de>
 <alpine.DEB.2.02.1110091244430.29622@l5.radscan.com>
 <20111012221527.GE1042@einval.com>
 <alpine.DEB.2.02.1110121847060.5801@l5.radscan.com>
 <alpine.DEB.2.02.1110121917070.5801@l5.radscan.com>
 <20111013170115.GD26544@einval.com>
 <alpine.DEB.2.02.1110131125100.8121@l5.radscan.com>
Message-ID: <20111013221105.GG1042@einval.com>

On Thu, Oct 13, 2011 at 11:26:34AM -0600, Jon Trulson wrote:
>On Thu, 13 Oct 2011, Steve McIntyre wrote:
>
>[...]
>>
>>nas-devel, or libaudio-dev? I'd expect the ubuntu/kubuntu packages to
>>follow the Debian packages I maintain...
>>
>
>libaudio-dev of course ) Sorry.
>
>[...]
>
>>>Let me know what you find.
>>
>>Yup, looks good now. I've just committed it into svn and I'll be
>>uploading a new Debian package shortly.
>
>Ok.  Thanks!

And apologies, totally forgot to credit you for the fix on the
checkin... :-(

-- 
Steve McIntyre, Cambridge, UK.                                steve at einval.com
< sladen> I actually stayed in a hotel and arrived to find a post-it
          note stuck to the mini-bar saying "Paul: This fridge and
          fittings are the correct way around and do not need altering"


