Your message dated Sat, 28 May 2011 15:32:39 +0200
with message-id <[email protected]>
and subject line Re: Misleading cross-references in attr(1)
has caused the Debian Bug report #447650,
regarding Misleading cross-references in attr(1)
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
447650: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=447650
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: attr
Version: 1:2.4.39-1
Severity: normal
attr(1) refers to several functions (section 3). There're a couple of
problems here:
1. The list is incomplete (it doesn't include the "f" variants, or
attr_list[f].
2. If you don't have libattr1-dev installed, but do have
libncurses[w]5-dev installed, "man 3 [set|get]_attr" will give you
ncurses pages, which is confusing.
For 1, I suggest you at least mention one function per man page.
Mentioning the function and the f-variants leaves the cross-reference
section a bit long.
For 2, I suggest you add a warning to attr(1). It's worth knowing
anyway, as if you want to use libncurses and libattr together,
presumably you have to hack around this clash.
-- System Information:
Debian Release: lenny/sid
APT prefers testing
APT policy: (700, 'testing'), (600, 'experimental'), (600, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.22-2-686 (SMP w/1 CPU core)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages attr depends on:
ii libattr1 1:2.4.39-1 Extended attribute shared library
ii libc6 2.6.1-1+b1 GNU C Library: Shared libraries
attr recommends no packages.
-- no debconf information
--- End Message ---
--- Begin Message ---
Hi
> attr(1) refers to several functions (section 3). There're a couple of
> problems here:
>
> 1. The list is incomplete (it doesn't include the "f" variants, or
> attr_list[f].
>
> 2. If you don't have libattr1-dev installed, but do have
> libncurses[w]5-dev installed, "man 3 [set|get]_attr" will give you
> ncurses pages, which is confusing.
For 1, there are now less variants so it should not be confusing anymore.
For 2, the confusion should be gone as libncurses has nothing similar
anymore.
So I'm closing this bug.
Cheers
Luk
--- End Message ---
