[prev in list] [next in list] [prev in thread] [next in thread] 

List:       bash-bug
Subject:    man page missing definition of jobspec
From:       Mikel Ward <mikel () mikelward ! com>
Date:       2008-02-03 23:15:21
Message-ID: 1202080521.3082.7.camel () localhost ! localdomain
[Download RAW message or body]

bg, fg, disown, jobs, kill, and notify take a "jobspec" as an argument.
I couldn't find a definition of "jobspec" in the man page.  (There is
one in the info documentation.)

This adds the definition just below the definition of the "jobs"
builtin.  There might be a better place for it, but it would be best
somewhere in the SHELL BUILTIN COMMANDS section, otherwise those
builtins will refer to something not documented in the current man page.



["bash.jobspec.patch" (bash.jobspec.patch)]

--- bash.1.old	2008-02-04 09:54:34.000000000 +1100
+++ bash.1	2008-02-04 10:14:36.000000000 +1100
@@ -7175,10 +7175,33 @@
 passing it
 .IR args ,
 returning its exit status.
+.PP
+Valid \fBjobspecs\fR are:
+.PD 0
+.TP
+\fB%\fR\fIn\fR
+Job number \fIn\fR (the number printed when the job was placed in the background)
+.PD 0
+.TP
+\fB%\fR, \fB%%\fR, \fB%+\fR
+Current job (the last job placed in the background)
+.PD 0
+.TP
+\fB+-\fR
+Previous job (the second last job placed in the background)
+.PD 0
+.TP
+\fB%\fR\fIs\fR
+Job whose name is \fIs\fR (error if not unique)
+.PD 0
+.TP
+\fB%?\fR\fIs\fR
+Job whose name contains \fIs\fR (error if not unique)
+.PD
 .RE
 .TP
 \fBkill\fP [\fB\-s\fP \fIsigspec\fP | \fB\-n\fP \fIsignum\fP | \
                \fB\-\fP\fIsigspec\fP] [\fIpid\fP | \fIjobspec\fP] ...
-.PD 0
+.PD0
 .TP
 \fBkill\fP \fB\-l\fP [\fIsigspec\fP | \fIexit_status\fP]
 .PD



[prev in list] [next in list] [prev in thread] [next in thread]