]> git.pld-linux.org Git - packages/coreutils.git/blame - coreutils-info.patch
- make sure it won't go to builders without fixing patch8
[packages/coreutils.git] / coreutils-info.patch
CommitLineData
3c350007
JB
1--- coreutils-6.10/doc/coreutils.texi.orig 2008-01-11 14:47:21.000000000 +0100
2+++ coreutils-6.10/doc/coreutils.texi 2008-03-02 02:00:24.656756959 +0100
05fadba2 3@@ -20,114 +20,100 @@
fbb5b105
JB
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-* Common options: (coreutils)Common options. Common options.
12-* File permissions: (coreutils)File permissions. Access modes.
a839fc2f 13-* Date input formats: (coreutils)Date input formats.
fbb5b105 14-@end direntry
a839fc2f 15-
c2be74f0
JB
16-@c FIXME: the following need documentation
17-@c * [: (coreutils)[ invocation. File/string tests.
18-@c * pinky: (coreutils)pinky invocation. FIXME.
19-@c * uptime: (coreutils)uptime invocation. FIXME.
05fadba2
AM
20-@c * mktemp: (coreutils)mktemp invocation. FIXME.
21-@c * chcon: (coreutils)chcon invocation. FIXME.
c2be74f0 22-
fbb5b105
JB
23-@dircategory Individual utilities
24-@direntry
3c350007 25-* arch: (coreutils)arch invocation. Print machine hardware name.
c2be74f0 26-* base64: (coreutils)base64 invocation. Base64 encode/decode data.
a839fc2f
JB
27-* basename: (coreutils)basename invocation. Strip directory and suffix.
28-* cat: (coreutils)cat invocation. Concatenate and write files.
29-* chgrp: (coreutils)chgrp invocation. Change file groups.
30-* chmod: (coreutils)chmod invocation. Change file permissions.
31-* chown: (coreutils)chown invocation. Change file owners/groups.
32-* chroot: (coreutils)chroot invocation. Specify the root directory.
fbb5b105 33-* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum.
a839fc2f
JB
34-* comm: (coreutils)comm invocation. Compare sorted files by line.
35-* cp: (coreutils)cp invocation. Copy files.
36-* csplit: (coreutils)csplit invocation. Split by context.
37-* cut: (coreutils)cut invocation. Print selected parts of lines.
38-* date: (coreutils)date invocation. Print/set system date and time.
39-* dd: (coreutils)dd invocation. Copy and convert a file.
c2be74f0 40-* df: (coreutils)df invocation. Report file system disk usage.
a839fc2f
JB
41-* dir: (coreutils)dir invocation. List directories briefly.
42-* dircolors: (coreutils)dircolors invocation. Color setup for ls.
43-* dirname: (coreutils)dirname invocation. Strip non-directory suffix.
44-* du: (coreutils)du invocation. Report on disk usage.
45-* echo: (coreutils)echo invocation. Print a line of text.
46-* env: (coreutils)env invocation. Modify the environment.
47-* expand: (coreutils)expand invocation. Convert tabs to spaces.
48-* expr: (coreutils)expr invocation. Evaluate expressions.
49-* factor: (coreutils)factor invocation. Print prime factors
50-* false: (coreutils)false invocation. Do nothing, unsuccessfully.
51-* fmt: (coreutils)fmt invocation. Reformat paragraph text.
52-* fold: (coreutils)fold invocation. Wrap long input lines.
53-* groups: (coreutils)groups invocation. Print group names a user is in.
54-* head: (coreutils)head invocation. Output the first part of files.
55-* hostid: (coreutils)hostid invocation. Print numeric host identifier.
56-* hostname: (coreutils)hostname invocation. Print or set system name.
c2be74f0 57-* id: (coreutils)id invocation. Print user identity.
a839fc2f
JB
58-* install: (coreutils)install invocation. Copy and change attributes.
59-* join: (coreutils)join invocation. Join lines on a common field.
60-* kill: (coreutils)kill invocation. Send a signal to processes.
61-* link: (coreutils)link invocation. Make hard links between files.
62-* ln: (coreutils)ln invocation. Make links between files.
63-* logname: (coreutils)logname invocation. Print current login name.
64-* ls: (coreutils)ls invocation. List directory contents.
c2be74f0 65-* md5sum: (coreutils)md5sum invocation. Print or check MD5 digests.
a839fc2f
JB
66-* mkdir: (coreutils)mkdir invocation. Create directories.
67-* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes).
68-* mknod: (coreutils)mknod invocation. Create special files.
69-* mv: (coreutils)mv invocation. Rename files.
c2be74f0 70-* nice: (coreutils)nice invocation. Modify niceness.
a839fc2f
JB
71-* nl: (coreutils)nl invocation. Number lines and write files.
72-* nohup: (coreutils)nohup invocation. Immunize to hangups.
73-* od: (coreutils)od invocation. Dump files in octal, etc.
74-* paste: (coreutils)paste invocation. Merge lines of files.
75-* pathchk: (coreutils)pathchk invocation. Check file name portability.
76-* pr: (coreutils)pr invocation. Paginate or columnate files.
77-* printenv: (coreutils)printenv invocation. Print environment variables.
78-* printf: (coreutils)printf invocation. Format and print data.
79-* ptx: (coreutils)ptx invocation. Produce permuted indexes.
80-* pwd: (coreutils)pwd invocation. Print working directory.
fbb5b105 81-* readlink: (coreutils)readlink invocation. Print referent of a symlink.
a839fc2f
JB
82-* rm: (coreutils)rm invocation. Remove files.
83-* rmdir: (coreutils)rmdir invocation. Remove empty directories.
84-* seq: (coreutils)seq invocation. Print numeric sequences
c2be74f0
JB
85-* sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests.
86-* sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests.
a839fc2f 87-* shred: (coreutils)shred invocation. Remove files more securely.
c2be74f0 88-* shuf: (coreutils)shuf invocation. Shuffling text files.
a839fc2f
JB
89-* sleep: (coreutils)sleep invocation. Delay for a specified time.
90-* sort: (coreutils)sort invocation. Sort text files.
91-* split: (coreutils)split invocation. Split into fixed-size pieces.
fbb5b105 92-* stat: (coreutils)stat invocation. Report file(system) status.
a839fc2f 93-* stty: (coreutils)stty invocation. Print/change terminal settings.
c2be74f0 94-* su: (coreutils)su invocation. Modify user and group ID.
a839fc2f
JB
95-* sum: (coreutils)sum invocation. Print traditional checksum.
96-* sync: (coreutils)sync invocation. Synchronize memory and disk.
97-* tac: (coreutils)tac invocation. Reverse files.
98-* tail: (coreutils)tail invocation. Output the last part of files.
99-* tee: (coreutils)tee invocation. Redirect to multiple files.
100-* test: (coreutils)test invocation. File/string tests.
101-* touch: (coreutils)touch invocation. Change file timestamps.
102-* tr: (coreutils)tr invocation. Translate characters.
103-* true: (coreutils)true invocation. Do nothing, successfully.
104-* tsort: (coreutils)tsort invocation. Topological sort.
105-* tty: (coreutils)tty invocation. Print terminal name.
106-* uname: (coreutils)uname invocation. Print system information.
107-* unexpand: (coreutils)unexpand invocation. Convert spaces to tabs.
a839fc2f 108-* uniq: (coreutils)uniq invocation. Uniquify files.
fbb5b105 109-* unlink: (coreutils)unlink invocation. Removal via unlink(2).
a839fc2f
JB
110-* users: (coreutils)users invocation. Print current user names.
111-* vdir: (coreutils)vdir invocation. List directories verbosely.
876a8767 112-* wc: (coreutils)wc invocation. Line, word, and byte counts.
a839fc2f 113-* who: (coreutils)who invocation. Print who is logged in.
c2be74f0 114-* whoami: (coreutils)whoami invocation. Print effective user ID.
a839fc2f 115-* yes: (coreutils)yes invocation. Print a string indefinitely.
05fadba2
AM
116+* Coreutils: (coreutils). Core GNU (file, text, shell) utilities.
117+* arch: (coreutils)arch invocation. Print machine hardware name.
118+* base64: (coreutils)base64 invocation. Base64 encode/decode data.
119+* basename: (coreutils)basename invocation. Strip directory and suffix.
120+* cat: (coreutils)cat invocation. Concatenate and write files.
121+* chgrp: (coreutils)chgrp invocation. Change file groups.
122+* chmod: (coreutils)chmod invocation. Change file permissions.
123+* chown: (coreutils)chown invocation. Change file owners/groups.
124+* chroot: (coreutils)chroot invocation. Specify the root directory.
125+* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum.
126+* comm: (coreutils)comm invocation. Compare sorted files by line.
127+* cp: (coreutils)cp invocation. Copy files.
128+* csplit: (coreutils)csplit invocation. Split by context.
129+* cut: (coreutils)cut invocation. Print selected parts of lines.
130+* date: (coreutils)date invocation. Print/set system date and time.
131+* dd: (coreutils)dd invocation. Copy and convert a file.
132+* df: (coreutils)df invocation. Report file system disk usage.
133+* dir: (coreutils)dir invocation. List directories briefly.
134+* dircolors: (coreutils)dircolors invocation. Color setup for ls.
135+* dirname: (coreutils)dirname invocation. Strip non-directory suffix.
136+* du: (coreutils)du invocation. Report on disk usage.
137+* echo: (coreutils)echo invocation. Print a line of text.
138+* env: (coreutils)env invocation. Modify the environment.
139+* expand: (coreutils)expand invocation. Convert tabs to spaces.
140+* expr: (coreutils)expr invocation. Evaluate expressions.
141+* factor: (coreutils)factor invocation. Print prime factors
142+* false: (coreutils)false invocation. Do nothing, unsuccessfully.
143+* fmt: (coreutils)fmt invocation. Reformat paragraph text.
144+* fold: (coreutils)fold invocation. Wrap long input lines.
145+* groups: (coreutils)groups invocation. Print group names a user is in.
146+* head: (coreutils)head invocation. Output the first part of files.
147+* hostid: (coreutils)hostid invocation. Print numeric host identifier.
148+* hostname: (coreutils)hostname invocation. Print or set system name.
149+* id: (coreutils)id invocation. Print user identity.
150+* install: (coreutils)install invocation. Copy and change attributes.
151+* join: (coreutils)join invocation. Join lines on a common field.
152+* kill: (coreutils)kill invocation. Send a signal to processes.
153+* link: (coreutils)link invocation. Make hard links between files.
154+* ln: (coreutils)ln invocation. Make links between files.
155+* logname: (coreutils)logname invocation. Print current login name.
156+* ls: (coreutils)ls invocation. List directory contents.
157+* md5sum: (coreutils)md5sum invocation. Print or check MD5 digests.
158+* mkdir: (coreutils)mkdir invocation. Create directories.
159+* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes).
160+* mknod: (coreutils)mknod invocation. Create special files.
161+* mv: (coreutils)mv invocation. Rename files.
162+* nice: (coreutils)nice invocation. Modify niceness.
163+* nl: (coreutils)nl invocation. Number lines and write files.
164+* nohup: (coreutils)nohup invocation. Immunize to hangups.
165+* od: (coreutils)od invocation. Dump files in octal, etc.
166+* paste: (coreutils)paste invocation. Merge lines of files.
167+* pathchk: (coreutils)pathchk invocation. Check file name portability.
168+* pr: (coreutils)pr invocation. Paginate or columnate files.
169+* printenv: (coreutils)printenv invocation. Print environment variables.
170+* printf: (coreutils)printf invocation. Format and print data.
171+* ptx: (coreutils)ptx invocation. Produce permuted indexes.
172+* pwd: (coreutils)pwd invocation. Print working directory.
173+* readlink: (coreutils)readlink invocation. Print referent of a symlink.
174+* rm: (coreutils)rm invocation. Remove files.
175+* rmdir: (coreutils)rmdir invocation. Remove empty directories.
176+* seq: (coreutils)seq invocation. Print numeric sequences
177+* sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests.
178+* sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests.
179+* shred: (coreutils)shred invocation. Remove files more securely.
180+* shuf: (coreutils)shuf invocation. Shuffling text files.
181+* sleep: (coreutils)sleep invocation. Delay for a specified time.
182+* sort: (coreutils)sort invocation. Sort text files.
183+* split: (coreutils)split invocation. Split into fixed-size pieces.
184+* stat: (coreutils)stat invocation. Report file(system) status.
185+* stty: (coreutils)stty invocation. Print/change terminal settings.
186+* su: (coreutils)su invocation. Modify user and group ID.
187+* sum: (coreutils)sum invocation. Print traditional checksum.
188+* sync: (coreutils)sync invocation. Synchronize memory and disk.
189+* tac: (coreutils)tac invocation. Reverse files.
190+* tail: (coreutils)tail invocation. Output the last part of files.
191+* tee: (coreutils)tee invocation. Redirect to multiple files.
192+* test: (coreutils)test invocation. File/string tests.
193+* touch: (coreutils)touch invocation. Change file timestamps.
194+* tr: (coreutils)tr invocation. Translate characters.
195+* true: (coreutils)true invocation. Do nothing, successfully.
196+* tsort: (coreutils)tsort invocation. Topological sort.
197+* tty: (coreutils)tty invocation. Print terminal name.
198+* uname: (coreutils)uname invocation. Print system information.
199+* unexpand: (coreutils)unexpand invocation. Convert spaces to tabs.
200+* uniq: (coreutils)uniq invocation. Uniquify files.
201+* unlink: (coreutils)unlink invocation. Removal via unlink(2).
202+* users: (coreutils)users invocation. Print current user names.
203+* vdir: (coreutils)vdir invocation. List directories verbosely.
204+* wc: (coreutils)wc invocation. Line, word, and byte counts.
205+* who: (coreutils)who invocation. Print who is logged in.
206+* whoami: (coreutils)whoami invocation. Print effective user ID.
207+* yes: (coreutils)yes invocation. Print a string indefinitely.
fbb5b105
JB
208 @end direntry
209
210 @copying
c2be74f0 211@@ -189,9 +175,8 @@
a839fc2f
JB
212 * File name manipulation:: dirname basename pathchk
213 * Working context:: pwd stty printenv tty
c2be74f0
JB
214 * User information:: id logname whoami groups users who
215-* System context:: date uname hostname hostid
216+* System context:: date uname hostid
a839fc2f
JB
217 * Modified command invocation:: chroot env nice nohup su
218-* Process control:: kill
219 * Delaying:: sleep
220 * Numeric operations:: factor seq
221 * File permissions:: Access modes.
3c350007 222@@ -218,42 +203,42 @@
a839fc2f
JB
223
224 Output of entire files
225
226-* cat invocation:: Concatenate and write files.
227-* tac invocation:: Concatenate and write files in reverse.
228-* nl invocation:: Number lines and write files.
229-* od invocation:: Write files in octal or other formats.
c2be74f0 230-* base64 invocation:: Transform data into printable data.
a839fc2f
JB
231+* cat:: Concatenate and write files.
232+* tac:: Concatenate and write files in reverse.
233+* nl:: Number lines and write files.
234+* od:: Write files in octal or other formats.
c2be74f0 235+* base64:: Transform data into printable data.
a839fc2f
JB
236
237 Formatting file contents
238
239-* fmt invocation:: Reformat paragraph text.
240-* pr invocation:: Paginate or columnate files for printing.
241-* fold invocation:: Wrap input lines to fit in specified width.
242+* fmt:: Reformat paragraph text.
243+* pr:: Paginate or columnate files for printing.
244+* fold:: Wrap input lines to fit in specified width.
245
246 Output of parts of files
247
248-* head invocation:: Output the first part of files.
249-* tail invocation:: Output the last part of files.
250-* split invocation:: Split a file into fixed-size pieces.
251-* csplit invocation:: Split a file into context-determined pieces.
252+* head:: Output the first part of files.
253+* tail:: Output the last part of files.
254+* split:: Split a file into fixed-size pieces.
255+* csplit:: Split a file into context-determined pieces.
256
257 Summarizing files
258
876a8767 259-* wc invocation:: Print newline, word, and byte counts.
a839fc2f
JB
260-* sum invocation:: Print checksum and block counts.
261-* cksum invocation:: Print CRC checksum and byte counts.
c2be74f0
JB
262-* md5sum invocation:: Print or check MD5 digests.
263-* sha1sum invocation:: Print or check SHA-1 digests.
264-* sha2 utilities:: Print or check SHA-2 digests.
876a8767 265+* wc:: Print newline, word, and byte counts.
a839fc2f
JB
266+* sum:: Print checksum and block counts.
267+* cksum:: Print CRC checksum and byte counts.
c2be74f0
JB
268+* md5sum:: Print or check MD5 digests.
269+* sha1sum:: Print or check SHA-1 digests.
270+* sha2:: Print or check SHA-2 digests.
a839fc2f
JB
271
272 Operating on sorted files
273
274-* sort invocation:: Sort text files.
c2be74f0 275-* shuf invocation:: Shuffle text files.
a839fc2f
JB
276-* uniq invocation:: Uniquify files.
277-* comm invocation:: Compare two sorted files line by line.
278-* ptx invocation:: Produce a permuted index of file contents.
279-* tsort invocation:: Topological sort.
280+* sort:: Sort text files.
c2be74f0 281+* shuf:: Shuffle text files.
a839fc2f
JB
282+* uniq:: Uniquify files.
283+* comm:: Compare two sorted files line by line.
284+* ptx:: Produce a permuted index of file contents.
285+* tsort:: Topological sort.
286
287 @command{ptx}: Produce permuted indexes
288
3c350007 289@@ -265,15 +250,15 @@
a839fc2f
JB
290
291 Operating on fields within a line
292
293-* cut invocation:: Print selected parts of lines.
294-* paste invocation:: Merge lines of files.
295-* join invocation:: Join lines on a common field.
296+* cut:: Print selected parts of lines.
297+* paste:: Merge lines of files.
298+* join:: Join lines on a common field.
299
300 Operating on characters
301
302-* tr invocation:: Translate, squeeze, and/or delete characters.
303-* expand invocation:: Convert tabs to spaces.
304-* unexpand invocation:: Convert spaces to tabs.
305+* tr:: Translate, squeeze, and/or delete characters.
306+* expand:: Convert tabs to spaces.
307+* unexpand:: Convert spaces to tabs.
308
309 @command{tr}: Translate, squeeze, and/or delete characters
310
3c350007 311@@ -283,10 +268,10 @@
a839fc2f
JB
312
313 Directory listing
314
315-* ls invocation:: List directory contents
316-* dir invocation:: Briefly list directory contents
317-* vdir invocation:: Verbosely list directory contents
318-* dircolors invocation:: Color setup for @command{ls}
319+* ls:: List directory contents
320+* dir:: Briefly list directory contents
321+* vdir:: Verbosely list directory contents
322+* dircolors:: Color setup for @command{ls}
323
324 @command{ls}: List directory contents
325
3c350007 326@@ -299,50 +284,50 @@
a839fc2f
JB
327
328 Basic operations
329
330-* cp invocation:: Copy files and directories
331-* dd invocation:: Convert and copy a file
332-* install invocation:: Copy files and set attributes
333-* mv invocation:: Move (rename) files
334-* rm invocation:: Remove files or directories
335-* shred invocation:: Remove files more securely
336+* cp:: Copy files and directories
337+* dd:: Convert and copy a file
338+* install:: Copy files and set attributes
339+* mv:: Move (rename) files
340+* rm:: Remove files or directories
341+* shred:: Remove files more securely
342
343 Special file types
344
345-* link invocation:: Make a hard link via the link syscall
346-* ln invocation:: Make links between files
347-* mkdir invocation:: Make directories
348-* mkfifo invocation:: Make FIFOs (named pipes)
349-* mknod invocation:: Make block or character special files
fbb5b105 350-* readlink invocation:: Print the referent of a symbolic link
a839fc2f
JB
351-* rmdir invocation:: Remove empty directories
352-* unlink invocation:: Remove files via unlink syscall
353+* link:: Make a hard link via the link syscall
354+* ln:: Make links between files
355+* mkdir:: Make directories
356+* mkfifo:: Make FIFOs (named pipes)
357+* mknod:: Make block or character special files
fbb5b105 358+* readlink:: Print the referent of a symbolic link
a839fc2f
JB
359+* rmdir:: Remove empty directories
360+* unlink:: Remove files via unlink syscall
361
362 Changing file attributes
363
364-* chown invocation:: Change file owner and group
365-* chgrp invocation:: Change group ownership
366-* chmod invocation:: Change access permissions
367-* touch invocation:: Change file timestamps
368+* chown:: Change file owner and group
369+* chgrp:: Change group ownership
370+* chmod:: Change access permissions
371+* touch:: Change file timestamps
372
373 Disk usage
374
c2be74f0 375-* df invocation:: Report file system disk space usage
a839fc2f 376-* du invocation:: Estimate file space usage
c2be74f0 377-* stat invocation:: Report file or file system status
a839fc2f 378-* sync invocation:: Synchronize data on disk with memory
c2be74f0 379+* df:: Report file system disk space usage
a839fc2f 380+* du:: Estimate file space usage
c2be74f0 381+* stat:: Report file or file system status
a839fc2f
JB
382+* sync:: Synchronize data on disk with memory
383
384 Printing text
385
386-* echo invocation:: Print a line of text
387-* printf invocation:: Format and print data
388-* yes invocation:: Print a string until interrupted
389+* echo:: Print a line of text
390+* printf:: Format and print data
391+* yes:: Print a string until interrupted
392
393 Conditions
394
395-* false invocation:: Do nothing, unsuccessfully
396-* true invocation:: Do nothing, successfully
397-* test invocation:: Check file types and compare values
398-* expr invocation:: Evaluate expressions
fbb5b105
JB
399+* false:: Do nothing, unsuccessfully
400+* true:: Do nothing, successfully
401+* test:: Check file types and compare values
402+* expr:: Evaluate expressions
a839fc2f
JB
403
404 @command{test}: Check file types and compare values
405
3c350007 406@@ -361,20 +346,20 @@
a839fc2f
JB
407
408 Redirection
409
3c350007
JB
410-* tee invocation:: Redirect output to multiple files or processes
411+* tee:: Redirect output to multiple files or processes
a839fc2f
JB
412
413 File name manipulation
414
415-* basename invocation:: Strip directory and suffix from a file name
416-* dirname invocation:: Strip non-directory suffix from a file name
417-* pathchk invocation:: Check file name portability
418+* basename:: Strip directory and suffix from a file name
419+* dirname:: Strip non-directory suffix from a file name
420+* pathchk:: Check file name portability
421
422 Working context
423
424-* pwd invocation:: Print working directory
425-* stty invocation:: Print or change terminal characteristics
426-* printenv invocation:: Print all or some environment variables
427-* tty invocation:: Print file name of terminal on standard input
428+* pwd:: Print working directory
429+* stty:: Print or change terminal characteristics
430+* printenv:: Print all or some environment variables
431+* tty:: Print file name of terminal on standard input
432
433 @command{stty}: Print or change terminal characteristics
434
3c350007 435@@ -388,20 +373,19 @@
a839fc2f
JB
436
437 User information
438
c2be74f0 439-* id invocation:: Print user identity
a839fc2f 440-* logname invocation:: Print current login name
c2be74f0 441-* whoami invocation:: Print effective user ID
a839fc2f
JB
442-* groups invocation:: Print group names a user is in
443-* users invocation:: Print login names of users currently logged in
444-* who invocation:: Print who is currently logged in
c2be74f0 445+* id:: Print user identity
a839fc2f 446+* logname:: Print current login name
c2be74f0 447+* whoami:: Print effective user ID
fc53c102 448+* groups:: Print group names a user is in
a839fc2f
JB
449+* users:: Print login names of users currently logged in
450+* who:: Print who is currently logged in
451
452 System context
453
3c350007 454-* arch invocation:: Print machine hardware name
a839fc2f
JB
455-* date invocation:: Print or set system date and time
456-* uname invocation:: Print system information
457-* hostname invocation:: Print or set system name
458-* hostid invocation:: Print numeric host identifier.
3c350007 459+* arch:: Print machine hardware name
a839fc2f
JB
460+* date:: Print or set system date and time
461+* uname:: Print system information
3c350007 462+* hostid:: Print numeric host identifier
a839fc2f
JB
463
464 @command{date}: Print or set system date and time
465
3c350007 466@@ -416,24 +400,20 @@
a839fc2f
JB
467
468 Modified command invocation
469
470-* chroot invocation:: Run a command with a different root directory
471-* env invocation:: Run a command in a modified environment
c2be74f0 472-* nice invocation:: Run a command with modified niceness
a839fc2f 473-* nohup invocation:: Run a command immune to hangups
c2be74f0 474-* su invocation:: Run a command with substitute user and group ID
a839fc2f
JB
475-
476-Process control
477-
478-* kill invocation:: Sending a signal to processes.
479+* chroot:: Run a command with a different root directory
480+* env:: Run a command in a modified environment
c2be74f0 481+* nice:: Run a command with modified niceness
a839fc2f 482+* nohup:: Run a command immune to hangups
c2be74f0 483+* su:: Run a command with substitute user and group ID
a839fc2f
JB
484
485 Delaying
486
487-* sleep invocation:: Delay for a specified time
488+* sleep:: Delay for a specified time
489
490 Numeric operations
491
492-* factor invocation:: Print prime factors
493-* seq invocation:: Print numeric sequences
494+* factor:: Print prime factors
495+* seq:: Print numeric sequences
496
497 File permissions
498
3c350007 499@@ -1276,14 +1256,14 @@
a839fc2f
JB
500 in some way.
501
502 @menu
503-* cat invocation:: Concatenate and write files.
504-* tac invocation:: Concatenate and write files in reverse.
505-* nl invocation:: Number lines and write files.
506-* od invocation:: Write files in octal or other formats.
c2be74f0 507-* base64 invocation:: Transform data into printable data.
a839fc2f
JB
508+* cat:: Concatenate and write files.
509+* tac:: Concatenate and write files in reverse.
510+* nl:: Number lines and write files.
511+* od:: Write files in octal or other formats.
c2be74f0 512+* base64:: Transform data into printable data.
a839fc2f
JB
513 @end menu
514
515-@node cat invocation
516+@node cat
517 @section @command{cat}: Concatenate and write files
518
519 @pindex cat
3c350007 520@@ -1382,7 +1362,7 @@
c2be74f0 521 @end smallexample
a839fc2f
JB
522
523
524-@node tac invocation
525+@node tac
526 @section @command{tac}: Concatenate and write files in reverse
527
528 @pindex tac
3c350007 529@@ -1431,7 +1411,7 @@
876a8767 530 @exitstatus
a839fc2f
JB
531
532
533-@node nl invocation
534+@node nl
535 @section @command{nl}: Number lines and write files
536
537 @pindex nl
3c350007 538@@ -1594,7 +1574,7 @@
876a8767 539 @exitstatus
a839fc2f
JB
540
541
542-@node od invocation
543+@node od
544 @section @command{od}: Write files in octal or other formats
545
546 @pindex od
3c350007 547@@ -1850,7 +1830,7 @@
c2be74f0
JB
548
549 @exitstatus
550
551-@node base64 invocation
552+@node base64
553 @section @command{base64}: Transform data into printable data.
554
555 @pindex base64
3c350007 556@@ -1917,13 +1897,13 @@
a839fc2f
JB
557 These commands reformat the contents of files.
558
559 @menu
560-* fmt invocation:: Reformat paragraph text.
561-* pr invocation:: Paginate or columnate files for printing.
562-* fold invocation:: Wrap input lines to fit in specified width.
563+* fmt:: Reformat paragraph text.
564+* pr:: Paginate or columnate files for printing.
565+* fold:: Wrap input lines to fit in specified width.
566 @end menu
567
568
569-@node fmt invocation
570+@node fmt
571 @section @command{fmt}: Reformat paragraph text
572
573 @pindex fmt
3c350007 574@@ -2022,7 +2002,7 @@
876a8767 575 @exitstatus
a839fc2f
JB
576
577
578-@node pr invocation
579+@node pr
580 @section @command{pr}: Paginate or columnate files for printing
581
582 @pindex pr
3c350007 583@@ -2162,7 +2142,7 @@
a839fc2f
JB
584 @cindex time formats
585 @cindex formatting times
586 Format header dates using @var{format}, using the same conventions as
c2be74f0
JB
587-for the command @samp{date +@var{format}}; @xref{date invocation}.
588+for the command @samp{date +@var{format}}; @xref{date}.
a839fc2f
JB
589 Except for directives, which start with
590 @samp{%}, characters in @var{format} are printed unchanged. You can use
591 this option to specify an arbitrary string in place of the header date,
3c350007 592@@ -2389,7 +2369,7 @@
876a8767 593 @exitstatus
a839fc2f
JB
594
595
596-@node fold invocation
597+@node fold
598 @section @command{fold}: Wrap input lines to fit in specified width
599
600 @pindex fold
3c350007 601@@ -2456,13 +2436,13 @@
a839fc2f
JB
602 These commands output pieces of the input.
603
604 @menu
605-* head invocation:: Output the first part of files.
606-* tail invocation:: Output the last part of files.
607-* split invocation:: Split a file into fixed-size pieces.
608-* csplit invocation:: Split a file into context-determined pieces.
609+* head:: Output the first part of files.
610+* tail:: Output the last part of files.
611+* split:: Split a file into fixed-size pieces.
612+* csplit:: Split a file into context-determined pieces.
613 @end menu
614
615-@node head invocation
616+@node head
617 @section @command{head}: Output the first part of files
618
619 @pindex head
3c350007 620@@ -2543,7 +2523,7 @@
876a8767
JB
621 @exitstatus
622
a839fc2f
JB
623
624-@node tail invocation
625+@node tail
626 @section @command{tail}: Output the last part of files
627
628 @pindex tail
3c350007 629@@ -2758,7 +2738,7 @@
876a8767
JB
630 @exitstatus
631
a839fc2f
JB
632
633-@node split invocation
634+@node split
635 @section @command{split}: Split a file into fixed-size pieces
636
637 @pindex split
3c350007 638@@ -2845,7 +2825,7 @@
876a8767 639 @exitstatus
a839fc2f
JB
640
641
642-@node csplit invocation
643+@node csplit
644 @section @command{csplit}: Split a file into context-determined pieces
645
646 @pindex csplit
3c350007 647@@ -2985,16 +2965,16 @@
a839fc2f
JB
648 contents of files.
649
650 @menu
876a8767 651-* wc invocation:: Print newline, word, and byte counts.
a839fc2f
JB
652-* sum invocation:: Print checksum and block counts.
653-* cksum invocation:: Print CRC checksum and byte counts.
c2be74f0
JB
654-* md5sum invocation:: Print or check MD5 digests.
655-* sha1sum invocation:: Print or check SHA-1 digests.
656-* sha2 utilities:: Print or check SHA-2 digests.
876a8767 657+* wc:: Print newline, word, and byte counts.
a839fc2f
JB
658+* sum:: Print checksum and block counts.
659+* cksum:: Print CRC checksum and byte counts.
c2be74f0
JB
660+* md5sum:: Print or check MD5 digests.
661+* sha1sum:: Print or check SHA-1 digests.
662+* sha2:: Print or check SHA-2 digests.
a839fc2f
JB
663 @end menu
664
665
666-@node wc invocation
667+@node wc
876a8767 668 @section @command{wc}: Print newline, word, and byte counts
a839fc2f
JB
669
670 @pindex wc
3c350007 671@@ -3101,7 +3081,7 @@
876a8767 672 @exitstatus
a839fc2f
JB
673
674
675-@node sum invocation
676+@node sum
677 @section @command{sum}: Print checksum and block counts
678
679 @pindex sum
3c350007 680@@ -3152,7 +3132,7 @@
876a8767 681 @exitstatus
a839fc2f
JB
682
683
684-@node cksum invocation
685+@node cksum
686 @section @command{cksum}: Print CRC checksum and byte counts
687
688 @pindex cksum
3c350007 689@@ -3186,7 +3166,7 @@
876a8767 690 @exitstatus
a839fc2f
JB
691
692
693-@node md5sum invocation
694+@node md5sum
c2be74f0 695 @section @command{md5sum}: Print or check MD5 digests
a839fc2f
JB
696
697 @pindex md5sum
3c350007 698@@ -3208,8 +3188,8 @@
c2be74f0
JB
699 considered infeasible at the moment, it is known how to produce
700 different files with identical MD5 (a ``collision''), something which
701 can be a security issue in certain contexts. For more secure hashes,
702-consider using SHA-1 or SHA-2. @xref{sha1sum invocation}, and
703-@ref{sha2 utilities}.
704+consider using SHA-1 or SHA-2. @xref{sha1sum}, and
705+@ref{sha2}.
706
707 If a @var{file} is specified as @samp{-} or if no files are given
708 @command{md5sum} computes the checksum for the standard input.
3c350007 709@@ -3307,7 +3287,7 @@
c2be74f0
JB
710 @exitstatus
711
712
713-@node sha1sum invocation
714+@node sha1sum
715 @section @command{sha1sum}: Print or check SHA-1 digests
716
717 @pindex sha1sum
3c350007 718@@ -3319,17 +3299,17 @@
c2be74f0
JB
719
720 @command{sha1sum} computes a 160-bit checksum for each specified
721 @var{file}. The usage and options of this command are precisely the
722-same as for @command{md5sum}. @xref{md5sum invocation}.
723+same as for @command{md5sum}. @xref{md5sum}.
724
725 Note: The SHA-1 digest is more secure than MD5, and no collisions of
726 it are known (different files having the same fingerprint). However,
727 it is known that they can be produced with considerable, but not
728 unreasonable, resources. For this reason, it is generally considered
729 that SHA-1 should be gradually phased out in favor of the more secure
730-SHA-2 hash algorithms. @xref{sha2 utilities}.
731+SHA-2 hash algorithms. @xref{sha2}.
732
733
734-@node sha2 utilities
735+@node sha2
736 @section sha2 utilities: Print or check SHA-2 digests
737
738 @pindex sha224sum
3c350007 739@@ -3359,7 +3339,7 @@
c2be74f0
JB
740 various lengths (respectively 224, 256, 384 and 512 bits),
741 collectively known as the SHA-2 hashes. The usage and options of
742 these commands are precisely the same as for @command{md5sum}.
743-@xref{md5sum invocation}.
744+@xref{md5sum}.
745
746 Note: The SHA384 and SHA512 digests are considerably slower to
747 compute, especially on 32-bit computers, than SHA224 or SHA256.
3c350007 748@@ -3374,17 +3354,17 @@
a839fc2f
JB
749 These commands work with (or produce) sorted files.
750
751 @menu
752-* sort invocation:: Sort text files.
c2be74f0 753-* shuf invocation:: Shuffle text files.
a839fc2f
JB
754-* uniq invocation:: Uniquify files.
755-* comm invocation:: Compare two sorted files line by line.
756-* ptx invocation:: Produce a permuted index of file contents.
757-* tsort invocation:: Topological sort.
758+* sort:: Sort text files.
c2be74f0 759+* shuf:: Shuffle text files.
a839fc2f
JB
760+* uniq:: Uniquify files.
761+* comm:: Compare two sorted files line by line.
762+* ptx:: Produce a permuted index of file contents.
763+* tsort:: Topological sort.
764 * tsort background:: Where tsort came from.
765 @end menu
766
767
768-@node sort invocation
769+@node sort
770 @section @command{sort}: Sort text files
771
772 @pindex sort
3c350007 773@@ -3629,7 +3609,7 @@
c2be74f0
JB
774 Sort by hashing the input keys and then sorting the hash values.
775 Choose the hash function at random, ensuring that it is free of
776 collisions so that differing keys have differing hash values. This is
777-like a random permutation of the inputs (@pxref{shuf invocation}),
778+like a random permutation of the inputs (@pxref{shuf}),
779 except that keys with the same value sort together.
780
781 If multiple random sort fields are specified, the same random hash
3c350007 782@@ -3792,7 +3772,7 @@
c2be74f0
JB
783 this equivalence does not extend to arbitrary @command{sort} options.
784 For example, @code{sort -n -u} inspects only the value of the initial
785 numeric string when checking for uniqueness, whereas @code{sort -n |
786-uniq} inspects the entire line. @xref{uniq invocation}.
787+uniq} inspects the entire line. @xref{uniq}.
788
789 @item -z
790 @itemx --zero-terminated
3c350007 791@@ -3985,7 +3965,7 @@
a839fc2f
JB
792 @end itemize
793
794
c2be74f0
JB
795-@node shuf invocation
796+@node shuf
797 @section @command{shuf}: Shuffling text
798
799 @pindex shuf
3c350007 800@@ -4126,7 +4106,7 @@
c2be74f0
JB
801 @exitstatus
802
803
a839fc2f
JB
804-@node uniq invocation
805+@node uniq
806 @section @command{uniq}: Uniquify files
807
808 @pindex uniq
3c350007 809@@ -4148,7 +4128,7 @@
c2be74f0
JB
810 The input need not be sorted, but repeated input lines are detected
811 only if they are adjacent. If you want to discard non-adjacent
812 duplicate lines, perhaps you want to use @code{sort -u}.
813-@xref{sort invocation}.
814+@xref{sort}.
815
816 @vindex LC_COLLATE
817 Comparisons use the character collating sequence specified by the
3c350007 818@@ -4286,7 +4266,7 @@
876a8767 819 @exitstatus
a839fc2f
JB
820
821
822-@node comm invocation
823+@node comm
824 @section @command{comm}: Compare two sorted files line by line
825
826 @pindex comm
3c350007 827@@ -4329,7 +4309,7 @@
a839fc2f
JB
828 If there is an error it exits with nonzero status.
829
830
831-@node tsort invocation
832+@node tsort
833 @section @command{tsort}: Topological sort
834
835 @pindex tsort
3c350007 836@@ -4483,7 +4463,7 @@
876a8767
JB
837 @exitstatus
838
a839fc2f
JB
839
840-@node ptx invocation
841+@node ptx
842 @section @command{ptx}: Produce permuted indexes
843
844 @pindex ptx
3c350007 845@@ -4942,13 +4922,13 @@
a839fc2f
JB
846 @chapter Operating on fields within a line
847
848 @menu
849-* cut invocation:: Print selected parts of lines.
850-* paste invocation:: Merge lines of files.
851-* join invocation:: Join lines on a common field.
852+* cut:: Print selected parts of lines.
853+* paste:: Merge lines of files.
854+* join:: Join lines on a common field.
855 @end menu
856
857
858-@node cut invocation
859+@node cut
860 @section @command{cut}: Print selected parts of lines
861
862 @pindex cut
3c350007 863@@ -5047,7 +5027,7 @@
876a8767 864 @exitstatus
a839fc2f
JB
865
866
867-@node paste invocation
868+@node paste
869 @section @command{paste}: Merge lines of files
870
871 @pindex paste
3c350007 872@@ -5117,7 +5097,7 @@
876a8767 873 @exitstatus
a839fc2f
JB
874
875
876-@node join invocation
877+@node join
878 @section @command{join}: Join lines on a common field
879
880 @pindex join
3c350007 881@@ -5260,13 +5240,13 @@
a839fc2f
JB
882 This commands operate on individual characters.
883
884 @menu
885-* tr invocation:: Translate, squeeze, and/or delete characters.
886-* expand invocation:: Convert tabs to spaces.
887-* unexpand invocation:: Convert spaces to tabs.
888+* tr:: Translate, squeeze, and/or delete characters.
889+* expand:: Convert tabs to spaces.
890+* unexpand:: Convert spaces to tabs.
891 @end menu
892
893
894-@node tr invocation
895+@node tr
896 @section @command{tr}: Translate, squeeze, and/or delete characters
897
898 @pindex tr
3c350007 899@@ -5644,7 +5624,7 @@
c2be74f0 900 @end itemize
a839fc2f
JB
901
902
903-@node expand invocation
904+@node expand
905 @section @command{expand}: Convert tabs to spaces
906
907 @pindex expand
3c350007 908@@ -5697,7 +5677,7 @@
876a8767 909 @exitstatus
a839fc2f
JB
910
911
912-@node unexpand invocation
913+@node unexpand
914 @section @command{unexpand}: Convert spaces to tabs
915
916 @pindex unexpand
3c350007 917@@ -5758,14 +5738,14 @@
a839fc2f
JB
918 and @command{vdir}, which list information about files.
919
920 @menu
921-* ls invocation:: List directory contents.
922-* dir invocation:: Briefly ls.
923-* vdir invocation:: Verbosely ls.
924-* dircolors invocation:: Color setup for ls, etc.
925+* ls:: List directory contents.
926+* dir:: Briefly ls.
927+* vdir:: Verbosely ls.
928+* dircolors:: Color setup for ls, etc.
929 @end menu
930
931
932-@node ls invocation
933+@node ls
934 @section @command{ls}: List directory contents
935
936 @pindex ls
3c350007 937@@ -6570,7 +6550,7 @@
a839fc2f
JB
938 @item +@var{format}
939 @vindex LC_TIME
940 List timestamps using @var{format}, where @var{format} is interpreted
941-like the format argument of @command{date} (@pxref{date invocation}).
942+like the format argument of @command{date} (@pxref{date}).
fbb5b105 943 For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
a839fc2f
JB
944 @command{ls} to list timestamps like @samp{2002-03-30 23:45:56}. As
945 with @command{date}, @var{format}'s interpretation is affected by the
3c350007 946@@ -6762,7 +6742,7 @@
a839fc2f
JB
947 @end table
948
949
950-@node dir invocation
951+@node dir
952 @section @command{dir}: Briefly list directory contents
953
954 @pindex dir
3c350007 955@@ -6772,10 +6752,10 @@
a839fc2f
JB
956 -b}; that is, by default files are listed in columns, sorted vertically,
957 and special characters are represented by backslash escape sequences.
958
959-@xref{ls invocation, @command{ls}}.
960+@xref{ls, @command{ls}}.
961
962
963-@node vdir invocation
964+@node vdir
965 @section @command{vdir}: Verbosely list directory contents
966
967 @pindex vdir
3c350007 968@@ -6785,7 +6765,7 @@
a839fc2f
JB
969 -b}; that is, by default files are listed in long format and special
970 characters are represented by backslash escape sequences.
971
972-@node dircolors invocation
973+@node dircolors
fbb5b105 974 @section @command{dircolors}: Color setup for @command{ls}
a839fc2f
JB
975
976 @pindex dircolors
3c350007 977@@ -6863,16 +6843,16 @@
a839fc2f
JB
978 copying, moving (renaming), and deleting (removing).
979
980 @menu
981-* cp invocation:: Copy files.
982-* dd invocation:: Convert and copy a file.
983-* install invocation:: Copy files and set attributes.
984-* mv invocation:: Move (rename) files.
985-* rm invocation:: Remove files or directories.
986-* shred invocation:: Remove files more securely.
987+* cp:: Copy files.
988+* dd:: Convert and copy a file.
989+* install:: Copy files and set attributes.
990+* mv:: Move (rename) files.
991+* rm:: Remove files or directories.
992+* shred:: Remove files more securely.
993 @end menu
994
995
996-@node cp invocation
997+@node cp
998 @section @command{cp}: Copy files and directories
999
1000 @pindex cp
3c350007 1001@@ -7251,7 +7231,7 @@
876a8767 1002 @exitstatus
a839fc2f
JB
1003
1004
1005-@node dd invocation
1006+@node dd
1007 @section @command{dd}: Convert and copy a file
1008
1009 @pindex dd
3c350007 1010@@ -7580,7 +7560,7 @@
876a8767 1011 @exitstatus
a839fc2f
JB
1012
1013
1014-@node install invocation
1015+@node install
1016 @section @command{install}: Copy files and set attributes
1017
1018 @pindex install
3c350007 1019@@ -7726,7 +7706,7 @@
876a8767 1020 @exitstatus
a839fc2f
JB
1021
1022
1023-@node mv invocation
1024+@node mv
1025 @section @command{mv}: Move (rename) files
1026
1027 @pindex mv
3c350007 1028@@ -7847,7 +7827,7 @@
876a8767 1029 @exitstatus
a839fc2f
JB
1030
1031
1032-@node rm invocation
1033+@node rm
1034 @section @command{rm}: Remove files or directories
1035
1036 @pindex rm
3c350007 1037@@ -8001,7 +7981,7 @@
876a8767 1038 @exitstatus
a839fc2f
JB
1039
1040
1041-@node shred invocation
1042+@node shred
1043 @section @command{shred}: Remove files more securely
1044
1045 @pindex shred
3c350007 1046@@ -8011,7 +7991,7 @@
a839fc2f
JB
1047 @command{shred} overwrites devices or files, to help prevent even
1048 very expensive hardware from recovering the data.
1049
1050-Ordinarily when you remove a file (@pxref{rm invocation}), the data is
1051+Ordinarily when you remove a file (@pxref{rm}), the data is
1052 not actually destroyed. Only the index listing where the file is
1053 stored is destroyed, and the storage is made available for reuse.
1054 There are undelete utilities that will attempt to reconstruct the index
3c350007 1055@@ -8243,18 +8223,18 @@
a839fc2f
JB
1056 (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
1057
1058 @menu
1059-* link invocation:: Make a hard link via the link syscall
1060-* ln invocation:: Make links between files.
1061-* mkdir invocation:: Make directories.
1062-* mkfifo invocation:: Make FIFOs (named pipes).
1063-* mknod invocation:: Make block or character special files.
fbb5b105 1064-* readlink invocation:: Print the referent of a symbolic link.
a839fc2f
JB
1065-* rmdir invocation:: Remove empty directories.
1066-* unlink invocation:: Remove files via the unlink syscall
3c350007 1067+* link:: Make a hard link via the link syscall.
a839fc2f
JB
1068+* ln:: Make links between files.
1069+* mkdir:: Make directories.
1070+* mkfifo:: Make FIFOs (named pipes).
1071+* mknod:: Make block or character special files.
fbb5b105 1072+* readlink:: Print the referent of a symbolic link.
a839fc2f 1073+* rmdir:: Remove empty directories.
fbb5b105 1074+* unlink:: Remove files via the unlink syscall.
a839fc2f
JB
1075 @end menu
1076
1077
1078-@node link invocation
1079+@node link
1080 @section @command{link}: Make a hard link via the link syscall
1081
1082 @pindex link
3c350007 1083@@ -8267,7 +8247,7 @@
c2be74f0
JB
1084 @code{link} function. @xref{Hard Links, , , libc,
1085 The GNU C Library Reference Manual}.
1086 It avoids the bells and whistles of the more commonly-used
1087-@command{ln} command (@pxref{ln invocation}).
1088+@command{ln} command (@pxref{ln}).
1089 Synopsis:
1090
1091 @example
3c350007 1092@@ -8288,7 +8268,7 @@
876a8767
JB
1093 @exitstatus
1094
a839fc2f
JB
1095
1096-@node ln invocation
1097+@node ln
1098 @section @command{ln}: Make links between files
1099
1100 @pindex ln
3c350007 1101@@ -8460,7 +8440,7 @@
c2be74f0 1102 @end smallexample
a839fc2f
JB
1103
1104
1105-@node mkdir invocation
1106+@node mkdir
1107 @section @command{mkdir}: Make directories
1108
1109 @pindex mkdir
3c350007 1110@@ -8530,7 +8510,7 @@
876a8767 1111 @exitstatus
a839fc2f
JB
1112
1113
1114-@node mkfifo invocation
1115+@node mkfifo
1116 @section @command{mkfifo}: Make FIFOs (named pipes)
1117
1118 @pindex mkfifo
3c350007 1119@@ -8569,7 +8549,7 @@
876a8767 1120 @exitstatus
a839fc2f
JB
1121
1122
1123-@node mknod invocation
1124+@node mknod
1125 @section @command{mknod}: Make block or character special files
1126
1127 @pindex mknod
3c350007 1128@@ -8641,7 +8621,7 @@
876a8767 1129 @exitstatus
a839fc2f
JB
1130
1131
fbb5b105
JB
1132-@node readlink invocation
1133+@node readlink
1134 @section @command{readlink}: Print the referent of a symbolic link
1135
1136 @pindex readlink
3c350007 1137@@ -8728,7 +8708,7 @@
876a8767 1138 @exitstatus
fbb5b105
JB
1139
1140
a839fc2f
JB
1141-@node rmdir invocation
1142+@node rmdir
1143 @section @command{rmdir}: Remove empty directories
1144
1145 @pindex rmdir
3c350007 1146@@ -8776,12 +8756,12 @@
a839fc2f
JB
1147
1148 @end table
1149
1150-@xref{rm invocation}, for how to remove non-empty directories (recursively).
1151+@xref{rm}, for how to remove non-empty directories (recursively).
1152
876a8767
JB
1153 @exitstatus
1154
1155
a839fc2f
JB
1156-@node unlink invocation
1157+@node unlink
1158 @section @command{unlink}: Remove files via the unlink syscall
1159
1160 @pindex unlink
3c350007 1161@@ -8792,7 +8772,7 @@
c2be74f0
JB
1162 @code{unlink} function. @xref{Deleting Files, , , libc,
1163 The GNU C Library Reference Manual}. Synopsis:
1164 It avoids the bells and whistles of the more commonly-used
1165-@command{rm} command (@pxref{rm invocation}).
1166+@command{rm} command (@pxref{rm}).
1167
1168 @example
1169 unlink @var{filename}
3c350007 1170@@ -8826,14 +8806,14 @@
a839fc2f
JB
1171 These commands change file attributes.
1172
1173 @menu
1174-* chgrp invocation:: Change file groups.
1175-* chmod invocation:: Change access permissions.
1176-* chown invocation:: Change file owners and groups.
1177-* touch invocation:: Change file timestamps.
1178+* chgrp:: Change file groups.
1179+* chmod:: Change access permissions.
1180+* chown:: Change file owners and groups.
1181+* touch:: Change file timestamps.
1182 @end menu
1183
1184
1185-@node chown invocation
1186+@node chown
1187 @section @command{chown}: Change file owner and group
1188
1189 @pindex chown
3c350007 1190@@ -9050,7 +9030,7 @@
c2be74f0 1191 @end smallexample
a839fc2f
JB
1192
1193
1194-@node chgrp invocation
1195+@node chgrp
1196 @section @command{chgrp}: Change group ownership
1197
1198 @pindex chgrp
3c350007 1199@@ -9172,7 +9152,7 @@
c2be74f0 1200 @end smallexample
a839fc2f
JB
1201
1202
1203-@node chmod invocation
1204+@node chmod
1205 @section @command{chmod}: Change access permissions
1206
1207 @pindex chmod
3c350007 1208@@ -9271,7 +9251,7 @@
876a8767 1209 @exitstatus
a839fc2f
JB
1210
1211
1212-@node touch invocation
1213+@node touch
1214 @section @command{touch}: Change file timestamps
1215
1216 @pindex touch
3c350007 1217@@ -9421,14 +9401,14 @@
c2be74f0 1218 file status information, and write buffers to disk.
a839fc2f
JB
1219
1220 @menu
c2be74f0 1221-* df invocation:: Report file system disk space usage.
a839fc2f 1222-* du invocation:: Estimate file space usage.
c2be74f0 1223-* stat invocation:: Report file or file system status.
a839fc2f 1224-* sync invocation:: Synchronize memory and disk.
c2be74f0 1225+* df:: Report file system disk space usage.
a839fc2f 1226+* du:: Estimate file space usage.
c2be74f0 1227+* stat:: Report file or file system status.
a839fc2f
JB
1228+* sync:: Synchronize memory and disk.
1229 @end menu
1230
1231
1232-@node df invocation
1233+@node df
c2be74f0 1234 @section @command{df}: Report file system disk space usage
a839fc2f
JB
1235
1236 @pindex df
3c350007 1237@@ -9633,7 +9613,7 @@
c2be74f0 1238 @samp{ext3} or @samp{reiserfs}.
a839fc2f
JB
1239
1240
1241-@node du invocation
1242+@node du
1243 @section @command{du}: Estimate file space usage
1244
1245 @pindex du
3c350007 1246@@ -9842,7 +9822,7 @@
c2be74f0
JB
1247 @item +@var{format}
1248 @vindex LC_TIME
1249 List timestamps using @var{format}, where @var{format} is interpreted
1250-like the format argument of @command{date} (@pxref{date invocation}).
1251+like the format argument of @command{date} (@pxref{date}).
1252 For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
1253 @command{du} to list timestamps like @samp{2002-03-30 23:45:56}. As
1254 with @command{date}, @var{format}'s interpretation is affected by the
3c350007 1255@@ -9910,7 +9890,7 @@
876a8767 1256 @exitstatus
a839fc2f
JB
1257
1258
1259-@node stat invocation
1260+@node stat
c2be74f0 1261 @section @command{stat}: Report file or file system status
a839fc2f
JB
1262
1263 @pindex stat
3c350007 1264@@ -10044,7 +10024,7 @@
876a8767 1265 @exitstatus
a839fc2f
JB
1266
1267
1268-@node sync invocation
1269+@node sync
1270 @section @command{sync}: Synchronize data on disk with memory
1271
1272 @pindex sync
3c350007 1273@@ -10080,13 +10060,13 @@
a839fc2f
JB
1274 This section describes commands that display text strings.
1275
1276 @menu
1277-* echo invocation:: Print a line of text.
1278-* printf invocation:: Format and print data.
1279-* yes invocation:: Print a string until interrupted.
1280+* echo:: Print a line of text.
1281+* printf:: Format and print data.
1282+* yes:: Print a string until interrupted.
1283 @end menu
1284
1285
1286-@node echo invocation
1287+@node echo
1288 @section @command{echo}: Print a line of text
1289
1290 @pindex echo
3c350007 1291@@ -10169,12 +10149,12 @@
c2be74f0
JB
1292 @var{string} contains a backslash or if the first argument is
1293 @option{-n}. Portable programs can use the @command{printf} command
1294 if they need to omit trailing newlines or output control characters or
1295-backslashes. @xref{printf invocation}.
1296+backslashes. @xref{printf}.
1297
876a8767 1298 @exitstatus
a839fc2f
JB
1299
1300
1301-@node printf invocation
1302+@node printf
1303 @section @command{printf}: Format and print data
1304
1305 @pindex printf
3c350007 1306@@ -10317,7 +10297,7 @@
876a8767 1307 @exitstatus
a839fc2f
JB
1308
1309
1310-@node yes invocation
1311+@node yes
1312 @section @command{yes}: Print a string until interrupted
1313
1314 @pindex yes
3c350007 1315@@ -10348,14 +10328,14 @@
a839fc2f
JB
1316 pipeline.
1317
1318 @menu
1319-* false invocation:: Do nothing, unsuccessfully.
1320-* true invocation:: Do nothing, successfully.
1321-* test invocation:: Check file types and compare values.
1322-* expr invocation:: Evaluate expressions.
1323+* false:: Do nothing, unsuccessfully.
1324+* true:: Do nothing, successfully.
1325+* test:: Check file types and compare values.
1326+* expr:: Evaluate expressions.
1327 @end menu
1328
1329
1330-@node false invocation
1331+@node false
1332 @section @command{false}: Do nothing, unsuccessfully
1333
1334 @pindex false
3c350007 1335@@ -10385,7 +10365,7 @@
c2be74f0 1336 non-@acronym{GNU} hosts.
a839fc2f
JB
1337
1338
1339-@node true invocation
1340+@node true
1341 @section @command{true}: Do nothing, successfully
1342
1343 @pindex true
3c350007 1344@@ -10421,7 +10401,7 @@
a839fc2f
JB
1345 more secure and faster than a shell script implementation, and may safely
1346 be used as a dummy shell for the purpose of disabling accounts.
1347
1348-@node test invocation
1349+@node test
1350 @section @command{test}: Check file types and compare values
1351
1352 @pindex test
3c350007 1353@@ -10752,7 +10732,7 @@
a839fc2f
JB
1354 @end table
1355
1356
1357-@node expr invocation
1358+@node expr
1359 @section @command{expr}: Evaluate expressions
1360
1361 @pindex expr
3c350007 1362@@ -11025,11 +11005,11 @@
a839fc2f
JB
1363 it's described here.
1364
1365 @menu
3c350007
JB
1366-* tee invocation:: Redirect output to multiple files or processes.
1367+* tee:: Redirect output to multiple files or processes.
a839fc2f
JB
1368 @end menu
1369
1370
1371-@node tee invocation
1372+@node tee
3c350007 1373 @section @command{tee}: Redirect output to multiple files or processes
a839fc2f
JB
1374
1375 @pindex tee
3c350007 1376@@ -11190,13 +11170,13 @@
a839fc2f
JB
1377 This section describes commands that manipulate file names.
1378
1379 @menu
1380-* basename invocation:: Strip directory and suffix from a file name.
1381-* dirname invocation:: Strip non-directory suffix from a file name.
1382-* pathchk invocation:: Check file name portability.
1383+* basename:: Strip directory and suffix from a file name.
1384+* dirname:: Strip non-directory suffix from a file name.
1385+* pathchk:: Check file name portability.
1386 @end menu
1387
1388
1389-@node basename invocation
1390+@node basename
fbb5b105 1391 @section @command{basename}: Strip directory and suffix from a file name
a839fc2f
JB
1392
1393 @pindex basename
3c350007 1394@@ -11250,7 +11230,7 @@
c2be74f0 1395 @end smallexample
a839fc2f
JB
1396
1397
1398-@node dirname invocation
1399+@node dirname
1400 @section @command{dirname}: Strip non-directory suffix from a file name
1401
1402 @pindex dirname
3c350007 1403@@ -11291,7 +11271,7 @@
c2be74f0 1404 @end smallexample
a839fc2f
JB
1405
1406
1407-@node pathchk invocation
1408+@node pathchk
1409 @section @command{pathchk}: Check file name portability
1410
1411 @pindex pathchk
3c350007 1412@@ -11379,14 +11359,14 @@
a839fc2f
JB
1413 so forth. See also the user-related commands in the next section.
1414
1415 @menu
1416-* pwd invocation:: Print working directory.
1417-* stty invocation:: Print or change terminal characteristics.
1418-* printenv invocation:: Print environment variables.
1419-* tty invocation:: Print file name of terminal on standard input.
1420+* pwd:: Print working directory.
1421+* stty:: Print or change terminal characteristics.
1422+* printenv:: Print environment variables.
1423+* tty:: Print file name of terminal on standard input.
1424 @end menu
1425
1426
1427-@node pwd invocation
1428+@node pwd
1429 @section @command{pwd}: Print working directory
1430
1431 @pindex pwd
3c350007 1432@@ -11411,7 +11391,7 @@
876a8767 1433 @exitstatus
a839fc2f
JB
1434
1435
1436-@node stty invocation
1437+@node stty
1438 @section @command{stty}: Print or change terminal characteristics
1439
1440 @pindex stty
3c350007 1441@@ -12070,7 +12050,7 @@
a839fc2f
JB
1442 @end table
1443
1444
1445-@node printenv invocation
1446+@node printenv
1447 @section @command{printenv}: Print all or some environment variables
1448
1449 @pindex printenv
3c350007 1450@@ -12100,7 +12080,7 @@
a839fc2f
JB
1451 @end display
1452
1453
1454-@node tty invocation
1455+@node tty
1456 @section @command{tty}: Print file name of terminal on standard input
1457
1458 @pindex tty
3c350007 1459@@ -12150,16 +12130,16 @@
a839fc2f
JB
1460 logins, groups, and so forth.
1461
1462 @menu
c2be74f0 1463-* id invocation:: Print user identity.
a839fc2f 1464-* logname invocation:: Print current login name.
c2be74f0 1465-* whoami invocation:: Print effective user ID.
a839fc2f
JB
1466-* groups invocation:: Print group names a user is in.
1467-* users invocation:: Print login names of users currently logged in.
1468-* who invocation:: Print who is currently logged in.
c2be74f0 1469+* id:: Print user identity.
a839fc2f 1470+* logname:: Print current login name.
c2be74f0 1471+* whoami:: Print effective user ID.
fc53c102 1472+* groups:: Print group names a user is in.
a839fc2f
JB
1473+* users:: Print login names of users currently logged in.
1474+* who:: Print who is currently logged in.
1475 @end menu
1476
1477
1478-@node id invocation
1479+@node id
c2be74f0 1480 @section @command{id}: Print user identity
a839fc2f
JB
1481
1482 @pindex id
3c350007 1483@@ -12222,7 +12202,7 @@
876a8767 1484 @exitstatus
a839fc2f
JB
1485
1486
1487-@node logname invocation
1488+@node logname
1489 @section @command{logname}: Print current login name
1490
1491 @pindex logname
3c350007 1492@@ -12243,7 +12223,7 @@
876a8767 1493 @exitstatus
a839fc2f
JB
1494
1495
1496-@node whoami invocation
1497+@node whoami
c2be74f0 1498 @section @command{whoami}: Print effective user ID
a839fc2f
JB
1499
1500 @pindex whoami
3c350007 1501@@ -12259,7 +12239,7 @@
876a8767 1502 @exitstatus
a839fc2f
JB
1503
1504
1505-@node groups invocation
fc53c102
JB
1506+@node groups
1507 @section @command{groups}: Print group names a user is in
1508
1509 @pindex groups
3c350007 1510@@ -12284,7 +12264,7 @@
876a8767 1511 @exitstatus
fc53c102
JB
1512
1513
a839fc2f
JB
1514-@node users invocation
1515+@node users
1516 @section @command{users}: Print login names of users currently logged in
1517
1518 @pindex users
3c350007 1519@@ -12315,7 +12295,7 @@
876a8767 1520 @exitstatus
a839fc2f
JB
1521
1522
1523-@node who invocation
1524+@node who
1525 @section @command{who}: Print who is currently logged in
1526
1527 @pindex who
3c350007 1528@@ -12462,15 +12442,14 @@
a839fc2f
JB
1529 information.
1530
1531 @menu
3c350007 1532-* arch invocation:: Print machine hardware name.
a839fc2f
JB
1533-* date invocation:: Print or set system date and time.
1534-* uname invocation:: Print system information.
1535-* hostname invocation:: Print or set system name.
1536-* hostid invocation:: Print numeric host identifier.
3c350007 1537+* arch:: Print machine hardware name.
a839fc2f
JB
1538+* date:: Print or set system date and time.
1539+* uname:: Print system information.
1540+* hostid:: Print numeric host identifier.
1541 @end menu
1542
1543
1544-@node date invocation
1545+@node date
1546 @section @command{date}: Print or set system date and time
1547
1548 @pindex date
3c350007 1549@@ -13098,7 +13077,7 @@
a839fc2f
JB
1550 @end itemize
1551
1552
3c350007
JB
1553-@node arch invocation
1554+@node arch
1555 @section @command{arch}: Print machine hardware name
1556
1557 @pindex arch
1558@@ -13118,7 +13097,7 @@
1559 @exitstatus
1560
1561
a839fc2f
JB
1562-@node uname invocation
1563+@node uname
1564 @section @command{uname}: Print system information
1565
1566 @pindex uname
3c350007 1567@@ -13247,31 +13226,7 @@
876a8767 1568 @exitstatus
a839fc2f 1569
a839fc2f
JB
1570
1571-@node hostname invocation
1572-@section @command{hostname}: Print or set system name
1573-
1574-@pindex hostname
1575-@cindex setting the hostname
1576-@cindex printing the hostname
1577-@cindex system name, printing
1578-@cindex appropriate privileges
1579-
1580-With no arguments, @command{hostname} prints the name of the current host
1581-system. With one argument, it sets the current host name to the
1582-specified string. You must have appropriate privileges to set the host
c2be74f0 1583-name. Synopsis:
a839fc2f
JB
1584-
1585-@example
1586-hostname [@var{name}]
1587-@end example
1588-
1589-The only options are @option{--help} and @option{--version}. @xref{Common
1590-options}.
1591-
876a8767
JB
1592-@exitstatus
1593-
a839fc2f
JB
1594-
1595-@node hostid invocation
1596+@node hostid
1597 @section @command{hostid}: Print numeric host identifier.
1598
1599 @pindex hostid
3c350007 1600@@ -13308,15 +13263,15 @@
a839fc2f
JB
1601 user, etc.
1602
1603 @menu
1604-* chroot invocation:: Modify the root directory.
1605-* env invocation:: Modify environment variables.
c2be74f0 1606-* nice invocation:: Modify niceness.
a839fc2f 1607-* nohup invocation:: Immunize to hangups.
c2be74f0 1608-* su invocation:: Modify user and group ID.
a839fc2f
JB
1609+* chroot:: Modify the root directory.
1610+* env:: Modify environment variables.
c2be74f0 1611+* nice:: Modify niceness.
a839fc2f 1612+* nohup:: Immunize to hangups.
c2be74f0 1613+* su:: Modify user and group ID.
a839fc2f
JB
1614 @end menu
1615
1616
1617-@node chroot invocation
1618+@node chroot
1619 @section @command{chroot}: Run a command with a different root directory
1620
1621 @pindex chroot
3c350007 1622@@ -13387,7 +13342,7 @@
876a8767 1623 @end display
a839fc2f
JB
1624
1625
1626-@node env invocation
1627+@node env
1628 @section @command{env}: Run a command in a modified environment
1629
1630 @pindex env
3c350007 1631@@ -13465,7 +13420,7 @@
876a8767 1632 @end display
a839fc2f
JB
1633
1634
1635-@node nice invocation
1636+@node nice
c2be74f0 1637 @section @command{nice}: Run a command with modified niceness
a839fc2f
JB
1638
1639 @pindex nice
3c350007 1640@@ -13590,7 +13545,7 @@
876a8767 1641 @end example
a839fc2f
JB
1642
1643
1644-@node nohup invocation
1645+@node nohup
1646 @section @command{nohup}: Run a command immune to hangups
1647
1648 @pindex nohup
3c350007 1649@@ -13659,7 +13614,7 @@
a839fc2f
JB
1650 @end display
1651
1652
1653-@node su invocation
1654+@node su
c2be74f0 1655 @section @command{su}: Run a command with substitute user and group ID
a839fc2f
JB
1656
1657 @pindex su
3c350007 1658@@ -13816,167 +13771,6 @@
fbb5b105 1659 might find this idea strange at first.
a839fc2f
JB
1660
1661
1662-@node Process control
1663-@chapter Process control
1664-
1665-@cindex processes, commands for controlling
1666-@cindex commands for controlling processes
1667-
1668-@menu
1669-* kill invocation:: Sending a signal to processes.
1670-@end menu
1671-
1672-
1673-@node kill invocation
1674-@section @command{kill}: Send a signal to processes
1675-
1676-@pindex kill
1677-@cindex send a signal to processes
1678-
1679-The @command{kill} command sends a signal to processes, causing them
1680-to terminate or otherwise act upon receiving the signal in some way.
1681-Alternatively, it lists information about signals. Synopses:
1682-
1683-@example
1684-kill [-s @var{signal} | --signal @var{signal} | -@var{signal}] @var{pid}@dots{}
1685-kill [-l | --list | -t | --table] [@var{signal}]@dots{}
1686-@end example
1687-
1688-The first form of the @command{kill} command sends a signal to all
1689-@var{pid} arguments. The default signal to send if none is specified
1690-is @samp{TERM}. The special signal number @samp{0} does not denote a
1691-valid signal, but can be used to test whether the @var{pid} arguments
1692-specify processes to which a signal could be sent.
1693-
1694-If @var{pid} is positive, the signal is sent to the process with the
c2be74f0 1695-process ID @var{pid}. If @var{pid} is zero, the signal is sent to all
a839fc2f 1696-processes in the process group of the current process. If @var{pid}
c2be74f0
JB
1697-is @minus{}1, the signal is sent to all processes for which the user has
1698-permission to send a signal. If @var{pid} is less than @minus{}1, the signal
a839fc2f
JB
1699-is sent to all processes in the process group that equals the absolute
1700-value of @var{pid}.
1701-
1702-If @var{pid} is not positive, a system-dependent set of system
1703-processes is excluded from the list of processes to which the signal
1704-is sent.
1705-
c2be74f0
JB
1706-If a negative @var{PID} argument is desired as the first one, it
1707-should be preceded by @option{--}. However, as a common extension to
1708-@acronym{POSIX}, @option{--} is not required with @samp{kill
1709--@var{signal} -@var{pid}}. The following commands are equivalent:
a839fc2f
JB
1710-
1711-@example
1712-kill -15 -1
1713-kill -TERM -1
c2be74f0 1714-kill -s TERM -- -1
a839fc2f
JB
1715-kill -- -1
1716-@end example
1717-
1718-The first form of the @command{kill} command succeeds if every @var{pid}
1719-argument specifies at least one process that the signal was sent to.
1720-
1721-The second form of the @command{kill} command lists signal information.
1722-Either the @option{-l} or @option{--list} option, or the @option{-t}
1723-or @option{--table} option must be specified. Without any
1724-@var{signal} argument, all supported signals are listed. The output
1725-of @option{-l} or @option{--list} is a list of the signal names, one
1726-per line; if @var{signal} is already a name, the signal number is
1727-printed instead. The output of @option{-t} or @option{--table} is a
1728-table of signal numbers, names, and descriptions. This form of the
1729-@command{kill} command succeeds if all @var{signal} arguments are valid
1730-and if there is no output error.
1731-
1732-The @command{kill} command also supports the @option{--help} and
1733-@option{--version} options. @xref{Common options}.
1734-
1735-A @var{signal} may be a signal name like @samp{HUP}, or a signal
1736-number like @samp{1}, or an exit status of a process terminated by the
1737-signal. A signal name can be given in canonical form or prefixed by
1738-@samp{SIG}. The case of the letters is ignored, except for the
1739-@option{-@var{signal}} option which must use upper case to avoid
1740-ambiguity with lower case option letters. The following signal names
1741-and numbers are supported on all @acronym{POSIX} compliant systems:
1742-
1743-@table @samp
1744-@item HUP
1745-1. Hangup.
1746-@item INT
1747-2. Terminal interrupt.
1748-@item QUIT
1749-3. Terminal quit.
1750-@item ABRT
1751-6. Process abort.
1752-@item KILL
1753-9. Kill (cannot be caught or ignored).
1754-@item ALRM
1755-14. Alarm Clock.
1756-@item TERM
1757-15. Termination.
1758-@end table
1759-
1760-@noindent
1761-Other supported signal names have system-dependent corresponding
1762-numbers. All systems conforming to @acronym{POSIX} 1003.1-2001 also
1763-support the following signals:
1764-
1765-@table @samp
1766-@item BUS
1767-Access to an undefined portion of a memory object.
1768-@item CHLD
1769-Child process terminated, stopped, or continued.
1770-@item CONT
1771-Continue executing, if stopped.
1772-@item FPE
1773-Erroneous arithmetic operation.
1774-@item ILL
1775-Illegal Instruction.
1776-@item PIPE
1777-Write on a pipe with no one to read it.
1778-@item SEGV
1779-Invalid memory reference.
1780-@item STOP
1781-Stop executing (cannot be caught or ignored).
1782-@item TSTP
1783-Terminal stop.
1784-@item TTIN
1785-Background process attempting read.
1786-@item TTOU
1787-Background process attempting write.
1788-@item URG
1789-High bandwidth data is available at a socket.
1790-@item USR1
1791-User-defined signal 1.
1792-@item USR2
1793-User-defined signal 2.
1794-@end table
1795-
1796-@noindent
1797-@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XSI} extension
1798-also support the following signals:
1799-
1800-@table @samp
1801-@item POLL
1802-Pollable event.
1803-@item PROF
1804-Profiling timer expired.
1805-@item SYS
1806-Bad system call.
1807-@item TRAP
1808-Trace/breakpoint trap.
1809-@item VTALRM
1810-Virtual timer expired.
1811-@item XCPU
1812-CPU time limit exceeded.
1813-@item XFSZ
1814-File size limit exceeded.
1815-@end table
1816-
1817-@noindent
1818-@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XRT} extension
1819-also support at least eight real-time signals called @samp{RTMIN},
1820-@samp{RTMIN+1}, @dots{}, @samp{RTMAX-1}, @samp{RTMAX}.
1821-
1822-
1823 @node Delaying
1824 @chapter Delaying
1825
3c350007 1826@@ -13986,11 +13780,11 @@
fbb5b105 1827 @c Perhaps @command{wait} or other commands should be described here also?
a839fc2f
JB
1828
1829 @menu
1830-* sleep invocation:: Delay for a specified time.
1831+* sleep:: Delay for a specified time.
1832 @end menu
1833
1834
1835-@node sleep invocation
1836+@node sleep
1837 @section @command{sleep}: Delay for a specified time
1838
1839 @pindex sleep
3c350007 1840@@ -14038,12 +13832,12 @@
a839fc2f
JB
1841 These programs do numerically-related operations.
1842
1843 @menu
1844-* factor invocation:: Show factors of numbers.
1845-* seq invocation:: Print sequences of numbers.
1846+* factor:: Show factors of numbers.
1847+* seq:: Print sequences of numbers.
1848 @end menu
1849
1850
1851-@node factor invocation
1852+@node factor
1853 @section @command{factor}: Print prime factors
1854
1855 @pindex factor
3c350007 1856@@ -14092,7 +13886,7 @@
876a8767
JB
1857 @exitstatus
1858
a839fc2f
JB
1859
1860-@node seq invocation
1861+@node seq
1862 @section @command{seq}: Print numeric sequences
1863
1864 @pindex seq
This page took 0.253984 seconds and 4 git commands to generate.