From owner-freebsd-doc@freebsd.org  Fri Aug 21 11:27:14 2015
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9D5C39BCD02
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Fri, 21 Aug 2015 11:27:14 +0000 (UTC)
 (envelope-from bugzilla-noreply@freebsd.org)
Received: from kenobi.freebsd.org (kenobi.freebsd.org
 [IPv6:2001:1900:2254:206a::16:76])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 8A0861CA8
 for <freebsd-doc@FreeBSD.org>; Fri, 21 Aug 2015 11:27:14 +0000 (UTC)
 (envelope-from bugzilla-noreply@freebsd.org)
Received: from bugs.freebsd.org ([127.0.1.118])
 by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id t7LBREVd069667
 for <freebsd-doc@FreeBSD.org>; Fri, 21 Aug 2015 11:27:14 GMT
 (envelope-from bugzilla-noreply@freebsd.org)
From: bugzilla-noreply@freebsd.org
To: freebsd-doc@FreeBSD.org
Subject: [Bug 202545] A small change suggestion for the manual page fopen(3)
Date: Fri, 21 Aug 2015 11:27:14 +0000
X-Bugzilla-Reason: AssignedTo
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: Documentation
X-Bugzilla-Component: Documentation
X-Bugzilla-Version: Latest
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: Affects Many People
X-Bugzilla-Who: intron@intron.ac
X-Bugzilla-Status: New
X-Bugzilla-Priority: ---
X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform
 op_sys bug_status bug_severity priority component assigned_to reporter
Message-ID: <bug-202545-9@https.bugs.freebsd.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 21 Aug 2015 11:27:14 -0000

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=202545

            Bug ID: 202545
           Summary: A small change suggestion for the manual page fopen(3)
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc@FreeBSD.org
          Reporter: intron@intron.ac

As so people know, fopen("/path/to/xxxxx.xxx", "w") empties the file if it
exists. I believe that the FreeBSD manual page fopen(3) needs to mention it.

The corresponding POSIX manual page fopen(3p) says:

w or wb       Truncate to zero length or create file for writing.

The corresponding Linux manual page fopen(3) says:

w      Truncate file to zero length or create text file for writing.  The
stream is positioned at the beginning of the file.

The following patch is against:

https://svnweb.freebsd.org/base/head/lib/libc/stdio/fopen.3?revision=266971&view=co

--- fopen.3.orig    2015-08-21 18:48:52 +0800
+++ fopen.3    2015-08-21 18:53:37 +0800
@@ -72,7 +72,7 @@
 .It Dq Li w
 Open for writing.
 The stream is positioned at the beginning of the file.
-Create the file if it does not exist.
+Truncate the file to zero length if it exists or create the file if it does
not exist.
 .It Dq Li a
 Open for writing.
 The stream is positioned at the end of the file.

-- 
You are receiving this mail because:
You are the assignee for the bug.