X-Loop: help-debbugs@HIDDEN Subject: bug#12589: dirname manpage partially wrong/confusing Resent-From: Filipus Klutiero <chealer@HIDDEN> Original-Sender: debbugs-submit-bounces <at> debbugs.gnu.org Resent-CC: bug-coreutils@HIDDEN Resent-Date: Sat, 06 Oct 2012 21:32:01 +0000 Resent-Message-ID: <handler.12589.B.134955910230409 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: report 12589 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 12589 <at> debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@HIDDEN Received: via spool by submit <at> debbugs.gnu.org id=B.134955910230409 (code B ref -1); Sat, 06 Oct 2012 21:32:01 +0000 Received: (at submit) by debbugs.gnu.org; 6 Oct 2012 21:31:42 +0000 Received: from localhost ([127.0.0.1]:58663 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1TKbyH-0007uP-O6 for submit <at> debbugs.gnu.org; Sat, 06 Oct 2012 17:31:42 -0400 Received: from eggs.gnu.org ([208.118.235.92]:52891) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from <chealer@HIDDEN>) id 1TKbyF-0007uC-HT for submit <at> debbugs.gnu.org; Sat, 06 Oct 2012 17:31:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <chealer@HIDDEN>) id 1TKbxr-0008Cz-9j for submit <at> debbugs.gnu.org; Sat, 06 Oct 2012 17:31:16 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:57106) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <chealer@HIDDEN>) id 1TKbxr-0008Cv-6M for submit <at> debbugs.gnu.org; Sat, 06 Oct 2012 17:31:15 -0400 Received: from eggs.gnu.org ([208.118.235.92]:43073) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <chealer@HIDDEN>) id 1TKbxq-000851-42 for bug-coreutils@HIDDEN; Sat, 06 Oct 2012 17:31:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <chealer@HIDDEN>) id 1TKbxo-0008Ch-U5 for bug-coreutils@HIDDEN; Sat, 06 Oct 2012 17:31:14 -0400 Received: from mail-qa0-f48.google.com ([209.85.216.48]:42024) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <chealer@HIDDEN>) id 1TKbxo-0008Ca-Po for bug-coreutils@HIDDEN; Sat, 06 Oct 2012 17:31:12 -0400 Received: by mail-qa0-f48.google.com with SMTP id c11so1443749qad.0 for <bug-coreutils@HIDDEN>; Sat, 06 Oct 2012 14:31:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject :content-type:content-transfer-encoding; bh=/aqKrng2kAC6l+OSXe7X1iZwb4fDQciI2jEBtXI7iVs=; b=HdIj3B4pAc+k77m2Hd7qnI/oMP6BCgWclHu6Cv5bA2bP1Dp/SByniPsG8BcFXHEaiT 9+2JFx4kIiwtW5/6iWFK70+676e4qOBhOMtBQ4/aN6yXZafegVsWDQ6MsGlhaBEx1QY5 a11SOIFrv/zo0/85H7chVGZ6+UBSpykNwhZdlvnS1lbs7AGdji4zwV0Z95o2wK9L1CI/ cFrN+jk4rVY/Wecje0AF7a1yyhsEYnzkfEZae3DkrlFAvLr8nCaPULwh/rWjMebFCgrB FoNolwuFbbe92/MhnbRXx4WOA5NnPzD5RTuKo/h7VMBJUtlfLoNNiFh2XK+9fy2aLBFS wPag== Received: by 10.229.136.7 with SMTP id p7mr5194072qct.102.1349559070311; Sat, 06 Oct 2012 14:31:10 -0700 (PDT) Received: from [192.168.1.9] (modemcable156.191-56-74.mc.videotron.ca. [74.56.191.156]) by mx.google.com with ESMTPS id o17sm13632194qao.14.2012.10.06.14.31.08 (version=SSLv3 cipher=OTHER); Sat, 06 Oct 2012 14:31:09 -0700 (PDT) Message-ID: <5070A30C.5060603@HIDDEN> Date: Sat, 06 Oct 2012 17:30:52 -0400 From: Filipus Klutiero <chealer@HIDDEN> User-Agent: Mozilla/5.0 (X11; Linux i686 on x86_64; rv:10.0.7) Gecko/20120922 Icedove/10.0.7 MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Sender: debbugs-submit-bounces <at> debbugs.gnu.org Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org X-Spam-Score: -3.4 (---) This report follows a previous report about dirname's info page and manpage: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=6175 dirname's info page is now IMO correct and quite clear in its description of dirname's behavior: > `dirname' prints all but the final slash-delimited component of NAME. > Slashes on either side of the final component are also removed. If the > string contains no slash, `dirname' prints `.' (meaning the current > directory). However, the manpage is still confusing. It used to read: > Print NAME with its trailing /component removed; if NAME contains no > /'s, output `.' (meaning the current directory). It now reads: > Output NAME with its last non-slash component and trailing slashes removed; if NAME contains no /'s, output `.' (meaning the current directory). First, it's unclear what kind of component this refers to. A slash is not a pathname component, therefore "non-slash component" would seem equivalent to simply "component". If one understands "component" as pathname component, then the description becomes equivalent for the typical case of "/foo/bar" to: > Output "/foo/bar" with its last component and trailing slashes removed. That would, in my understanding, mean outputting "/foo/" (there are no trailing slashes in "/foo/bar"). But dirname would actually output "/foo", removing the last slash in the result. I would recommend adopting the same description as the one used in the info page. By the way, the short description reads: > strip last component from file name In POSIX terminology, this sounds like "take a filename, output nothing". "from a pathname" would make more sense.
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.428 (Entity 5.428) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Filipus Klutiero <chealer@HIDDEN> Subject: bug#12589: Acknowledgement (dirname manpage partially wrong/confusing) Message-ID: <handler.12589.B.134955910230409.ack <at> debbugs.gnu.org> References: <5070A30C.5060603@HIDDEN> X-Gnu-PR-Message: ack 12589 X-Gnu-PR-Package: coreutils Reply-To: 12589 <at> debbugs.gnu.org Date: Sat, 06 Oct 2012 21:32:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-coreutils@HIDDEN If you wish to submit further information on this problem, please send it to 12589 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 12589: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D12589 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
Received: (at control) by debbugs.gnu.org; 6 Nov 2018 18:04:58 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Nov 06 13:04:58 2018 Received: from localhost ([127.0.0.1]:37691 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1gK5ij-0004su-Qh for submit <at> debbugs.gnu.org; Tue, 06 Nov 2018 13:04:58 -0500 Received: from mail-pf1-f182.google.com ([209.85.210.182]:43793) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <assafgordon@HIDDEN>) id 1gK5ih-0004sg-Mx for control <at> debbugs.gnu.org; Tue, 06 Nov 2018 13:04:55 -0500 Received: by mail-pf1-f182.google.com with SMTP id g7-v6so4196623pfo.10 for <control <at> debbugs.gnu.org>; Tue, 06 Nov 2018 10:04:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:message-id:date:user-agent:mime-version:content-language :content-transfer-encoding; bh=8jBknfLgfk7qcjK1CCv7j1yO3KPlLigPmMa7DK3n3Qk=; b=qNNQoTOt6+dbxESkwbaA0bloWii70te16qKG4MQwXXwEPpeXCZeZ9alz8icKPWIUqy rhA8r5PDf3Ne68VN+cUQTF94Fln69eNaR9Jay6QFjNOXB6ZzuA6lnDCWwWDoFgqEEcQQ InfzWF3L0mqKYx0BJp7YhLm/CV5wjbtQmgRXcUw/R9wcQ74dvbSThy1m0z0kteEYX7fi tk3Xxx0Eyn+KQa0c8/v03tl9fq1QS/Zs//a1A6vDdSZ+xcHAvWLJCDrxidXatMTio4eA OOdDj6KJB6/qWTOwaUBJw6m/T9LBwsxiK3RGXL07wnFLrA/zebR0f2zZm83LSoYCiaHR gsdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=8jBknfLgfk7qcjK1CCv7j1yO3KPlLigPmMa7DK3n3Qk=; b=LVPfMmUudZllJk4NVtW/9KRQSDiPfDVDvVPRU07bg6uiTY3HIjHn5FJO4j+Ub0ROc4 QYkS5FzXplsTGQPTUbpt7FW63EBV7Ud5j7PeOMBpmh8qQFJg5R/9ZlZTTBUnEGQKzx/i FJp+TiThzWy5t/BRpSr2b/kPpiqEopEpskvF95bJCzlMZrkp6f0sdOVDxvaTj9q0uYcT YC+MzYhC8CrZ7nn9hM7SGHcJchUNWEhBVOHZLKsNtgwnrHFOhtt1NX36xGNl0wj1xp3A +WQisSLfyV5xOuD46hULIyUpHAjgmJxyZFza8QENhrP07rNZwWBMUiWJ8oxgXWjlyovE nMxg== X-Gm-Message-State: AGRZ1gLZIQ0eVcNsMKBxUh2aAuF484uMtHB+hzwA8zqwF2qOl3JHchJs KAek388n4v+1G0qBEDvomHg1/018 X-Google-Smtp-Source: AJdET5erfaBCtrw9w+lSCHaAOgn8mvjhZfVSPxHa2fXwQhDb83WOVq8p/AR2EzSRTyTJqg9EEdvSqw== X-Received: by 2002:aa7:804e:: with SMTP id y14-v6mr840540pfm.73.1541527489424; Tue, 06 Nov 2018 10:04:49 -0800 (PST) Received: from tomato.housegordon.com (moose.housegordon.com. [184.68.105.38]) by smtp.googlemail.com with ESMTPSA id a73-v6sm6366118pfj.38.2018.11.06.10.04.48 for <control <at> debbugs.gnu.org> (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Nov 2018 10:04:48 -0800 (PST) To: control <at> debbugs.gnu.org From: Assaf Gordon <assafgordon@HIDDEN> Message-ID: <96b5a904-78e4-010f-6a3c-dd0f2f2cf162@HIDDEN> Date: Tue, 6 Nov 2018 11:04:47 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.2.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: severity 12589 wishlist retitle 12589 doc: dirname: manpage partially wrong/confusing [...] Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at http://www.dnswl.org/, no trust [209.85.210.182 listed in list.dnswl.org] 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (assafgordon[at]gmail.com) -0.0 SPF_PASS SPF: sender matches SPF record 1.8 MISSING_SUBJECT Missing Subject: header 0.2 NO_SUBJECT Extra score for no subject X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: 1.0 (+) severity 12589 wishlist retitle 12589 doc: dirname: manpage partially wrong/confusing
Received: (at control) by debbugs.gnu.org; 6 Nov 2018 18:04:58 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Nov 06 13:04:58 2018 Received: from localhost ([127.0.0.1]:37691 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1gK5ij-0004su-Qh for submit <at> debbugs.gnu.org; Tue, 06 Nov 2018 13:04:58 -0500 Received: from mail-pf1-f182.google.com ([209.85.210.182]:43793) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <assafgordon@HIDDEN>) id 1gK5ih-0004sg-Mx for control <at> debbugs.gnu.org; Tue, 06 Nov 2018 13:04:55 -0500 Received: by mail-pf1-f182.google.com with SMTP id g7-v6so4196623pfo.10 for <control <at> debbugs.gnu.org>; Tue, 06 Nov 2018 10:04:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:message-id:date:user-agent:mime-version:content-language :content-transfer-encoding; bh=8jBknfLgfk7qcjK1CCv7j1yO3KPlLigPmMa7DK3n3Qk=; b=qNNQoTOt6+dbxESkwbaA0bloWii70te16qKG4MQwXXwEPpeXCZeZ9alz8icKPWIUqy rhA8r5PDf3Ne68VN+cUQTF94Fln69eNaR9Jay6QFjNOXB6ZzuA6lnDCWwWDoFgqEEcQQ InfzWF3L0mqKYx0BJp7YhLm/CV5wjbtQmgRXcUw/R9wcQ74dvbSThy1m0z0kteEYX7fi tk3Xxx0Eyn+KQa0c8/v03tl9fq1QS/Zs//a1A6vDdSZ+xcHAvWLJCDrxidXatMTio4eA OOdDj6KJB6/qWTOwaUBJw6m/T9LBwsxiK3RGXL07wnFLrA/zebR0f2zZm83LSoYCiaHR gsdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=8jBknfLgfk7qcjK1CCv7j1yO3KPlLigPmMa7DK3n3Qk=; b=LVPfMmUudZllJk4NVtW/9KRQSDiPfDVDvVPRU07bg6uiTY3HIjHn5FJO4j+Ub0ROc4 QYkS5FzXplsTGQPTUbpt7FW63EBV7Ud5j7PeOMBpmh8qQFJg5R/9ZlZTTBUnEGQKzx/i FJp+TiThzWy5t/BRpSr2b/kPpiqEopEpskvF95bJCzlMZrkp6f0sdOVDxvaTj9q0uYcT YC+MzYhC8CrZ7nn9hM7SGHcJchUNWEhBVOHZLKsNtgwnrHFOhtt1NX36xGNl0wj1xp3A +WQisSLfyV5xOuD46hULIyUpHAjgmJxyZFza8QENhrP07rNZwWBMUiWJ8oxgXWjlyovE nMxg== X-Gm-Message-State: AGRZ1gLZIQ0eVcNsMKBxUh2aAuF484uMtHB+hzwA8zqwF2qOl3JHchJs KAek388n4v+1G0qBEDvomHg1/018 X-Google-Smtp-Source: AJdET5erfaBCtrw9w+lSCHaAOgn8mvjhZfVSPxHa2fXwQhDb83WOVq8p/AR2EzSRTyTJqg9EEdvSqw== X-Received: by 2002:aa7:804e:: with SMTP id y14-v6mr840540pfm.73.1541527489424; Tue, 06 Nov 2018 10:04:49 -0800 (PST) Received: from tomato.housegordon.com (moose.housegordon.com. [184.68.105.38]) by smtp.googlemail.com with ESMTPSA id a73-v6sm6366118pfj.38.2018.11.06.10.04.48 for <control <at> debbugs.gnu.org> (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Nov 2018 10:04:48 -0800 (PST) To: control <at> debbugs.gnu.org From: Assaf Gordon <assafgordon@HIDDEN> Message-ID: <96b5a904-78e4-010f-6a3c-dd0f2f2cf162@HIDDEN> Date: Tue, 6 Nov 2018 11:04:47 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.2.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: severity 12589 wishlist retitle 12589 doc: dirname: manpage partially wrong/confusing [...] Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at http://www.dnswl.org/, no trust [209.85.210.182 listed in list.dnswl.org] 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (assafgordon[at]gmail.com) -0.0 SPF_PASS SPF: sender matches SPF record 1.8 MISSING_SUBJECT Missing Subject: header 0.2 NO_SUBJECT Extra score for no subject X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: 1.0 (+) severity 12589 wishlist retitle 12589 doc: dirname: manpage partially wrong/confusing
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.