From simon@arthur.nitro.dk  Mon May 19 15:24:14 2003
Return-Path: <simon@arthur.nitro.dk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 0221437B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 May 2003 15:24:14 -0700 (PDT)
Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0193943F85
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 May 2003 15:24:13 -0700 (PDT)
	(envelope-from simon@arthur.nitro.dk)
Received: by arthur.nitro.dk (Postfix, from userid 1000)
	id 822F610BF81; Tue, 20 May 2003 00:24:10 +0200 (CEST)
Message-Id: <20030519222410.822F610BF81@arthur.nitro.dk>
Date: Tue, 20 May 2003 00:24:10 +0200 (CEST)
From: Simon L.Nielsen <simon@nitro.dk>
Reply-To: Simon L.Nielsen <simon@nitro.dk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Misc man page reference fixes
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         52448
>Category:       docs
>Synopsis:       [patch] Misc man page reference fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    simon
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 19 15:30:02 PDT 2003
>Closed-Date:    Sun Sep 03 22:43:02 GMT 2006
>Last-Modified:  Sat Mar 16 02:03:51 UTC 2013
>Originator:     Simon L. Nielsen
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
>Environment:
>Description:
intro.3:
	Remove Xr references to libc, libcurses, libcompat, libkvm,
	libl, libtermcap and liby since they do not exists as man
	pages under those names.

	Add section number to libmp Xr reference (which do have a man
	page).
	Add libmp description - from libmp(3).

picobsd.8:
	Remove Xr reference to etherboot since it does not have a man
	page at all. Add reference to the location of the port instead.

>How-To-Repeat:
>Fix:
--- man-intro-3.patch begins here ---
Index: intro.3
===================================================================
RCS file: /home/ncvs/src/share/man/man3/intro.3,v
retrieving revision 1.14
diff -u -d -r1.14 intro.3
--- intro.3	7 Aug 2001 15:48:38 -0000	1.14
+++ intro.3	20 May 2003 00:11:09 -0000
@@ -60,7 +60,7 @@
 .Pp
 The various libraries (followed by the loader flag):
 .Bl -tag -width "libc (-lc)"
-.It Xr libc Pq Fl l Ns Ar c
+.It libc Pq Fl l Ns Ar c
 Standard C library functions.
 .\" (See
 .\" .Xr libc 3 . )
@@ -71,7 +71,7 @@
 .Fl l Ns Ar c
 for these functions.
 There are several `libraries' or groups of functions included inside of
-.Xr libc :
+.Em libc :
 the standard
 .Tn I/O
 routines,
@@ -81,12 +81,12 @@
 character tests and character operators,
 des encryption routines,
 storage allocation, time functions, signal handling and more.
-.It Xr libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap
+.It libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap
 Terminal independent screen management routines
 for two dimensional non-bitmap display terminals.
 (See
 .Xr ncurses 3 . )
-.It Xr libcompat Pq Fl l Ns Ar compat
+.It libcompat Pq Fl l Ns Ar compat
 Functions which are obsolete but are available for compatibility with
 .Bx 4.3 .
 In particular,
@@ -96,16 +96,16 @@
 Use of these routines should, for the most part, be avoided.
 The manual page entry for each compatibility routine
 indicates the proper interface to use.
-.It Xr libkvm Pq Fl l Ns Ar kvm
+.It libkvm Pq Fl l Ns Ar kvm
 Functions used to access kernel memory are in this library.  They can be used
 against both a running system and a crash dump.
 (See
 .Xr kvm 3 . )
-.It Xr libl Pq Fl l Ns Ar l
+.It libl Pq Fl l Ns Ar l
 The library for
 .Xr lex 1 .
 .\" .It Xr libln
-.It Xr libm Pq Fl l Ns Ar m
+.It libm Pq Fl l Ns Ar m
 The math library,
 .Em libm .
 The math library is loaded as needed by the Pascal compiler,
@@ -115,7 +115,8 @@
 flag.
 (See
 .Xr math 3 . )
-.It Xr libmp Pq Fl l Ns Ar mp
+.It Xr libmp 3 Pq Fl l Ns Ar mp
+The traditional BSD multiple precision integer arithmetic library.
 .\" .It Xr libom
 .\" Old math library.
 .\" .It Xr libplot Pq Fl l Ns Ar plot
@@ -128,12 +129,12 @@
 .\" .Xr plot 3 . )
 .\" .It Xr libresolv Pq Fl l Ns Ar resolv
 .\" Routines for network address resolution.
-.It Xr libtermcap Pq Fl l Ns Ar termcap
+.It libtermcap Pq Fl l Ns Ar termcap
 The terminal independent operation library package.
 (See
 .Xr termcap 3 . )
 .\" .It libvt0.a
-.It Xr liby Pq Fl l Ns Ar y
+.It liby Pq Fl l Ns Ar y
 The library for
 .Xr yacc 1 .
 .El
--- man-intro-3.patch ends here ---

--- man-picobsd-8.patch begins here ---
Index: man8/picobsd.8
===================================================================
RCS file: /home/ncvs/src/share/man/man8/picobsd.8,v
retrieving revision 1.24
diff -u -d -r1.24 picobsd.8
--- man8/picobsd.8	27 Dec 2002 12:15:34 -0000	1.24
+++ man8/picobsd.8	19 May 2003 22:37:11 -0000
@@ -19,7 +19,7 @@
 .Nm PicoBSD )
 which typically fits on one floppy disk, or can be downloaded as a
 single image file from some media such as CDROM, flash memory, or through
-.Xr etherboot .
+etherboot [ /usr/ports/net/etherboot ].
 .Pp
 The
 .Nm
@@ -101,8 +101,7 @@
 kernel.
 This is the default behaviour, and is
 extremely useful as the kernel itself can be loaded,
-using
-.Xr etherboot
+using etherboot [ /usr/ports/net/etherboot ]
 or
 .Xr pxeboot 8 ,
 as a fully functional system.
--- man-picobsd-8.patch ends here ---


>Release-Note:
>Audit-Trail:

From: Alexey Zelkin <phantom@FreeBSD.org.ua>
To: "Simon L.Nielsen" <simon@nitro.dk>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/52448: [patch] Misc man page reference fixes
Date: Tue, 20 May 2003 11:28:28 +0300

 On Tue, May 20, 2003 at 12:24:10AM +0200, Simon L.Nielsen wrote:
 > 
 > >Number:         52448
 > >Category:       docs
 > >Synopsis:       [patch] Misc man page reference fixes
 
 [..]
 
 > >Description:
 > intro.3:
 > 	Remove Xr references to libc, libcurses, libcompat, libkvm,
 > 	libl, libtermcap and liby since they do not exists as man
 > 	pages under those names.
 > 
 > 	Add section number to libmp Xr reference (which do have a man
 > 	page).
 > 	Add libmp description - from libmp(3).
 
 I'd rather prefer to someone write stub or normal (which is better) manual
 pages for those libraries than removing Xr's.  Yet Another Junior Doc Hacker
 Task -- ant takers ? :-)
 
 > picobsd.8:
 > 	Remove Xr reference to etherboot since it does not have a man
 > 	page at all. Add reference to the location of the port instead.
 

From: "Simon L. Nielsen" <simon@nitro.dk>
To: Alexey Zelkin <phantom@FreeBSD.org.ua>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/52448: [patch] Misc man page reference fixes
Date: Tue, 20 May 2003 11:10:49 +0200

 --HcAYCG3uE/tztfnV
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2003.05.20 11:28:28 +0300, Alexey Zelkin wrote:
 > On Tue, May 20, 2003 at 12:24:10AM +0200, Simon L.Nielsen wrote:
 > >=20
 > > >Number:         52448
 > > >Category:       docs
 > > >Synopsis:       [patch] Misc man page reference fixes
 >=20
 > [..]
 >=20
 > > >Description:
 > > intro.3:
 > > 	Remove Xr references to libc, libcurses, libcompat, libkvm,
 > > 	libl, libtermcap and liby since they do not exists as man
 > > 	pages under those names.
 > >=20
 > > 	Add section number to libmp Xr reference (which do have a man
 > > 	page).
 > > 	Add libmp description - from libmp(3).
 >=20
 > I'd rather prefer to someone write stub or normal (which is better) manual
 > pages for those libraries than removing Xr's.  Yet Another Junior Doc Hac=
 ker
 > Task -- ant takers ? :-)
 
 I might as well get to know mdoc better :-) I will have a look at theese.
 
 Some of them might simply be fixed with proper links to existing man
 page.  Update to follow once I get looked at it more.
 
 --=20
 Simon L. Nielsen
 
 --HcAYCG3uE/tztfnV
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.1 (FreeBSD)
 
 iD8DBQE+yfEX8kocFXgPTRwRAv90AKDOEEQcy+2aSoBd5VEVacLBqwPdfQCgwBE+
 3lrnNPLCidIqOThf8uCpizI=
 =HTZl
 -----END PGP SIGNATURE-----
 
 --HcAYCG3uE/tztfnV--
Responsible-Changed-From-To: freebsd-doc->simon 
Responsible-Changed-By: simon 
Responsible-Changed-When: Sun Jul 20 15:40:15 PDT 2003 
Responsible-Changed-Why:  
I will handle my own PR's. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=52448 
State-Changed-From-To: open->closed 
State-Changed-By: simon 
State-Changed-When: Sun Sep 3 22:42:25 UTC 2006 
State-Changed-Why:  
Close PR since I doubt I will ever get around to fixing this, and it's 
not really that important. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=52448 
>Unformatted:
