From nobody@FreeBSD.org  Mon Oct  4 20:06:47 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6679B106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Mon,  4 Oct 2010 20:06:47 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 560C58FC1A
	for <freebsd-gnats-submit@FreeBSD.org>; Mon,  4 Oct 2010 20:06:47 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o94K6l7M072537
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 4 Oct 2010 20:06:47 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o94K6kxm072536;
	Mon, 4 Oct 2010 20:06:46 GMT
	(envelope-from nobody)
Message-Id: <201010042006.o94K6kxm072536@www.freebsd.org>
Date: Mon, 4 Oct 2010 20:06:46 GMT
From: Ben Haga <bhaga@absoludicrous.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Add "intro(#)" to 'SEE ALSO' in 'MAN(1)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         151216
>Category:       docs
>Synopsis:       [patch] Add "intro(#)" to 'SEE ALSO' in 'MAN(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gordon
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Oct 04 20:10:05 UTC 2010
>Closed-Date:    Mon Nov 29 05:44:49 PST 2010
>Last-Modified:  Mon Nov 29 05:44:49 PST 2010
>Originator:     Ben Haga
>Release:        FreeBSD 8.0-RELEASE
>Organization:
>Environment:
FreeBSD absoludicrous.com 8.0-RELEASE FreeBSD 8.0-RELEASE #0: Sat Nov 21 15:02:08 UTC 2009     root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
It would be 'nice to have' a mention of the intro(#) pages in MAN(1), this information is not immediately available and may be confusing or otherwise difficult to find for users.
>How-To-Repeat:
man 1 man, not find the information about documentation sections.
>Fix:
--- /usr/src/gnu/usr.bin/man/man/man.man	2009-10-24 18:10:29.000000000 -0700
+++ /home/bhaga/man.man-intro	2010-10-04 13:03:29.000000000 -0700
@@ -301,7 +301,8 @@
 .Xr more 1 ,
 .Xr whatis 1 ,
 .Xr man 7 ,
-.Xr mdoc 7
+.Xr mdoc 7 ,
+.Xr intro 1
 .Sh BUGS
 The
 .Fl t

Or perhaps:


--- /usr/src/gnu/usr.bin/man/man/man.man	2009-10-24 18:10:29.000000000 -0700
+++ /home/bhaga/man.man-intro	2010-10-04 13:05:54.000000000 -0700
@@ -301,7 +301,8 @@
 .Xr more 1 ,
 .Xr whatis 1 ,
 .Xr man 7 ,
-.Xr mdoc 7
+.Xr mdoc 7 ,
+.Xr intro N
 .Sh BUGS
 The
 .Fl t

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->gordon 
Responsible-Changed-By: arundel 
Responsible-Changed-When: Tue Oct 5 14:34:09 UTC 2010 
Responsible-Changed-Why:  
Hi Gordon, 
care to add 'intro(1)' to the 'SEE ALSO' section of your man(1) manual? 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151216: commit references a PR
Date: Tue,  5 Oct 2010 16:14:16 +0000 (UTC)

 Author: gordon
 Date: Tue Oct  5 16:14:08 2010
 New Revision: 213454
 URL: http://svn.freebsd.org/changeset/base/213454
 
 Log:
   Add reference to intro(1) in SEE ALSO section.
   
   PR:		docs/151216
   Approved by:	wes (mentor, implicit)
 
 Modified:
   head/usr.bin/man/man.1
 
 Modified: head/usr.bin/man/man.1
 ==============================================================================
 --- head/usr.bin/man/man.1	Tue Oct  5 15:40:59 2010	(r213453)
 +++ head/usr.bin/man/man.1	Tue Oct  5 16:14:08 2010	(r213454)
 @@ -290,6 +290,7 @@ System configuration file.
  Local configuration files.
  .El
  .Sh SEE ALSO
 +.Xr intro 1 ,
  .Xr apropos 1 ,
  .Xr locale 1 ,
  .Xr manpath 1 ,
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: gordon 
State-Changed-When: Mon Nov 29 05:43:23 PST 2010 
State-Changed-Why:  
Committed to head revision. Will look at a similar change for stable branch. 

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