From owner-freebsd-doc@FreeBSD.ORG Fri Nov 30 20:40:00 2012 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id B1B28F05 for ; Fri, 30 Nov 2012 20:40:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 6D10F8FC17 for ; Fri, 30 Nov 2012 20:40:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qAUKe0ge011920 for ; Fri, 30 Nov 2012 20:40:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qAUKe0Lv011919; Fri, 30 Nov 2012 20:40:00 GMT (envelope-from gnats) Resent-Date: Fri, 30 Nov 2012 20:40:00 GMT Resent-Message-Id: <201211302040.qAUKe0Lv011919@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, Paul Procacci Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4E6DCDCC for ; Fri, 30 Nov 2012 20:30:40 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 34FCB8FC08 for ; Fri, 30 Nov 2012 20:30:40 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.5/8.14.5) with ESMTP id qAUKUeeK041467 for ; Fri, 30 Nov 2012 20:30:40 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.5/8.14.5/Submit) id qAUKUe9C041465; Fri, 30 Nov 2012 20:30:40 GMT (envelope-from nobody) Message-Id: <201211302030.qAUKUe9C041465@red.freebsd.org> Date: Fri, 30 Nov 2012 20:30:40 GMT From: Paul Procacci To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/174023: [minor] getline(3) doc bug X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 30 Nov 2012 20:40:00 -0000 >Number: 174023 >Category: docs >Synopsis: [minor] getline(3) doc bug >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Nov 30 20:40:00 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Paul Procacci >Release: 8.3-RELEASE-p4 >Organization: >Environment: FreeBSD nat.myhome 8.3-RELEASE-p3 FreeBSD 8.3-RELEASE-p3 #4: Fri Jun 29 14:59:00 CDT 2012 root@nat.myhome:/usr/obj/usr/src/sys/FIREWALL i386 >Description: Really minor documentation bug in getline(3). (Major if you want to confuse someone - hehe). In the "Return Values" section of the manpage it says the call to either the getline and getdelim functions return the value of the number of characters _written_. Certainly this should have been _read_. >How-To-Repeat: man getline >Fix: diff -u lib/libc/stdio/getline.3.orig lib/libc/stdio/getline.3 --- lib/libc/stdio/getline.3.orig 2012-11-30 14:26:08.000000000 -0600 +++ lib/libc/stdio/getline.3 2012-11-30 14:26:16.000000000 -0600 @@ -76,7 +76,7 @@ .Fn getdelim and .Fn getline -functions return the number of characters written, excluding the +functions return the number of characters read, excluding the terminating .Dv NUL character. >Release-Note: >Audit-Trail: >Unformatted: