Bug 428222

Summary:	builtins man page missing section on conditional expressions
Product:	[Fedora] Fedora	Reporter:	Mikel Ward <mikel>
Component:	bash	Assignee:	Tomas Janousek <tjanouse>
Status:	CLOSED WONTFIX	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	low	Docs Contact:
Priority:	low
Version:	8	CC:	twaugh
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2008-02-04 14:13:23 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Mikel Ward 2008-01-10 00:20:37 UTC

Some man pages refer to bash builtins (usually but not always including read and
test).

The documentation for test doesn't mention common things like the -f, -d, or -L
flags.  It refers to a non-existent section called "CONDITIONAL EXPRESSIONS".

If you can't see the man page I'm talking about, just try "man builtins".

$ rpm -q bash
bash-3.2-18.fc8

Comment 1 Tomas Janousek 2008-01-21 13:38:31 UTC

The text in the builtins.1 manpage is included from the bash.1 manpage, so it
refers to the section in the bash manpage. I don't think it's viable to mention
that the section is in the bash manpage, not in the builtins one, because the
very same text would have to be in the bash manpage.

Comment 2 Mikel Ward 2008-01-21 20:31:54 UTC

I was thinking we either statically include that section of text from the bash
man page, dynamically include it, or better still, re-write the section on the
test builtin to include it.

Comment 3 Tomas Janousek 2008-02-04 14:13:23 UTC

I don't think it's worth the effort.