From owner-freebsd-doc@FreeBSD.ORG Tue Sep 14 04:40:03 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 24635106566B for ; Tue, 14 Sep 2010 04:40:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D97928FC27 for ; Tue, 14 Sep 2010 04:40:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o8E4e2Qq089634 for ; Tue, 14 Sep 2010 04:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o8E4e2J7089633; Tue, 14 Sep 2010 04:40:02 GMT (envelope-from gnats) Resent-Date: Tue, 14 Sep 2010 04:40:02 GMT Resent-Message-Id: <201009140440.o8E4e2J7089633@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Anonymous Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DB17D1065670 for ; Tue, 14 Sep 2010 04:33:18 +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 CAD708FC25 for ; Tue, 14 Sep 2010 04:33:18 +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 o8E4XI0A046341 for ; Tue, 14 Sep 2010 04:33:18 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o8E4XIvS046340; Tue, 14 Sep 2010 04:33:18 GMT (envelope-from nobody) Message-Id: <201009140433.o8E4XIvS046340@www.freebsd.org> Date: Tue, 14 Sep 2010 04:33:18 GMT From: Anonymous To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/150548: An error in the printf man page. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 14 Sep 2010 04:40:03 -0000 >Number: 150548 >Category: docs >Synopsis: An error in the printf man page. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Sep 14 04:40:02 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Anonymous >Release: 8.1 >Organization: >Environment: FreeBSD home 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Mon Jul 19 02:55:53 UTC 2010 root@almeida.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 >Description: I originally came across this when I used "man 3 sprintf" to view the sprintf man page. This is the output from "man 3 printf", the hyphens are added to make the separation between my writing and my copied and pasted text clear: -------------------------------------------------------------- [prdeltoid@home /usr/home/prdeltoid]$ man 3 printf PRINTF(3) FreeBSD Library Functions Manual PRINTF(3) NAME printf, fprintf, sprintf, snprintf, asprintf, dprintf, vprintf, vfprintf, vsprintf, vsnprintf, vasprintf, vdprintf -- formatted output conversion LIBRARY Standard C Library (libc, -lc) SYNOPSIS #define _WITH_DPRINTF #include int printf(const char * restrict format, ...); int fprintf(FILE * restrict stream, const char * restrict format, ...); int sprintf(char * restrict str, const char * restrict format, ...); int --More--(byte 1161)mdoc warning: Using a macro as first argument cancels effect of .Cm (#815) Usage: .%U URL ... (#815) Usage: .Cm interactive_command_modifier ... (#819) snprintf(char * restrict str, size_t size, const char * restrict format, ...); int asprintf(char **ret, const char *format, ...); -------------------------------------------------------------- >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: