GNU bug report logs - #60981
Bug in man page for the "test" command

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 21 Jan 2023 08:49:49 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jan 21 03:49:49 2023
Received: from localhost ([127.0.0.1]:48016 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pJ9ZM-0003KP-MY
	for submit <at> debbugs.gnu.org; Sat, 21 Jan 2023 03:49:49 -0500
Received: from lists.gnu.org ([209.51.188.17]:40452)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <kaulkwappe@HIDDEN>) id 1pJ1Xa-0006Za-Mg
 for submit <at> debbugs.gnu.org; Fri, 20 Jan 2023 19:15:27 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <kaulkwappe@HIDDEN>)
 id 1pJ1Xa-0007gv-7P
 for bug-coreutils@HIDDEN; Fri, 20 Jan 2023 19:15:26 -0500
Received: from mail.prvy.eu ([185.236.8.250])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <kaulkwappe@HIDDEN>)
 id 1pJ1XY-0007yb-3H
 for bug-coreutils@HIDDEN; Fri, 20 Jan 2023 19:15:25 -0500
Received: from unknown (unknown [192.168.254.1])
 by mail.prvy.eu (Postfix) with ESMTPSA id D835B7F9EE
 for <bug-coreutils@HIDDEN>; Sat, 21 Jan 2023 00:15:19 +0000 (UTC)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=prvy.eu; s=20180701;
 t=1674260119; bh=ELM7nlvuMbnYITxmZho1/MOdRUHit+nWSB/CPeoENWU=;
 h=Date:From:Reply-To:To:Subject:From;
 b=o1dRljiIyaJiu6a8z07EMOnoLzRJYA1yYsESEcLwh5Uv8IGNPc3ABkO4u2SwqpwUR
 pm04aQI0K7wP0MohDurrggBvqSCva5pjtng19Vey6I328PrMUkNqk4VBldoG9rzNr/
 WnQSJD1GvP6YQhbPmvEjnMbZWmfGxJAsLbke1MfmEabEgfKOhs3b+t/PsUrlJk7f8+
 llrLmodzfPgTNkl6YU0UQ3B1A+fr3gZLoV2x8tgmd8p0Y4Nbu4ftzkmSw8pCUmL31j
 fypFRLwg2BcFabifMqqbmUcqRUh3U9WXkWBCv+jKMmKfNPxkQ/TVitnI05A18gXCbz
 RmlRplff1v3mg==
Date: Sat, 21 Jan 2023 01:15:19 +0100
From: "Kaulkwappe" <kaulkwappe@HIDDEN>
To: <bug-coreutils@HIDDEN>
Subject: Bug in man page for the "test" command
Message-ID: <5xng0h0bh.eGdhs8@HIDDEN>
X-Conversation-ID: 0cvos0vxyd
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Received-SPF: pass client-ip=185.236.8.250; envelope-from=kaulkwappe@HIDDEN;
 helo=mail.prvy.eu
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 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, 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: Sat, 21 Jan 2023 03:49:47 -0500
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>
Reply-To: kaulkwappe+0cvos0vxyd@HIDDEN
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.4 (--)

Dear colleagues,=0A=0Athis might have been reported before (or not), but th=
ere is a confusing description in the man page of the "test command:=0A=0A#=
##=0A-e FILE=0A=C2=A0 FILE exists=0A=0A-L FILE=0A=C2=A0 FILE exists and is =
a symbolic link (same as -h)=0A=0A###=0A=0AThe problem here is the situatio=
n of a broken symlink. When flag -e is used on a broken symbolic link, it f=
ails. But when -L is used on a broken symlink, it returns true.=0A=0AWhile =
this may be the expected behavior, it does not reflect what the documentati=
on says. Because if -e fails on a broken symlink ("FILE exists") one would =
assume that the same of course is true for -L. The correct description for =
-L should be:=0A=0A###=0A-e FILE=0A=C2=A0 FILE exists or is valid symbolic =
link=0A=0A-L FILE=0A=C2=A0 FILE is a symbolic link, whether broken or not (=
same as -h)=0A=0A###=0A=0AKind Regards,=0AKaulkwappe