From owner-freebsd-doc Thu May 3 22:50:39 2001 Delivered-To: freebsd-doc@freebsd.org Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138]) by hub.freebsd.org (Postfix) with ESMTP id 3440B37B423; Thu, 3 May 2001 22:50:36 -0700 (PDT) (envelope-from dima@unixfreak.org) Received: from spike.unixfreak.org (spike [63.198.170.139]) by bazooka.unixfreak.org (Postfix) with ESMTP id B782C3E2A; Thu, 3 May 2001 22:50:35 -0700 (PDT) To: John Baldwin Cc: "Andrew R. Reiter" , freebsd-doc@FreeBSD.org Subject: Re: Updated uprintf.9 (was Re: uprintf.9) In-Reply-To: ; from jhb@FreeBSD.org on "Wed, 02 May 2001 15:02:31 -0700 (PDT)" Date: Thu, 03 May 2001 22:50:35 -0700 From: Dima Dorfman Message-Id: <20010504055035.B782C3E2A@bazooka.unixfreak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org John Baldwin writes: > On 02-May-01 Andrew R. Reiter wrote: > > > > Ok, I updated the printf.9 page a bunch, but am not positive that it's > > finished. I'd appreciate more comments... :-/ > > > > If you don't want the attached copy, you can find a copy at: > > http://www.watson.org/~arr/fbsd-stuff/printf.9 > > I hacked up some other parts of the manpage as well. You can find the result > at http://www.FreeBSD.org/~jhb/patches/printf.9. There is a also a diff > (minus the ^M fix) in the same locaiton as printf9.diff. Okay, this looks good. I've cleaned it up a little more. Diff attached. If everyone is okay with this, I'll commit it in a couple of days. Thanks, Dima Dorfman dima@unixfreak.org --- pf9 Wed May 2 14:59:55 2001 +++ printf.9 Thu May 3 22:47:11 2001 @@ -44,8 +44,9 @@ .Sh DESCRIPTION The .Nm -functions are similar to -.Xr printf 3 . +family of functions are similar to the +.Xr printf 3 +family of functions. The three functions each use a different output stream. The .Fn uprintf @@ -55,10 +56,10 @@ The .Fn tprintf function outputs to the tty associated with the process -.Fa p , -and will also write to the logging facility if the +.Fa p +and the logging facility if .Fa pri -value is not -1. +is not \&-1. .Pp Each of these related functions use the .Fa fmt @@ -70,7 +71,10 @@ .Pp The .Cm \&%b -identifier expects two arguments: an integer and a char *. +identifier expects two arguments: an +.Ft int +and a +.Ft char * . These are used as a register value and a print mask for decoding bitmasks. The print mask is made up of two parts: the base and the arguments. @@ -87,7 +91,11 @@ The .Cm \&%D identifier is meant to assist in hexdumps. -It requires two arguments: a u_char * pointer and a char * string. +It requires two arguments: a +.Ft u_char * +pointer and a +.Ft char * +string. The memory pointed to be the pointer is output in hexadecimal one byte at a time. The string is used as a delimiter between individual bytes. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message