From nobody@FreeBSD.org  Wed Feb  6 08:56:19 2002
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id F21D237C3CF
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  6 Feb 2002 08:51:58 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g16GpwY67261;
	Wed, 6 Feb 2002 08:51:58 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200202061651.g16GpwY67261@freefall.freebsd.org>
Date: Wed, 6 Feb 2002 08:51:58 -0800 (PST)
From: Stefan Farfeleder <e0026813@stud3.tuwien.ac.at>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Document '+' for -t in ktrace(1)
X-Send-Pr-Version: www-1.0

>Number:         34668
>Category:       docs
>Synopsis:       Document '+' for -t in ktrace(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Feb 06 09:00:06 PST 2002
>Closed-Date:    Mon Feb 11 01:06:58 PST 2002
>Last-Modified:  Mon Feb 11 01:07:16 PST 2002
>Originator:     Stefan Farfeleder
>Release:        4-5
>Organization:
>Environment:
FreeBSD stefan.fafoe 4.5-RELEASE FreeBSD 4.5-RELEASE #1: Sat Feb  2 13:05:42 CET 2002     stefan@stefan.fafoe:/usr/obj/usr/src/sys/MYKERNEL  i386

>Description:
The -t option takes a string of characters, of which '+' wasn't documented    till now. Wording taken from NetBSD ktrace(1).

Additional problem: kdump(1) refers to ktrace(1) for information about -t, but while ktrace defaults to DEF_POINTS (-t +), kdump has ALL_POINTS (-t +w) when no -t option is given.
>How-To-Repeat:

>Fix:
--- ktrace.1.orig       Wed Feb  6 16:05:12 2002
+++ ktrace.1    Wed Feb  6 16:40:44 2002
@@ -119,6 +119,8 @@
 userland traces
 .It Cm w
 context switches
+.It Cm +
+trace the default set of trace points (c, n, i, s, u)
 .El
 .It Ar command
 Execute

>Release-Note:
>Audit-Trail:

From: Peter Pentchev <roam@ringlet.net>
To: Stefan Farfeleder <e0026813@stud3.tuwien.ac.at>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/34668: Document '+' for -t in ktrace(1)
Date: Thu, 7 Feb 2002 10:21:13 +0200

 --IrhDeMKUP4DT/M7F
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Wed, Feb 06, 2002 at 08:51:58AM -0800, Stefan Farfeleder wrote:
 >=20
 > >Number:         34668
 > >Category:       docs
 > >Synopsis:       Document '+' for -t in ktrace(1)
 > >Originator:     Stefan Farfeleder
 >=20
 > >Description:
 > The -t option takes a string of characters, of which '+' wasn't documente=
 d    till now. Wording taken from NetBSD ktrace(1).
 >=20
 > Additional problem: kdump(1) refers to ktrace(1) for information about -t=
 , but while ktrace defaults to DEF_POINTS (-t +), kdump has ALL_POINTS (-t =
 +w) when no -t option is given.
 > >How-To-Repeat:
 >=20
 > >Fix:
 > --- ktrace.1.orig       Wed Feb  6 16:05:12 2002
 > +++ ktrace.1    Wed Feb  6 16:40:44 2002
 > @@ -119,6 +119,8 @@
 >  userland traces
 >  .It Cm w
 >  context switches
 > +.It Cm +
 > +trace the default set of trace points (c, n, i, s, u)
 >  .El
 >  .It Ar command
 >  Execute
 
 Would it not be better to mark those up as Cm's, as in
 the attached patch?
 G'luck,
 Peter
 
 --=20
 Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 This sentence contains exactly threee erors.
 
 Index: src/usr.bin/ktrace/ktrace.1
 =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=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
 RCS file: /home/ncvs/src/usr.bin/ktrace/ktrace.1,v
 retrieving revision 1.13
 diff -u -r1.13 ktrace.1
 --- src/usr.bin/ktrace/ktrace.1	15 Jul 2001 08:01:20 -0000	1.13
 +++ src/usr.bin/ktrace/ktrace.1	7 Feb 2002 08:19:48 -0000
 @@ -119,6 +119,13 @@
  userland traces
  .It Cm w
  context switches
 +.It Cm +
 +trace the default set of trace points -
 +.Cm c ,
 +.Cm n ,
 +.Cm i ,
 +.Cm s ,
 +.Cm u
  .El
  .It Ar command
  Execute
 
 --IrhDeMKUP4DT/M7F
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.6 (FreeBSD)
 Comment: For info see http://www.gnupg.org
 
 iEYEARECAAYFAjxiOPkACgkQ7Ri2jRYZRVOGogCfR9yGi1ESE7jFEn3Qkprmzfri
 YkgAn0yfvziDwhkW01CHumj2FVv6Iv9+
 =wFVh
 -----END PGP SIGNATURE-----
 
 --IrhDeMKUP4DT/M7F--

From: Peter Pentchev <roam@ringlet.net>
To: Stefan Farfeleder <e0026813@tuwien.ac.at>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/34668: Document '+' for -t in ktrace(1)
Date: Thu, 7 Feb 2002 10:30:56 +0200

 Hmm.. is this your correct e-mail address?  I got a 'mail delivery
 failure: user does not exist' on the one in the PR..
 
 (Apologies to -doc and GNATS for getting this message twice)
 
 G'luck,
 Peter
 
 -- 
 Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 What would this sentence be like if pi were 3?
 
 ----- Forwarded message from Peter Pentchev <roam@ringlet.net> -----
 
 Date: Thu, 7 Feb 2002 10:21:13 +0200
 From: Peter Pentchev <roam@ringlet.net>
 To: Stefan Farfeleder <e0026813@stud3.tuwien.ac.at>
 Cc: freebsd-gnats-submit@freebsd.org
 Subject: Re: docs/34668: Document '+' for -t in ktrace(1)
 
 On Wed, Feb 06, 2002 at 08:51:58AM -0800, Stefan Farfeleder wrote:
 > 
 > >Number:         34668
 > >Category:       docs
 > >Synopsis:       Document '+' for -t in ktrace(1)
 > >Originator:     Stefan Farfeleder
 > 
 > >Description:
 > The -t option takes a string of characters, of which '+' wasn't documented    till now. Wording taken from NetBSD ktrace(1).
 > 
 > Additional problem: kdump(1) refers to ktrace(1) for information about -t, but while ktrace defaults to DEF_POINTS (-t +), kdump has ALL_POINTS (-t +w) when no -t option is given.
 > >How-To-Repeat:
 > 
 > >Fix:
 > --- ktrace.1.orig       Wed Feb  6 16:05:12 2002
 > +++ ktrace.1    Wed Feb  6 16:40:44 2002
 > @@ -119,6 +119,8 @@
 >  userland traces
 >  .It Cm w
 >  context switches
 > +.It Cm +
 > +trace the default set of trace points (c, n, i, s, u)
 >  .El
 >  .It Ar command
 >  Execute
 
 Would it not be better to mark those up as Cm's, as in
 the attached patch?
 G'luck,
 Peter
 
 -- 
 Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 This sentence contains exactly threee erors.
 
 Index: src/usr.bin/ktrace/ktrace.1
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/ktrace/ktrace.1,v
 retrieving revision 1.13
 diff -u -r1.13 ktrace.1
 --- src/usr.bin/ktrace/ktrace.1	15 Jul 2001 08:01:20 -0000	1.13
 +++ src/usr.bin/ktrace/ktrace.1	7 Feb 2002 08:19:48 -0000
 @@ -119,6 +119,13 @@
  userland traces
  .It Cm w
  context switches
 +.It Cm +
 +trace the default set of trace points -
 +.Cm c ,
 +.Cm n ,
 +.Cm i ,
 +.Cm s ,
 +.Cm u
  .El
  .It Ar command
  Execute
 
 
 
 ----- End forwarded message -----

From: Peter Pentchev <roam@ringlet.net>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/34668: Document '+' for -t in ktrace(1)
Date: Thu, 7 Feb 2002 10:37:01 +0200

 The second e-mail address that I tried bounces too.
 
 Still, I think this PR should be addressed, regardless of the fact
 that the originator's e-mail address bounces :)
 
 G'luck,
 Peter
 
 -- 
 Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 This sentence would be seven words long if it were six words shorter.

From: Stefan Farfeleder <e0026813@student.tuwien.ac.at>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/34668: Document '+' for -t in ktrace(1)
Date: Thu, 7 Feb 2002 18:14:51 +0100

 Peter Pentchev wrote:
 >Would it not be better to mark those up as Cm's, as in the attached
 >patch?
 
 That's ok with me. Sorry about the bouncing mails, the address is
 correct, but the server at the university was down for some reason.
 Everything should work again by now :-)
 
 Stefan

From: Dima Dorfman <dima@trit.org>
To: Peter Pentchev <roam@ringlet.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/34668: Document '+' for -t in ktrace(1) 
Date: Sun, 10 Feb 2002 07:32:51 +0000

 Peter Pentchev <roam@ringlet.net> wrote:
 >  --IrhDeMKUP4DT/M7F
 >  Content-Type: text/plain; charset=us-ascii
 >  Content-Disposition: inline
 >  Content-Transfer-Encoding: quoted-printable
 
 Ugh.  GNATS does a very good job of making MIME unreadable.
 
 >  Would it not be better to mark those up as Cm's, as in
 >  the attached patch?
 
 Yes, but not quite; I think using a single Cm would be even better, as
 in the following.
 
 P.S.  Peter, please commit this in a few days if nobody objects and I
 don't do it myself.
 
 Index: ktrace.1
 ===================================================================
 RCS file: /ref/cvsf/src/usr.bin/ktrace/ktrace.1,v
 retrieving revision 1.13
 diff -u -r1.13 ktrace.1
 --- ktrace.1	15 Jul 2001 08:01:20 -0000	1.13
 +++ ktrace.1	10 Feb 2002 07:28:25 -0000
 @@ -119,6 +119,9 @@
  userland traces
  .It Cm w
  context switches
 +.It Cm +
 +trace the default set of trace points -
 +.Cm c , n , i , s , u
  .El
  .It Ar command
  Execute
State-Changed-From-To: open->closed 
State-Changed-By: roam 
State-Changed-When: Mon Feb 11 01:06:58 PST 2002 
State-Changed-Why:  
The fix to ktrace(1) was committed.  Thanks! 

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