From unknown Sun Jun 22 00:57:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#52782: Man Page: Incorrect Summary of --color Option Resent-From: Pranab Lawrence Ekka Dasgupta Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Fri, 24 Dec 2021 17:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52782 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 52782@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.164036608311784 (code B ref -1); Fri, 24 Dec 2021 17:15:02 +0000 Received: (at submit) by debbugs.gnu.org; 24 Dec 2021 17:14:43 +0000 Received: from localhost ([127.0.0.1]:37977 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0o9T-000340-J9 for submit@debbugs.gnu.org; Fri, 24 Dec 2021 12:14:43 -0500 Received: from lists.gnu.org ([209.51.188.17]:44892) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0mEi-0006fg-RZ for submit@debbugs.gnu.org; Fri, 24 Dec 2021 10:12:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:57580) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n0mEi-0000ay-M6 for bug-coreutils@gnu.org; Fri, 24 Dec 2021 10:12:00 -0500 Received: from [2607:f8b0:4864:20::b35] (port=39860 helo=mail-yb1-xb35.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n0mEf-0007av-Tw for bug-coreutils@gnu.org; Fri, 24 Dec 2021 10:12:00 -0500 Received: by mail-yb1-xb35.google.com with SMTP id d1so3420206ybh.6 for ; Fri, 24 Dec 2021 07:11:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=rCsOAz9t2WbnM6FuS12BeBV+mTOapuUaJONg92onZO0=; b=hZxq8+TxDljrQp7hFZjqk3Eig1CVJpsM8QfFk63b1NVfjukOoQbL+5yeRo4WnzxFf1 g8K2vsgqPkxuw4WxqinAaO/SmKgFnhIOcmAkv6vTE4kBL1c0QB5CkWLb7uGCujJ0JYAv EKwE/2VkmzC3RNA6yCtsuuY/CUE1U/hJbMlB94tXjBGYzzL0eIYNwMwY+15ybSckzngu G7MTyGdQNRqUUEXXpyyzmQpbeLei2R/vNkUYjmodcAQVWIWy/9OQXTjHfwUlbjMLrq92 1+vyLJQBeACMXImT6cBpmjoK6jKUptTQOQuhWRFqk2UzbILmFVwlBU7p2o2mQoynvuoZ 54Xg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=rCsOAz9t2WbnM6FuS12BeBV+mTOapuUaJONg92onZO0=; b=Qp3IJMQnD32kQnVe3BkZSCefh6foBhVUG3GjMWZpwtuINN1/nJz/oroLtV1gjXziOV IEK/UVyipswKBuUOo89ActLk7CWeEjgNDXvHa4uW8xk7ZIzDLZ7yHe+2uUhAKrZlb9aH /Fhqt+GF07bxVhGT5r2ojmGhhnSw9icroZY+Gvf5q0HVuBHSfEcaXCKMqPv2i8N/rX+u PsDikwvFRj6cL3a0cV4pwha5AHZ8ngHm+nNUzyFF65Rfn73e5twAMueKYF/+v0B7IHl2 VkMAgmEoRwT4KGeqRVanSjBf5ixVlIlX0NXpj9mOcvHQ7cztuYrE9tRJb4Ir0PsCyrE3 XWFw== X-Gm-Message-State: AOAM533drrTim1sRNqOvb9lblG2Q8rAUhAem7YmCbb7jhdDNdD3ja4Yl 3uSOB6LqMzGVvZWgn3idb7fyWO1ZlQc1kE3GAkUFpIhGTXc9s/7g X-Google-Smtp-Source: ABdhPJzQEBPN9DlxAkOX7IRQsVbMGD9UuQP1B2Q3DPQThCmCISj5PuHzGHMHi1dGv87TXUkNEI/pKEaQMN1tDPJw1Eo= X-Received: by 2002:a05:6902:1350:: with SMTP id g16mr9555833ybu.202.1640358716456; Fri, 24 Dec 2021 07:11:56 -0800 (PST) MIME-Version: 1.0 From: Pranab Lawrence Ekka Dasgupta Date: Fri, 24 Dec 2021 20:41:45 +0530 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::b35 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::b35; envelope-from=pranabekka@gmail.com; helo=mail-yb1-xb35.google.com X-Spam_score_int: 14 X-Spam_score: 1.4 X-Spam_bar: + X-Spam_report: (1.4 / 5.0 requ) BAYES_50=0.8, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: -0.0 (/) X-Mailman-Approved-At: Fri, 24 Dec 2021 12:14:42 -0500 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.3 (--) Version Information ls/coreutils: 8.32 Distribution: Pop_OS! 20.10 The summary of the `--color` option incorrectly states that the default option is 'always', whereas it functions otherwise and the information at the bottom of the man page suggests that the default is 'never'. This error persists in online manual pages and in other distributions >From the manual page: --- --color[=WHEN] colorize the output; WHEN can be 'always' (default if omitted), 'auto', or 'never'; more info below ... Using color to distinguish file types is disabled both by default and with --color=never. With --color=auto, ls emits color codes only when --- Thanks and Regards, Pranab Dasgupta From unknown Sun Jun 22 00:57:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#52782: Man Page: Incorrect Summary of --color Option Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Fri, 24 Dec 2021 17:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52782 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: Pranab Lawrence Ekka Dasgupta , 52782@debbugs.gnu.org Received: via spool by 52782-submit@debbugs.gnu.org id=B52782.164036837817350 (code B ref 52782); Fri, 24 Dec 2021 17:53:01 +0000 Received: (at 52782) by debbugs.gnu.org; 24 Dec 2021 17:52:58 +0000 Received: from localhost ([127.0.0.1]:37998 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0okO-0004Vb-8I for submit@debbugs.gnu.org; Fri, 24 Dec 2021 12:52:58 -0500 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:40666) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0okK-0004VG-MU for 52782@debbugs.gnu.org; Fri, 24 Dec 2021 12:52:50 -0500 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C50A01600FD; Fri, 24 Dec 2021 09:52:42 -0800 (PST) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id ZTaRd0Da-m4b; Fri, 24 Dec 2021 09:52:41 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 33B0E16014B; Fri, 24 Dec 2021 09:52:41 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id WNi0v05D7ofP; Fri, 24 Dec 2021 09:52:41 -0800 (PST) Received: from [192.168.1.9] (cpe-172-91-119-151.socal.res.rr.com [172.91.119.151]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id E7F90160151; Fri, 24 Dec 2021 09:52:40 -0800 (PST) Content-Type: multipart/mixed; boundary="------------VLjN17BIlkneHEesd9mItLD3" Message-ID: <1e6bae3a-8d36-69cb-2d42-d56c59a31829@cs.ucla.edu> Date: Fri, 24 Dec 2021 09:52:40 -0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1 Content-Language: en-US References: From: Paul Eggert Organization: UCLA Computer Science Department In-Reply-To: X-Spam-Score: -2.4 (--) 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.1 (-) This is a multi-part message in MIME format. --------------VLjN17BIlkneHEesd9mItLD3 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 12/24/21 07:11, Pranab Lawrence Ekka Dasgupta wrote: > The summary of the `--color` option incorrectly states that the default > option is 'always', whereas it functions otherwise It sounds like you misunderstood the man page. It says that --color[=WHEN] means "colorize the output; WHEN can be 'always' (default if omitted), 'auto', or 'never'". The phrase "if omitted" refers to when you use plain "--colorize", not to when you don't use "--colorize" at all. The same wording is used to document --classify[=WHEN], --hyperlink[=WHEN]. I suppose we could reword the man page to avoid this potential confusion in --color, --classify and --hyperlink. However, I don't see how to do that without adding so much wording that the cost would likely exceed the benefit. Perhaps some other wordsmith could chip in. In the meantime I noticed that the documentation uses the word "colorize" when it should say "color", so I installed the attached. --------------VLjN17BIlkneHEesd9mItLD3 Content-Type: text/x-patch; charset=UTF-8; name="0001-doc-colorize-color.patch" Content-Disposition: attachment; filename="0001-doc-colorize-color.patch" Content-Transfer-Encoding: base64 RnJvbSAyYjMwMzEyZjc3Zjk5ZWZjOGM1NjgwNDQyNGM0YTMxN2UyNTk1M2YxIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1 PgpEYXRlOiBGcmksIDI0IERlYyAyMDIxIDA5OjQ3OjE4IC0wODAwClN1YmplY3Q6IFtQQVRD SF0gZG9jOiBjb2xvcml6ZSAtPiBjb2xvcgoKTGl2aW5nIHNvIGNsb3NlIHRvIEhvbGx5d29v ZCBJIGtub3cgdGhhdCAiY29sb3JpemUiCm1lYW5zIGFkZGluZyBjb2xvciB0byBzb21ldGhp bmcgdGhhdCB3YXMgYWxyZWFkeSBtb25vY2hyb21lLAp3aGVyZWFzICJjb2xvciIgbWVhbnMg dG8gZ2l2ZSBjb2xvciB0byBzb21ldGhpbmcuCkNvcmV1dGlscyBhcHBzIGNvbG9yIHRleHQg aW5zdGVhZCBvZiBjb2xvcml6aW5nIGl0LgotLS0KIE5FV1MgICAgICAgICAgICAgICAgICAg ICAgICAgICB8IDIgKy0KIGNmZy5tayAgICAgICAgICAgICAgICAgICAgICAgICB8IDIgKy0K IGRvYy9jb3JldXRpbHMudGV4aSAgICAgICAgICAgICB8IDIgKy0KIHNyYy9kaXJjb2xvcnMu aGluICAgICAgICAgICAgICB8IDYgKysrLS0tCiBzcmMvbHMuYyAgICAgICAgICAgICAgICAg ICAgICAgfCA0ICsrLS0KIHRlc3RzL2xzL2NhcGFiaWxpdHkuc2ggICAgICAgICB8IDIgKy0K IHRlc3RzL2xzL2NvbG9yLWV4dC5zaCAgICAgICAgICB8IDIgKy0KIHRlc3RzL2xzL2NvbG9y LW5vcm0uc2ggICAgICAgICB8IDIgKy0KIHRlc3RzL2xzL211bHRpaGFyZGxpbmsuc2ggICAg ICB8IDIgKy0KIHRlc3RzL2xzL3N0YXQtZnJlZS1zeW1saW5rcy5zaCB8IDIgKy0KIDEwIGZp bGVzIGNoYW5nZWQsIDEzIGluc2VydGlvbnMoKyksIDEzIGRlbGV0aW9ucygtKQoKZGlmZiAt LWdpdCBhL05FV1MgYi9ORVdTCmluZGV4IGM4ZThiZGMxNi4uODExZTI3ZTNhIDEwMDY0NAot LS0gYS9ORVdTCisrKyBiL05FV1MKQEAgLTMwNjMsNyArMzA2Myw3IEBAIEdOVSBjb3JldXRp bHMgTkVXUyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIC0qLSBvdXRsaW5l IC0qLQogICBpbnN0YWxsIGFjY2VwdHMgYSBuZXcgb3B0aW9uIC0tc3RyaXAtcHJvZ3JhbSB0 byBzcGVjaWZ5IHRoZSBwcm9ncmFtIHVzZWQgdG8KICAgc3RyaXAgYmluYXJpZXMuCiAKLSAg bHMgbm93IGNvbG9yaXplcyBmaWxlcyB3aXRoIGNhcGFiaWxpdGllcyBpZiBsaWJjYXAgaXMg YXZhaWxhYmxlCisgIGxzIG5vdyBjb2xvcnMgbmFtZXMgb2YgZmlsZXMgd2l0aCBjYXBhYmls aXRpZXMgaWYgbGliY2FwIGlzIGF2YWlsYWJsZS4KIAogICBscyAtdiBub3cgdXNlcyBmaWxl dmVyY21wIGZ1bmN0aW9uIGFzIHNvcnQgcHJlZGljYXRlIChpbnN0ZWFkIG9mIHN0cnZlcnNj bXApCiAKZGlmZiAtLWdpdCBhL2NmZy5tayBiL2NmZy5tawppbmRleCA2ZDZjMzdkYzIuLjA0 NmYxNDE2NyAxMDA2NDQKLS0tIGEvY2ZnLm1rCisrKyBiL2NmZy5tawpAQCAtNDksNyArNDks NyBAQCBleHBvcnQgVkVSQk9TRSA9IHllcwogIyA0OTE0MTUyIDllCiBleHBvcnQgWFpfT1BU ID0gLThlCiAKLW9sZF9ORVdTX2hhc2ggPSA0ZDE3NjUxZTIzMThhMDE2ODdhMWYwZmRjYTkx NzdlNQorb2xkX05FV1NfaGFzaCA9IDYxMmJhZDYyNmJmMjhiMTg0N2FkMDExNGNiMmNkNmZl CiAKICMgQWRkIGFuIGV4ZW1wdGlvbiBmb3Igc2NfbWFrZWZpbGVfYXRfYXRfY2hlY2suCiBf bWFrZWZpbGVfYXRfYXRfY2hlY2tfZXhjZXB0aW9ucyA9ICcgJiYgIS9eY3VfaW5zdGFsbF9w cm9nLyAmJiAhL2R5bmFtaWMtZGVwLycKZGlmZiAtLWdpdCBhL2RvYy9jb3JldXRpbHMudGV4 aSBiL2RvYy9jb3JldXRpbHMudGV4aQppbmRleCA2MDY4ZDhiMDguLmY3Y2UxNjU0YiAxMDA2 NDQKLS0tIGEvZG9jL2NvcmV1dGlscy50ZXhpCisrKyBiL2RvYy9jb3JldXRpbHMudGV4aQpA QCAtODEwOSw3ICs4MTA5LDcgQEAgbWF5IGJlIG9taXR0ZWQsIG9yIG9uZSBvZjoKIEBlbmQg aXRlbWl6ZQogU3BlY2lmeWluZyBAb3B0aW9uey0tY29sb3J9IGFuZCBubyBAdmFye3doZW59 IGlzIGVxdWl2YWxlbnQgdG8KIEBvcHRpb257LS1jb2xvcj1hbHdheXN9LgotSWYgcGlwaW5n IGEgY29sb3JpemVkIGxpc3RpbmcgdGhyb3VnaCBhIHBhZ2VyIGxpa2UgQGNvbW1hbmR7bGVz c30sCitJZiBwaXBpbmcgYSBjb2xvcmVkIGxpc3RpbmcgdGhyb3VnaCBhIHBhZ2VyIGxpa2Ug QGNvbW1hbmR7bGVzc30sCiB1c2UgdGhlIHBhZ2VyJ3MgQG9wdGlvbnstUn0gb3B0aW9uIHRv IHBhc3MgdGhlIGNvbG9yIGNvZGVzIHRvIHRoZSB0ZXJtaW5hbC4KIAogQHZpbmRleCBMU19D T0xPUlMKZGlmZiAtLWdpdCBhL3NyYy9kaXJjb2xvcnMuaGluIGIvc3JjL2RpcmNvbG9ycy5o aW4KaW5kZXggYjVkNjQ1MmQ3Li5kODZlMDA4OGYgMTAwNjQ0Ci0tLSBhL3NyYy9kaXJjb2xv cnMuaGluCisrKyBiL3NyYy9kaXJjb2xvcnMuaGluCkBAIC05LDcgKzksNyBAQAogIyBzbGFj a3dhcmUgdmVyc2lvbiBvZiBkaXJjb2xvcnMpIGFyZSByZWNvZ25pemVkIGJ1dCBpZ25vcmVk LgogCiAjIEJlbG93IGFyZSBURVJNIGVudHJpZXMsIHdoaWNoIGNhbiBiZSBhIGdsb2IgcGF0 dGVybnMsIHRvIG1hdGNoCi0jIGFnYWluc3QgdGhlIFRFUk0gZW52aXJvbm1lbnQgdmFyaWFi bGUgdG8gZGV0ZXJtaW5lIGlmIGl0IGlzIGNvbG9yaXphYmxlLgorIyBhZ2FpbnN0IHRoZSBU RVJNIGVudmlyb25tZW50IHZhcmlhYmxlIHRvIGRldGVybWluZSBpZiBpdCBpcyBjb2xvcmFi bGUuCiBURVJNIEV0ZXJtCiBURVJNIGFuc2kKIFRFUk0gKmNvbG9yKgpAQCAtNzEsNyArNzEs NyBAQCBTVElDS1kgMzc7NDQJIyBkaXIgd2l0aCB0aGUgc3RpY2t5IGJpdCBzZXQgKCt0KSBh bmQgbm90IG90aGVyLXdyaXRhYmxlCiBFWEVDIDAxOzMyCiAKICMgTGlzdCBhbnkgZmlsZSBl eHRlbnNpb25zIGxpa2UgJy5neicgb3IgJy50YXInIHRoYXQgeW91IHdvdWxkIGxpa2UgbHMK LSMgdG8gY29sb3JpemUgYmVsb3cuIFB1dCB0aGUgZXh0ZW5zaW9uLCBhIHNwYWNlLCBhbmQg dGhlIGNvbG9yIGluaXQgc3RyaW5nLgorIyB0byBjb2xvciBiZWxvdy4gUHV0IHRoZSBleHRl bnNpb24sIGEgc3BhY2UsIGFuZCB0aGUgY29sb3IgaW5pdCBzdHJpbmcuCiAjIChhbmQgYW55 IGNvbW1lbnRzIHlvdSB3YW50IHRvIGFkZCBhZnRlciBhICcjJykKIAogIyBJZiB5b3UgdXNl IERPUy1zdHlsZSBzdWZmaXhlcywgeW91IG1heSB3YW50IHRvIHVuY29tbWVudCB0aGUgZm9s bG93aW5nOgpAQCAtODAsNyArODAsNyBAQCBFWEVDIDAxOzMyCiAjLmNvbSAwMTszMgogIy5i dG0gMDE7MzIKICMuYmF0IDAxOzMyCi0jIE9yIGlmIHlvdSB3YW50IHRvIGNvbG9yaXplIHNj cmlwdHMgZXZlbiBpZiB0aGV5IGRvIG5vdCBoYXZlIHRoZQorIyBPciBpZiB5b3Ugd2FudCB0 byBjb2xvciBzY3JpcHRzIGV2ZW4gaWYgdGhleSBkbyBub3QgaGF2ZSB0aGUKICMgZXhlY3V0 YWJsZSBiaXQgYWN0dWFsbHkgc2V0LgogIy5zaCAgMDE7MzIKICMuY3NoIDAxOzMyCmRpZmYg LS1naXQgYS9zcmMvbHMuYyBiL3NyYy9scy5jCmluZGV4IDZlODdhZjY1MS4uYzM1MDc4N2I2 IDEwMDY0NAotLS0gYS9zcmMvbHMuYworKysgYi9zcmMvbHMuYwpAQCAtMzYxLDcgKzM2MSw3 IEBAIHN0YXRpYyBib29sIGNvbG9yX3N5bWxpbmtfYXNfcmVmZXJlbnQ7CiAKIHN0YXRpYyBj aGFyIGNvbnN0ICpob3N0bmFtZTsKIAotLyogbW9kZSBvZiBhcHByb3ByaWF0ZSBmaWxlIGZv ciBjb2xvcml6YXRpb24gKi8KKy8qIE1vZGUgb2YgYXBwcm9wcmlhdGUgZmlsZSBmb3IgY29s b3JpbmcuICAqLwogc3RhdGljIG1vZGVfdAogZmlsZV9vcl9saW5rX21vZGUgKHN0cnVjdCBm aWxlaW5mbyBjb25zdCAqZmlsZSkKIHsKQEAgLTU0MjQsNyArNTQyNCw3IEBAIFNvcnQgZW50 cmllcyBhbHBoYWJldGljYWxseSBpZiBub25lIG9mIC1jZnR1dlNVWCBub3IgLS1zb3J0IGlz IHNwZWNpZmllZC5cblwKICIpLCBzdGRvdXQpOwogICAgICAgZnB1dHMgKF8oIlwKICAgLUMg ICAgICAgICAgICAgICAgICAgICAgICAgbGlzdCBlbnRyaWVzIGJ5IGNvbHVtbnNcblwKLSAg ICAgIC0tY29sb3JbPVdIRU5dICAgICAgICAgY29sb3JpemUgdGhlIG91dHB1dDsgV0hFTiBj YW4gYmUgJ2Fsd2F5cycgKGRlZmF1bHRcCisgICAgICAtLWNvbG9yWz1XSEVOXSAgICAgICAg IGNvbG9yIHRoZSBvdXRwdXQ7IFdIRU4gY2FuIGJlICdhbHdheXMnIChkZWZhdWx0XAogXG5c CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgaWYgb21pdHRlZCksICdhdXRvJywg b3IgJ25ldmVyJzsgbW9yZSBpbmZvIGJlbG93XAogXG5cCmRpZmYgLS1naXQgYS90ZXN0cy9s cy9jYXBhYmlsaXR5LnNoIGIvdGVzdHMvbHMvY2FwYWJpbGl0eS5zaAppbmRleCAwODg2ZjUw YmYuLjVjNTUzMmRlZSAxMDA3NTUKLS0tIGEvdGVzdHMvbHMvY2FwYWJpbGl0eS5zaAorKysg Yi90ZXN0cy9scy9jYXBhYmlsaXR5LnNoCkBAIC0xLDUgKzEsNSBAQAogIyEvYmluL3NoCi0j IEVuc3VyZSAibHMgLS1jb2xvciIgcHJvcGVybHkgY29sb3JpemVzIGZpbGUgd2l0aCBjYXBh YmlsaXR5LgorIyBFbnN1cmUgImxzIC0tY29sb3IiIHByb3Blcmx5IGNvbG9ycyBuYW1lIG9m IGZpbGUgd2l0aCBjYXBhYmlsaXR5LgogCiAjIENvcHlyaWdodCAoQykgMjAwOC0yMDIxIEZy ZWUgU29mdHdhcmUgRm91bmRhdGlvbiwgSW5jLgogCmRpZmYgLS1naXQgYS90ZXN0cy9scy9j b2xvci1leHQuc2ggYi90ZXN0cy9scy9jb2xvci1leHQuc2gKaW5kZXggNWZhOGM1ZGRmLi5i MzZiMDAzNDUgMTAwNzU1Ci0tLSBhL3Rlc3RzL2xzL2NvbG9yLWV4dC5zaAorKysgYi90ZXN0 cy9scy9jb2xvci1leHQuc2gKQEAgLTEsNSArMSw1IEBACiAjIS9iaW4vc2gKLSMgRW5zdXJl ICJscyAtLWNvbG9yIiBwcm9wZXJseSBjb2xvcml6ZXMgZmlsZSBleHRlbnNpb25zCisjIEVu c3VyZSAibHMgLS1jb2xvciIgcHJvcGVybHkgY29sb3JzIGZpbGUgbmFtZSBleHRlbnNpb25z LgogCiAjIENvcHlyaWdodCAoQykgMjAxOC0yMDIxIEZyZWUgU29mdHdhcmUgRm91bmRhdGlv biwgSW5jLgogCmRpZmYgLS1naXQgYS90ZXN0cy9scy9jb2xvci1ub3JtLnNoIGIvdGVzdHMv bHMvY29sb3Itbm9ybS5zaAppbmRleCAxN2E3OTBlMjguLjU4ZDE3MmVkNyAxMDA3NTUKLS0t IGEvdGVzdHMvbHMvY29sb3Itbm9ybS5zaAorKysgYi90ZXN0cy9scy9jb2xvci1ub3JtLnNo CkBAIC0zNiw3ICszNiw3IEBAIHRvdWNoIG5vY29sb3IgfHwgZnJhbWV3b3JrX2ZhaWx1cmVf CiAKIFRDT0xPUlM9Im5vPTc6ZXg9MDE7MzIiCiAKLSMgTm9uIGNvbG91cmVkIGZpbGVzIGlu aGVyaXQgTk9STUFMIGF0dHJpYnV0ZXMKKyMgVW5jb2xvcmVkIGZpbGUgbmFtZXMgaW5oZXJp dCBOT1JNQUwgYXR0cmlidXRlcy4KIExTX0NPTE9SUz0kVENPTE9SUyAgICAgIGxzIC1nR1Ug LS1jb2xvciBleGUgbm9jb2xvciB8IHFscyA+PiBvdXQgfHwgZmFpbD0xCiBMU19DT0xPUlM9 JFRDT0xPUlMgICAgICBscyAteFUgIC0tY29sb3IgZXhlIG5vY29sb3IgICAgICAgPj4gb3V0 IHx8IGZhaWw9MQogTFNfQ09MT1JTPSRUQ09MT1JTICAgICAgbHMgLWdHVSAtLWNvbG9yIG5v Y29sb3IgZXhlIHwgcWxzID4+IG91dCB8fCBmYWlsPTEKZGlmZiAtLWdpdCBhL3Rlc3RzL2xz L211bHRpaGFyZGxpbmsuc2ggYi90ZXN0cy9scy9tdWx0aWhhcmRsaW5rLnNoCmluZGV4IDJl OGIxNjU2ZC4uZmQxYTNkNDQxIDEwMDc1NQotLS0gYS90ZXN0cy9scy9tdWx0aWhhcmRsaW5r LnNoCisrKyBiL3Rlc3RzL2xzL211bHRpaGFyZGxpbmsuc2gKQEAgLTEsNSArMSw1IEBACiAj IS9iaW4vc2gKLSMgRW5zdXJlICJscyAtLWNvbG9yIiBwcm9wZXJseSBjb2xvcml6ZXMgaGFy ZCBsaW5rZWQgZmlsZXMuCisjIEVuc3VyZSAibHMgLS1jb2xvciIgcHJvcGVybHkgY29sb3Jz IG5hbWVzIG9mIGhhcmQgbGlua2VkIGZpbGVzLgogCiAjIENvcHlyaWdodCAoQykgMjAwOC0y MDIxIEZyZWUgU29mdHdhcmUgRm91bmRhdGlvbiwgSW5jLgogCmRpZmYgLS1naXQgYS90ZXN0 cy9scy9zdGF0LWZyZWUtc3ltbGlua3Muc2ggYi90ZXN0cy9scy9zdGF0LWZyZWUtc3ltbGlu a3Muc2gKaW5kZXggNmU5N2U4ZjY1Li4zMzk3YzllMDEgMTAwNzU1Ci0tLSBhL3Rlc3RzL2xz L3N0YXQtZnJlZS1zeW1saW5rcy5zaAorKysgYi90ZXN0cy9scy9zdGF0LWZyZWUtc3ltbGlu a3Muc2gKQEAgLTYyLDcgKzYyLDcgQEAgbl9zdGF0Mj0kKGdyZXAgLXZGICcrKysnIGxvZzIg fCB3YyAtbCkgfHwgZnJhbWV3b3JrX2ZhaWx1cmVfCiB0ZXN0ICRuX3N0YXQxID0gJCgoJG5f c3RhdDIgLSAxKSkgXAogICB8fCB7IGZhaWw9MTsgaGVhZCAtbjMwIGxvZyo7IH0KIAotIyBD aGVjayB0aGF0IG91dHB1dCBpcyBjb2xvcml6ZWQsIGFzIHJlcXVlc3RlZCwgdG9vLgorIyBD aGVjayB0aGF0IG91dHB1dCBpcyBjb2xvcmVkLCBhcyByZXF1ZXN0ZWQsIHRvby4KIHsKICAg cHJpbnRmICdcMDMzWzBtXDAzM1swMTszNW1saW5rLXRvLXhcMDMzWzBtQFxuJwogICBwcmlu dGYgJ1wwMzNbMDE7MzJteFwwMzNbMG0qXG4nCi0tIAoyLjMyLjAKCg== --------------VLjN17BIlkneHEesd9mItLD3-- From unknown Sun Jun 22 00:57:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#52782: Man Page: Incorrect Summary of --color Option Resent-From: Pranab Lawrence Ekka Dasgupta Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Fri, 24 Dec 2021 21:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52782 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: Paul Eggert Cc: 52782@debbugs.gnu.org Received: via spool by 52782-submit@debbugs.gnu.org id=B52782.16403807429113 (code B ref 52782); Fri, 24 Dec 2021 21:20:02 +0000 Received: (at 52782) by debbugs.gnu.org; 24 Dec 2021 21:19:02 +0000 Received: from localhost ([127.0.0.1]:38160 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0rxt-0002Md-4l for submit@debbugs.gnu.org; Fri, 24 Dec 2021 16:19:02 -0500 Received: from mail-yb1-f175.google.com ([209.85.219.175]:40811) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0pUe-00062j-B5 for 52782@debbugs.gnu.org; Fri, 24 Dec 2021 13:40:41 -0500 Received: by mail-yb1-f175.google.com with SMTP id d201so1369959ybc.7 for <52782@debbugs.gnu.org>; Fri, 24 Dec 2021 10:40:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=K3RVsOJsVC8i69DK6X05PPI8DdCkELzTKXiCIOdaTDU=; b=S9O6a6amYBOHTloWoIwlTucSjK+4xPpe5K6ZQYOcfqwAoQXFMsr6HmsMAahXrr8bZU V8iMqnbDx4fvMw4IvYqvWFTajd/kPGJ2dsZzfaDHCQ48mEQgvD+p1mm97nk/PXDHpQhB ALtP9Tgm6INUdJweozNX/388sneYyqci/jcU+M0x2LO7a4CgzIb2zSVvQqvlJhL2l88g SA4jrxXEjDoCWYwpdAJkRMHjrviVLHXuklGgMU9DF4ND/BH5nBAQoec1plPoIJtzgbEx SXRDLO7WnM4bnwIG7B5YG2Ct3H66YACnl4cLhxKS8Lw5o70EmrF9LME0G0hnWpidqFq7 pXHQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=K3RVsOJsVC8i69DK6X05PPI8DdCkELzTKXiCIOdaTDU=; b=feO42Zv/cmE7h0Nqex4iB4GF3ftKeZYZo4lFm6vAOYQtME3dtT9hqPaBEGUg7NPlu1 LVQe3TXPGtOaziluedCARr3Ab3xEYFHEDUAavheR2ILcCSoRjYfo/OK4pZIU/klvw23d jaLDndn+pswrfo/QCWvkhp5WTU4XvpLretoPx9P0GGWI4Om+++oIsKsEsfvjzC9togYs 7aZVjPhgC8wYLpIX37HT9GFWL16Uwb2JwfGYocDL1HTwOjhgNfu5LOazJniDdIbZr8S7 79+nV8cG9imsBTsMkhex3Ku4iI+f2Vd5l2JDbfQtyDgEif8BAO8oWsGJkoAcelYkxDpx V01w== X-Gm-Message-State: AOAM530PjLSsNOXABSejXiQKJ9jhoSZwQjpb7IriRzZjtzcpiqpt1CKH a/CJbh5MrU/X36g+2bdEpHoT5kaAuppOGHEL9gA= X-Google-Smtp-Source: ABdhPJxOXkAUu7Ym1d6gjAZjumWEV8XH+a4nMOUuhmzN5p0suhcUWehxRKtcemhFQfNsmN3NvL2HgJ8bjLhPkvZDR40= X-Received: by 2002:a05:6902:1350:: with SMTP id g16mr10488819ybu.202.1640371234633; Fri, 24 Dec 2021 10:40:34 -0800 (PST) MIME-Version: 1.0 References: <1e6bae3a-8d36-69cb-2d42-d56c59a31829@cs.ucla.edu> In-Reply-To: <1e6bae3a-8d36-69cb-2d42-d56c59a31829@cs.ucla.edu> From: Pranab Lawrence Ekka Dasgupta Date: Sat, 25 Dec 2021 00:10:23 +0530 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) X-Mailman-Approved-At: Fri, 24 Dec 2021 16:18:59 -0500 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 (-) Ah, my mistake. It does make sense that the contents of the parentheses apply to the specification of WHEN. Perhaps it could be reworded to "default if WHEN is omitted", although that does cause some repetition. Alternatively, the entire description could be modified, as on die.net[1]: "color the output. WHEN defaults to 'always' (if omitted) or can be 'never' or 'auto'. More info below." The issue here is that it might suggest that the user may not explicitly specify 'always'. Regarding the usage of 'colorize', I think the correction future proofs the documentation, given that I've never heard or seen it used. [1]https://linux.die.net/man/1/ls From unknown Sun Jun 22 00:57:18 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: Pranab Lawrence Ekka Dasgupta Subject: bug#52782: closed (Re: bug#52782: Man Page: Incorrect Summary of --color Option) Message-ID: References: <034f3f35-72df-12c1-faf4-b2990050d728@cs.ucla.edu> X-Gnu-PR-Message: they-closed 52782 X-Gnu-PR-Package: coreutils Reply-To: 52782@debbugs.gnu.org Date: Fri, 24 Dec 2021 23:29:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1640388542-32410-1" This is a multi-part message in MIME format... ------------=_1640388542-32410-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #52782: Man Page: Incorrect Summary of --color Option 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 52782@debbugs.gnu.org. --=20 52782: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D52782 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1640388542-32410-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 52782-done) by debbugs.gnu.org; 24 Dec 2021 23:28:12 +0000 Received: from localhost ([127.0.0.1]:38284 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0tyu-0008PT-H1 for submit@debbugs.gnu.org; Fri, 24 Dec 2021 18:28:12 -0500 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:40674) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0tyr-0008P8-AP for 52782-done@debbugs.gnu.org; Fri, 24 Dec 2021 18:28:11 -0500 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id F310C160057; Fri, 24 Dec 2021 15:28:02 -0800 (PST) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id xTr-ABdToeXl; Fri, 24 Dec 2021 15:28:02 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 13726160071; Fri, 24 Dec 2021 15:28:02 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id D48mDe-iPQ44; Fri, 24 Dec 2021 15:28:01 -0800 (PST) Received: from [192.168.1.9] (cpe-172-91-119-151.socal.res.rr.com [172.91.119.151]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id DC97A160057; Fri, 24 Dec 2021 15:28:01 -0800 (PST) Content-Type: multipart/mixed; boundary="------------NVhxquIMmJ7mmYsjfgaa0XZo" Message-ID: <034f3f35-72df-12c1-faf4-b2990050d728@cs.ucla.edu> Date: Fri, 24 Dec 2021 15:28:01 -0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1 Subject: Re: bug#52782: Man Page: Incorrect Summary of --color Option Content-Language: en-US To: Pranab Lawrence Ekka Dasgupta References: <1e6bae3a-8d36-69cb-2d42-d56c59a31829@cs.ucla.edu> From: Paul Eggert Organization: UCLA Computer Science Department In-Reply-To: X-Spam-Score: -2.4 (--) X-Debbugs-Envelope-To: 52782-done Cc: 52782-done@debbugs.gnu.org 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: -3.4 (---) This is a multi-part message in MIME format. --------------NVhxquIMmJ7mmYsjfgaa0XZo Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 12/24/21 10:40, Pranab Lawrence Ekka Dasgupta wrote: > Perhaps it could be reworded to "default if WHEN is omitted", although > that does cause some repetition Thanks, I gave that sort of thing a shot by installing the attached, and am closing the bug report. --------------NVhxquIMmJ7mmYsjfgaa0XZo Content-Type: text/x-patch; charset=UTF-8; name="0001-ls-improve-doc-for-WHEN.patch" Content-Disposition: attachment; filename="0001-ls-improve-doc-for-WHEN.patch" Content-Transfer-Encoding: base64 RnJvbSAyMjY5ZWE1YWEyYjg1NzllZDJlYzIyNDA3ZjU1ZGU0ZmQ3MjE4ZTRiIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1 PgpEYXRlOiBGcmksIDI0IERlYyAyMDIxIDE1OjI1OjI5IC0wODAwClN1YmplY3Q6IFtQQVRD SF0gbHM6IGltcHJvdmUgZG9jIGZvciA9V0hFTgoKKiBzcmMvbHMuYyAodXNhZ2UpOiBJbXBy b3ZlIGNsYXJpdHkgb2YgPVdIRU4gYXJncyAoQnVnIzUyNzgyKS4KLS0tCiBzcmMvbHMuYyB8 IDE2ICsrKysrKystLS0tLS0tLS0KIDEgZmlsZSBjaGFuZ2VkLCA3IGluc2VydGlvbnMoKyks IDkgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvc3JjL2xzLmMgYi9zcmMvbHMuYwppbmRl eCBjMzUwNzg3YjYuLmQ2YzczMDJkYyAxMDA2NDQKLS0tIGEvc3JjL2xzLmMKKysrIGIvc3Jj L2xzLmMKQEAgLTU0MjQsMTggKzU0MjQsMTMgQEAgU29ydCBlbnRyaWVzIGFscGhhYmV0aWNh bGx5IGlmIG5vbmUgb2YgLWNmdHV2U1VYIG5vciAtLXNvcnQgaXMgc3BlY2lmaWVkLlxuXAog IiksIHN0ZG91dCk7CiAgICAgICBmcHV0cyAoXygiXAogICAtQyAgICAgICAgICAgICAgICAg ICAgICAgICBsaXN0IGVudHJpZXMgYnkgY29sdW1uc1xuXAotICAgICAgLS1jb2xvcls9V0hF Tl0gICAgICAgICBjb2xvciB0aGUgb3V0cHV0OyBXSEVOIGNhbiBiZSAnYWx3YXlzJyAoZGVm YXVsdFwKLVxuXAotICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGlmIG9taXR0ZWQp LCAnYXV0bycsIG9yICduZXZlcic7IG1vcmUgaW5mbyBiZWxvd1wKLVxuXAorICAgICAgLS1j b2xvcls9V0hFTl0gICAgICAgICBjb2xvciB0aGUgb3V0cHV0IFdIRU47IG1vcmUgaW5mbyBi ZWxvd1xuXAogICAtZCwgLS1kaXJlY3RvcnkgICAgICAgICAgICBsaXN0IGRpcmVjdG9yaWVz IHRoZW1zZWx2ZXMsIG5vdCB0aGVpciBjb250ZW50c1xuXAogICAtRCwgLS1kaXJlZCAgICAg ICAgICAgICAgICBnZW5lcmF0ZSBvdXRwdXQgZGVzaWduZWQgZm9yIEVtYWNzJyBkaXJlZCBt b2RlXG5cCiAiKSwgc3Rkb3V0KTsKICAgICAgIGZwdXRzIChfKCJcCiAgIC1mICAgICAgICAg ICAgICAgICAgICAgICAgIGxpc3QgYWxsIGVudHJpZXMgaW4gZGlyZWN0b3J5IG9yZGVyXG5c Ci0gIC1GLCAtLWNsYXNzaWZ5Wz1XSEVOXSAgICAgIGFwcGVuZCBpbmRpY2F0b3IgKG9uZSBv ZiAqLz0+QHwpIHRvIGVudHJpZXM7XG5cCi0gICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgV0hFTiBjYW4gYmUgJ2Fsd2F5cycgKGRlZmF1bHQgaWYgb21pdHRlZCksXG5cCi0gICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgJ2F1dG8nLCBvciAnbmV2ZXInXG5cCisgIC1G LCAtLWNsYXNzaWZ5Wz1XSEVOXSAgICAgIGFwcGVuZCBpbmRpY2F0b3IgKG9uZSBvZiAqLz0+ QHwpIHRvIGVudHJpZXMgV0hFTlxuXAogICAgICAgLS1maWxlLXR5cGUgICAgICAgICAgICBs aWtld2lzZSwgZXhjZXB0IGRvIG5vdCBhcHBlbmQgJyonXG5cCiAgICAgICAtLWZvcm1hdD1X T1JEICAgICAgICAgIGFjcm9zcyAteCwgY29tbWFzIC1tLCBob3Jpem9udGFsIC14LCBsb25n IC1sLFxuXAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHNpbmdsZS1jb2x1bW4g LTEsIHZlcmJvc2UgLWwsIHZlcnRpY2FsIC1DXG5cCkBAIC01NDY4LDggKzU0NjMsNyBAQCBT b3J0IGVudHJpZXMgYWxwaGFiZXRpY2FsbHkgaWYgbm9uZSBvZiAtY2Z0dXZTVVggbm9yIC0t c29ydCBpcyBzcGVjaWZpZWQuXG5cCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg KG92ZXJyaWRkZW4gYnkgLWEgb3IgLUEpXG5cCiAiKSwgc3Rkb3V0KTsKICAgICAgIGZwdXRz IChfKCJcCi0gICAgICAtLWh5cGVybGlua1s9V0hFTl0gICAgIGh5cGVybGluayBmaWxlIG5h bWVzOyBXSEVOIGNhbiBiZSAnYWx3YXlzJ1xuXAotICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgIChkZWZhdWx0IGlmIG9taXR0ZWQpLCAnYXV0bycsIG9yICduZXZlcidcblwKKyAg ICAgIC0taHlwZXJsaW5rWz1XSEVOXSAgICAgaHlwZXJsaW5rIGZpbGUgbmFtZXMgV0hFTlxu XAogIiksIHN0ZG91dCk7CiAgICAgICBmcHV0cyAoXygiXAogICAgICAgLS1pbmRpY2F0b3It c3R5bGU9V09SRCAgYXBwZW5kIGluZGljYXRvciB3aXRoIHN0eWxlIFdPUkQgdG8gZW50cnkg bmFtZXM6XApAQCAtNTU2Myw2ICs1NTU3LDEwIEBAIEFsc28gdGhlIFRJTUVfU1RZTEUgZW52 aXJvbm1lbnQgdmFyaWFibGUgc2V0cyB0aGUgZGVmYXVsdCBzdHlsZSB0byB1c2UuXG5cCiAi KSwgc3Rkb3V0KTsKICAgICAgIGZwdXRzIChfKCJcCiBcblwKK1RoZSBXSEVOIGFyZ3VtZW50 IGRlZmF1bHRzIHRvICdhbHdheXMnIGFuZCBjYW4gYWxzbyBiZSAnYXV0bycgb3IgJ25ldmVy Jy5cblwKKyIpLCBzdGRvdXQpOworICAgICAgZnB1dHMgKF8oIlwKK1xuXAogVXNpbmcgY29s b3IgdG8gZGlzdGluZ3Vpc2ggZmlsZSB0eXBlcyBpcyBkaXNhYmxlZCBib3RoIGJ5IGRlZmF1 bHQgYW5kXG5cCiB3aXRoIC0tY29sb3I9bmV2ZXIuICBXaXRoIC0tY29sb3I9YXV0bywgbHMg ZW1pdHMgY29sb3IgY29kZXMgb25seSB3aGVuXG5cCiBzdGFuZGFyZCBvdXRwdXQgaXMgY29u bmVjdGVkIHRvIGEgdGVybWluYWwuICBUaGUgTFNfQ09MT1JTIGVudmlyb25tZW50XG5cCi0t IAoyLjMyLjAKCg== --------------NVhxquIMmJ7mmYsjfgaa0XZo-- ------------=_1640388542-32410-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 24 Dec 2021 17:14:43 +0000 Received: from localhost ([127.0.0.1]:37977 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0o9T-000340-J9 for submit@debbugs.gnu.org; Fri, 24 Dec 2021 12:14:43 -0500 Received: from lists.gnu.org ([209.51.188.17]:44892) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0mEi-0006fg-RZ for submit@debbugs.gnu.org; Fri, 24 Dec 2021 10:12:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:57580) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n0mEi-0000ay-M6 for bug-coreutils@gnu.org; Fri, 24 Dec 2021 10:12:00 -0500 Received: from [2607:f8b0:4864:20::b35] (port=39860 helo=mail-yb1-xb35.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n0mEf-0007av-Tw for bug-coreutils@gnu.org; Fri, 24 Dec 2021 10:12:00 -0500 Received: by mail-yb1-xb35.google.com with SMTP id d1so3420206ybh.6 for ; Fri, 24 Dec 2021 07:11:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=rCsOAz9t2WbnM6FuS12BeBV+mTOapuUaJONg92onZO0=; b=hZxq8+TxDljrQp7hFZjqk3Eig1CVJpsM8QfFk63b1NVfjukOoQbL+5yeRo4WnzxFf1 g8K2vsgqPkxuw4WxqinAaO/SmKgFnhIOcmAkv6vTE4kBL1c0QB5CkWLb7uGCujJ0JYAv EKwE/2VkmzC3RNA6yCtsuuY/CUE1U/hJbMlB94tXjBGYzzL0eIYNwMwY+15ybSckzngu G7MTyGdQNRqUUEXXpyyzmQpbeLei2R/vNkUYjmodcAQVWIWy/9OQXTjHfwUlbjMLrq92 1+vyLJQBeACMXImT6cBpmjoK6jKUptTQOQuhWRFqk2UzbILmFVwlBU7p2o2mQoynvuoZ 54Xg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=rCsOAz9t2WbnM6FuS12BeBV+mTOapuUaJONg92onZO0=; b=Qp3IJMQnD32kQnVe3BkZSCefh6foBhVUG3GjMWZpwtuINN1/nJz/oroLtV1gjXziOV IEK/UVyipswKBuUOo89ActLk7CWeEjgNDXvHa4uW8xk7ZIzDLZ7yHe+2uUhAKrZlb9aH /Fhqt+GF07bxVhGT5r2ojmGhhnSw9icroZY+Gvf5q0HVuBHSfEcaXCKMqPv2i8N/rX+u PsDikwvFRj6cL3a0cV4pwha5AHZ8ngHm+nNUzyFF65Rfn73e5twAMueKYF/+v0B7IHl2 VkMAgmEoRwT4KGeqRVanSjBf5ixVlIlX0NXpj9mOcvHQ7cztuYrE9tRJb4Ir0PsCyrE3 XWFw== X-Gm-Message-State: AOAM533drrTim1sRNqOvb9lblG2Q8rAUhAem7YmCbb7jhdDNdD3ja4Yl 3uSOB6LqMzGVvZWgn3idb7fyWO1ZlQc1kE3GAkUFpIhGTXc9s/7g X-Google-Smtp-Source: ABdhPJzQEBPN9DlxAkOX7IRQsVbMGD9UuQP1B2Q3DPQThCmCISj5PuHzGHMHi1dGv87TXUkNEI/pKEaQMN1tDPJw1Eo= X-Received: by 2002:a05:6902:1350:: with SMTP id g16mr9555833ybu.202.1640358716456; Fri, 24 Dec 2021 07:11:56 -0800 (PST) MIME-Version: 1.0 From: Pranab Lawrence Ekka Dasgupta Date: Fri, 24 Dec 2021 20:41:45 +0530 Message-ID: Subject: Man Page: Incorrect Summary of --color Option To: bug-coreutils@gnu.org Content-Type: text/plain; charset="UTF-8" X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::b35 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::b35; envelope-from=pranabekka@gmail.com; helo=mail-yb1-xb35.google.com X-Spam_score_int: 14 X-Spam_score: 1.4 X-Spam_bar: + X-Spam_report: (1.4 / 5.0 requ) BAYES_50=0.8, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Fri, 24 Dec 2021 12:14:42 -0500 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.3 (--) Version Information ls/coreutils: 8.32 Distribution: Pop_OS! 20.10 The summary of the `--color` option incorrectly states that the default option is 'always', whereas it functions otherwise and the information at the bottom of the man page suggests that the default is 'never'. This error persists in online manual pages and in other distributions >From the manual page: --- --color[=WHEN] colorize the output; WHEN can be 'always' (default if omitted), 'auto', or 'never'; more info below ... Using color to distinguish file types is disabled both by default and with --color=never. With --color=auto, ls emits color codes only when --- Thanks and Regards, Pranab Dasgupta ------------=_1640388542-32410-1--