Pierre Labastie wrote:
On 30/11/2015 16:34, Bruce Dubbs wrote:
Pierre Labastie wrote:
Hi,
When building LFS with a package manager, I got an error because the man
pages of the attr package (section 2 and 5) would overwrite those of the
man-pages package. I am not sure what to do, but it seem that the pages
from the man-pages project are more accurate than those of attr. Shouldn't
we remove those pages? I have to test, but I think it would amount to "rm
-r man/{man2,man5}".
Have you compared the contents of the man pages between the attr package
and the man-pages package? It would seem odd to me that the man-pages
versions would be more accurate.
Yes I did. It is not so easy because there are a lot of format
differences. As far as I can tell, the overall content is not very
different, but man pages from attr are more informal: Example:
----------------
attr man page (snippet of stexattr.2):
----------------
The flags parameter can be used to refine the semantics of the
opera‐
tion. XATTR_CREATE specifies a pure create, which fails if the named
attribute exists already. XATTR_REPLACE specifies a pure replace
oper‐
ation, which fails if the named attribute does not already
exist. By
default (no flags), the extended attribute will be created if
need be,
or will simply replace the value if the attribute exists.
---------------
the corresponding paragraph in man-pages
---------------
By default (i.e., flags is zero), the extended attribute will be
cre‐
ated if it does not exist, or the value will be replaced
if the
attribute already exists. To modify these semantics, one of the
fol‐
lowing values can be specified in flags:
XATTR_CREATE
Perform a pure create, which fails if the named attribute
exists
already.
XATTR_REPLACE
Perform a pure replace operation, which fails if the named
attribute does not already exist.
---------------
Note that the man-pages project provides only man pages for section 2 of
the manual and now section 5 (see below). They have initially imported
those man pages from the attr package. They have done format and wording
changes, and one big change, consisting in moving the description of the
extended attributes from section 5 (attr.5) to section 7 of the manual
(xattr.7), where it pertains (section 5 is for file formats). Man-pages
file attr.5 is a link to xattr.7, so that you can still get the
information by typing "man 5 attr".
It seems odd to me that the projects do not appear to be coordinating.
Generally I think we should go with the package pages as they are the
experts. I haven't seen anything in the above discussion to contradict
that.
-- Bruce
--
http://lists.linuxfromscratch.org/listinfo/lfs-dev
FAQ: http://www.linuxfromscratch.org/faq/
Unsubscribe: See the above information page
