xsrc/44414: Misformatted X manpages

[rhialto%falu.nl@localhost]

>Number:         44414
>Category:       xsrc
>Synopsis:       Misformatted X manpages
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    xsrc-manager
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jan 19 01:05:00 +0000 2011
>Originator:     Rhialto
>Release:        NetBSD 5.99.39
>Organization:
        
>Environment:
        
        
System: NetBSD vargaz.falu.nl 5.99.39 NetBSD 5.99.39 (VARGAZ) #3: Sat Oct 2 
01:26:45 CEST 2010 
rhialto%radl.falu.nl@localhost:/scratch2/obj.amd64/sys/arch/amd64/compile/VARGAZ
 amd64
Architecture: x86_64
Machine: amd64
        it is really a 5.1 userland with a newer kernel
>Description:
        Several X manpages are misformatted. It appears like not all
        preprocessors for the nroff source have been used, such as tbl(1).
        
>How-To-Repeat:
        $ man XCreateGC
        ...
        STRUCTURES
            The XGCValues structure contains:

            /* GC attribute value mask bits */

            lw(.5i) lw(2.5i) lw(.75i).  T{ #define T}   T{ GCFunction T}   T{
            (1L<<0) T} T{ #define T}   T{ GCPlaneMask T}   T{ (1L<<1) T} T{ 
#define
            T}   T{ GCForeground T}   T{ (1L<<2) T} T{ #define T}   T{ 
GCBackground
            T}   T{ (1L<<3) T} T{ #define T}   T{ GCLineWidth T}   T{ (1L<<4) 
T} T{
            #define T}   T{ GCLineStyle T}   T{ (1L<<5) T} T{ #define T}   T{
            GCCapStyle T}   T{ (1L<<6) T} T{ #define T}   T{ GCJoinStyle T}   T{
            (1L<<7) T} T{ #define T}   T{ GCFillStyle T}   T{ (1L<<8) T} T{ 
#define
            T}   T{ GCFillRule T}   T{ (1L<<9) T} T{ #define T}   T{ GCTile T}  
 T{
            (1L<<10) T} T{ #define T}   T{ GCStipple T}   T{ (1L<<11) T} T{ 
#define
            T}   T{ GCTileStipXOrigin T}   T{ (1L<<12) T} T{ #define T}   T{
            GCTileStipYOrigin T}   T{ (1L<<13) T} T{ #define T}   T{ GCFont T}  
 T{
            (1L<<14) T} T{ #define T}   T{ GCSubwindowMode T}   T{ (1L<<15) T} 
T{
    
        By grepping for 'T{', it seems at least these X manpages are affected:

        /usr/X11R7/man/cat3/XAllocSizeHints.0
        /usr/X11R7/man/cat3/XAllocStandardColormap.0
        /usr/X11R7/man/cat3/XAllocWMHints.0
        /usr/X11R7/man/cat3/XChangeKeyboardControl.0
        /usr/X11R7/man/cat3/XConfigureWindow.0
        /usr/X11R7/man/cat3/XCreateGC.0
        /usr/X11R7/man/cat3/XCreateWindow.0
        /usr/X11R7/man/cat3/XGetVisualInfo.0
        /usr/X11R7/man/cat3/XGetWindowAttributes.0
        /usr/X11R7/man/cat3/XmbLookupString.0
        /usr/X11R7/man/cat3/XmbTextListToTextProperty.0
        /usr/X11R7/man/cat3/XrmEnumerateDatabase.0

>Fix:
        Workaround:

        $ tbl /usr/X11R7/man/man3/XCreateGC.3 | nroff -mandoc | more

        this still seems to give dodgy output in the table of CG functions 
though:

                -----------------------------------------------
                Function Name     Value   Operation
                -----------------------------------------------



                ()                                                              
         
            ()



-Olaf.
-- 
___ Olaf 'Rhialto' Seibert  -- There's no point being grown-up if you 
\X/ rhialto/at/xs4all.nl    -- can't be childish sometimes. -The 4th Doctor
X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*

>Unformatted:
        it is really a 5.1 userland with a newer kernel