GNU bug report logs -
#50889
Please improve the documentation for install --compare (-C)
Previous Next
Reported by: Ian Cross <ian.cross <at> galagic.com>
Date: Wed, 29 Sep 2021 15:02:01 UTC
Severity: minor
Done: Pádraig Brady <P <at> draigBrady.com>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 50889 in the body.
You can then email your comments to 50889 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-coreutils <at> gnu.org
:
bug#50889
; Package
coreutils
.
(Wed, 29 Sep 2021 15:02:01 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
Ian Cross <ian.cross <at> galagic.com>
:
New bug report received and forwarded. Copy sent to
bug-coreutils <at> gnu.org
.
(Wed, 29 Sep 2021 15:02:01 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
Hi,
A while back a request was made to improve the documentation of the
`install --compare` cmd:
https://lists.gnu.org/archive/html/bug-coreutils/2009-09/msg00029.html
It seems the wording in `coreutils.texi` has been updated since
(https://github.com/coreutils/coreutils/commit/c8ac385299950ba84eb8c33f7e32e4d85b18e3ff
) but the manpage and `--help` as of coreutils v8.32 still leave things
vague:
> compare each pair of source and destination files, and in some cases,
do not modify the destination at all
Florain Schlichting at the time of the request suggested this wording
instead:
> compare each pair of source and destination files, and if identical
(by content, ownership and mode), do not copy to preserve mtime
It looks like a patch was made but somehow never made it into the
codebase. Please could the manpage and help be updated with this
wording so users can understand more readily what compare will do?
Thanks
Ian
Reply sent
to
Pádraig Brady <P <at> draigBrady.com>
:
You have taken responsibility.
(Sat, 09 Apr 2022 12:07:02 GMT)
Full text and
rfc822 format available.
Notification sent
to
Ian Cross <ian.cross <at> galagic.com>
:
bug acknowledged by developer.
(Sat, 09 Apr 2022 12:07:02 GMT)
Full text and
rfc822 format available.
Message #10 received at 50889-done <at> debbugs.gnu.org (full text, mbox):
[Message part 1 (text/plain, inline)]
On 29/09/2021 12:09, Ian Cross via GNU coreutils Bug Reports wrote:
> Hi,
>
> A while back a request was made to improve the documentation of the
> `install --compare` cmd:
>
> https://lists.gnu.org/archive/html/bug-coreutils/2009-09/msg00029.html
>
> It seems the wording in `coreutils.texi` has been updated since
> (https://github.com/coreutils/coreutils/commit/c8ac385299950ba84eb8c33f7e32e4d85b18e3ff
> ) but the manpage and `--help` as of coreutils v8.32 still leave things
> vague:
>
>> compare each pair of source and destination files, and in some cases,
> do not modify the destination at all
>
> Florain Schlichting at the time of the request suggested this wording
> instead:
>
>> compare each pair of source and destination files, and if identical
> (by content, ownership and mode), do not copy to preserve mtime
>
> It looks like a patch was made but somehow never made it into the
> codebase. Please could the manpage and help be updated with this
> wording so users can understand more readily what compare will do?
Both the --help and texinfo was incomplete / confusing.
I've installed the attached to address this.
Marking this as done.
thanks,
Pádraig
[install--compare-clarify.patch (text/x-patch, attachment)]
Information forwarded
to
bug-coreutils <at> gnu.org
:
bug#50889
; Package
coreutils
.
(Thu, 05 May 2022 11:23:01 GMT)
Full text and
rfc822 format available.
Message #13 received at 50889-done <at> debbugs.gnu.org (full text, mbox):
Wonderful, many thanks!
Ian.
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Thu, 02 Jun 2022 11:24:07 GMT)
Full text and
rfc822 format available.
This bug report was last modified 1 year and 323 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.