Subject: misc/23278: fixes for sh(1) - wrong sections and man pages referred
To: None <>
From: None <>
List: netbsd-bugs
Date: 10/26/2003 14:10:05
>Number:         23278
>Category:       misc
>Synopsis:       fixes for sh(1) - wrong sections and man pages referred
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Oct 26 13:11:00 UTC 2003
>Originator:     Igor Sobrado
>Release:        NetBSD 1.6.1
	University of Oviedo
	<The following information is extracted from your kernel. Please>
	<append output of "ldd", "ident" where relevant (multiple lines).>
System: NetBSD 1.6 NetBSD 1.6 (GENERIC) #0: Sun Sep 8 19:43:40 UTC 2002 i386
Architecture: i386
Machine: i386
	There are two bugs in the Bourne shell man page sh(1).

	1. There is a reference to passwd(4) instead of passwd(5).
	   The password file is described in section 5 of the NetBSD
	   manual.  A patch for this issue is included with this PR.

	2. There is a reference to alias(1) in this man page: "An alias
	   is a name and corresponding value set using the alias(1) builtin
	   command."  But alias(1) is a link to the C shell man page,
           csh's alias syntax differs from the sh's alias builtin command.

	   I am not sure about this fix: either removing the reference
	   to the csh man page and adding a description of the Bourne
	   shell alias command, or adding the right man page to the online
	   manual.  In any case, referring the csh's alias command is wrong.
	   Syntax differs between both implementations of the alias command.

	Looking for the password file description in section 4 (not found),
	and trying to use the csh's alias command described in alias(1)
	with the shell developed by Stephen Bourne.


--- sh.1	Sat Oct 25 17:28:19 2003
+++ sh.1.fixed	Sat Oct 25 17:29:38 2003
@@ -1775,7 +1775,7 @@
 Set automatically by
 .Xr login 1
 from the user's login directory in the password file
-.Pq Xr passwd 4 .
+.Pq Xr passwd 5 .
 This environment variable also functions as the default argument for the
 cd builtin.
 .It Ev PATH