From rdm@cfcl.com  Sun Mar 25 22:27:57 2001
Return-Path: <rdm@cfcl.com>
Received: from idiom.com (idiom.com [216.240.32.1])
	by hub.freebsd.org (Postfix) with ESMTP id A5CE937B718
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 25 Mar 2001 22:27:56 -0800 (PST)
	(envelope-from rdm@cfcl.com)
Received: from cfcl.com (cpe-24-221-169-54.ca.sprintbbd.net [24.221.169.54])
	by idiom.com (8.9.3/8.9.3) with ESMTP id WAA72220
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 25 Mar 2001 22:27:55 -0800 (PST)
Received: (from rdm@localhost)
	by cfcl.com (8.11.1/8.11.1) id f2Q6T7i54312;
	Sun, 25 Mar 2001 22:29:07 -0800 (PST)
	(envelope-from rdm)
Message-Id: <200103260629.f2Q6T7i54312@cfcl.com>
Date: Sun, 25 Mar 2001 22:29:07 -0800 (PST)
From: Rich Morin <rdm@cfcl.com>
Reply-To: rdm@cfcl.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: more broken "SEE ALSO" references
X-Send-Pr-Version: 3.2

>Number:         26090
>Category:       docs
>Synopsis:       more broken "SEE ALSO" references
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    mpp
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Mar 25 22:30:01 PST 2001
>Closed-Date:    Sun Jul 22 05:04:06 PDT 2001
>Last-Modified:  Sun Jul 22 05:05:22 PDT 2001
>Originator:     Rich Morin
>Release:        FreeBSD 4.2-RELEASE i386
>Organization:
Canta Forda Computer Laboratory
>Environment:

        FreeBSD fb42.cfcl.com 4.2-RELEASE FreeBSD 4.2-RELEASE #0:
        Mon Nov 20 13:02:55 GMT 2000
        jkh@bento.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386

>Description:

	A number of SEE ALSO references point to nonexistent pages.
        In some cases, I have been able to supply a hint.  Here,
        in any event, is the list:

 Referencing page              Referenced page                            Hint
 ================              ===============                            ====
 appres(1)                     X(1)
 bdftopcf(1)                   X(1)
 ico(1)                        X(1)
 listres(1)                    X(1)
 oclock(1)                     X(1)
 showfont(1)                   fs(1)
 twm(1)                        X(1)
 viewres(1)                    X(1)
 x11perf(1)                    X(1)
 x11perf(1)                    xbench(1)
 x11perfcomp(1)                X(1)
 xbiff(1)                      X(1)
 xcalc(1)                      X(1)
 xclipboard(1)                 X(1)
 xcutsel(1)                    X(1)
 xditview(1)                   X(1)
 xdpyinfo(1)                   X(1)
 xev(1)                        X(1)
 xeyes(1)                      X(1)
 xfd(1)                        X(1)
 xfs(1)                        X(1)
 xfwp(1)                       ymngr(1)
 xgc(1)                        X(1)
 xieperf(1)                    X(1)
 xkbcomp(1)                    X(1)
 xkbevd(1)                     X(1)
 xkill(1)                      X(1)
 xlsatoms(1)                   X(1)
 xlsclients(1)                 X(1)
 xlsfonts(1)                   X(1)
 xmessage(1)                   X(1)
 xmodmap(1)                    X(1)
 xprop(1)                      X(1)
 xrefresh(1)                   X(1)
 xset(1)                       X(1)
 xsetroot(1)                   X(1)
 xstdcmap(1)                   X(1)
 xvidtune(1)                   XF86Config(4/5)                             (4)
 xwininfo(1)                   X(1)
 xmessage(1)                   X(1)

 X(3)                          XConsortium(1)                              (3)
 X(3)                          XStandards(1)                               (3)
 X(3)                          Xsecurity(1)                                (1)
 XCreateFontSet(3)             XExtentsofFontSet(3X11)           XExtentsOf...
 XCreateOC(3)                  XCreateOM(3X11)
 XDestroyOC(3)                 XCreateOM(3X11)
 XFreeFontPath(3)              XListFont(3X11)                XListFonts(3X11)
 XFreeFontPath(3)              XLoadFonts(3X11)                XLoadFont(3X11)
 XFreeFontSet(3)               XExtentsofFontSet(3X11)           XExtentsOf...
 XGetDeviceButtonMapping(3)    XChangeDeviceKeyboardControl(3X)
 XGetDeviceModifierMapping(3)  XSetDeviceKeyMapping(3X11)           XChange...
 XGetFontPath(3)               XListFont(3X11)                XListFonts(3X11)
 XGetFontPath(3)               XLoadFonts(3X11)                XLoadFont(3X11)
 XGetOCValues(3)               XCreateOM(3X11)
 XGrabKey(3)                   XAllowAccess(3X11)
 XInstallColormap(3)           XChangeWindowAtrributes(3X11)       ...Attri...
 XListInstalledColormaps(3)    XChangeWindowAtrributes(3X11)       ...Attri...
 XOMOfOC(3)                    XCreateOM(3X11)
 XSetDeviceButtonMapping(3)    XChangeDeviceKeyboardControl(3X)
 XSetDeviceModifierMapping(3)  XSetDeviceKeyMapping(3X11)           XChange...
 XSetFontPath(3)               XListFont(3X11)                XListFonts(3X11)
 XSetFontPath(3)               XLoadFonts(3X11)                XLoadFont(3X11)
 XSetOCValues(3)               XCreateOM(3X11)
 XUngrabKey(3)                 XAllowAccess(3X11)
 XUninstallColormap(3)         XChangeWindowAtrributes(3X11)       ...Attri...
 XmbDrawString(3)              XXDrawImageString(3X11)                XDraw...
 XtAppAddSignal(3)             dWorkProc(3Xt)
 XtInstallAccelerators(3)      XtParseTranslationTable(1)                  (3)
 XtInstallAllAccelerators(3)   XtParseTranslationTable(1)                  (3)
 XtNoticeSignal(3)             dWorkProc(3Xt)
 XtParseAcceleratorTable(3)    XtParseTranslationTable(1)                  (3)
 XtRemoveSignal(3)             dWorkProc(3Xt)
 XwcDrawString(3)              XXDrawImageString(3X11)                XDraw...

>How-To-Repeat:

	Run whatis(1) on the referenced pages and see what comes up.

>Fix:

	The references will have to be analyzed and fixed on a case-
        by-case basis.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->mpp 
Responsible-Changed-By: mpp 
Responsible-Changed-When: Mon Mar 26 23:38:13 PST 2001 
Responsible-Changed-Why:  
I'll look at this, but it looks like most of them are 3rd party man 
pages. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=26090 

From: Nik Clayton <nik@freebsd.org>
To: Rich Morin <rdm@cfcl.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/26090: more broken "SEE ALSO" references
Date: Tue, 27 Mar 2001 10:08:55 +0100

 --bp/iNruPH9dso1Pn
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Rich,,
 
 Most of these look like being problems with the X distribution, which we
 don't maintain.  Can you follow this up with the XFree86 people?
 
 On Sun, Mar 25, 2001 at 10:29:07PM -0800, Rich Morin wrote:
 >  Referencing page              Referenced page                           =
  Hint
 >  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D              =3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D                            =3D=3D=3D=3D
 >  appres(1)                     X(1)
 
 X(1) exists on my XFree86 3.3.6 system.  What version of X do you have
 installed?  I've deleted all the other X(1) problems.
 
 >  showfont(1)                   fs(1)
 
 Real bug.
 
 >  x11perf(1)                    xbench(1)
 
 Real bug.
 
 >  xfwp(1)                       ymngr(1)
 
 The actual man page says:
 
        xfindproxy (1), Proxy Management Protocol spec V1.0, prox-
        ymngr(1), Xserver(1)
 
 so that's the result of the hyphenation algorithm.  The actual command
 is proxymngr(1).  This is a bug in the markup in the man page.
 
 >  xvidtune(1)                   XF86Config(4/5)                           =
   (4)
 
 Exists, but the man page is written oddly, and it only exists in section
 5, not section 4.
 
 >  X(3)                          XConsortium(1)                            =
   (3)
 
 Exists on my system.
 
 >  X(3)                          XStandards(1)                             =
   (3)
 
 Ditto.
 
 >  X(3)                          Xsecurity(1)                              =
   (1)
 
 Ditto.
 
 >  XCreateFontSet(3)             XExtentsofFontSet(3X11)           XExtents=
 Of...
 >  XCreateOC(3)                  XCreateOM(3X11)
 >  XDestroyOC(3)                 XCreateOM(3X11)
 >  XFreeFontPath(3)              XListFont(3X11)                XListFonts(=
 3X11)
 >  XFreeFontPath(3)              XLoadFonts(3X11)                XLoadFont(=
 3X11)
 >  XFreeFontSet(3)               XExtentsofFontSet(3X11)           XExtents=
 Of...
 >  XGetDeviceButtonMapping(3)    XChangeDeviceKeyboardControl(3X)
 >  XGetDeviceModifierMapping(3)  XSetDeviceKeyMapping(3X11)           XChan=
 ge...
 >  XGetFontPath(3)               XListFont(3X11)                XListFonts(=
 3X11)
 >  XGetFontPath(3)               XLoadFonts(3X11)                XLoadFont(=
 3X11)
 >  XGetOCValues(3)               XCreateOM(3X11)
 >  XGrabKey(3)                   XAllowAccess(3X11)
 >  XInstallColormap(3)           XChangeWindowAtrributes(3X11)       ...Att=
 ri...
 >  XListInstalledColormaps(3)    XChangeWindowAtrributes(3X11)       ...Att=
 ri...
 >  XOMOfOC(3)                    XCreateOM(3X11)
 >  XSetDeviceButtonMapping(3)    XChangeDeviceKeyboardControl(3X)
 >  XSetDeviceModifierMapping(3)  XSetDeviceKeyMapping(3X11)           XChan=
 ge...
 >  XSetFontPath(3)               XListFont(3X11)                XListFonts(=
 3X11)
 >  XSetFontPath(3)               XLoadFonts(3X11)                XLoadFont(=
 3X11)
 >  XSetOCValues(3)               XCreateOM(3X11)
 >  XUngrabKey(3)                 XAllowAccess(3X11)
 >  XUninstallColormap(3)         XChangeWindowAtrributes(3X11)       ...Att=
 ri...
 >  XmbDrawString(3)              XXDrawImageString(3X11)                XDr=
 aw...
 >  XtAppAddSignal(3)             dWorkProc(3Xt)
 >  XtInstallAccelerators(3)      XtParseTranslationTable(1)                =
   (3)
 >  XtInstallAllAccelerators(3)   XtParseTranslationTable(1)                =
   (3)
 >  XtNoticeSignal(3)             dWorkProc(3Xt)
 >  XtParseAcceleratorTable(3)    XtParseTranslationTable(1)                =
   (3)
 >  XtRemoveSignal(3)             dWorkProc(3Xt)
 >  XwcDrawString(3)              XXDrawImageString(3X11)                XDr=
 aw...
 
 Look like real bugs that the XFree86 project needs to fix.
 
 N
 --=20
 FreeBSD: The Power to Serve             http://www.freebsd.org/
 FreeBSD Documentation Project           http://www.freebsd.org/docproj/
 
           --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---
 
 --bp/iNruPH9dso1Pn
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.4 (FreeBSD)
 Comment: For info see http://www.gnupg.org
 
 iEYEARECAAYFAjrAWKYACgkQk6gHZCw343XNEACeIdhiLUuSz3EqkiY+uSt3pQsj
 TPgAn3a6xSJ97KiZ6BmNREZ/c9Kiee9w
 =nR8d
 -----END PGP SIGNATURE-----
 
 --bp/iNruPH9dso1Pn--

From: Rich Morin <rdm@cfcl.com>
To: Nik Clayton <nik@freebsd.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/26090: more broken "SEE ALSO" references
Date: Tue, 27 Mar 2001 08:42:41 -0800

 I find it a bit peculiar to be sent scuttling off to talk to the XF86
 folks.  In the first place, I don't even _use_ X11.  In the second, I
 was perhaps a bit too credulous at BSDcon 2000 when the BSD folks said
 that they handled all bugs in the distro themselves, unlike the Linux
 folks who just referred folks off to the package authors.  Sigh...
 
 Owell, I'll send them a note and see if they'll listen to me.
 
 
 >X(1) exists on my XFree86 3.3.6 system.  What version of X do you have
 >installed?  I've deleted all the other X(1) problems.
 
 As my uname output indicates, I'm running FB 4.2.  The version of X11
 is whatever was on the distro.
 
 Getting back to the X(1) problem, however, the error lies in the fact
 that the man page isn't really in section 1:
 
    /usr/X11R6/man/cat3/X.3.gz
 
 >The actual man page says:
 >
 >        xfindproxy (1), Proxy Management Protocol spec V1.0, prox-
 >        ymngr(1), Xserver(1)
 >
 >so that's the result of the hyphenation algorithm.  The actual command
 >is proxymngr(1).  This is a bug in the markup in the man page.
 
 Well, it's a poor job of hyphenation, to be sure, but it's also a bug
 in my parsing code, which should splice hyphenated words back together.
 
 >>   xvidtune(1)                   XF86Config(4/5)                      (4)
 >
 >Exists, but the man page is written oddly, and it only exists in section
 >5, not section 4.
 
 This is the only instance I have found of this kind of notation, so I
 think it wouldn't be too outrageous to ask that it be normalized.
 
 >>   X(3)                          XConsortium(1)                       (3)
 >Exists on my system.
 >>   X(3)                          XStandards(1)                        (3)
 >Ditto.
 >>   X(3)                          Xsecurity(1)                         (1)
 >Ditto.
 
 Yes, they exist, but they are all in section 3:
 
    /usr/X11R6/man/cat3/XConsortium.3.gz
    /usr/X11R6/man/cat3/Xsecurity.3.gz
    /usr/X11R6/man/cat3/XStandards.3.gz
 
 >>   XCreateFontSet(3)             XExtentsofFontSet(3X11)        XExtentsOf...
 >>...
 >Look like real bugs that the XFree86 project needs to fix.
 
 Agreed.  I'll send them a note...
 
 -r
 -- 
 http://www.cfcl.com/rdm - home page, resume, etc.
 http://www.cfcl.com/Meta/md_fb.html - The FreeBSD Browser
 email: rdm@cfcl.com; phone: +1 650-873-7841
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Sun Jul 22 05:04:06 PDT 2001 
State-Changed-Why:  
These are all 3rd party package xrefs that we do not fix ourselves. 
Originator stated that he would try and contact the XFree organization 
about getting them fixed. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=26090 
>Unformatted:
