]> TLD Linux GIT Repositories - packages/coreutils.git/blob - coreutils-info.patch
- merged 9.0 from PLD
[packages/coreutils.git] / coreutils-info.patch
1 --- coreutils-9.0/doc/coreutils.texi.orig       2021-09-24 13:31:05.000000000 +0200
2 +++ coreutils-9.0/doc/coreutils.texi    2021-10-07 17:55:04.486617755 +0200
3 @@ -22,123 +22,112 @@
4  @syncodeindex pg cp
5  @syncodeindex vr cp
6  
7 -@dircategory Basics
8 +@dircategory Core utilities:
9  @direntry
10 -* Coreutils: (coreutils).       Core GNU (file, text, shell) utilities.
11 +* Coreutils: (coreutils).              Core GNU (file, text, shell) utilities
12  * Common options: (coreutils)Common options.
13 -* File permissions: (coreutils)File permissions.  Access modes.
14 +* File permissions: (coreutils)File permissions.       Access modes.
15  * Date input formats: (coreutils)Date input formats.
16 -@end direntry
17 -
18 -@c FIXME: the following need documentation
19 -@c * [: (coreutils)[ invocation.                   File/string tests.
20 -@c * pinky: (coreutils)pinky invocation.           FIXME.
21 -
22 -@dircategory Individual utilities
23 -@direntry
24 -* arch: (coreutils)arch invocation.             Print machine hardware name.
25 -* b2sum: (coreutils)b2sum invocation.           Print or check BLAKE2 digests.
26 -* base32: (coreutils)base32 invocation.         Base32 encode/decode data.
27 -* base64: (coreutils)base64 invocation.         Base64 encode/decode data.
28 -* basename: (coreutils)basename invocation.     Strip directory and suffix.
29 -* basenc: (coreutils)basenc invocation.         Encoding/decoding of data.
30 -* cat: (coreutils)cat invocation.               Concatenate and write files.
31 -* chcon: (coreutils)chcon invocation.           Change SELinux CTX of files.
32 -* chgrp: (coreutils)chgrp invocation.           Change file groups.
33 -* chmod: (coreutils)chmod invocation.           Change access permissions.
34 -* chown: (coreutils)chown invocation.           Change file owners and groups.
35 -* chroot: (coreutils)chroot invocation.         Specify the root directory.
36 -* cksum: (coreutils)cksum invocation.           Print POSIX CRC checksum.
37 -* comm: (coreutils)comm invocation.             Compare sorted files by line.
38 -* cp: (coreutils)cp invocation.                 Copy files.
39 -* csplit: (coreutils)csplit invocation.         Split by context.
40 -* cut: (coreutils)cut invocation.               Print selected parts of lines.
41 -* date: (coreutils)date invocation.             Print/set system date and time.
42 -* dd: (coreutils)dd invocation.                 Copy and convert a file.
43 -* df: (coreutils)df invocation.                 Report file system usage.
44 -* dir: (coreutils)dir invocation.               List directories briefly.
45 -* dircolors: (coreutils)dircolors invocation.   Color setup for ls.
46 -* dirname: (coreutils)dirname invocation.       Strip last file name component.
47 -* du: (coreutils)du invocation.                 Report file usage.
48 -* echo: (coreutils)echo invocation.             Print a line of text.
49 -* env: (coreutils)env invocation.               Modify the environment.
50 -* expand: (coreutils)expand invocation.         Convert tabs to spaces.
51 -* expr: (coreutils)expr invocation.             Evaluate expressions.
52 -* factor: (coreutils)factor invocation.         Print prime factors
53 -* false: (coreutils)false invocation.           Do nothing, unsuccessfully.
54 -* fmt: (coreutils)fmt invocation.               Reformat paragraph text.
55 -* fold: (coreutils)fold invocation.             Wrap long input lines.
56 -* groups: (coreutils)groups invocation.         Print group names a user is in.
57 -* head: (coreutils)head invocation.             Output the first part of files.
58 -* hostid: (coreutils)hostid invocation.         Print numeric host identifier.
59 -* hostname: (coreutils)hostname invocation.     Print or set system name.
60 -* id: (coreutils)id invocation.                 Print user identity.
61 -* install: (coreutils)install invocation.       Copy files and set attributes.
62 -* join: (coreutils)join invocation.             Join lines on a common field.
63 -* kill: (coreutils)kill invocation.             Send a signal to processes.
64 -* link: (coreutils)link invocation.             Make hard links between files.
65 -* ln: (coreutils)ln invocation.                 Make links between files.
66 -* logname: (coreutils)logname invocation.       Print current login name.
67 -* ls: (coreutils)ls invocation.                 List directory contents.
68 -* md5sum: (coreutils)md5sum invocation.         Print or check MD5 digests.
69 -* mkdir: (coreutils)mkdir invocation.           Create directories.
70 -* mkfifo: (coreutils)mkfifo invocation.         Create FIFOs (named pipes).
71 -* mknod: (coreutils)mknod invocation.           Create special files.
72 -* mktemp: (coreutils)mktemp invocation.         Create temporary files.
73 -* mv: (coreutils)mv invocation.                 Rename files.
74 -* nice: (coreutils)nice invocation.             Modify niceness.
75 -* nl: (coreutils)nl invocation.                 Number lines and write files.
76 -* nohup: (coreutils)nohup invocation.           Immunize to hangups.
77 -* nproc: (coreutils)nproc invocation.           Print the number of processors.
78 -* numfmt: (coreutils)numfmt invocation.         Reformat numbers.
79 -* od: (coreutils)od invocation.                 Dump files in octal, etc.
80 -* paste: (coreutils)paste invocation.           Merge lines of files.
81 -* pathchk: (coreutils)pathchk invocation.       Check file name portability.
82 -* pr: (coreutils)pr invocation.                 Paginate or columnate files.
83 -* printenv: (coreutils)printenv invocation.     Print environment variables.
84 -* printf: (coreutils)printf invocation.         Format and print data.
85 -* ptx: (coreutils)ptx invocation.               Produce permuted indexes.
86 -* pwd: (coreutils)pwd invocation.               Print working directory.
87 -* readlink: (coreutils)readlink invocation.     Print referent of a symlink.
88 -* realpath: (coreutils)realpath invocation.     Print resolved file names.
89 -* rm: (coreutils)rm invocation.                 Remove files.
90 -* rmdir: (coreutils)rmdir invocation.           Remove empty directories.
91 -* runcon: (coreutils)runcon invocation.         Run in specified SELinux CTX.
92 -* seq: (coreutils)seq invocation.               Print numeric sequences
93 -* sha1sum: (coreutils)sha1sum invocation.       Print or check SHA-1 digests.
94 -* sha2: (coreutils)sha2 utilities.              Print or check SHA-2 digests.
95 -* shred: (coreutils)shred invocation.           Remove files more securely.
96 -* shuf: (coreutils)shuf invocation.             Shuffling text files.
97 -* sleep: (coreutils)sleep invocation.           Delay for a specified time.
98 -* sort: (coreutils)sort invocation.             Sort text files.
99 -* split: (coreutils)split invocation.           Split into pieces.
100 -* stat: (coreutils)stat invocation.             Report file(system) status.
101 -* stdbuf: (coreutils)stdbuf invocation.         Modify stdio buffering.
102 -* stty: (coreutils)stty invocation.             Print/change terminal settings.
103 -* sum: (coreutils)sum invocation.               Print traditional checksum.
104 -* sync: (coreutils)sync invocation.             Sync files to stable storage.
105 -* tac: (coreutils)tac invocation.               Reverse files.
106 -* tail: (coreutils)tail invocation.             Output the last part of files.
107 -* tee: (coreutils)tee invocation.               Redirect to multiple files.
108 -* test: (coreutils)test invocation.             File/string tests.
109 -* timeout: (coreutils)timeout invocation.       Run with time limit.
110 -* touch: (coreutils)touch invocation.           Change file timestamps.
111 -* tr: (coreutils)tr invocation.                 Translate characters.
112 -* true: (coreutils)true invocation.             Do nothing, successfully.
113 -* truncate: (coreutils)truncate invocation.     Shrink/extend size of a file.
114 -* tsort: (coreutils)tsort invocation.           Topological sort.
115 -* tty: (coreutils)tty invocation.               Print terminal name.
116 -* uname: (coreutils)uname invocation.           Print system information.
117 -* unexpand: (coreutils)unexpand invocation.     Convert spaces to tabs.
118 -* uniq: (coreutils)uniq invocation.             Uniquify files.
119 -* unlink: (coreutils)unlink invocation.         Removal via unlink(2).
120 -* uptime: (coreutils)uptime invocation.         Print uptime and load.
121 -* users: (coreutils)users invocation.           Print current user names.
122 -* vdir: (coreutils)vdir invocation.             List directories verbosely.
123 -* wc: (coreutils)wc invocation.                 Line, word, and byte counts.
124 -* who: (coreutils)who invocation.               Print who is logged in.
125 -* whoami: (coreutils)whoami invocation.         Print effective user ID.
126 -* yes: (coreutils)yes invocation.               Print a string indefinitely.
127 +* arch: (coreutils)arch.               Print machine hardware name.
128 +* b2sum: (coreutils)b2sum.             Print or check BLAKE2 digests.
129 +* base32: (coreutils)base32.           Base32 encode/decode data.
130 +* base64: (coreutils)base64.           Base64 encode/decode data.
131 +* basename: (coreutils)basename.       Strip directory and suffix.
132 +* basenc: (coreutils)basenc.           Encoding/decoding of data.
133 +* cat: (coreutils)cat.                 Concatenate and write files.
134 +* chcon: (coreutils)chcon.             Change SELinux CTX of files.
135 +* chgrp: (coreutils)chgrp.             Change file groups.
136 +* chmod: (coreutils)chmod.             Change access permissions.
137 +* chown: (coreutils)chown.             Change file owners and groups.
138 +* chroot: (coreutils)chroot.           Specify the root directory.
139 +* cksum: (coreutils)cksum.             Print POSIX CRC checksum.
140 +* comm: (coreutils)comm.               Compare sorted files by line.
141 +* cp: (coreutils)cp.                   Copy files.
142 +* csplit: (coreutils)csplit.           Split by context.
143 +* cut: (coreutils)cut.                 Print selected parts of lines.
144 +* date: (coreutils)date.               Print/set system date and time.
145 +* dd: (coreutils)dd.                   Copy and convert a file.
146 +* df: (coreutils)df.                   Report file system usage.
147 +* dir: (coreutils)dir.                 List directories briefly.
148 +* dircolors: (coreutils)dircolors.     Color setup for ls.
149 +* dirname: (coreutils)dirname.         Strip last file name component.
150 +* du: (coreutils)du.                   Report file usage.
151 +* echo: (coreutils)echo.               Print a line of text.
152 +* env: (coreutils)env.                 Modify the environment.
153 +* expand: (coreutils)expand.           Convert tabs to spaces.
154 +* expr: (coreutils)expr.               Evaluate expressions.
155 +* factor: (coreutils)factor.           Print prime factors
156 +* false: (coreutils)false.             Do nothing, unsuccessfully.
157 +* fmt: (coreutils)fmt.                 Reformat paragraph text.
158 +* fold: (coreutils)fold.               Wrap long input lines.
159 +* groups: (coreutils)groups.           Print group names a user is in.
160 +* head: (coreutils)head.               Output the first part of files.
161 +* hostid: (coreutils)hostid.           Print numeric host identifier.
162 +* id: (coreutils)id.                   Print user identity.
163 +* install: (coreutils)install.         Copy files and set attributes.
164 +* join: (coreutils)join.               Join lines on a common field.
165 +* link: (coreutils)link.               Make hard links between files.
166 +* ln: (coreutils)ln.                   Make links between files.
167 +* logname: (coreutils)logname.         Print current login name.
168 +* ls: (coreutils)ls.                   List directory contents.
169 +* md5sum: (coreutils)md5sum.           Print or check MD5 digests.
170 +* mkdir: (coreutils)mkdir.             Create directories.
171 +* mkfifo: (coreutils)mkfifo.           Create FIFOs (named pipes).
172 +* mknod: (coreutils)mknod.             Create special files.
173 +* mktemp: (coreutils)mktemp.           Create temporary files.
174 +* mv: (coreutils)mv.                   Rename files.
175 +* nice: (coreutils)nice.               Modify niceness.
176 +* nl: (coreutils)nl.                   Number lines and write files.
177 +* nohup: (coreutils)nohup.             Immunize to hangups.
178 +* nproc: (coreutils)nproc.             Print the number of processors.
179 +* numfmt: (coreutils)numfmt.           Reformat numbers.
180 +* od: (coreutils)od.                   Dump files in octal, etc.
181 +* paste: (coreutils)paste.             Merge lines of files.
182 +* pathchk: (coreutils)pathchk.         Check file name portability.
183 +* pr: (coreutils)pr.                   Paginate or columnate files.
184 +* printenv: (coreutils)printenv.       Print environment variables.
185 +* printf: (coreutils)printf.           Format and print data.
186 +* ptx: (coreutils)ptx.                 Produce permuted indexes.
187 +* pwd: (coreutils)pwd.                 Print working directory.
188 +* readlink: (coreutils)readlink.       Print referent of a symlink.
189 +* realpath: (coreutils)realpath.       Print resolved file names.
190 +* rm: (coreutils)rm.                   Remove files.
191 +* rmdir: (coreutils)rmdir.             Remove empty directories.
192 +* runcon: (coreutils)runcon.           Run in specified SELinux CTX.
193 +* seq: (coreutils)seq.                 Print numeric sequences
194 +* sha1sum: (coreutils)sha1sum.         Print or check SHA-1 digests.
195 +* sha2: (coreutils)sha2 utilities.     Print or check SHA-2 digests.
196 +* shred: (coreutils)shred.             Remove files more securely.
197 +* shuf: (coreutils)shuf.               Shuffling text files.
198 +* sleep: (coreutils)sleep.             Delay for a specified time.
199 +* sort: (coreutils)sort.               Sort text files.
200 +* split: (coreutils)split.             Split into pieces.
201 +* stat: (coreutils)stat.               Report file(system) status.
202 +* stdbuf: (coreutils)stdbuf.           Modify stdio buffering.
203 +* stty: (coreutils)stty.               Print/change terminal settings.
204 +* sum: (coreutils)sum.                 Print traditional checksum.
205 +* sync: (coreutils)sync.               Sync files to stable storage.
206 +* tac: (coreutils)tac.                 Reverse files.
207 +* tail: (coreutils)tail.               Output the last part of files.
208 +* tee: (coreutils)tee.                 Redirect to multiple files.
209 +* test: (coreutils)test.               File/string tests.
210 +* timeout: (coreutils)timeout.         Run with time limit.
211 +* touch: (coreutils)touch.             Change file timestamps.
212 +* tr: (coreutils)tr.                   Translate characters.
213 +* true: (coreutils)true.               Do nothing, successfully.
214 +* truncate: (coreutils)truncate.       Shrink/extend size of a file.
215 +* tsort: (coreutils)tsort.             Topological sort.
216 +* tty: (coreutils)tty.                 Print terminal name.
217 +* uname: (coreutils)uname.             Print system information.
218 +* unexpand: (coreutils)unexpand.       Convert spaces to tabs.
219 +* uniq: (coreutils)uniq.               Uniquify files.
220 +* unlink: (coreutils)unlink.           Removal via unlink(2).
221 +* users: (coreutils)users.             Print current user names.
222 +* vdir: (coreutils)vdir.               List directories verbosely.
223 +* wc: (coreutils)wc.                   Line, word, and byte counts.
224 +* who: (coreutils)who.                 Print who is logged in.
225 +* whoami: (coreutils)whoami.           Print effective user ID.
226 +* yes: (coreutils)yes.                 Print a string indefinitely.
227  @end direntry
228  
229  @copying
230 @@ -203,10 +192,9 @@ Free Documentation License''.
231  * File name manipulation::       dirname basename pathchk mktemp realpath
232  * Working context::              pwd stty printenv tty
233  * User information::             id logname whoami groups users who
234 -* System context::               date arch nproc uname hostname hostid uptime
235 +* System context::               date arch nproc uname hostid
236  * SELinux context::              chcon runcon
237  * Modified command invocation::  chroot env nice nohup stdbuf timeout
238 -* Process control::              kill
239  * Delaying::                     sleep
240  * Numeric operations::           factor numfmt seq
241  * File permissions::             Access modes
242 @@ -238,45 +226,45 @@ Common Options
243  
244  Output of entire files
245  
246 -* cat invocation::               Concatenate and write files
247 -* tac invocation::               Concatenate and write files in reverse
248 -* nl invocation::                Number lines and write files
249 -* od invocation::                Write files in octal or other formats
250 -* base32 invocation::            Transform data into printable data
251 -* base64 invocation::            Transform data into printable data
252 -* basenc invocation::            Transform data into printable data
253 +* cat::                          Concatenate and write files
254 +* tac::                          Concatenate and write files in reverse
255 +* nl::                           Number lines and write files
256 +* od::                           Write files in octal or other formats
257 +* base32::                       Transform data into printable data
258 +* base64::                       Transform data into printable data
259 +* basenc::                       Transform data into printable data
260  
261  Formatting file contents
262  
263 -* fmt invocation::               Reformat paragraph text
264 -* pr invocation::                Paginate or columnate files for printing
265 -* fold invocation::              Wrap input lines to fit in specified width
266 +* fmt::                          Reformat paragraph text
267 +* pr::                           Paginate or columnate files for printing
268 +* fold::                         Wrap input lines to fit in specified width
269  
270  Output of parts of files
271  
272 -* head invocation::              Output the first part of files
273 -* tail invocation::              Output the last part of files
274 -* split invocation::             Split a file into fixed-size pieces
275 -* csplit invocation::            Split a file into context-determined pieces
276 +* head::                         Output the first part of files
277 +* tail::                         Output the last part of files
278 +* split::                        Split a file into fixed-size pieces
279 +* csplit::                       Split a file into context-determined pieces
280  
281  Summarizing files
282  
283 -* wc invocation::                Print newline, word, and byte counts
284 -* sum invocation::               Print checksum and block counts
285 -* cksum invocation::             Print CRC checksum and byte counts
286 -* b2sum invocation::             Print or check BLAKE2 digests
287 -* md5sum invocation::            Print or check MD5 digests
288 -* sha1sum invocation::           Print or check SHA-1 digests
289 +* wc::                           Print newline, word, and byte counts
290 +* sum::                          Print checksum and block counts
291 +* cksum::                        Print CRC checksum and byte counts
292 +* b2sum::                        Print or check BLAKE2 digests
293 +* md5sum::                       Print or check MD5 digests
294 +* sha1sum::                      Print or check SHA-1 digests
295  * sha2 utilities::               Print or check SHA-2 digests
296  
297  Operating on sorted files
298  
299 -* sort invocation::              Sort text files
300 -* shuf invocation::              Shuffle text files
301 -* uniq invocation::              Uniquify files
302 -* comm invocation::              Compare two sorted files line by line
303 -* ptx invocation::               Produce a permuted index of file contents
304 -* tsort invocation::             Topological sort
305 +* sort::                         Sort text files
306 +* shuf::                         Shuffle text files
307 +* uniq::                         Uniquify files
308 +* comm::                         Compare two sorted files line by line
309 +* ptx::                          Produce a permuted index of file contents
310 +* tsort::                        Topological sort
311  
312  @command{ptx}: Produce permuted indexes
313  
314 @@ -288,15 +276,15 @@ Operating on sorted files
315  
316  Operating on fields
317  
318 -* cut invocation::               Print selected parts of lines
319 -* paste invocation::             Merge lines of files
320 -* join invocation::              Join lines on a common field
321 +* cut::                          Print selected parts of lines
322 +* paste::                        Merge lines of files
323 +* join::                         Join lines on a common field
324  
325  Operating on characters
326  
327 -* tr invocation::                Translate, squeeze, and/or delete characters
328 -* expand invocation::            Convert tabs to spaces
329 -* unexpand invocation::          Convert spaces to tabs
330 +* tr::                           Translate, squeeze, and/or delete characters
331 +* expand::                       Convert tabs to spaces
332 +* unexpand::                     Convert spaces to tabs
333  
334  @command{tr}: Translate, squeeze, and/or delete characters
335  
336 @@ -306,10 +294,10 @@ Operating on characters
337  
338  Directory listing
339  
340 -* ls invocation::                List directory contents
341 -* dir invocation::               Briefly list directory contents
342 -* vdir invocation::              Verbosely list directory contents
343 -* dircolors invocation::         Color setup for @command{ls}
344 +* ls::                           List directory contents
345 +* dir::                          Briefly list directory contents
346 +* vdir::                         Verbosely list directory contents
347 +* dircolors::                    Color setup for @command{ls}
348  
349  @command{ls}:  List directory contents
350  
351 @@ -321,51 +309,51 @@ Directory listing
352  
353  Basic operations
354  
355 -* cp invocation::                Copy files and directories
356 -* dd invocation::                Convert and copy a file
357 -* install invocation::           Copy files and set attributes
358 -* mv invocation::                Move (rename) files
359 -* rm invocation::                Remove files or directories
360 -* shred invocation::             Remove files more securely
361 +* cp::                           Copy files and directories
362 +* dd::                           Convert and copy a file
363 +* install::                      Copy files and set attributes
364 +* mv::                           Move (rename) files
365 +* rm::                           Remove files or directories
366 +* shred::                        Remove files more securely
367  
368  Special file types
369  
370 -* link invocation::              Make a hard link via the link syscall
371 -* ln invocation::                Make links between files
372 -* mkdir invocation::             Make directories
373 -* mkfifo invocation::            Make FIFOs (named pipes)
374 -* mknod invocation::             Make block or character special files
375 -* readlink invocation::          Print value of a symlink or canonical file name
376 -* rmdir invocation::             Remove empty directories
377 -* unlink invocation::            Remove files via unlink syscall
378 +* link::                         Make a hard link via the link syscall
379 +* ln::                           Make links between files
380 +* mkdir::                        Make directories
381 +* mkfifo::                       Make FIFOs (named pipes)
382 +* mknod::                        Make block or character special files
383 +* readlink::                     Print value of a symlink or canonical file name
384 +* rmdir::                        Remove empty directories
385 +* unlink::                       Remove files via unlink syscall
386  
387  Changing file attributes
388  
389 -* chown invocation::             Change file owner and group
390 -* chgrp invocation::             Change group ownership
391 -* chmod invocation::             Change access permissions
392 -* touch invocation::             Change file timestamps
393 +* chown::                        Change file owner and group
394 +* chgrp::                        Change group ownership
395 +* chmod::                        Change access permissions
396 +* touch::                        Change file timestamps
397  
398  File space usage
399  
400 -* df invocation::                Report file system space usage
401 -* du invocation::                Estimate file space usage
402 -* stat invocation::              Report file or file system status
403 -* sync invocation::              Synchronize cached writes to persistent storage
404 -* truncate invocation::          Shrink or extend the size of a file
405 +* df::                           Report file system space usage
406 +* du::                           Estimate file space usage
407 +* stat::                         Report file or file system status
408 +* sync::                         Synchronize cached writes to persistent storage
409 +* truncate::                     Shrink or extend the size of a file
410  
411  Printing text
412  
413 -* echo invocation::              Print a line of text
414 -* printf invocation::            Format and print data
415 -* yes invocation::               Print a string until interrupted
416 +* echo::                         Print a line of text
417 +* printf::                       Format and print data
418 +* yes::                          Print a string until interrupted
419  
420  Conditions
421  
422 -* false invocation::             Do nothing, unsuccessfully
423 -* true invocation::              Do nothing, successfully
424 -* test invocation::              Check file types and compare values
425 -* expr invocation::              Evaluate expressions
426 +* false::                        Do nothing, unsuccessfully
427 +* true::                         Do nothing, successfully
428 +* test::                         Check file types and compare values
429 +* expr::                         Evaluate expressions
430  
431  @command{test}: Check file types and compare values
432  
433 @@ -384,22 +372,22 @@ Conditions
434  
435  Redirection
436  
437 -* tee invocation::               Redirect output to multiple files or processes
438 +* tee::                          Redirect output to multiple files or processes
439  
440  File name manipulation
441  
442 -* basename invocation::          Strip directory and suffix from a file name
443 -* dirname invocation::           Strip last file name component
444 -* pathchk invocation::           Check file name validity and portability
445 -* mktemp invocation::            Create temporary file or directory
446 -* realpath invocation::          Print resolved file names
447 +* basename::                     Strip directory and suffix from a file name
448 +* dirname::                      Strip last file name component
449 +* pathchk::                      Check file name validity and portability
450 +* mktemp::                       Create temporary file or directory
451 +* realpath::                     Print resolved file names
452  
453  Working context
454  
455 -* pwd invocation::               Print working directory
456 -* stty invocation::              Print or change terminal characteristics
457 -* printenv invocation::          Print all or some environment variables
458 -* tty invocation::               Print file name of terminal on standard input
459 +* pwd::                          Print working directory
460 +* stty::                         Print or change terminal characteristics
461 +* printenv::                     Print all or some environment variables
462 +* tty::                          Print file name of terminal on standard input
463  
464  @command{stty}: Print or change terminal characteristics
465  
466 @@ -413,22 +401,20 @@ Working context
467  
468  User information
469  
470 -* id invocation::                Print user identity
471 -* logname invocation::           Print current login name
472 -* whoami invocation::            Print effective user ID
473 -* groups invocation::            Print group names a user is in
474 -* users invocation::             Print login names of users currently logged in
475 -* who invocation::               Print who is currently logged in
476 +* id::                           Print user identity
477 +* logname::                      Print current login name
478 +* whoami::                       Print effective user ID
479 +* groups::                       Print group names a user is in
480 +* users::                        Print login names of users currently logged in
481 +* who::                          Print who is currently logged in
482  
483  System context
484  
485 -* arch invocation::              Print machine hardware name
486 -* date invocation::              Print or set system date and time
487 -* nproc invocation::             Print the number of processors
488 -* uname invocation::             Print system information
489 -* hostname invocation::          Print or set system name
490 -* hostid invocation::            Print numeric host identifier
491 -* uptime invocation::            Print system uptime and load
492 +* arch::                         Print machine hardware name
493 +* date::                         Print or set system date and time
494 +* nproc::                        Print the number of processors
495 +* uname::                        Print system information
496 +* hostid::                       Print numeric host identifier
497  
498  @command{date}: Print or set system date and time
499  
500 @@ -443,31 +429,27 @@ System context
501  
502  SELinux context
503  
504 -* chcon invocation::             Change SELinux context of file
505 -* runcon invocation::            Run a command in specified SELinux context
506 +* chcon::                        Change SELinux context of file
507 +* runcon::                       Run a command in specified SELinux context
508  
509  Modified command invocation
510  
511 -* chroot invocation::            Run a command with a different root directory
512 -* env invocation::               Run a command in a modified environment
513 -* nice invocation::              Run a command with modified niceness
514 -* nohup invocation::             Run a command immune to hangups
515 -* stdbuf invocation::            Run a command with modified I/O buffering
516 -* timeout invocation::           Run a command with a time limit
517 -
518 -Process control
519 -
520 -* kill invocation::              Sending a signal to processes.
521 +* chroot::                       Run a command with a different root directory
522 +* env::                          Run a command in a modified environment
523 +* nice::                         Run a command with modified niceness
524 +* nohup::                        Run a command immune to hangups
525 +* stdbuf::                       Run a command with modified I/O buffering
526 +* timeout::                      Run a command with a time limit
527  
528  Delaying
529  
530 -* sleep invocation::             Delay for a specified time
531 +* sleep::                        Delay for a specified time
532  
533  Numeric operations
534  
535 -* factor invocation::            Print prime factors
536 -* numfmt invocation::            Reformat numbers
537 -* seq invocation::               Print numeric sequences
538 +* factor::                       Print prime factors
539 +* numfmt::                       Reformat numbers
540 +* seq::                          Print numeric sequences
541  
542  
543  File timestamps
544 @@ -1597,16 +1579,16 @@ These commands read and write entire fil
545  in some way.
546  
547  @menu
548 -* cat invocation::              Concatenate and write files.
549 -* tac invocation::              Concatenate and write files in reverse.
550 -* nl invocation::               Number lines and write files.
551 -* od invocation::               Write files in octal or other formats.
552 -* base32 invocation::           Transform data into printable data.
553 -* base64 invocation::           Transform data into printable data.
554 -* basenc invocation::           Transform data into printable data.
555 +* cat::                         Concatenate and write files.
556 +* tac::                         Concatenate and write files in reverse.
557 +* nl::                          Number lines and write files.
558 +* od::                          Write files in octal or other formats.
559 +* base32::                      Transform data into printable data.
560 +* base64::                      Transform data into printable data.
561 +* basenc::                      Transform data into printable data.
562  @end menu
563  
564 -@node cat invocation
565 +@node cat
566  @section @command{cat}: Concatenate and write files
567  
568  @pindex cat
569 @@ -1708,7 +1690,7 @@ cat
570  @end example
571  
572  
573 -@node tac invocation
574 +@node tac
575  @section @command{tac}: Concatenate and write files in reverse
576  
577  @pindex tac
578 @@ -1766,7 +1748,7 @@ tac -r -s 'x\|[^x]'
579  @end example
580  
581  
582 -@node nl invocation
583 +@node nl
584  @section @command{nl}: Number lines and write files
585  
586  @pindex nl
587 @@ -1934,7 +1916,7 @@ Use @var{number} characters for line num
588  @exitstatus
589  
590  
591 -@node od invocation
592 +@node od
593  @section @command{od}: Write files in octal or other formats
594  
595  @pindex od
596 @@ -2200,7 +2182,7 @@ address.
597  @exitstatus
598  
599  
600 -@node base32 invocation
601 +@node base32
602  @section @command{base32}: Transform data into printable data
603  
604  @pindex base32
605 @@ -2210,10 +2192,10 @@ address.
606  into (or from) base32 encoded form.  The base32 encoded form uses
607  printable ASCII characters to represent binary data.
608  The usage and options of this command are precisely the
609 -same as for @command{base64}.  @xref{base64 invocation}.
610 +same as for @command{base64}.  @xref{base64}.
611  
612  
613 -@node base64 invocation
614 +@node base64
615  @section @command{base64}: Transform data into printable data
616  
617  @pindex base64
618 @@ -2273,7 +2255,7 @@ to permit distorted data to be decoded.
619  
620  @exitstatus
621  
622 -@node basenc invocation
623 +@node basenc
624  @section @command{basenc}: Transform data into printable data
625  
626  @pindex basenc
627 @@ -2294,7 +2276,7 @@ The @var{encoding} argument is required.
628  @command{basenc} reads from standard input.
629  The @option{-w/--wrap},@option{-i/--ignore-garbage},
630  @option{-d/--decode} options of this command are precisely the same as
631 -for @command{base64}. @xref{base64 invocation}.
632 +for @command{base64}. @xref{base64}.
633  
634  
635  Supported @var{encoding}s are:
636 @@ -2409,13 +2391,13 @@ $ printf 01010100 | basenc --base2lsbf -
637  These commands reformat the contents of files.
638  
639  @menu
640 -* fmt invocation::              Reformat paragraph text.
641 -* pr invocation::               Paginate or columnate files for printing.
642 -* fold invocation::             Wrap input lines to fit in specified width.
643 +* fmt::                         Reformat paragraph text.
644 +* pr::                          Paginate or columnate files for printing.
645 +* fold::                        Wrap input lines to fit in specified width.
646  @end menu
647  
648  
649 -@node fmt invocation
650 +@node fmt
651  @section @command{fmt}: Reformat paragraph text
652  
653  @pindex fmt
654 @@ -2519,7 +2501,7 @@ leaving the code unchanged.
655  
656  @exitstatus
657  
658 -@node pr invocation
659 +@node pr
660  @section @command{pr}: Paginate or columnate files for printing
661  
662  @pindex pr
663 @@ -2629,7 +2611,7 @@ Double space the output.
664  @cindex time formats
665  @cindex formatting times
666  Format header dates using @var{format}, using the same conventions as
667 -for the command @samp{date +@var{format}}.  @xref{date invocation}.
668 +for the command @samp{date +@var{format}}.  @xref{date}.
669  Except for directives, which start with
670  @samp{%}, characters in @var{format} are printed unchanged.  You can use
671  this option to specify an arbitrary string in place of the header date,
672 @@ -2859,7 +2841,7 @@ line is never truncated.
673  @exitstatus
674  
675  
676 -@node fold invocation
677 +@node fold
678  @section @command{fold}: Wrap input lines to fit in specified width
679  
680  @pindex fold
681 @@ -2926,13 +2908,13 @@ instead.
682  These commands output pieces of the input.
683  
684  @menu
685 -* head invocation::             Output the first part of files.
686 -* tail invocation::             Output the last part of files.
687 -* split invocation::            Split a file into pieces.
688 -* csplit invocation::           Split a file into context-determined pieces.
689 +* head::                        Output the first part of files.
690 +* tail::                        Output the last part of files.
691 +* split::                       Split a file into pieces.
692 +* csplit::                      Split a file into context-determined pieces.
693  @end menu
694  
695 -@node head invocation
696 +@node head
697  @section @command{head}: Output the first part of files
698  
699  @pindex head
700 @@ -3011,7 +2993,7 @@ avoid @command{head}, e.g., by using @sa
701  @exitstatus
702  
703  
704 -@node tail invocation
705 +@node tail
706  @section @command{tail}: Output the last part of files
707  
708  @pindex tail
709 @@ -3262,7 +3244,7 @@ mean either @samp{tail ./+4} or @samp{ta
710  @exitstatus
711  
712  
713 -@node split invocation
714 +@node split
715  @section @command{split}: Split a file into pieces.
716  
717  @pindex split
718 @@ -3517,7 +3499,7 @@ $ seq 100 > k; split -nl/7/33 k
719  @end example
720  
721  
722 -@node csplit invocation
723 +@node csplit
724  @section @command{csplit}: Split a file into context-determined pieces
725  
726  @pindex csplit
727 @@ -3736,17 +3718,17 @@ These commands generate just a few numbe
728  contents of files.
729  
730  @menu
731 -* wc invocation::               Print newline, word, and byte counts.
732 -* sum invocation::              Print checksum and block counts.
733 -* cksum invocation::            Print CRC checksum and byte counts.
734 -* b2sum invocation::            Print or check BLAKE2 digests.
735 -* md5sum invocation::           Print or check MD5 digests.
736 -* sha1sum invocation::          Print or check SHA-1 digests.
737 +* wc::                          Print newline, word, and byte counts.
738 +* sum::                         Print checksum and block counts.
739 +* cksum::                       Print CRC checksum and byte counts.
740 +* b2sum::                       Print or check BLAKE2 digests.
741 +* md5sum::                      Print or check MD5 digests.
742 +* sha1sum::                     Print or check SHA-1 digests.
743  * sha2 utilities::              Print or check SHA-2 digests.
744  @end menu
745  
746  
747 -@node wc invocation
748 +@node wc
749  @section @command{wc}: Print newline, word, and byte counts
750  
751  @pindex wc
752 @@ -3872,7 +3854,7 @@ find . -name '*.[ch]' -print0 |
753  @exitstatus
754  
755  
756 -@node sum invocation
757 +@node sum
758  @section @command{sum}: Print checksum and block counts
759  
760  @pindex sum
761 @@ -3921,7 +3903,7 @@ next section) is preferable in new appli
762  @exitstatus
763  
764  
765 -@node cksum invocation
766 +@node cksum
767  @section @command{cksum}: Print and verify file checksums
768  
769  @pindex cksum
770 @@ -3953,7 +3935,7 @@ for each file along with the number of b
771  and the file name unless no arguments were given.
772  
773  The same usage and options as the @command{b2sum}
774 -command are supported.  @xref{b2sum invocation}.
775 +command are supported.  @xref{b2sum}.
776  In addition @command{cksum} supports the following options.
777  
778  @table @samp
779 @@ -3996,11 +3978,11 @@ This format has the checksum at the star
780  more amenable to further processing by other utilities,
781  especially in combination with the @option{--zero} option.
782  Note this does not identify the digest algorithm used for the checksum.
783 -@xref{md5sum invocation} for details of this format.
784 +@xref{md5sum} for details of this format.
785  @end table
786  
787  
788 -@node b2sum invocation
789 +@node b2sum
790  @section @command{b2sum}: Print or check BLAKE2 digests
791  
792  @pindex b2sum
793 @@ -4012,7 +3994,7 @@ Note this does not identify the digest a
794  
795  @command{b2sum} computes a 512-bit checksum for each specified
796  @var{file}.  The same usage and options as the @command{md5sum}
797 -command are supported.  @xref{md5sum invocation}.
798 +command are supported.  @xref{md5sum}.
799  In addition @command{b2sum} supports the following options.
800  
801  @table @samp
802 @@ -4027,7 +4009,7 @@ This option is ignored when @option{--ch
803  as the length is automatically determined when checking.
804  @end table
805  
806 -@node md5sum invocation
807 +@node md5sum
808  @section @command{md5sum}: Print or check MD5 digests
809  
810  @pindex md5sum
811 @@ -4050,7 +4032,7 @@ fingerprint is considered infeasible at
812  to modify certain files, including digital certificates, so that they
813  appear valid when signed with an \hash\ digest.  For more secure hashes,
814  consider using SHA-2, or the newer @command{b2sum} command.
815 -@xref{sha2 utilities}. @xref{b2sum invocation}.
816 +@xref{sha2 utilities}. @xref{b2sum}.
817  @end macro
818  @weakHash{MD5}
819  
820 @@ -4208,7 +4190,7 @@ Also file name escaping is not used.
821  @exitstatus
822  
823  
824 -@node sha1sum invocation
825 +@node sha1sum
826  @section @command{sha1sum}: Print or check SHA-1 digests
827  
828  @pindex sha1sum
829 @@ -4220,7 +4202,7 @@ Also file name escaping is not used.
830  
831  @command{sha1sum} computes a 160-bit checksum for each specified
832  @var{file}.  The usage and options of this command are precisely the
833 -same as for @command{md5sum}.  @xref{md5sum invocation}.
834 +same as for @command{md5sum}.  @xref{md5sum}.
835  
836  @weakHash{SHA-1}
837  
838 @@ -4256,7 +4238,7 @@ various lengths (respectively 224, 256,
839  collectively known as the SHA-2 hashes.  The usage and options of
840  these commands are precisely the same as for @command{md5sum}
841  and @command{sha1sum}.
842 -@xref{md5sum invocation}.
843 +@xref{md5sum}.
844  
845  
846  @node Operating on sorted files
847 @@ -4268,16 +4250,16 @@ and @command{sha1sum}.
848  These commands work with (or produce) sorted files.
849  
850  @menu
851 -* sort invocation::             Sort text files.
852 -* shuf invocation::             Shuffle text files.
853 -* uniq invocation::             Uniquify files.
854 -* comm invocation::             Compare two sorted files line by line.
855 -* ptx invocation::              Produce a permuted index of file contents.
856 -* tsort invocation::            Topological sort.
857 +* sort::                        Sort text files.
858 +* shuf::                        Shuffle text files.
859 +* uniq::                        Uniquify files.
860 +* comm::                        Compare two sorted files line by line.
861 +* ptx::                         Produce a permuted index of file contents.
862 +* tsort::                       Topological sort.
863  @end menu
864  
865  
866 -@node sort invocation
867 +@node sort
868  @section @command{sort}: Sort text files
869  
870  @pindex sort
871 @@ -4573,7 +4555,7 @@ appear earlier in the output instead of
872  Sort by hashing the input keys and then sorting the hash values.
873  Choose the hash function at random, ensuring that it is free of
874  collisions so that differing keys have differing hash values.  This is
875 -like a random permutation of the inputs (@pxref{shuf invocation}),
876 +like a random permutation of the inputs (@pxref{shuf}),
877  except that keys with the same value sort together.
878  
879  If multiple random sort fields are specified, the same random hash
880 @@ -4771,7 +4753,7 @@ Set the number of sorts run in parallel
881  @var{n} is set to the number of available processors, but limited
882  to 8, as there are diminishing performance gains after that.
883  Note also that using @var{n} threads increases the memory usage by
884 -a factor of log @var{n}.  Also see @ref{nproc invocation}.
885 +a factor of log @var{n}.  Also see @ref{nproc}.
886  
887  @item -u
888  @itemx --unique
889 @@ -4789,7 +4771,7 @@ The commands @code{sort -u} and @code{so
890  this equivalence does not extend to arbitrary @command{sort} options.
891  For example, @code{sort -n -u} inspects only the value of the initial
892  numeric string when checking for uniqueness, whereas @code{sort -n |
893 -uniq} inspects the entire line.  @xref{uniq invocation}.
894 +uniq} inspects the entire line.  @xref{uniq}.
895  
896  @optZeroTerminated
897  @macro newlineFieldSeparator
898 @@ -5002,7 +4984,7 @@ ls */* | sort -t / -k 1,1R -k 2,2
899  @end itemize
900  
901  
902 -@node shuf invocation
903 +@node shuf
904  @section @command{shuf}: Shuffling text
905  
906  @pindex shuf
907 @@ -5158,7 +5140,7 @@ shuf -r -n 100 -e Head Tail
908  @exitstatus
909  
910  
911 -@node uniq invocation
912 +@node uniq
913  @section @command{uniq}: Uniquify files
914  
915  @pindex uniq
916 @@ -5180,7 +5162,7 @@ lines that are not repeated, or all repe
917  The input need not be sorted, but repeated input lines are detected
918  only if they are adjacent.  If you want to discard non-adjacent
919  duplicate lines, perhaps you want to use @code{sort -u}.
920 -@xref{sort invocation}.
921 +@xref{sort}.
922  
923  @vindex LC_COLLATE
924  Comparisons honor the rules specified by the @env{LC_COLLATE}
925 @@ -5345,7 +5327,7 @@ compared.
926  @exitstatus
927  
928  
929 -@node comm invocation
930 +@node comm
931  @section @command{comm}: Compare two sorted files line by line
932  
933  @pindex comm
934 @@ -5460,7 +5442,7 @@ $ comm -12 file1 file2 | wc -l    # numb
935  
936  @end table
937  
938 -@node ptx invocation
939 +@node ptx
940  @section @command{ptx}: Produce permuted indexes
941  
942  @pindex ptx
943 @@ -5950,7 +5932,7 @@ allowed with System V @command{ptx}.
944  @end itemize
945  
946  
947 -@node tsort invocation
948 +@node tsort
949  @section @command{tsort}: Topological sort
950  
951  @pindex tsort
952 @@ -6112,13 +6094,13 @@ in different ways.
953  @chapter Operating on fields
954  
955  @menu
956 -* cut invocation::              Print selected parts of lines.
957 -* paste invocation::            Merge lines of files.
958 -* join invocation::             Join lines on a common field.
959 +* cut::                         Print selected parts of lines.
960 +* paste::                       Merge lines of files.
961 +* join::                        Join lines on a common field.
962  @end menu
963  
964  
965 -@node cut invocation
966 +@node cut
967  @section @command{cut}: Print selected parts of lines
968  
969  @pindex cut
970 @@ -6243,7 +6225,7 @@ many fields and want to print all but a
971  @exitstatus
972  
973  
974 -@node paste invocation
975 +@node paste
976  @section @command{paste}: Merge lines of files
977  
978  @pindex paste
979 @@ -6341,7 +6323,7 @@ $ paste -d '%_' num2 let3 num2
980  @exitstatus
981  
982  
983 -@node join invocation
984 +@node join
985  @section @command{join}: Join lines on a common field
986  
987  @pindex join
988 @@ -6873,13 +6855,13 @@ entire lines as the key.
989  These commands operate on individual characters.
990  
991  @menu
992 -* tr invocation::               Translate, squeeze, and/or delete characters.
993 -* expand invocation::           Convert tabs to spaces.
994 -* unexpand invocation::         Convert spaces to tabs.
995 +* tr::                          Translate, squeeze, and/or delete characters.
996 +* expand::                      Convert tabs to spaces.
997 +* unexpand::                    Convert spaces to tabs.
998  @end menu
999  
1000  
1001 -@node tr invocation
1002 +@node tr
1003  @section @command{tr}: Translate, squeeze, and/or delete characters
1004  
1005  @pindex tr
1006 @@ -7291,7 +7273,7 @@ square brackets from interpretation by a
1007  @end itemize
1008  
1009  
1010 -@node expand invocation
1011 +@node expand
1012  @section @command{expand}: Convert tabs to spaces
1013  
1014  @pindex expand
1015 @@ -7360,7 +7342,7 @@ characters) on each line to spaces.
1016  @exitstatus
1017  
1018  
1019 -@node unexpand invocation
1020 +@node unexpand
1021  @section @command{unexpand}: Convert spaces to tabs
1022  
1023  @pindex unexpand
1024 @@ -7423,14 +7405,14 @@ This chapter describes the @command{ls}
1025  and @command{vdir}, which list information about files.
1026  
1027  @menu
1028 -* ls invocation::               List directory contents.
1029 -* dir invocation::              Briefly ls.
1030 -* vdir invocation::             Verbosely ls.
1031 -* dircolors invocation::        Color setup for ls, etc.
1032 +* ls::                          List directory contents.
1033 +* dir::                         Briefly ls.
1034 +* vdir::                        Verbosely ls.
1035 +* dircolors::                   Color setup for ls, etc.
1036  @end menu
1037  
1038  
1039 -@node ls invocation
1040 +@node ls
1041  @section @command{ls}: List directory contents
1042  
1043  @pindex ls
1044 @@ -8325,7 +8307,7 @@ be one of the following:
1045  @item +@var{format}
1046  @vindex LC_TIME
1047  List timestamps using @var{format}, where @var{format} is interpreted
1048 -like the format argument of @command{date} (@pxref{date invocation}).
1049 +like the format argument of @command{date} (@pxref{date}).
1050  For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
1051  @command{ls} to list timestamps like @samp{2020-03-30 23:45:56}.  As
1052  with @command{date}, @var{format}'s interpretation is affected by the
1053 @@ -8526,7 +8508,7 @@ This is the default unless the output is
1054  @end table
1055  
1056  
1057 -@node dir invocation
1058 +@node dir
1059  @section @command{dir}: Briefly list directory contents
1060  
1061  @pindex dir
1062 @@ -8536,10 +8518,10 @@ This is the default unless the output is
1063  -b}; that is, by default files are listed in columns, sorted vertically,
1064  and special characters are represented by backslash escape sequences.
1065  
1066 -@xref{ls invocation, @command{ls}}.
1067 +@xref{ls, @command{ls}}.
1068  
1069  
1070 -@node vdir invocation
1071 +@node vdir
1072  @section @command{vdir}: Verbosely list directory contents
1073  
1074  @pindex vdir
1075 @@ -8549,9 +8531,9 @@ and special characters are represented b
1076  -b}; that is, by default files are listed in long format and special
1077  characters are represented by backslash escape sequences.
1078  
1079 -@xref{ls invocation, @command{ls}}.
1080 +@xref{ls, @command{ls}}.
1081  
1082 -@node dircolors invocation
1083 +@node dircolors
1084  @section @command{dircolors}: Color setup for @command{ls}
1085  
1086  @pindex dircolors
1087 @@ -8638,16 +8620,16 @@ This chapter describes the commands for
1088  copying, moving (renaming), and deleting (removing).
1089  
1090  @menu
1091 -* cp invocation::               Copy files.
1092 -* dd invocation::               Convert and copy a file.
1093 -* install invocation::          Copy files and set attributes.
1094 -* mv invocation::               Move (rename) files.
1095 -* rm invocation::               Remove files or directories.
1096 -* shred invocation::            Remove files more securely.
1097 +* cp::                          Copy files.
1098 +* dd::                          Convert and copy a file.
1099 +* install::                     Copy files and set attributes.
1100 +* mv::                          Move (rename) files.
1101 +* rm::                          Remove files or directories.
1102 +* shred::                       Remove files more securely.
1103  @end menu
1104  
1105  
1106 -@node cp invocation
1107 +@node cp
1108  @section @command{cp}: Copy files and directories
1109  
1110  @pindex cp
1111 @@ -9142,7 +9124,7 @@ option, and overrides the @option{--pres
1112  @exitstatus
1113  
1114  
1115 -@node dd invocation
1116 +@node dd
1117  @section @command{dd}: Convert and copy a file
1118  
1119  @pindex dd
1120 @@ -9683,7 +9665,7 @@ environment variable is set.
1121  @exitstatus
1122  
1123  
1124 -@node install invocation
1125 +@node install
1126  @section @command{install}: Copy files and set attributes
1127  
1128  @pindex install
1129 @@ -9865,7 +9847,7 @@ This option is mutually exclusive with t
1130  @exitstatus
1131  
1132  
1133 -@node mv invocation
1134 +@node mv
1135  @section @command{mv}: Move (rename) files
1136  
1137  @pindex mv
1138 @@ -10011,7 +9993,7 @@ to the system default type for destinati
1139  @exitstatus
1140  
1141  
1142 -@node rm invocation
1143 +@node rm
1144  @section @command{rm}: Remove files or directories
1145  
1146  @pindex rm
1147 @@ -10177,7 +10159,7 @@ predates the development of the @code{ge
1148  @exitstatus
1149  
1150  
1151 -@node shred invocation
1152 +@node shred
1153  @section @command{shred}: Remove files more securely
1154  
1155  @pindex shred
1156 @@ -10187,7 +10169,7 @@ predates the development of the @code{ge
1157  @command{shred} overwrites devices or files, to help prevent even
1158  extensive forensics from recovering the data.
1159  
1160 -Ordinarily when you remove a file (@pxref{rm invocation}), its data
1161 +Ordinarily when you remove a file (@pxref{rm}), its data
1162  and metadata are not actually destroyed.  Only the file's directory
1163  entry is removed, and the file's storage is reclaimed only when no
1164  process has the file open and no other directory entry links to the
1165 @@ -10474,18 +10456,18 @@ Besides directories, other special file
1166  (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
1167  
1168  @menu
1169 -* link invocation::             Make a hard link via the link syscall
1170 -* ln invocation::               Make links between files.
1171 -* mkdir invocation::            Make directories.
1172 -* mkfifo invocation::           Make FIFOs (named pipes).
1173 -* mknod invocation::            Make block or character special files.
1174 -* readlink invocation::         Print value of a symlink or canonical file name.
1175 -* rmdir invocation::            Remove empty directories.
1176 -* unlink invocation::           Remove files via the unlink syscall
1177 +* link::             Make a hard link via the link syscall
1178 +* ln::               Make links between files.
1179 +* mkdir::            Make directories.
1180 +* mkfifo::           Make FIFOs (named pipes).
1181 +* mknod::            Make block or character special files.
1182 +* readlink::         Print value of a symlink or canonical file name.
1183 +* rmdir::            Remove empty directories.
1184 +* unlink::           Remove files via the unlink syscall
1185  @end menu
1186  
1187  
1188 -@node link invocation
1189 +@node link
1190  @section @command{link}: Make a hard link via the link syscall
1191  
1192  @pindex link
1193 @@ -10498,7 +10480,7 @@ It is a minimalist interface to the syst
1194  @code{link} function.  @xref{Hard Links, , , libc,
1195  The GNU C Library Reference Manual}.
1196  It avoids the bells and whistles of the more commonly-used
1197 -@command{ln} command (@pxref{ln invocation}).
1198 +@command{ln} command (@pxref{ln}).
1199  Synopsis:
1200  
1201  @example
1202 @@ -10524,7 +10506,7 @@ to specify which behavior is desired.
1203  @exitstatus
1204  
1205  
1206 -@node ln invocation
1207 +@node ln
1208  @section @command{ln}: Make links between files
1209  
1210  @pindex ln
1211 @@ -10711,7 +10693,7 @@ ln -srv /a/file /tmp
1212  Relative symbolic links are generated based on their canonicalized
1213  containing directory, and canonicalized targets.  I.e., all symbolic
1214  links in these file names will be resolved.
1215 -@xref{realpath invocation}, which gives greater control
1216 +@xref{realpath}, which gives greater control
1217  over relative file name generation, as demonstrated in the following example:
1218  
1219  @example
1220 @@ -10788,7 +10770,7 @@ ln -s ../adir/afile yetanotherfile
1221  @end example
1222  
1223  
1224 -@node mkdir invocation
1225 +@node mkdir
1226  @section @command{mkdir}: Make directories
1227  
1228  @pindex mkdir
1229 @@ -10866,7 +10848,7 @@ Print a message for each created directo
1230  @exitstatus
1231  
1232  
1233 -@node mkfifo invocation
1234 +@node mkfifo
1235  @section @command{mkfifo}: Make FIFOs (named pipes)
1236  
1237  @pindex mkfifo
1238 @@ -10907,7 +10889,7 @@ permission bits.  @xref{File permissions
1239  @exitstatus
1240  
1241  
1242 -@node mknod invocation
1243 +@node mknod
1244  @section @command{mknod}: Make block or character special files
1245  
1246  @pindex mknod
1247 @@ -10984,7 +10966,7 @@ Set the mode of created files to @var{mo
1248  @exitstatus
1249  
1250  
1251 -@node readlink invocation
1252 +@node readlink
1253  @section @command{readlink}: Print value of a symlink or canonical file name
1254  
1255  @pindex readlink
1256 @@ -11008,7 +10990,7 @@ of a symbolic link, it produces no outpu
1257  @command{readlink} outputs the absolute name of the given files which contain
1258  no @file{.}, @file{..} components nor any repeated separators
1259  (@file{/}) or symbolic links.  Note the @command{realpath} command is the
1260 -preferred command to use for canonicalization.  @xref{realpath invocation}.
1261 +preferred command to use for canonicalization.  @xref{realpath}.
1262  
1263  @end table
1264  
1265 @@ -11083,7 +11065,7 @@ The @command{realpath} command without o
1266  @exitstatus
1267  
1268  
1269 -@node rmdir invocation
1270 +@node rmdir
1271  @section @command{rmdir}: Remove empty directories
1272  
1273  @pindex rmdir
1274 @@ -11131,7 +11113,7 @@ Give a diagnostic for each successful re
1275  
1276  @end table
1277  
1278 -@xref{rm invocation}, for how to remove non-empty directories recursively.
1279 +@xref{rm}, for how to remove non-empty directories recursively.
1280  
1281  To remove all empty directories under @var{dirname}, including
1282  directories that become empty because other directories are removed,
1283 @@ -11148,7 +11130,7 @@ find @var{dirname} -depth -type d -exec
1284  @exitstatus
1285  
1286  
1287 -@node unlink invocation
1288 +@node unlink
1289  @section @command{unlink}: Remove files via the unlink syscall
1290  
1291  @pindex unlink
1292 @@ -11159,7 +11141,7 @@ It is a minimalist interface to the syst
1293  @code{unlink} function.  @xref{Deleting Files, , , libc,
1294  The GNU C Library Reference Manual}.  Synopsis:
1295  It avoids the bells and whistles of the more commonly-used
1296 -@command{rm} command (@pxref{rm invocation}).
1297 +@command{rm} command (@pxref{rm}).
1298  
1299  @example
1300  unlink @var{filename}
1301 @@ -11193,14 +11175,14 @@ timestamps, and other information.  Coll
1302  These commands change file attributes.
1303  
1304  @menu
1305 -* chown invocation::            Change file owners and groups.
1306 -* chgrp invocation::            Change file groups.
1307 -* chmod invocation::            Change access permissions.
1308 -* touch invocation::            Change file timestamps.
1309 +* chown::                       Change file owners and groups.
1310 +* chgrp::                       Change file groups.
1311 +* chmod::                       Change access permissions.
1312 +* touch::                       Change file timestamps.
1313  @end menu
1314  
1315  
1316 -@node chown invocation
1317 +@node chown
1318  @section @command{chown}: Change file owner and group
1319  
1320  @pindex chown
1321 @@ -11427,7 +11409,7 @@ chown -hR root /u
1322  @end example
1323  
1324  
1325 -@node chgrp invocation
1326 +@node chgrp
1327  @section @command{chgrp}: Change group ownership
1328  
1329  @pindex chgrp
1330 @@ -11436,7 +11418,7 @@ chown -hR root /u
1331  
1332  @command{chgrp} changes the group ownership of each given @var{file}
1333  to @var{group} (which can be either a group name or a numeric group ID)
1334 -or to the group of an existing reference file.  @xref{chown invocation}.
1335 +or to the group of an existing reference file.  @xref{chown}.
1336  Synopsis:
1337  
1338  @example
1339 @@ -11555,7 +11537,7 @@ chgrp -hR staff /u
1340  @end example
1341  
1342  
1343 -@node chmod invocation
1344 +@node chmod
1345  @section @command{chmod}: Change access permissions
1346  
1347  @pindex chmod
1348 @@ -11677,7 +11659,7 @@ chmod -R a=,+rwX dir
1349  @end smallexample
1350  
1351  
1352 -@node touch invocation
1353 +@node touch
1354  @section @command{touch}: Change file timestamps
1355  
1356  @pindex touch
1357 @@ -11852,15 +11834,15 @@ how much storage is in use or available,
1358  file status information, and write buffers to file systems.
1359  
1360  @menu
1361 -* df invocation::               Report file system space usage.
1362 -* du invocation::               Estimate file space usage.
1363 -* stat invocation::             Report file or file system status.
1364 -* sync invocation::             Synchronize cached writes to persistent storage.
1365 -* truncate invocation::         Shrink or extend the size of a file.
1366 +* df::                          Report file system space usage.
1367 +* du::                          Estimate file space usage.
1368 +* stat::                        Report file or file system status.
1369 +* sync::                        Synchronize cached writes to persistent storage.
1370 +* truncate::                    Shrink or extend the size of a file.
1371  @end menu
1372  
1373  
1374 -@node df invocation
1375 +@node df
1376  @section @command{df}: Report file system space usage
1377  
1378  @pindex df
1379 @@ -12168,7 +12150,7 @@ be read and one or more of the options @
1380  or @option{-x} is used together with a file name argument.
1381  
1382  
1383 -@node du invocation
1384 +@node du
1385  @section @command{du}: Estimate file space usage
1386  
1387  @pindex du
1388 @@ -12426,7 +12408,7 @@ be one of the following:
1389  @item +@var{format}
1390  @vindex LC_TIME
1391  List timestamps using @var{format}, where @var{format} is interpreted
1392 -like the format argument of @command{date} (@pxref{date invocation}).
1393 +like the format argument of @command{date} (@pxref{date}).
1394  For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
1395  @command{du} to list timestamps like @samp{2020-07-21 23:45:56}.  As
1396  with @command{date}, @var{format}'s interpretation is affected by the
1397 @@ -12494,7 +12476,7 @@ in HP-UX; it also affects the HP-UX @com
1398  @exitstatus
1399  
1400  
1401 -@node stat invocation
1402 +@node stat
1403  @section @command{stat}: Report file or file system status
1404  
1405  @pindex stat
1406 @@ -12735,7 +12717,7 @@ with @env{TZ}, libc, The GNU C Library R
1407  @exitstatus
1408  
1409  
1410 -@node sync invocation
1411 +@node sync
1412  @section @command{sync}: Synchronize cached writes to persistent storage
1413  
1414  @pindex sync
1415 @@ -12795,7 +12777,7 @@ write barriers, than a global sync(2) us
1416  @exitstatus
1417  
1418  
1419 -@node truncate invocation
1420 +@node truncate
1421  @section @command{truncate}: Shrink or extend the size of a file
1422  
1423  @pindex truncate
1424 @@ -12872,13 +12854,13 @@ the size of each @var{file} based on its
1425  This section describes commands that display text strings.
1426  
1427  @menu
1428 -* echo invocation::             Print a line of text.
1429 -* printf invocation::           Format and print data.
1430 -* yes invocation::              Print a string until interrupted.
1431 +* echo::                        Print a line of text.
1432 +* printf::                      Format and print data.
1433 +* yes::                         Print a string until interrupted.
1434  @end menu
1435  
1436  
1437 -@node echo invocation
1438 +@node echo
1439  @section @command{echo}: Print a line of text
1440  
1441  @pindex echo
1442 @@ -12967,12 +12949,12 @@ that the behavior of @command{echo} is i
1443  @var{string} contains a backslash or if the first argument is
1444  @option{-n}.  Portable programs can use the @command{printf} command
1445  if they need to omit trailing newlines or output control characters or
1446 -backslashes.  @xref{printf invocation}.
1447 +backslashes.  @xref{printf}.
1448  
1449  @exitstatus
1450  
1451  
1452 -@node printf invocation
1453 +@node printf
1454  @section @command{printf}: Format and print data
1455  
1456  @pindex printf
1457 @@ -13134,7 +13116,7 @@ $ recode BIG5..JAVA < sample.txt \
1458  @exitstatus
1459  
1460  
1461 -@node yes invocation
1462 +@node yes
1463  @section @command{yes}: Print a string until interrupted
1464  
1465  @pindex yes
1466 @@ -13165,14 +13147,14 @@ condition of shell @code{if} statements,
1467  pipeline.
1468  
1469  @menu
1470 -* false invocation::            Do nothing, unsuccessfully.
1471 -* true invocation::             Do nothing, successfully.
1472 -* test invocation::             Check file types and compare values.
1473 -* expr invocation::             Evaluate expressions.
1474 +* false::                       Do nothing, unsuccessfully.
1475 +* true::                        Do nothing, successfully.
1476 +* test::                        Check file types and compare values.
1477 +* expr::                        Evaluate expressions.
1478  @end menu
1479  
1480  
1481 -@node false invocation
1482 +@node false
1483  @section @command{false}: Do nothing, unsuccessfully
1484  
1485  @pindex false
1486 @@ -13202,7 +13184,7 @@ Portable programs should not assume that
1487  non-GNU hosts.
1488  
1489  
1490 -@node true invocation
1491 +@node true
1492  @section @command{true}: Do nothing, successfully
1493  
1494  @pindex true
1495 @@ -13238,7 +13220,7 @@ This version of @command{true} is implem
1496  more secure and faster than a shell script implementation, and may safely
1497  be used as a dummy shell for the purpose of disabling accounts.
1498  
1499 -@node test invocation
1500 +@node test
1501  @section @command{test}: Check file types and compare values
1502  
1503  @pindex test
1504 @@ -13609,7 +13591,7 @@ True if either @var{expr1} or @var{expr2
1505  @end table
1506  
1507  
1508 -@node expr invocation
1509 +@node expr
1510  @section @command{expr}: Evaluate expressions
1511  
1512  @pindex expr
1513 @@ -13886,11 +13868,11 @@ useful redirection is performed by a sep
1514  it's described here.
1515  
1516  @menu
1517 -* tee invocation::              Redirect output to multiple files or processes.
1518 +* tee::                         Redirect output to multiple files or processes.
1519  @end menu
1520  
1521  
1522 -@node tee invocation
1523 +@node tee
1524  @section @command{tee}: Redirect output to multiple files or processes
1525  
1526  @pindex tee
1527 @@ -14098,15 +14080,15 @@ tar chof - "$tardir" \
1528  This section describes commands that manipulate file names.
1529  
1530  @menu
1531 -* basename invocation::         Strip directory and suffix from a file name.
1532 -* dirname invocation::          Strip last file name component.
1533 -* pathchk invocation::          Check file name validity and portability.
1534 -* mktemp invocation::           Create temporary file or directory.
1535 -* realpath invocation::         Print resolved file names.
1536 +* basename::                    Strip directory and suffix from a file name.
1537 +* dirname::                     Strip last file name component.
1538 +* pathchk::                     Check file name validity and portability.
1539 +* mktemp::                      Create temporary file or directory.
1540 +* realpath::                    Print resolved file names.
1541  @end menu
1542  
1543  
1544 -@node basename invocation
1545 +@node basename
1546  @section @command{basename}: Strip directory and suffix from a file name
1547  
1548  @pindex basename
1549 @@ -14188,7 +14170,7 @@ basename -a -s .h include/stdio.h includ
1550  @end example
1551  
1552  
1553 -@node dirname invocation
1554 +@node dirname
1555  @section @command{dirname}: Strip last file name component
1556  
1557  @pindex dirname
1558 @@ -14241,7 +14223,7 @@ dirname stdio.h
1559  @end example
1560  
1561  
1562 -@node pathchk invocation
1563 +@node pathchk
1564  @section @command{pathchk}: Check file name validity and portability
1565  
1566  @pindex pathchk
1567 @@ -14317,7 +14299,7 @@ Exit status:
1568  1 otherwise.
1569  @end display
1570  
1571 -@node mktemp invocation
1572 +@node mktemp
1573  @section @command{mktemp}: Create temporary file or directory
1574  
1575  @pindex mktemp
1576 @@ -14492,7 +14474,7 @@ Exit status:
1577  @end display
1578  
1579  
1580 -@node realpath invocation
1581 +@node realpath
1582  @section @command{realpath}: Print the resolved file name.
1583  
1584  @pindex realpath
1585 @@ -14684,14 +14666,14 @@ which you are working: the current direc
1586  so forth.  See also the user-related commands in the next section.
1587  
1588  @menu
1589 -* pwd invocation::              Print working directory.
1590 -* stty invocation::             Print or change terminal characteristics.
1591 -* printenv invocation::         Print environment variables.
1592 -* tty invocation::              Print file name of terminal on standard input.
1593 +* pwd::                         Print working directory.
1594 +* stty::                        Print or change terminal characteristics.
1595 +* printenv::                    Print environment variables.
1596 +* tty::                         Print file name of terminal on standard input.
1597  @end menu
1598  
1599  
1600 -@node pwd invocation
1601 +@node pwd
1602  @section @command{pwd}: Print working directory
1603  
1604  @pindex pwd
1605 @@ -14738,7 +14720,7 @@ environment variable is set.
1606  @exitstatus
1607  
1608  
1609 -@node stty invocation
1610 +@node stty
1611  @section @command{stty}: Print or change terminal characteristics
1612  
1613  @pindex stty
1614 @@ -15480,7 +15462,7 @@ or
1615  @end table
1616  
1617  
1618 -@node printenv invocation
1619 +@node printenv
1620  @section @command{printenv}: Print all or some environment variables
1621  
1622  @pindex printenv
1623 @@ -15515,7 +15497,7 @@ Exit status:
1624  @end display
1625  
1626  
1627 -@node tty invocation
1628 +@node tty
1629  @section @command{tty}: Print file name of terminal on standard input
1630  
1631  @pindex tty
1632 @@ -15565,16 +15547,16 @@ This section describes commands that pri
1633  logins, groups, and so forth.
1634  
1635  @menu
1636 -* id invocation::               Print user identity.
1637 -* logname invocation::          Print current login name.
1638 -* whoami invocation::           Print effective user ID.
1639 -* groups invocation::           Print group names a user is in.
1640 -* users invocation::            Print login names of users currently logged in.
1641 -* who invocation::              Print who is currently logged in.
1642 +* id::                          Print user identity.
1643 +* logname::                     Print current login name.
1644 +* whoami::                      Print effective user ID.
1645 +* groups::                      Print group names a user is in.
1646 +* users::                       Print login names of users currently logged in.
1647 +* who::                         Print who is currently logged in.
1648  @end menu
1649  
1650  
1651 -@node id invocation
1652 +@node id
1653  @section @command{id}: Print user identity
1654  
1655  @pindex id
1656 @@ -15681,7 +15663,7 @@ database to be consulted afresh, and so
1657  
1658  @exitstatus
1659  
1660 -@node logname invocation
1661 +@node logname
1662  @section @command{logname}: Print current login name
1663  
1664  @pindex logname
1665 @@ -15702,7 +15684,7 @@ options}.
1666  @exitstatus
1667  
1668  
1669 -@node whoami invocation
1670 +@node whoami
1671  @section @command{whoami}: Print effective user name
1672  
1673  @pindex whoami
1674 @@ -15718,7 +15700,7 @@ options}.
1675  @exitstatus
1676  
1677  
1678 -@node groups invocation
1679 +@node groups
1680  @section @command{groups}: Print group names a user is in
1681  
1682  @pindex groups
1683 @@ -15745,7 +15727,7 @@ options}.
1684  
1685  @exitstatus
1686  
1687 -@node users invocation
1688 +@node users
1689  @section @command{users}: Print login names of users currently logged in
1690  
1691  @pindex users
1692 @@ -15780,7 +15762,7 @@ should not rely on its existence on non-
1693  @exitstatus
1694  
1695  
1696 -@node who invocation
1697 +@node who
1698  @section @command{who}: Print who is currently logged in
1699  
1700  @pindex who
1701 @@ -15943,16 +15925,14 @@ This section describes commands that pri
1702  information.
1703  
1704  @menu
1705 -* date invocation::             Print or set system date and time.
1706 -* arch invocation::             Print machine hardware name.
1707 -* nproc invocation::            Print the number of processors.
1708 -* uname invocation::            Print system information.
1709 -* hostname invocation::         Print or set system name.
1710 -* hostid invocation::           Print numeric host identifier.
1711 -* uptime invocation::           Print system uptime and load.
1712 +* date::             Print or set system date and time.
1713 +* arch::             Print machine hardware name.
1714 +* nproc::            Print the number of processors.
1715 +* uname::            Print system information.
1716 +* hostid::           Print numeric host identifier.
1717  @end menu
1718  
1719 -@node date invocation
1720 +@node date
1721  @section @command{date}: Print or set system date and time
1722  
1723  @pindex date
1724 @@ -16675,7 +16655,7 @@ date --date='2017-01-01 00:00:00 +0000'
1725  @end itemize
1726  
1727  
1728 -@node arch invocation
1729 +@node arch
1730  @section @command{arch}: Print machine hardware name
1731  
1732  @pindex arch
1733 @@ -16698,7 +16678,7 @@ not rely on its existence.
1734  @exitstatus
1735  
1736  
1737 -@node nproc invocation
1738 +@node nproc
1739  @section @command{nproc}: Print the number of available processors
1740  
1741  @pindex nproc
1742 @@ -16737,7 +16717,7 @@ If possible, exclude this @var{number} o
1743  @exitstatus
1744  
1745  
1746 -@node uname invocation
1747 +@node uname
1748  @section @command{uname}: Print system information
1749  
1750  @pindex uname
1751 @@ -16867,35 +16847,7 @@ Print the kernel version.
1752  @exitstatus
1753  
1754  
1755 -@node hostname invocation
1756 -@section @command{hostname}: Print or set system name
1757 -
1758 -@pindex hostname
1759 -@cindex setting the hostname
1760 -@cindex printing the hostname
1761 -@cindex system name, printing
1762 -@cindex appropriate privileges
1763 -
1764 -With no arguments, @command{hostname} prints the name of the current host
1765 -system.  With one argument, it sets the current host name to the
1766 -specified string.  You must have appropriate privileges to set the host
1767 -name.  Synopsis:
1768 -
1769 -@example
1770 -hostname [@var{name}]
1771 -@end example
1772 -
1773 -The only options are @option{--help} and @option{--version}.  @xref{Common
1774 -options}.
1775 -
1776 -@command{hostname} is not installed by default, and other packages
1777 -also supply a @command{hostname} command, so portable scripts should
1778 -not rely on its existence or on the exact behavior documented above.
1779 -
1780 -@exitstatus
1781 -
1782 -
1783 -@node hostid invocation
1784 +@node hostid
1785  @section @command{hostid}: Print numeric host identifier
1786  
1787  @pindex hostid
1788 @@ -16923,44 +16875,6 @@ existence.
1789  
1790  @exitstatus
1791  
1792 -@node uptime invocation
1793 -@section @command{uptime}: Print system uptime and load
1794 -
1795 -@pindex uptime
1796 -@cindex printing the system uptime and load
1797 -
1798 -@command{uptime} prints the current time, the system's uptime, the
1799 -number of logged-in users and the current load average.
1800 -
1801 -If an argument is specified, it is used as the file to be read
1802 -to discover how many users are logged in.  If no argument is
1803 -specified, a system default is used (@command{uptime --help} indicates
1804 -the default setting).
1805 -
1806 -The only options are @option{--help} and @option{--version}.
1807 -@xref{Common options}.
1808 -
1809 -For example, here's what it prints right now on one system I use:
1810 -
1811 -@example
1812 -$ uptime
1813 - 14:07  up   3:35,  3 users,  load average: 1.39, 1.15, 1.04
1814 -@end example
1815 -
1816 -The precise method of calculation of load average varies somewhat
1817 -between systems.  Some systems calculate it as the average number of
1818 -runnable processes over the last 1, 5 and 15 minutes, but some systems
1819 -also include processes in the uninterruptible sleep state (that is,
1820 -those processes which are waiting for device I/O).  The Linux kernel
1821 -includes uninterruptible processes.
1822 -
1823 -@command{uptime} is installed only on platforms with infrastructure
1824 -for obtaining the boot time, and other packages also supply an
1825 -@command{uptime} command, so portable scripts should not rely on its
1826 -existence or on the exact behavior documented above.
1827 -
1828 -@exitstatus
1829 -
1830  @node SELinux context
1831  @chapter SELinux context
1832  
1833 @@ -16972,11 +16886,11 @@ This section describes commands for oper
1834  contexts.
1835  
1836  @menu
1837 -* chcon invocation::            Change SELinux context of file
1838 -* runcon invocation::           Run a command in specified SELinux context
1839 +* chcon::                       Change SELinux context of file
1840 +* runcon::                      Run a command in specified SELinux context
1841  @end menu
1842  
1843 -@node chcon invocation
1844 +@node chcon
1845  @section @command{chcon}: Change SELinux context of file
1846  
1847  @pindex chcon
1848 @@ -17079,7 +16993,7 @@ Set range @var{range} in the target secu
1849  
1850  @exitstatus
1851  
1852 -@node runcon invocation
1853 +@node runcon
1854  @section @command{runcon}: Run a command in specified SELinux context
1855  
1856  @pindex runcon
1857 @@ -17171,16 +17085,16 @@ different than the current one: a modifi
1858  user, etc.
1859  
1860  @menu
1861 -* chroot invocation::           Modify the root directory.
1862 -* env invocation::              Modify environment variables.
1863 -* nice invocation::             Modify niceness.
1864 -* nohup invocation::            Immunize to hangups.
1865 -* stdbuf invocation::           Modify buffering of standard streams.
1866 -* timeout invocation::          Run with time limit.
1867 +* chroot::                      Modify the root directory.
1868 +* env::                         Modify environment variables.
1869 +* nice::                        Modify niceness.
1870 +* nohup::                       Immunize to hangups.
1871 +* stdbuf::                      Modify buffering of standard streams.
1872 +* timeout::                     Run with time limit.
1873  @end menu
1874  
1875  
1876 -@node chroot invocation
1877 +@node chroot
1878  @section @command{chroot}: Run a command with a different root directory
1879  
1880  @pindex chroot
1881 @@ -17296,7 +17210,7 @@ the exit status of @var{command} otherwi
1882  @end display
1883  
1884  
1885 -@node env invocation
1886 +@node env
1887  @section @command{env}: Run a command in a modified environment
1888  
1889  @pindex env
1890 @@ -17916,7 +17830,7 @@ OLDUSER=gordon
1891  
1892  
1893  
1894 -@node nice invocation
1895 +@node nice
1896  @section @command{nice}: Run a command with modified niceness
1897  
1898  @pindex nice
1899 @@ -18047,7 +17961,7 @@ $ sudo nice -n -1 nice
1900  @end example
1901  
1902  
1903 -@node nohup invocation
1904 +@node nohup
1905  @section @command{nohup}: Run a command immune to hangups
1906  
1907  @pindex nohup
1908 @@ -18121,7 +18035,7 @@ If @env{POSIXLY_CORRECT} is set, interna
1909  instead of 125.
1910  
1911  
1912 -@node stdbuf invocation
1913 +@node stdbuf
1914  @section @command{stdbuf}: Run a command with modified I/O stream buffering
1915  
1916  @pindex stdbuf
1917 @@ -18215,7 +18129,7 @@ the exit status of @var{command} otherwi
1918  @end display
1919  
1920  
1921 -@node timeout invocation
1922 +@node timeout
1923  @section @command{timeout}: Run a command with a time limit
1924  
1925  @pindex timeout
1926 @@ -18350,90 +18264,6 @@ timeout -s INT 5s env --ignore-signal=IN
1927  timeout -s INT -k 3s 5s env --ignore-signal=INT sleep 20
1928  @end example
1929  
1930 -@node Process control
1931 -@chapter Process control
1932 -
1933 -@cindex processes, commands for controlling
1934 -@cindex commands for controlling processes
1935 -
1936 -@menu
1937 -* kill invocation::             Sending a signal to processes.
1938 -@end menu
1939 -
1940 -
1941 -@node kill invocation
1942 -@section @command{kill}: Send a signal to processes
1943 -
1944 -@pindex kill
1945 -@cindex send a signal to processes
1946 -
1947 -The @command{kill} command sends a signal to processes, causing them
1948 -to terminate or otherwise act upon receiving the signal in some way.
1949 -Alternatively, it lists information about signals.  Synopses:
1950 -
1951 -@example
1952 -kill [-s @var{signal} | --signal @var{signal} | -@var{signal}] @var{pid}@dots{}
1953 -kill [-l | --list | -t | --table] [@var{signal}]@dots{}
1954 -@end example
1955 -
1956 -@mayConflictWithShellBuiltIn{kill}
1957 -
1958 -The first form of the @command{kill} command sends a signal to all
1959 -@var{pid} arguments.  The default signal to send if none is specified
1960 -is @samp{TERM}@.  The special signal number @samp{0} does not denote a
1961 -valid signal, but can be used to test whether the @var{pid} arguments
1962 -specify processes to which a signal could be sent.
1963 -
1964 -If @var{pid} is positive, the signal is sent to the process with the
1965 -process ID @var{pid}.  If @var{pid} is zero, the signal is sent to all
1966 -processes in the process group of the current process.  If @var{pid}
1967 -is @minus{}1, the signal is sent to all processes for which the user has
1968 -permission to send a signal.  If @var{pid} is less than @minus{}1, the signal
1969 -is sent to all processes in the process group that equals the absolute
1970 -value of @var{pid}.
1971 -
1972 -If @var{pid} is not positive, a system-dependent set of system
1973 -processes is excluded from the list of processes to which the signal
1974 -is sent.
1975 -
1976 -If a negative @var{pid} argument is desired as the first one, it
1977 -should be preceded by @option{--}.  However, as a common extension to
1978 -POSIX, @option{--} is not required with @samp{kill
1979 --@var{signal} -@var{pid}}.  The following commands are equivalent:
1980 -
1981 -@example
1982 -kill -15 -1
1983 -kill -TERM -1
1984 -kill -s TERM -- -1
1985 -kill -- -1
1986 -@end example
1987 -
1988 -The first form of the @command{kill} command succeeds if every @var{pid}
1989 -argument specifies at least one process that the signal was sent to.
1990 -
1991 -The second form of the @command{kill} command lists signal information.
1992 -Either the @option{-l} or @option{--list} option, or the @option{-t}
1993 -or @option{--table} option must be specified.  Without any
1994 -@var{signal} argument, all supported signals are listed.  The output
1995 -of @option{-l} or @option{--list} is a list of the signal names, one
1996 -per line; if @var{signal} is already a name, the signal number is
1997 -printed instead.  The output of @option{-t} or @option{--table} is a
1998 -table of signal numbers, names, and descriptions.  This form of the
1999 -@command{kill} command succeeds if all @var{signal} arguments are valid
2000 -and if there is no output error.
2001 -
2002 -The @command{kill} command also supports the @option{--help} and
2003 -@option{--version} options.  @xref{Common options}.
2004 -
2005 -A @var{signal} may be a signal name like @samp{HUP}, or a signal
2006 -number like @samp{1}, or an exit status of a process terminated by the
2007 -signal.  A signal name can be given in canonical form or prefixed by
2008 -@samp{SIG}@.  The case of the letters is ignored, except for the
2009 -@option{-@var{signal}} option which must use upper case to avoid
2010 -ambiguity with lower case option letters.
2011 -@xref{Signal specifications}, for a list of supported
2012 -signal names and numbers.
2013 -
2014  @node Delaying
2015  @chapter Delaying
2016  
2017 @@ -18443,11 +18273,11 @@ signal names and numbers.
2018  @c Perhaps @command{wait} or other commands should be described here also?
2019  
2020  @menu
2021 -* sleep invocation::            Delay for a specified time.
2022 +* sleep::                       Delay for a specified time.
2023  @end menu
2024  
2025  
2026 -@node sleep invocation
2027 +@node sleep
2028  @section @command{sleep}: Delay for a specified time
2029  
2030  @pindex sleep
2031 @@ -18510,13 +18340,13 @@ options}.
2032  These programs do numerically-related operations.
2033  
2034  @menu
2035 -* factor invocation::              Show factors of numbers.
2036 -* numfmt invocation::              Reformat numbers.
2037 -* seq invocation::                 Print sequences of numbers.
2038 +* factor::                         Show factors of numbers.
2039 +* numfmt::                         Reformat numbers.
2040 +* seq::                            Print sequences of numbers.
2041  @end menu
2042  
2043  
2044 -@node factor invocation
2045 +@node factor
2046  @section @command{factor}: Print prime factors
2047  
2048  @pindex factor
2049 @@ -18577,7 +18407,7 @@ are the product of two large primes), ot
2050  @exitstatus
2051  
2052  
2053 -@node numfmt invocation
2054 +@node numfmt
2055  @section @command{numfmt}: Reformat numbers
2056  
2057  @pindex numfmt
2058 @@ -18917,7 +18747,7 @@ $ LC_ALL=ta_IN numfmt --from=iec --forma
2059  @end example
2060  
2061  
2062 -@node seq invocation
2063 +@node seq
2064  @section @command{seq}: Print numeric sequences
2065  
2066  @pindex seq
2067 @@ -19092,7 +18922,7 @@ Naively, a file's atime, mtime, and ctim
2068  whenever you read, write, or change the attributes of the file
2069  respectively, and searching a directory counts as reading it.  A
2070  file's atime and mtime can also be set directly, via the
2071 -@command{touch} command (@pxref{touch invocation}).  In practice,
2072 +@command{touch} command (@pxref{touch}).  In practice,
2073  though, timestamps are not updated quite that way.
2074  
2075  For efficiency reasons, many systems are lazy about updating atimes: