pages/common/*: correct urls, see also improvements, unbashify pages, examples addition (#16841)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

pages/common/alias.md

@@ -1,8 +1,9 @@
 # alias
 
 > Create aliases - words that are replaced by a command string.
-> Aliases expire with the current shell session unless defined in the shell's configuration file, e.g. `~/.bashrc`.
+> Aliases expire with the current shell session unless defined in the shell's configuration file, e.g. `~/.bashrc` for Bash or `~/.zshrc` for Zsh.
-> More information: <https://tldp.org/LDP/abs/html/aliases.html>.
+> See also: `unalias`.
+> More information: <https://manned.org/alias>.
 
 - List all aliases:
 

pages/common/bg.md

@@ -1,12 +1,13 @@
 # bg
 
 > Resume suspended jobs (e.g. using `<Ctrl z>`), and keeps them running in the background.
+> See also: `jobs`, `fg` and `disown`.
 > More information: <https://manned.org/bg>.
 
 - Resume the most recently suspended job and run it in the background:
 
 `bg`
 
-- Resume a specific job (use `jobs -l` to get its ID) and run it in the background:
+- Resume a specific job and run it in the background (run `jobs` to find the job number):
 
-`bg %{{job_id}}`
+`bg %{{job_number}}`

pages/common/command.md

@@ -7,6 +7,10 @@
 
 `command {{ls}}`
 
+- Find and execute a command using a default `$PATH` (`/bin:/usr/bin:/sbin:/usr/sbin:/etc:/usr/etc`) that guarantees to find all standard utilities:
+
+`command -p {{command_name}}`
+
 - Display the path to the executable or the alias definition of a specific command:
 
 `command -v {{command_name}}`

pages/common/dirs.md

@@ -2,6 +2,7 @@
 
 > Display or manipulate the directory stack.
 > The directory stack is a list of recently visited directories that can be manipulated with the `pushd` and `popd` commands.
+> See also: `pushd`, `popd`.
 > More information: <https://www.gnu.org/software/bash/manual/bash.html#Directory-Stack-Builtins>.
 
 - Display the directory stack with a space between each entry:
@@ -12,10 +13,22 @@
 
 `dirs -p`
 
-- Display only the `n`th entry in the directory stack, starting at 0:
+- Display a numbered list of entries in the directory stack:
+
+`dirs -v`
+
+- Display the directory stack without the tilde-prefix (`~`):
+
+`dirs -l`
+
+- Display only the `n`th entry in the directory stack, starting at 0 (Bash only):
 
 `dirs +{{n}}`
 
+- Display only the `n`th entry in the directory stack from the last, starting at 0 (Bash only):
+
+`dirs -{{n}}`
+
 - Clear the directory stack:
 
 `dirs -c`

pages/common/disown.md

@@ -1,21 +1,21 @@
 # disown
 
 > Allow sub-processes to live beyond the shell that they are attached to.
-> See also the `jobs` command.
+> See also: `jobs` for finding job numbers.
 > More information: <https://www.gnu.org/software/bash/manual/bash.html#index-disown>.
 
 - Disown the current job:
 
 `disown`
 
-- Disown a specific job:
+- Disown a specific job (run `jobs` to find the job number):
 
 `disown %{{job_number}}`
 
-- Disown all jobs:
+- Disown all jobs (Bash only):
 
 `disown -a`
 
-- Keep job (do not disown it), but mark it so that no future SIGHUP is received on shell exit:
+- Keep job (do not disown it), but mark it so that no future SIGHUP is received on shell exit (Bash only):
 
 `disown -h %{{job_number}}`

pages/common/echo.md

@@ -1,6 +1,7 @@
 # echo
 
 > Print given arguments.
+> See also: `printf`.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/echo-invocation.html>.
 
 - Print a text message. Note: Quotes are optional:

pages/common/fg.md

@@ -1,12 +1,13 @@
 # fg
 
 > Run jobs in foreground.
+> See also: `jobs`, `bg` and `disown`.
 > More information: <https://manned.org/fg>.
 
 - Bring most recently suspended or running background job to foreground:
 
 `fg`
 
-- Bring a specific job to foreground:
+- Bring a specific job to foreground (run `jobs` to find the job number):
 
-`fg %{{job_id}}`
+`fg %{{job_number}}`

pages/common/local.md

@@ -1,7 +1,7 @@
 # local
 
 > Declare local variables and give them attributes.
-> See also: `declare`.
+> See also: `declare` and `export`.
 > More information: <https://www.gnu.org/software/bash/manual/bash.html#index-local>.
 
 - Declare a string variable with the specified value:

pages/common/popd.md

@@ -1,7 +1,7 @@
 # popd
 
 > Remove a directory placed on the directory stack via the pushd shell built-in.
-> See also `pushd` to place a directory on the stack and `dirs` to display directory stack contents.
+> See also: `pushd` to place a directory on the stack and `dirs` to display directory stack contents.
 > More information: <https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html#index-popd>.
 
 - Remove the top directory from the stack and cd to it:

pages/common/printf.md

@@ -1,6 +1,7 @@
 # printf
 
 > Format and print text.
+> See also: `echo`.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/printf-invocation.html>.
 
 - Print a text message:

pages/common/pushd.md

@@ -1,7 +1,7 @@
 # pushd
 
 > Place a directory on a stack so it can be accessed later.
-> See also `popd` to switch back to original directory and `dirs` to display directory stack contents.
+> See also: `popd` to switch back to original directory and `dirs` to display directory stack contents.
 > More information: <https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html#index-pushd>.
 
 - Switch to directory and push it on the stack:

pages/common/test.md

@@ -23,3 +23,7 @@
 - If A is true, then do B, or C in the case of an error (notice that C may run even if A fails):
 
 `test {{condition}} && {{echo "true"}} || {{echo "false"}}`
+
+- Use `test` in a conditional statement:
+
+`if test -f "{{path/to/file}}"; then echo "File exists"; else echo "File does not exist"; fi`

pages/common/unalias.md

@@ -1,6 +1,7 @@
 # unalias
 
 > Remove aliases.
+> See also: `alias`.
 > More information: <https://manned.org/unalias>.
 
 - Remove an alias:

pages/common/wait.md

@@ -1,6 +1,7 @@
 # wait
 
 > Wait for a process to complete before proceeding.
+> See also: `ps` to view information about running processes.
 > More information: <https://manned.org/wait>.
 
 - Wait for a process to finish given its process ID (PID) and return its exit status:
@@ -11,7 +12,7 @@
 
 `wait`
 
-- Wait for a job to finish:
+- Wait for a job to finish (run `jobs` to find the job number):
 
 `wait %{{job_number}}`