** First issue: In the bash.1 man page, the following section is not rendered correctly by the HP-UX version of nroff:
If a .I sigspec is .SM .BR RETURN , the command .I arg is executed each time a shell function or a script executed with the \fB.\fP or \fBsource\fP builtins finishes executing. The problem is the last line, which begins with a dot. Even with the \fB...\fP markup around it, nroff interprets this as an entry in a bullet-point list. (The nroff on Debian 5.0 doesn't seem to share this interpretation.) However, since there's no whitespace in front of the bullet point indicator, the line is simply discarded. I get a truncated sentence. The simplest fix is to move the word "the" from the previous line down to the start of the next line: is executed each time a shell function or a script executed with the \fB.\fP or \fBsource\fP builtins finishes executing. I don't know whether this is a bug in my version of nroff, or if this is how things are supposed to work. But... there it is. ** Second issue: There's no mention of RETURN in 'help trap'. It's only documented in the man page. And since I couldn't read it in the man page, that left me a bit stuck when someone asked about it.
--- bash.1.orig Tue Oct 19 16:45:59 2010 +++ bash.1 Tue Oct 19 16:46:19 2010 @@ -9190,8 +9190,8 @@ .BR RETURN , the command .I arg -is executed each time a shell function or a script executed with the -\fB.\fP or \fBsource\fP builtins finishes executing. +is executed each time a shell function or a script executed with +the \fB.\fP or \fBsource\fP builtins finishes executing. .if t .sp 0.5 .if n .sp 1 If a
