bash.1 vs HP-UX (also, lack of mention in help)

[Greg Wooledge]

** 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-nroff-diff
Description: Text document