Debian Bug report logs - #363518
manpages-dev: tmpfile.3 is confusing

version graph

Package: manpages-dev; Maintainer for manpages-dev is Dr. Tobias Quathamer <[email protected]>; Source for manpages-dev is src:manpages (PTS, buildd, popcon).

Reported by: Reuben Thomas <[email protected]>

Date: Wed, 19 Apr 2006 15:18:22 UTC

Severity: minor

Tags: fixed-upstream

Found in version manpages-dev/2.22-1

Fixed in versions manpages/2.28-1, manpages/2.31-1

Done: Martin Schulze <[email protected]>

Bug is archived. No further changes may be made.

Full log

🔗 View this message in rfc822 format

X-Loop: [email protected]
Subject: Bug#363518: manpages-dev: tmpfile.3 is confusing
Reply-To: Reuben Thomas <[email protected]>, [email protected]
Resent-From: Reuben Thomas <[email protected]>
Resent-To: [email protected]
Resent-CC: Martin Schulze <[email protected]>
Resent-Date: Wed, 19 Apr 2006 15:18:22 UTC
Resent-Message-ID: <[email protected]>
Resent-Sender: [email protected]
X-Debian-PR-Message: report 363518
X-Debian-PR-Package: manpages-dev
X-Debian-PR-Keywords: 
Received: via spool by [email protected] id=B.114545967330224
          (code B ref -1); Wed, 19 Apr 2006 15:18:22 UTC
Received: (at submit) by bugs.debian.org; 19 Apr 2006 15:14:33 +0000
Received: from pelican.sc3d.org ([216.184.201.86])
	by spohr.debian.org with esmtp (Exim 4.50)
	id 1FWEO1-0007qz-1m
	for [email protected]; Wed, 19 Apr 2006 08:14:33 -0700
Received: from drom ([86.11.14.204])
        by pelican.sc3d.org (pf ESMTP spamd IP-based SPAM blocker) with ASMTP id XTH32732;
        Wed, 19 Apr 2006 11:14:32 -0400
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Reuben Thomas <[email protected]>
To: Debian Bug Tracking System <[email protected]>
Message-ID: <[email protected]>
X-Mailer: reportbug 3.18
Date: Wed, 19 Apr 2006 16:14:27 +0100
Delivered-To: [email protected]
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Level: 
X-Spam-Status: No, hits=-8.0 required=4.0 tests=BAYES_00,HAS_PACKAGE 
	autolearn=no version=2.60-bugs.debian.org_2005_01_02

Package: manpages-dev
Version: 2.22-1
Severity: minor

The man page says:

 "The tmpfile() function generates a unique temporary filename."

This is true, but largely irrelevant: there's no (legal) way to get at
the name. Since this a rather difficult area (tmpname, tempnam,
mkstemp &c.), clarity helps.

I suggest rewriting the first two sentences as:

  The tmpfile() opens a unique temporary file in binary read/write
  (w+b) mode.

The generation of a unique filename is mentioned later (with reference
to errors); that's fine.

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.12-hibernate
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)

Versions of packages manpages-dev depends on:
ii  manpages                      2.22-1     Manual pages about using a GNU/Lin

manpages-dev recommends no packages.

-- no debconf information

Send a report that this bug log contains spam.

Debian bug tracking system administrator <[email protected]>. Last modified: Wed Nov 13 12:54:37 2024; Machine Name: bembo

Debian Bug tracking system

Debbugs is free software and licensed under the terms of the GNU Public License version 2. The current version can be obtained from https://bugs.debian.org/debbugs-source/.

Copyright © 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson, 2005-2017 Don Armstrong, and many other contributors.