From kstailey@surfbest.net  Sat Feb 16 13:42:47 2002
Return-Path: <kstailey@surfbest.net>
Received: from server12.safepages.com (server12.safepages.com [216.127.146.26])
	by hub.freebsd.org (Postfix) with ESMTP id CBE4837B402
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 16 Feb 2002 13:42:46 -0800 (PST)
Received: from hermes.surfbest.net (reston-gnap-ip-216012-66.dynamic.ziplink.net [216.8.12.66])
	by server12.safepages.com (Postfix) with ESMTP id A6A7B136217
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 16 Feb 2002 21:42:37 +0000 (GMT)
Received: (from kstailey@localhost)
	by hermes.surfbest.net (8.11.6/8.11.6) id g1GLfGk85808;
	Sat, 16 Feb 2002 16:41:16 -0500 (EST)
	(envelope-from kstailey)
Message-Id: <200202162141.g1GLfGk85808@hermes.surfbest.net>
Date: Sat, 16 Feb 2002 16:41:16 -0500 (EST)
From: Ken Stailey <kstailey@surfbest.net>
Reply-To: Ken Stailey <kstailey@surfbest.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: There are no commands called "diskless" or "jail".
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         35011
>Category:       docs
>Synopsis:       There are no commands called "diskless" or "jail".
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 16 13:50:01 PST 2002
>Closed-Date:    Sat Oct 21 20:37:56 GMT 2006
>Last-Modified:  Fri Oct 27 11:10:28 GMT 2006
>Originator:     Ken Stailey
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
self
>Environment:
System: FreeBSD hermes.surfbest.net 4.5-STABLE FreeBSD 4.5-STABLE #7: Mon Feb 4 22:33:35 EST 2002 kstailey@hermes.surfbest.net:/usr/src/sys/compile/HERMES i386


	
>Description:
IMHO, the intro(8) manpage should be edited to say "command and procedures" not just "commands"  There are no commands called "diskless" or "jail".

>How-To-Repeat:
	N/A
>Fix:

change intro(8) manpage from

     intro - introduction to system maintenance and operation commands

to

     intro - introduction to system administration commands and procedures


>Release-Note:
>Audit-Trail:

From: Chris Costello <chris@FreeBSD.ORG>
To: Ken Stailey <kstailey@surfbest.net>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/35011: There are no commands called "diskless" or "jail".
Date: Sat, 16 Feb 2002 15:54:42 -0600

 On Saturday, February 16, 2002, Ken Stailey wrote:
 > >Synopsis:       There are no commands called "diskless" or "jail".
 
    Actually, there is a command called `jail'.  However,
 diskless(8) should probably become diskless(7).
 
 -- 
 +-------------------+---------------------------------------------------------+
 | Chris Costello    | Be moderate where pleasure is concerned, avoid fatigue. |
 | chris@FreeBSD.org |                                                         |
 +-------------------+---------------------------------------------------------+

From: Ken Stailey <kstailey@surfbest.net>
To: chris@FreeBSD.ORG
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/35011: There are no commands called "diskless" or "jail".
Date: Sat, 16 Feb 2002 16:59:35 -0500

 Chris Costello wrote:
 
 >On Saturday, February 16, 2002, Ken Stailey wrote:
 >
 >>>Synopsis:       There are no commands called "diskless" or "jail".
 >>>
 >
 >   Actually, there is a command called `jail'.  However,
 >diskless(8) should probably become diskless(7).
 >
 Fine with me.
 
 
 
State-Changed-From-To: open->analyzed 
State-Changed-By: murray 
State-Changed-When: Thu Mar 28 01:43:32 PST 2002 
State-Changed-Why:  
diskless should be moved to man7.  I've asked Ruslan for his approval 
before requesting this from the CVS meisters. 


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

From: Chern Lee <chern@FreeBSD.org>
To: Ken Stailey <kstailey@surfbest.net>
Cc: <FreeBSD-gnats-submit@freebsd.org>, <freebsd-doc@freebsd.org>
Subject: Re: docs/35011: There are no commands called "diskless" or "jail".
Date: Mon, 29 Jul 2002 04:16:26 -0700 (PDT)

 Does anyone object in making this change?  Ken is trying to state that
 section 8 contains more than just commands, eg: diskless(8), yp(8), etc.
 
 The short description of intro(8) should be changed to reflect this.
 
 - chern
 
 Index: intro.8
 ===================================================================
 RCS file: /home/ncvs/src/share/man/man8/intro.8,v
 retrieving revision 1.3.2.3
 diff -u -r1.3.2.3 intro.8
 --- intro.8     12 Apr 2002 16:25:18 -0000      1.3.2.3
 +++ intro.8     29 Jul 2002 11:14:26 -0000
 @@ -37,7 +37,7 @@
  .Os
  .Sh NAME
  .Nm intro
 -.Nd "introduction to system maintenance and operation commands"
 +.Nd "introduction to system administration commands and procedures"
  .Sh DESCRIPTION
  This section contains information related to system operation
  and maintenance.
 
 
 On Sat, 16 Feb 2002, Ken Stailey wrote:
 
 >
 > >Description:
 > IMHO, the intro(8) manpage should be edited to say "command and
 > procedures"  not just "commands"  There are no commands called
 > "diskless" or "jail". >
 > >How-To-Repeat:
 > 	N/A
 > >Fix:
 >
 > change intro(8) manpage from
 >
 >      intro - introduction to system maintenance and operation commands
 >
 > to
 >
 >      intro - introduction to system administration commands and procedures
 >
 >
 

From: Ken Stailey <kstailey@speakeasy.net>
To: Chern Lee <chern@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org
Subject: Re: docs/35011: There are no commands called "diskless" or "jail".
Date: Mon, 29 Jul 2002 08:03:46 -0400

 No, the intro should not be changed.  Those pages should be moved to 
 section 7.
 
 Chern Lee wrote:
 
 >Does anyone object in making this change?  Ken is trying to state that
 >section 8 contains more than just commands, eg: diskless(8), yp(8), etc.
 >
 >The short description of intro(8) should be changed to reflect this.
 >
 >- chern
 >
 >Index: intro.8
 >===================================================================
 >RCS file: /home/ncvs/src/share/man/man8/intro.8,v
 >retrieving revision 1.3.2.3
 >diff -u -r1.3.2.3 intro.8
 >--- intro.8     12 Apr 2002 16:25:18 -0000      1.3.2.3
 >+++ intro.8     29 Jul 2002 11:14:26 -0000
 >@@ -37,7 +37,7 @@
 > .Os
 > .Sh NAME
 > .Nm intro
 >-.Nd "introduction to system maintenance and operation commands"
 >+.Nd "introduction to system administration commands and procedures"
 > .Sh DESCRIPTION
 > This section contains information related to system operation
 > and maintenance.
 >
 >
 >On Sat, 16 Feb 2002, Ken Stailey wrote:
 >
 >  
 >
 >>>Description:
 >>>      
 >>>
 >>IMHO, the intro(8) manpage should be edited to say "command and
 >>procedures"  not just "commands"  There are no commands called
 >>"diskless" or "jail". >
 >>    
 >>
 >>>How-To-Repeat:
 >>>      
 >>>
 >>	N/A
 >>    
 >>
 >>>Fix:
 >>>      
 >>>
 >>change intro(8) manpage from
 >>
 >>     intro - introduction to system maintenance and operation commands
 >>
 >>to
 >>
 >>     intro - introduction to system administration commands and procedures
 >>
 >>
 >>    
 >>
 >
 >
 >
 >  
 >
 
 
 

From: "Simon L. Nielsen" <simon@nitro.dk>
To: freebsd-gnats-submit@FreeBSD.org, kstailey@surfbest.net
Cc:  
Subject: Re: docs/35011: There are no commands called "diskless" or "jail"
Date: Thu, 1 May 2003 01:35:24 +0200

 --dzI2QqkSBOAresgT
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Hello
 
 To summerize this bug :
 
 Several man pages from section 8 really should be moved to section 7
 since section 7 should be for "system maintenance and operation
 commands".
 
 The ones I can find are (basically most of share/man/man8/) :
 
 adding_user
 crash
 diskless
 picobsd (this is strictly a command but hardly has anything to do with
 	"system maintenance and operation commands").
 sticky
 yp
 
 For the complete picture NetBSD appears to have modified their definition
 of what should be in section 8 to accomodate man pages like diskless(8) :
 
      A number of pages in this section describe general system management t=
 op-
      ics. For example, the diskless(8) page describes how to boot a system
      over a network, and the compat_linux(8) page describes how to run Linux
      binaries on NetBSD architectures that support it.
 
 OpenBSD still have diskless in section 8 but does not have generally noted
 this in intro(8) but do have :
 
      The section `crash' should be consulted to understand how to interpret
      system crash dumps.
 
 If the pages should be moved I can make the patch to update the relevant
 references from man pages / docbook documents and so on.
 
 My 0.02c is that this would be a good thing for consistency.
 
 --=20
 Simon L. Nielsen
 
 --dzI2QqkSBOAresgT
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.1 (FreeBSD)
 
 iD8DBQE+sF288kocFXgPTRwRAjzdAKC70IZzNz3kgLoDI5AOGLPCKJPNxwCeNo8+
 aCytbsNg8HcnKq4iurXiNTo=
 =omP6
 -----END PGP SIGNATURE-----
 
 --dzI2QqkSBOAresgT--

From: "Simon L. Nielsen" <simon@nitro.dk>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/35011: There are no commands called "diskless" or "jail"
Date: Thu, 1 May 2003 01:45:20 +0200

 --Vxa5joy26gVGOrvU
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2003.04.30 16:40:15 -0700, Simon L. Nielsen wrote:
 >  Several man pages from section 8 really should be moved to section 7
 >  since section 7 should be for "system maintenance and operation
 >  commands".
 
 Time to go to bed... It is of course section 8 which is "system
 maintenance and operation commands" - secion 7 is "miscellaneous
 information pages".
 
 --=20
 Simon L. Nielsen
 
 --Vxa5joy26gVGOrvU
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.1 (FreeBSD)
 
 iD8DBQE+sGAP8kocFXgPTRwRAhbGAKDAlra+51M9Zz0JEvOvUQPnN7hfpACeNV9i
 4dFqkiPMVwfTcwe7tMaCc7Q=
 =gkdS
 -----END PGP SIGNATURE-----
 
 --Vxa5joy26gVGOrvU--
State-Changed-From-To: analyzed->closed 
State-Changed-By: ru 
State-Changed-When: Sat Oct 21 20:36:52 UTC 2006 
State-Changed-Why:  
The intro(8) manpage has been updated. 


Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: ru 
Responsible-Changed-When: Sat Oct 21 20:36:52 UTC 2006 
Responsible-Changed-Why:  

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/35011: commit references a PR
Date: Sat, 21 Oct 2006 20:36:12 +0000 (UTC)

 ru          2006-10-21 20:35:50 UTC
 
   FreeBSD src repository
 
   Modified files:
     share/man/man8       intro.8 
   Log:
   Make it clear that section 8 also documents system management
   procedures, not necessarily commands.
   
   PR:             docs/35011
   Obtained from:  NetBSD (partly)
   
   Revision  Changes    Path
   1.12      +28 -17    src/share/man/man8/intro.8
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/35011: commit references a PR
Date: Fri, 27 Oct 2006 11:03:50 +0000 (UTC)

 ru          2006-10-27 11:03:35 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     share/man/man8       intro.8 
   Log:
   MFC: 1.12:
   
   Make it clear that section 8 also documents system management
   procedures, not necessarily commands.
   
   PR:             docs/35011
   Approved by:    re (blanket)
   
   Revision   Changes    Path
   1.11.12.1  +28 -17    src/share/man/man8/intro.8
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
