Errors in bash man page

Bug #839560 reported by Carl Allain
16
This bug affects 3 people
Affects Status Importance Assigned to Milestone
bash (Ubuntu)
Confirmed
Low
Unassigned

Bug Description

man bash provides helpful info about the bash command. I have found what looks like 2 documentation issues and one clarification "request" so far by reading it and trying to understand how it works:

First, there is this paragraph that explains how bash behave when invoked as an interactive shell:

"When bash is invoked as an interactive login shell... it first reads and executes commands from the file /etc/profile, if that file exists."

Well, what I have found on my system is that it first reads /etc/bash.bashrc, then /etc/profile (using both of them in fact).

Second, there is this paragraph explaining how bash behave when it is being run with its standard input connected to a network connection:

"Bash attempts to determine when it is being run with its standard input connected to a network connection... If bash determines it is being run in this fashion, it reads and executes commands from ~/.bashrc and ­~./bashrc, ..."

The problem here is that is says ~/.bashrc twice. I have not checked the actual behavior, but this is certainly a documentation problem.

Finally, for the document enhancement request, it is about the usage of |&, which should say that the standard error of command is connected to command2's standard input in addition to standard output. The shorthand 2>&1 | helps to understand what is explained, but I think this simple additional precision as text would help better grasp what is meant here.

I am using Ubuntu 11.04

Tags: manpage
Robert Roth (evfool)
Changed in ubuntu:
status: New → Confirmed
affects: ubuntu → bash (Ubuntu)
Changed in bash (Ubuntu):
importance: Undecided → Low
B Bobo (yout-bobo123)
tags: added: manpage
Revision history for this message
osirisgothra (osirisgothra) wrote :

I've confirmed these (and some more) bugs as well, very annoying when the cornerstone of the entire OS isn't documented properly. This is still the case in 13.04 raring, and probably in 13.10 saucy as well.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.