[PATCH v2 1/3] man: document jobs builtin

[PATCH v2 1/3] man: document jobs builtin

[наб]

[-- Attachment #1: Type: text/plain, Size: 996 bytes --]

Fixes: https://bugs.debian.org/558607
---
Resending my patchset from May while I'm at it.

 src/dash.1 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/dash.1 b/src/dash.1
index ff02237..969a883 100644
--- a/src/dash.1
+++ b/src/dash.1
@@ -1464,6 +1464,20 @@ The
 .Fl r
 option causes the hash command to delete all the entries in the hash table
 except for functions.
+.It jobs Oo Fl lp Oc Op Ar job ...
+Display the status of all, or just the specified,
+.Ar job Ns s :
+.Bl -tag -compact -offset 5n -width "By default"
+.It By default
+display the job number, currency
+.Pq Sy +-
+status, if any, the job state, and its shell command.
+.It Fl l
+also output the PID of the group leader, and just the PID and shell commands
+of other members of the job.
+.It Fl p
+Display only leader PIDs, one per line.
+.El
 .It pwd Op Fl LP
 builtin command remembers what the current directory
 is rather than recomputing it each time.
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 2/3] man: note chdir being the same builtin as cd

[наб]

[-- Attachment #1: Type: text/plain, Size: 535 bytes --]

---
 src/dash.1 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/dash.1 b/src/dash.1
index 969a883..dd2bd47 100644
--- a/src/dash.1
+++ b/src/dash.1
@@ -1143,8 +1143,8 @@ Do not execute the command but
 search for the command and print the absolute pathname
 of utilities, the name for builtins or the expansion of aliases.
 .El
-.It cd Ar -
-.It Xo cd Op Fl LP
+.It cd|chdir Ar -
+.It Xo cd|chdir Op Fl LP
 .Op Ar directory
 .Xc
 Switch to the specified directory (default
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 3/3] man: document kill builtin

[наб]

[-- Attachment #1: Type: text/plain, Size: 1077 bytes --]

The manual now contains all built-ins
---
 src/dash.1 | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/src/dash.1 b/src/dash.1
index dd2bd47..514fcfe 100644
--- a/src/dash.1
+++ b/src/dash.1
@@ -1478,6 +1478,33 @@ of other members of the job.
 .It Fl p
 Display only leader PIDs, one per line.
 .El
+.It kill Oo Fl s Ar sigspec | Fl Ns Ar signum | Fl Ns Ar sigspec Oc Op Ar pid | job ...
+Equivalent to
+.Xr kill 1 ,
+but a
+.Ar job
+spec may also be specified.
+Signals can be either case-insensitive names without
+.Dv SIG
+prefixes or decimal numbers; the default is
+.Dv TERM .
+.It kill Fl l Op Ar signum | exitstatus
+List available signal names without the
+.Dv SIG
+prefix
+.Pq Ar sigspec Ns s .
+If
+.Ar signum
+specified, display just the
+.Ar sigspec
+for that signal.
+If
+.Ar exitstatus
+specified
+.Pq > Sy 128 ,
+display just the
+.Ar sigspec
+that caused it.
 .It pwd Op Fl LP
 builtin command remembers what the current directory
 is rather than recomputing it each time.
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 4/3] man: document false built-in

[наб]

[-- Attachment #1: Type: text/plain, Size: 604 bytes --]

Only true was documented, add false just below it
(out of order, but so is true, and the grouping makes much more sense).
---
 src/dash.1 | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/dash.1 b/src/dash.1
index 514fcfe..f06efb6 100644
--- a/src/dash.1
+++ b/src/dash.1
@@ -1095,6 +1095,8 @@ etc).
 .It :
 .It true
 A null command that returns a 0 (true) exit value.
+.It false
+A null command that returns a 1 (false) exit value.
 .It \&. file
 The commands in the specified file are read and executed by the shell.
 .It alias Op Ar name Ns Op Ar "=string ..."
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH v2 1/3] man: document jobs builtin

[Herbert Xu]

наб <nabijaczleweli@nabijaczleweli.xyz> wrote:
> [-- text/plain, encoding quoted-printable, charset: us-ascii, 37 lines --]
> 
> Fixes: https://bugs.debian.org/558607
> ---
> Resending my patchset from May while I'm at it.
> 
> src/dash.1 | 14 ++++++++++++++
> 1 file changed, 14 insertions(+)

All applied.  Thanks.
-- 
Email: Herbert Xu <herbert@gondor.apana.org.au>
Home Page: http://gondor.apana.org.au/~herbert/
PGP Key: http://gondor.apana.org.au/~herbert/pubkey.txt