From unknown Sat Sep 06 04:31:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50889: Please improve the documentation for install --compare (-C) Resent-From: Ian Cross Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Wed, 29 Sep 2021 15:02:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 50889 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 50889@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.163292772027788 (code B ref -1); Wed, 29 Sep 2021 15:02:01 +0000 Received: (at submit) by debbugs.gnu.org; 29 Sep 2021 15:02:00 +0000 Received: from localhost ([127.0.0.1]:49816 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVb5p-0007E2-Q9 for submit@debbugs.gnu.org; Wed, 29 Sep 2021 11:01:59 -0400 Received: from lists.gnu.org ([209.51.188.17]:46488) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVXT5-0006oK-IQ for submit@debbugs.gnu.org; Wed, 29 Sep 2021 07:09:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38164) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVXSz-0003z1-Vb for bug-coreutils@gnu.org; Wed, 29 Sep 2021 07:09:41 -0400 Received: from aibo.runbox.com ([91.220.196.211]:51010) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVXSx-0006pU-6q for bug-coreutils@gnu.org; Wed, 29 Sep 2021 07:09:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=galagic.com ; s=selector2; h=Content-Transfer-Encoding:MIME-Version:Content-Type:Date:To: From:Subject:Message-ID; bh=IWXh4jXy5zRi+s4nYJBWgp+pZ6TCWsLgugtvewcO8Q8=; b=c qiKDBzw+UYCHFIq6wszmhz6bWgd/N4SeXF/zdlwJizSOXMqw5qEYjDblUYuYcspVeb2FFJwFTTp8p 4RXmNkKIkWOLZ+W6UCdsAmcJG2LSwhuyYvQS1tt0JemRqDCz3TYWHXQHr5dS+Ql27p0xpn9byp78x HRSEtMWV9GKVgXPPcwUoVsb2NTUbeSCRXjX2Lonmf9gU0XPDY6w1w1r65mFsUskSZYxYR2AHgBxnP 5gHh3OUjuAAvZipaNrZN8R1pv9GBwa8XNmK6x5dWAgmOth+2d29WQfYGDqVF12Km2HRx0C5XvMwiY 25UhdJd18VeZdPGw6nbLpnARP28bu5/Bw==; Received: from [10.9.9.72] (helo=submission01.runbox) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1mVXSr-0008Bk-UX for bug-coreutils@gnu.org; Wed, 29 Sep 2021 13:09:30 +0200 Received: by submission01.runbox with esmtpsa [Authenticated ID (938040)] (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) id 1mVXSd-0000tl-W0 for bug-coreutils@gnu.org; Wed, 29 Sep 2021 13:09:16 +0200 Message-ID: From: Ian Cross Date: Wed, 29 Sep 2021 12:09:15 +0100 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.40.4 (3.40.4-1.fc34) MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Received-SPF: pass client-ip=91.220.196.211; envelope-from=ian.cross@galagic.com; helo=aibo.runbox.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Mailman-Approved-At: Wed, 29 Sep 2021 11:01:56 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) 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 From unknown Sat Sep 06 04:31:27 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Ian Cross Subject: bug#50889: closed (Re: bug#50889: Please improve the documentation for install --compare (-C)) Message-ID: References: X-Gnu-PR-Message: they-closed 50889 X-Gnu-PR-Package: coreutils Reply-To: 50889@debbugs.gnu.org Date: Sat, 09 Apr 2022 12:07:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1649506022-18173-1" This is a multi-part message in MIME format... ------------=_1649506022-18173-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #50889: Please improve the documentation for install --compare (-C) which was filed against the coreutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 50889@debbugs.gnu.org. --=20 50889: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D50889 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1649506022-18173-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 50889-done) by debbugs.gnu.org; 9 Apr 2022 12:06:38 +0000 Received: from localhost ([127.0.0.1]:36910 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nd9rS-0004iS-0x for submit@debbugs.gnu.org; Sat, 09 Apr 2022 08:06:38 -0400 Received: from mail-wr1-f45.google.com ([209.85.221.45]:34660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nd9rP-0004iG-OG for 50889-done@debbugs.gnu.org; Sat, 09 Apr 2022 08:06:36 -0400 Received: by mail-wr1-f45.google.com with SMTP id m30so16555130wrb.1 for <50889-done@debbugs.gnu.org>; Sat, 09 Apr 2022 05:06:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:message-id:date:mime-version:user-agent:subject :content-language:to:references:from:in-reply-to; bh=EBBgyYB6zvXSvyk1wO9tJqThLn//LvzQJHQwJhexf5o=; b=jBhUBnOcuUd4UsM/5zELjhV+cp9sX3G2J42jQeSjmBH72SVjv3OnsJ/n3ngizKCgm3 IcytgkkD+SziUatRpmr+FAvfrvcBr2NkWDWqoqY4H3emdAVoVy6itPdPniXYqN/C6q7c m+xWbReSQ74CtnTyKNFLwjNWeya4IquD1OdYyCv96ToOYGLNuCcaA2Thv0wFCxvkarpx r2rAJ+jZQqmHK7lEKW+xOo9jTOuxdPB2sUJ5iGCb1+8OxWp4Iy4X8WO9EmyMMbrDSI7p H4jT8X5j5BbQcrDu4SAWwyvaNsdLReOC5/dsRjX0+mnHsk8tkMN0lQtaLD6ngDG+cYFJ UmJQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:message-id:date:mime-version:user-agent :subject:content-language:to:references:from:in-reply-to; bh=EBBgyYB6zvXSvyk1wO9tJqThLn//LvzQJHQwJhexf5o=; b=Irwh966SUgAb0sU/hzKReLdLA+4RTiwZqipCuzU8G7LQvIz4shfJX+Gtxx4B2blAqH aZBN68cI6749D8aJ6wtGo4ZeOPI+SM800VgHhyiX9EjTQZ5n/zKOlDAlS9MYm629q9J0 sKhTNoWg0bBIbTktWsIlDUXWO+XmfJZF71TfQsFWYE6tJd56G5q7Zt4X5fJ1r8/pcoYD rwkhrZgdEcT5HNeZ/6512fpVJwYOT266UTvc1gLJ9cen/eBBW3NucgkehWfedTdKWTDS ihq8NFovWm1IxYWge4iiSnBN/RVS+r0s9O4wMSwnAvbFUDeUzghNCtpklhU4zbDsKX5/ HX8A== X-Gm-Message-State: AOAM532AdbLMTywU93DkDCfmb/KDzcgOkBmm9RD2rMRPyA5bR2RyW+SP CK6IpkOq+5nTP8HgVxbnAwY= X-Google-Smtp-Source: ABdhPJx+mzUhQPWF1Y47x7bQ5YkcwwpgOpoxoYl+VC5S+BE9m3+pFSlryZAb5QCHqFwR7Rs3Z5h3vw== X-Received: by 2002:a05:6000:1868:b0:204:1e4f:7f9a with SMTP id d8-20020a056000186800b002041e4f7f9amr18172620wri.106.1649505989940; Sat, 09 Apr 2022 05:06:29 -0700 (PDT) Received: from [192.168.1.9] (95-44-90-175-dynamic.agg2.lod.rsl-rtd.eircom.net. [95.44.90.175]) by smtp.googlemail.com with ESMTPSA id r16-20020a7bc090000000b0038e73023334sm11464465wmh.2.2022.04.09.05.06.28 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 09 Apr 2022 05:06:29 -0700 (PDT) Content-Type: multipart/mixed; boundary="------------ZS9D202U2OurBuPzI5OztUia" Message-ID: Date: Sat, 9 Apr 2022 13:06:28 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:97.0) Gecko/20100101 Thunderbird/97.0 Subject: Re: bug#50889: Please improve the documentation for install --compare (-C) Content-Language: en-US To: Ian Cross , 50889-done@debbugs.gnu.org References: From: =?UTF-8?Q?P=c3=a1draig_Brady?= In-Reply-To: X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 50889-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) This is a multi-part message in MIME format. --------------ZS9D202U2OurBuPzI5OztUia Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit 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 --------------ZS9D202U2OurBuPzI5OztUia Content-Type: text/x-patch; charset=UTF-8; name="install--compare-clarify.patch" Content-Disposition: attachment; filename="install--compare-clarify.patch" Content-Transfer-Encoding: base64 RnJvbSA2ZDI0NmZiNjhiN2Q4ZmNkNmU3YjNkYTg4YmQ3ODZiMzA1ZjQwZjMyIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiA9P1VURi04P3E/UD1DMz1BMWRyYWlnPTIwQnJhZHk/ PSA8UEBkcmFpZ0JyYWR5LmNvbT4KRGF0ZTogU2F0LCA5IEFwciAyMDIyIDEyOjQyOjM3ICsw MTAwClN1YmplY3Q6IFtQQVRDSF0gZG9jOiBpbnN0YWxsIC0tY29tcGFyZTogY2xhcmlmeSBt b2RlIG9mIG9wZXJhdGlvbgoKKiBkb2MvY29yZXV0aWxzLnRleGkgKGluc3RhbGwgaW52b2Nh dGlvbik6IEZvciB0aGUgLS1jb21wYXJlIG9wdGlvbiwKY2xhcmlmeSB0aGF0IHRoZSBvd25l cnNoaXAgb3IgcGVybWlzc2lvbnMgb2YgdGhlIHNvdXJjZSBmaWxlcyBkb24ndAptYXR0ZXIu ICBBbHNvIGRvbid0IGltcGx5IC0tb3duZXIgb3IgLS1ncm91cCBuZWVkIHRvIGJlIHNwZWNp ZmllZApmb3IgLS1jb21wYXJlIHRvIGJlIGVmZmVjdGl2ZS4KKiBzcmMvaW5zdGFsbC5jICh1 c2FnZSk6IEFkZCBtb3JlIGRldGFpbCBvbiB3aGF0J3MgYmVpbmcgY29tcGFyZWQuCi0tLQog ZG9jL2NvcmV1dGlscy50ZXhpIHwgNCArKy0tCiBzcmMvaW5zdGFsbC5jICAgICAgfCA1ICsr Ky0tCiAyIGZpbGVzIGNoYW5nZWQsIDUgaW5zZXJ0aW9ucygrKSwgNCBkZWxldGlvbnMoLSkK CmRpZmYgLS1naXQgYS9kb2MvY29yZXV0aWxzLnRleGkgYi9kb2MvY29yZXV0aWxzLnRleGkK aW5kZXggYzkyNDNjNjgzLi44Y2ZhNjk4YTEgMTAwNjQ0Ci0tLSBhL2RvYy9jb3JldXRpbHMu dGV4aQorKysgYi9kb2MvY29yZXV0aWxzLnRleGkKQEAgLTk3OTYsOCArOTc5Niw4IEBAIFRo ZSBwcm9ncmFtIGFjY2VwdHMgdGhlIGZvbGxvd2luZyBvcHRpb25zLiAgQWxzbyBzZWUgQHJl ZntDb21tb24gb3B0aW9uc30uCiBAaXRlbXggLS1jb21wYXJlCiBAb3BpbmRleCAtQwogQG9w aW5kZXggLS1jb21wYXJlCi1Db21wYXJlIGVhY2ggcGFpciBvZiBzb3VyY2UgYW5kIGRlc3Rp bmF0aW9uIGZpbGVzLCBhbmQgaWYgdGhlIGRlc3RpbmF0aW9uIGhhcwotaWRlbnRpY2FsIGNv bnRlbnQgYW5kIGFueSBzcGVjaWZpZWQgb3duZXIsIGdyb3VwLCBwZXJtaXNzaW9ucywgYW5k IHBvc3NpYmx5CitDb21wYXJlIGNvbnRlbnQgb2Ygc291cmNlIGFuZCBkZXN0aW5hdGlvbiBm aWxlcywgYW5kIGlmIHRoZXJlIHdvdWxkIGJlIG5vCitjaGFuZ2UgdG8gdGhlIGRlc3RpbmF0 aW9uIGNvbnRlbnQsIG93bmVyLCBncm91cCwgcGVybWlzc2lvbnMsIGFuZCBwb3NzaWJseQog U0VMaW51eCBjb250ZXh0LCB0aGVuIGRvIG5vdCBtb2RpZnkgdGhlIGRlc3RpbmF0aW9uIGF0 IGFsbC4KIE5vdGUgdGhpcyBvcHRpb24gaXMgYmVzdCB1c2VkIGluIGNvbmp1bmN0aW9uIHdp dGggQG9wdGlvbnstLXVzZXJ9LAogQG9wdGlvbnstLWdyb3VwfSBhbmQgQG9wdGlvbnstLW1v ZGV9IG9wdGlvbnMsIGxlc3QgQGNvbW1hbmR7aW5zdGFsbH0KZGlmZiAtLWdpdCBhL3NyYy9p bnN0YWxsLmMgYi9zcmMvaW5zdGFsbC5jCmluZGV4IDU3YTg3N2Y0YS4uMDc5Y2UxZjcwIDEw MDY0NAotLS0gYS9zcmMvaW5zdGFsbC5jCisrKyBiL3NyYy9pbnN0YWxsLmMKQEAgLTU5Miw4 ICs1OTIsOSBAQCBJbiB0aGUgNHRoIGZvcm0sIGNyZWF0ZSBhbGwgY29tcG9uZW50cyBvZiB0 aGUgZ2l2ZW4gRElSRUNUT1JZKGllcykuXG5cCiAgICAgICAtLWJhY2t1cFs9Q09OVFJPTF0g IG1ha2UgYSBiYWNrdXAgb2YgZWFjaCBleGlzdGluZyBkZXN0aW5hdGlvbiBmaWxlXG5cCiAg IC1iICAgICAgICAgICAgICAgICAgbGlrZSAtLWJhY2t1cCBidXQgZG9lcyBub3QgYWNjZXB0 IGFuIGFyZ3VtZW50XG5cCiAgIC1jICAgICAgICAgICAgICAgICAgKGlnbm9yZWQpXG5cCi0g IC1DLCAtLWNvbXBhcmUgICAgICAgY29tcGFyZSBlYWNoIHBhaXIgb2Ygc291cmNlIGFuZCBk ZXN0aW5hdGlvbiBmaWxlcywgYW5kXG5cCi0gICAgICAgICAgICAgICAgICAgICAgICBpbiBz b21lIGNhc2VzLCBkbyBub3QgbW9kaWZ5IHRoZSBkZXN0aW5hdGlvbiBhdCBhbGxcblwKKyAg LUMsIC0tY29tcGFyZSAgICAgICBjb21wYXJlIGNvbnRlbnQgb2Ygc291cmNlIGFuZCBkZXN0 aW5hdGlvbiBmaWxlcywgYW5kXG5cCisgICAgICAgICAgICAgICAgICAgICAgICBpZiBubyBj aGFuZ2UgdG8gY29udGVudCwgb3duZXJzaGlwLCBhbmQgcGVybWlzc2lvbnMsXG5cCisgICAg ICAgICAgICAgICAgICAgICAgICBkbyBub3QgbW9kaWZ5IHRoZSBkZXN0aW5hdGlvbiBhdCBh bGxcblwKICAgLWQsIC0tZGlyZWN0b3J5ICAgICB0cmVhdCBhbGwgYXJndW1lbnRzIGFzIGRp cmVjdG9yeSBuYW1lczsgY3JlYXRlIGFsbFxuXAogICAgICAgICAgICAgICAgICAgICAgICAg Y29tcG9uZW50cyBvZiB0aGUgc3BlY2lmaWVkIGRpcmVjdG9yaWVzXG5cCiAiKSwgc3Rkb3V0 KTsKLS0gCjIuMjYuMgoK --------------ZS9D202U2OurBuPzI5OztUia-- ------------=_1649506022-18173-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 29 Sep 2021 15:02:00 +0000 Received: from localhost ([127.0.0.1]:49816 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVb5p-0007E2-Q9 for submit@debbugs.gnu.org; Wed, 29 Sep 2021 11:01:59 -0400 Received: from lists.gnu.org ([209.51.188.17]:46488) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVXT5-0006oK-IQ for submit@debbugs.gnu.org; Wed, 29 Sep 2021 07:09:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38164) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVXSz-0003z1-Vb for bug-coreutils@gnu.org; Wed, 29 Sep 2021 07:09:41 -0400 Received: from aibo.runbox.com ([91.220.196.211]:51010) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVXSx-0006pU-6q for bug-coreutils@gnu.org; Wed, 29 Sep 2021 07:09:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=galagic.com ; s=selector2; h=Content-Transfer-Encoding:MIME-Version:Content-Type:Date:To: From:Subject:Message-ID; bh=IWXh4jXy5zRi+s4nYJBWgp+pZ6TCWsLgugtvewcO8Q8=; b=c qiKDBzw+UYCHFIq6wszmhz6bWgd/N4SeXF/zdlwJizSOXMqw5qEYjDblUYuYcspVeb2FFJwFTTp8p 4RXmNkKIkWOLZ+W6UCdsAmcJG2LSwhuyYvQS1tt0JemRqDCz3TYWHXQHr5dS+Ql27p0xpn9byp78x HRSEtMWV9GKVgXPPcwUoVsb2NTUbeSCRXjX2Lonmf9gU0XPDY6w1w1r65mFsUskSZYxYR2AHgBxnP 5gHh3OUjuAAvZipaNrZN8R1pv9GBwa8XNmK6x5dWAgmOth+2d29WQfYGDqVF12Km2HRx0C5XvMwiY 25UhdJd18VeZdPGw6nbLpnARP28bu5/Bw==; Received: from [10.9.9.72] (helo=submission01.runbox) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1mVXSr-0008Bk-UX for bug-coreutils@gnu.org; Wed, 29 Sep 2021 13:09:30 +0200 Received: by submission01.runbox with esmtpsa [Authenticated ID (938040)] (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) id 1mVXSd-0000tl-W0 for bug-coreutils@gnu.org; Wed, 29 Sep 2021 13:09:16 +0200 Message-ID: Subject: Please improve the documentation for install --compare (-C) From: Ian Cross To: bug-coreutils@gnu.org Date: Wed, 29 Sep 2021 12:09:15 +0100 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.40.4 (3.40.4-1.fc34) MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Received-SPF: pass client-ip=91.220.196.211; envelope-from=ian.cross@galagic.com; helo=aibo.runbox.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Wed, 29 Sep 2021 11:01:56 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) 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 ------------=_1649506022-18173-1-- From unknown Sat Sep 06 04:31:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50889: Please improve the documentation for install --compare (-C) Resent-From: Ian Cross Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Thu, 05 May 2022 11:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50889 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: =?UTF-8?Q?P=C3=A1draig?= Brady , 50889-done@debbugs.gnu.org Received: via spool by 50889-done@debbugs.gnu.org id=D50889.165174975726554 (code D ref 50889); Thu, 05 May 2022 11:23:01 +0000 Received: (at 50889-done) by debbugs.gnu.org; 5 May 2022 11:22:37 +0000 Received: from localhost ([127.0.0.1]:44558 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nmZZ6-0006uE-Sk for submit@debbugs.gnu.org; Thu, 05 May 2022 07:22:37 -0400 Received: from mailtransmit05.runbox.com ([185.226.149.38]:45432) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nmZZ4-0006tx-Ll for 50889-done@debbugs.gnu.org; Thu, 05 May 2022 07:22:35 -0400 Received: from mailtransmit02.runbox ([10.9.9.162] helo=aibo.runbox.com) by mailtransmit05.runbox.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1nmZYx-000BQE-J5 for 50889-done@debbugs.gnu.org; Thu, 05 May 2022 13:22:27 +0200 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=galagic.com ; s=selector2; h=Content-Transfer-Encoding:MIME-Version:Content-Type: References:In-Reply-To:Date:To:From:Subject:Message-ID; bh=LRwPOZmpyE4cH4C7AqmFK7uC3AEIW4rwLzUgzmWLLl0=; b=CbtVuOqI1abl3fRZoEl23pseJg dKyFVLIPL7ortjatGi//4CxcD9RIE0qcEYzj2CKm7ssg2/bOCXRm0FtakiaoZtXWdYU62kzUChFUg 0yY3Gwvyc0ISxmB+X32Pc+UpOHVtIfS4GmAxG94js7oxlaLFTrPV7nKCP8qdRxPTT8bAq3hfWPuwC GbaeSVld44u+P0wGobU/53E141cz3s4wnUDhTIB5abd8HKzEs8Lmx5HeABTqtYMJSSJ825LdmgtHp ELvJIqAHfbLKVEx5RjGAakMsYTPfkdTgQ+uo2RbxEB5DIgVa81HeB4Vx8zx63Dmz9DzsKadkKH+4C jRGWuWxw==; Received: from [10.9.9.72] (helo=submission01.runbox) by mailtransmit02.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1nmZYx-00028O-2y; Thu, 05 May 2022 13:22:27 +0200 Received: by submission01.runbox with esmtpsa [Authenticated ID (938040)] (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) id 1nmZYg-0007RF-0b; Thu, 05 May 2022 13:22:10 +0200 Message-ID: <6dc999bc6b9e565e64a14067ea2abcc0e4870608.camel@galagic.com> From: Ian Cross Date: Thu, 05 May 2022 12:22:04 +0100 In-Reply-To: References: Content-Type: text/plain User-Agent: Evolution 3.40.4 (3.40.4-5.fc34) MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Wonderful, many thanks! Ian.