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
Subject: Re: Bug#363518: manpages-dev: tmpfile.3 is confusing
Date: Wed, 19 Apr 2006 22:21:51 +0200 (MEST)
tags 363518 fixed-upstream
thanks
> 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.
Reuben,
Thanks for your report. I agree and have amended upstream as
you suggest. Fixed in upstream 2.31.
Cheers,
Michael
--
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7
Want to help with man page maintenance?
Grab the latest tarball at
ftp://ftp.win.tue.nl/pub/linux-local/manpages/,
read the HOWTOHELP file and grep the source
files for 'FIXME'.
Source: manpages
Source-Version: 2.28-1
We believe that the bug you reported is fixed in the latest version of
manpages, which is due to be installed in the Debian FTP archive:
manpages-dev_2.28-1_all.deb
to pool/main/m/manpages/manpages-dev_2.28-1_all.deb
manpages_2.28-1.diff.gz
to pool/main/m/manpages/manpages_2.28-1.diff.gz
manpages_2.28-1.dsc
to pool/main/m/manpages/manpages_2.28-1.dsc
manpages_2.28-1_all.deb
to pool/main/m/manpages/manpages_2.28-1_all.deb
manpages_2.28.orig.tar.gz
to pool/main/m/manpages/manpages_2.28.orig.tar.gz
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Martin Schulze <[email protected]> (supplier of updated manpages package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.7
Date: Sun, 30 Apr 2006 11:55:26 +0200
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 2.28-1
Distribution: unstable
Urgency: low
Maintainer: Martin Schulze <[email protected]>
Changed-By: Martin Schulze <[email protected]>
Description:
manpages - Manual pages about using a GNU/Linux system
manpages-dev - Manual pages about using GNU/Linux for development
Closes: 186307205238306121326564348038348930351834360166360625363518365112365338
Changes:
manpages (2.28-1) unstable; urgency=low
.
* New upstream source
- Removed reference to core(5) (closes: Bug#360166)
- Corrected the reference from ppoll(2) to poll(2) (closes: Bug#365338)
* Document EBUSY better in rmdir(2) to reflect the situation on Linux
(closes: Bug#205238)
* Removed readv(3) and writev(3) since they were moved into section 2 a
while ago (closes: Bug#326564)
* Use upstream version of clog10(3)
* Untypo fenv(3)
* Added a note to nl_langinfo(3) that setlocale(3) needs to be called
first (closes: Bug#351834)
* Deactivated set_mempolicy(2) since the interface is provided and
documented in numactl (closes: Bug#360625)
* Removed superflous line in ld.so(8) (closes: Bug#365112)
* Added information about BROWSER to environ(5) (closes: Bug#348930)
* Improved the description of tmpfile(3) (closes: Bug#363518)
* Added error(3) by Justin Pryzby (closes: Bug#186307)
* Added the MIT license for the new error(3) manpage
* Install upstream Changes files (closes: Bug#306121, Bug#348038)
* Added argp_parse to missing(7) (Bug#349388)
Files:
7a9bcbb2ef6a7199f7ab70d7300059b9 586 doc - manpages_2.28-1.dsc
997fcdb108d776c8c80664321d191e51 1141760 doc - manpages_2.28.orig.tar.gz
22840abb92e0ab1fabe5d8e9e86ec5b5 49127 doc - manpages_2.28-1.diff.gz
8bb7708ed7f2824ce38422df14766555 461352 doc important manpages_2.28-1_all.deb
dc2085ce707cd12b19fe8ad92c3a1da9 1173348 doc standard manpages-dev_2.28-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)
iD8DBQFEVIpjW5ql+IAeqTIRAv0/AKCPKCiCHX+c2W3R4yqG9xjgWAkLKACghYoT
yYUWar29TcdPRDdOJc+hrQ0=
=3nJs
-----END PGP SIGNATURE-----
Source: manpages
Source-Version: 2.31-1
We believe that the bug you reported is fixed in the latest version of
manpages, which is due to be installed in the Debian FTP archive:
manpages-dev_2.31-1_all.deb
to pool/main/m/manpages/manpages-dev_2.31-1_all.deb
manpages_2.31-1.diff.gz
to pool/main/m/manpages/manpages_2.31-1.diff.gz
manpages_2.31-1.dsc
to pool/main/m/manpages/manpages_2.31-1.dsc
manpages_2.31-1_all.deb
to pool/main/m/manpages/manpages_2.31-1_all.deb
manpages_2.31.orig.tar.gz
to pool/main/m/manpages/manpages_2.31.orig.tar.gz
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Martin Schulze <[email protected]> (supplier of updated manpages package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.7
Date: Tue, 30 May 2006 09:10:05 +0200
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 2.31-1
Distribution: unstable
Urgency: low
Maintainer: Martin Schulze <[email protected]>
Changed-By: Martin Schulze <[email protected]>
Description:
manpages - Manual pages about using a GNU/Linux system
manpages-dev - Manual pages about using GNU/Linux for development
Closes: 186307363518
Changes:
manpages (2.31-1) unstable; urgency=low
.
* New upstream source
. New page describing error() and error_at_line (closes: Bug#186307)
. Fixed DESCRIPTION of tmpfile(3) (closes: Bug#363518)
Files:
69312c1f0218818b34e567c12c60e800 584 doc - manpages_2.31-1.dsc
c524a2729cd2e5d60172007f377925f4 1164421 doc - manpages_2.31.orig.tar.gz
aa08dc399601b9388710ba8dd38bdd98 48268 doc - manpages_2.31-1.diff.gz
3e1976d2712dafcaa08ee940f740c9f8 472478 doc important manpages_2.31-1_all.deb
a5822577ee1cbe1ed375d994e7509bbd 1194956 doc standard manpages-dev_2.31-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)
iD8DBQFEe/TOW5ql+IAeqTIRAvVXAJ96iBRfY4OUqgZqeKFHJZ1vbLE8KgCcC3Yo
u/peV0WfwbVZpgu8K8UcPx8=
=EmYc
-----END PGP SIGNATURE-----