[PATCH 1/2] man: document jobs builtin

[PATCH 1/2] man: document jobs builtin

[наб]

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

Fixes: Debian #558607
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
Please keep me in CC, as I'm not subscribed.

 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 2/2] man: note chdir being the same builtin as cd

[наб]

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

The manual now contains all built-ins

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
Please keep me in CC, as I'm not subscribed.

 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 3/2] man: document kill builtin

[наб]

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

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
I missed that kill wasn't documented;
it is now, and it should really be all.

Please keep me in CC, as I'm not subscribed.

 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 --]