Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > gnu.bash.bug > #11707

[patch] adding a missing bracket to the manual

Show all headers | View raw

[Multipart message — attachments visible in raw view] - view raw

In the Info document of bash-4.4-beta it says:

    cd [-L|[-P [-e]] [-@] [DIRECTORY]

which is missing a closing bracket somewhere.

On the man page and in 'help cd' it says:

    cd [-L|[-P [-e]] [-@]] [dir]

At first glance this seems to say that -@ can only be used
when also -L is used.  On closer reading this is of course
not so, but the brackets being so wide apart makes this
somewhat hard to parse.

So I would suggest the following instead:

    cd [-L]|[-P [-e]] [-@] [dir]

Of course it is somewhat silly to have "optional | optional",
but this way it is much clearer to me that -@ is independent
and also a bit clearer that -e only goes with -P.

Attached patch makes the proposed change.

(I may have patched a wrong file, though -- it's unclear to me
why generated files are in the git repo.)

Benno

-- 
http://www.fastmail.com - The way an email service should be

Back to gnu.bash.bug | Previous | Next | Find similar

Thread

[patch] adding a missing bracket to the manual Benno Schulenberg <bensberg@justemail.net> - 2015-10-19 13:55 +0200

csiph-web