'man bash' omits a very useful Option (listed near the beginning), ie ' -x Print commands and their arguments as they are executed'. this option is listed via 'bash -c "help set"' , but needs to be inserted into the 'man' file between '-s' & '-D'.
per gentoo-dev mailing list marking this as invalid
'invalid' is not a reponse to anything, just on its own. perhaps a few additional words of explanation ?
considering you're on the mailing list and you should have seen the final response i didnt feel it was needed http://article.gmane.org/gmane.linux.gentoo.devel/15819
well, what you said was : "In my opinion, the bash man page is as clear as mud to someone that hasn't been around Unix/Linux for awhile", which suggests a willingness to make improvements depending on difficulty, time etc. i suppose the 'Options' section does say " In addition to the single-character shell options documented in the description of the set builtin command, bash interprets the following options when it is invoked", so you might argue that adding '-x' there wb to say the same thing twice. however, the description in the 'Set ' section -- "After expanding each simple command, display the expanded value of PS4, followed by the command and its expanded arguments" -- is hardly the same as the description given via 'bash -c "help set"' -- "Print commands and their arguments as they are executed". the former does not say anything about executing the commands, merely displaying them. so i'ld say something needs to be added somewhere & the minimal change is the one i originally suggested.
i didnt say any of that, i'm not Paul :P at any rate, like you said, the manpage says that when bash is invoked, it also supports all the things that the builtin command 'set' supports if we look at 'set', it supports a ton of commands, so copying and pasting all of those to the OPTIONS section is a lot of bloating
well, then you need to add in the Set section that each command is executed as it is displayed, which is the difference i pointed out between what Set says re '-x' & what 'bash -h' says re it. as things stand, the man page nowhere tells users that the commands are actually executed, which well mb the vital thing they need to know.
