itman: update man pages to say $HOME when accurate - plan9port - [fork] Plan 9 from user space Err mx1.adamsgaard.dk 70 hgit clone git://src.adamsgaard.dk/plan9port URL:git://src.adamsgaard.dk/plan9port mx1.adamsgaard.dk 70 1Log /src/plan9port/log.gph mx1.adamsgaard.dk 70 1Files /src/plan9port/files.gph mx1.adamsgaard.dk 70 1Refs /src/plan9port/refs.gph mx1.adamsgaard.dk 70 1README /src/plan9port/file/README.md.gph mx1.adamsgaard.dk 70 1LICENSE /src/plan9port/file/LICENSE.gph mx1.adamsgaard.dk 70 i--- Err mx1.adamsgaard.dk 70 1commit bfe4377e409ce271c479665e6ef966a7b6008626 /src/plan9port/commit/bfe4377e409ce271c479665e6ef966a7b6008626.gph mx1.adamsgaard.dk 70 1parent d25d0ca1a3682d97df67f62789767562aa5bf1b3 /src/plan9port/commit/d25d0ca1a3682d97df67f62789767562aa5bf1b3.gph mx1.adamsgaard.dk 70 hAuthor: Russ Cox URL:mailto:rsc@swtch.com mx1.adamsgaard.dk 70 iDate: Mon, 18 May 2020 23:51:35 -0400 Err mx1.adamsgaard.dk 70 i Err mx1.adamsgaard.dk 70 iman: update man pages to say $HOME when accurate Err mx1.adamsgaard.dk 70 i Err mx1.adamsgaard.dk 70 iFixes #386. Err mx1.adamsgaard.dk 70 i Err mx1.adamsgaard.dk 70 iDiffstat: Err mx1.adamsgaard.dk 70 i M man/man1/acid.1 | 30 +++++++++++++++--------------- Err mx1.adamsgaard.dk 70 i M man/man1/acme.1 | 8 ++++---- Err mx1.adamsgaard.dk 70 i M man/man1/rc.1 | 4 ++++ Err mx1.adamsgaard.dk 70 i M man/man1/sam.1 | 28 ++++++++++++++-------------- Err mx1.adamsgaard.dk 70 i Err mx1.adamsgaard.dk 70 i4 files changed, 37 insertions(+), 33 deletions(-) Err mx1.adamsgaard.dk 70 i--- Err mx1.adamsgaard.dk 70 1diff --git a/man/man1/acid.1 b/man/man1/acid.1 /src/plan9port/file/man/man1/acid.1.gph mx1.adamsgaard.dk 70 it@@ -48,7 +48,7 @@ is a programmable symbolic debugger. Err mx1.adamsgaard.dk 70 i It can inspect one or more processes that share an address space. Err mx1.adamsgaard.dk 70 i A program to be debugged may be specified by the process id of Err mx1.adamsgaard.dk 70 i a running or defunct process, Err mx1.adamsgaard.dk 70 i-or by the name of the program's text file Err mx1.adamsgaard.dk 70 i+or by the name of the program's text file Err mx1.adamsgaard.dk 70 i .RB ( a.out Err mx1.adamsgaard.dk 70 i by default). Err mx1.adamsgaard.dk 70 i At the prompt, Err mx1.adamsgaard.dk 70 it@@ -63,7 +63,7 @@ Allow the textfile to be modified. Err mx1.adamsgaard.dk 70 i Print variable renamings at startup. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .BI -l " library Err mx1.adamsgaard.dk 70 i-Load from Err mx1.adamsgaard.dk 70 i+Load from Err mx1.adamsgaard.dk 70 i .I library Err mx1.adamsgaard.dk 70 i at startup; see below. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -84,8 +84,8 @@ obtains standard function definitions from the library file Err mx1.adamsgaard.dk 70 i architecture-dependent functions from Err mx1.adamsgaard.dk 70 i .BR \*9/acid/$objtype , Err mx1.adamsgaard.dk 70 i user-specified functions from Err mx1.adamsgaard.dk 70 i-.BR $home/lib/acid , Err mx1.adamsgaard.dk 70 i-and further functions from Err mx1.adamsgaard.dk 70 i+.BR $HOME/lib/acid , Err mx1.adamsgaard.dk 70 i+and further functions from Err mx1.adamsgaard.dk 70 i .B -l Err mx1.adamsgaard.dk 70 i files. Err mx1.adamsgaard.dk 70 i Definitions in any file may override previously defined functions. Err mx1.adamsgaard.dk 70 it@@ -106,7 +106,7 @@ to create Err mx1.adamsgaard.dk 70 i .I acid Err mx1.adamsgaard.dk 70 i functions for examining data structures. Err mx1.adamsgaard.dk 70 i .SS Language Err mx1.adamsgaard.dk 70 i-Symbols of the program being debugged become integer Err mx1.adamsgaard.dk 70 i+Symbols of the program being debugged become integer Err mx1.adamsgaard.dk 70 i variables whose values are addresses. Err mx1.adamsgaard.dk 70 i Contents of addresses are obtained by indirection. Err mx1.adamsgaard.dk 70 i Local variables are qualified by Err mx1.adamsgaard.dk 70 it@@ -114,7 +114,7 @@ function name, for example Err mx1.adamsgaard.dk 70 i .BR main:argv . Err mx1.adamsgaard.dk 70 i When program symbols conflict with Err mx1.adamsgaard.dk 70 i .I acid Err mx1.adamsgaard.dk 70 i-words, distinguishing Err mx1.adamsgaard.dk 70 i+words, distinguishing Err mx1.adamsgaard.dk 70 i .B $ Err mx1.adamsgaard.dk 70 i signs are prefixed. Err mx1.adamsgaard.dk 70 i Such renamings are reported at startup; option Err mx1.adamsgaard.dk 70 it@@ -127,7 +127,7 @@ and formats are inferred from assignments. Err mx1.adamsgaard.dk 70 i Truth values false/true are attributed to zero/nonzero Err mx1.adamsgaard.dk 70 i integers or floats and to empty/nonempty lists or strings. Err mx1.adamsgaard.dk 70 i Lists are sequences of expressions surrounded by Err mx1.adamsgaard.dk 70 i-.BR {\^} Err mx1.adamsgaard.dk 70 i+.BR {\^} Err mx1.adamsgaard.dk 70 i and separated by commas. Err mx1.adamsgaard.dk 70 i .PP Err mx1.adamsgaard.dk 70 i Expressions are much as in C, Err mx1.adamsgaard.dk 70 it@@ -219,7 +219,7 @@ Same as Err mx1.adamsgaard.dk 70 i .BR spr();gpr() . Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .BI fmt( expr , format ) Err mx1.adamsgaard.dk 70 i-Expression Err mx1.adamsgaard.dk 70 i+Expression Err mx1.adamsgaard.dk 70 i .I expr Err mx1.adamsgaard.dk 70 i with format given by the character value of expression Err mx1.adamsgaard.dk 70 i .IR format . Err mx1.adamsgaard.dk 70 it@@ -243,7 +243,7 @@ List current source directories. Err mx1.adamsgaard.dk 70 i Add a source directory to the list. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .BI filepc( where ) Err mx1.adamsgaard.dk 70 i-Convert a string of the form Err mx1.adamsgaard.dk 70 i+Convert a string of the form Err mx1.adamsgaard.dk 70 i .IB sourcefile : linenumber Err mx1.adamsgaard.dk 70 i to a machine address. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -288,7 +288,7 @@ interpreted according to a string of format codes. Err mx1.adamsgaard.dk 70 i .BI dump( address , n , string\fP) Err mx1.adamsgaard.dk 70 i Like Err mx1.adamsgaard.dk 70 i .BR mem (), Err mx1.adamsgaard.dk 70 i-repeated for Err mx1.adamsgaard.dk 70 i+repeated for Err mx1.adamsgaard.dk 70 i .I n Err mx1.adamsgaard.dk 70 i consecutive blocks. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -300,7 +300,7 @@ Start a new process with arguments given as a string Err mx1.adamsgaard.dk 70 i and halt at the first instruction. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .B new() Err mx1.adamsgaard.dk 70 i-Like Err mx1.adamsgaard.dk 70 i+Like Err mx1.adamsgaard.dk 70 i .IR newproc (), Err mx1.adamsgaard.dk 70 i but take arguments (except Err mx1.adamsgaard.dk 70 i .BR argv[0] ) Err mx1.adamsgaard.dk 70 it@@ -308,7 +308,7 @@ from string variable Err mx1.adamsgaard.dk 70 i .BR progargs . Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .B win() Err mx1.adamsgaard.dk 70 i-Like Err mx1.adamsgaard.dk 70 i+Like Err mx1.adamsgaard.dk 70 i .IR new (), Err mx1.adamsgaard.dk 70 i but run the process in a separate window. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -337,7 +337,7 @@ When a pid or core file is specified on the command line, Err mx1.adamsgaard.dk 70 i .I acid Err mx1.adamsgaard.dk 70 i will, as part of its startup, determine the set of shared libraries Err mx1.adamsgaard.dk 70 i in use by the process image and map those at appropriate locations. Err mx1.adamsgaard.dk 70 i-If Err mx1.adamsgaard.dk 70 i+If Err mx1.adamsgaard.dk 70 i .I acid Err mx1.adamsgaard.dk 70 i is started without a pid or core file Err mx1.adamsgaard.dk 70 i and is subsequently attached to a process via Err mx1.adamsgaard.dk 70 it@@ -414,7 +414,7 @@ acid: *argv0 Err mx1.adamsgaard.dk 70 i acid: bpset(ls) Err mx1.adamsgaard.dk 70 i acid: cont() Err mx1.adamsgaard.dk 70 i 70094: breakpoint ls ADD $-0x16c8,R29 Err mx1.adamsgaard.dk 70 i-acid: Err mx1.adamsgaard.dk 70 i+acid: Err mx1.adamsgaard.dk 70 i .EE Err mx1.adamsgaard.dk 70 i .PP Err mx1.adamsgaard.dk 70 i Display elements of a linked list of structures: Err mx1.adamsgaard.dk 70 it@@ -499,7 +499,7 @@ acid: cont() Err mx1.adamsgaard.dk 70 i .br Err mx1.adamsgaard.dk 70 i .B \*9/acid/truss Err mx1.adamsgaard.dk 70 i .br Err mx1.adamsgaard.dk 70 i-.B $home/lib/acid Err mx1.adamsgaard.dk 70 i+.B $HOME/lib/acid Err mx1.adamsgaard.dk 70 i .SH SOURCE Err mx1.adamsgaard.dk 70 i .B \*9/src/cmd/acid Err mx1.adamsgaard.dk 70 i .SH "SEE ALSO" Err mx1.adamsgaard.dk 70 1diff --git a/man/man1/acme.1 b/man/man1/acme.1 /src/plan9port/file/man/man1/acme.1.gph mx1.adamsgaard.dk 70 it@@ -300,7 +300,7 @@ Delete window without checking for dirtiness. Err mx1.adamsgaard.dk 70 i Write the state of Err mx1.adamsgaard.dk 70 i .I acme Err mx1.adamsgaard.dk 70 i to the file name, if specified, or Err mx1.adamsgaard.dk 70 i-.B $home/acme.dump Err mx1.adamsgaard.dk 70 i+.B $HOME/acme.dump Err mx1.adamsgaard.dk 70 i by default. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .B Edit Err mx1.adamsgaard.dk 70 it@@ -403,7 +403,7 @@ commands named as arguments. Err mx1.adamsgaard.dk 70 i Restore the state of Err mx1.adamsgaard.dk 70 i .I acme Err mx1.adamsgaard.dk 70 i from a file (default Err mx1.adamsgaard.dk 70 i-.BR $home/acme.dump ) Err mx1.adamsgaard.dk 70 i+.BR $HOME/acme.dump ) Err mx1.adamsgaard.dk 70 i created by the Err mx1.adamsgaard.dk 70 i .B Dump Err mx1.adamsgaard.dk 70 i command. Err mx1.adamsgaard.dk 70 it@@ -745,9 +745,9 @@ and Err mx1.adamsgaard.dk 70 i .I awd Err mx1.adamsgaard.dk 70 i reside. Err mx1.adamsgaard.dk 70 i .SH FILES Err mx1.adamsgaard.dk 70 i-.TF $home/acme.dump Err mx1.adamsgaard.dk 70 i+.TF $HOME/acme.dump Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i-.B $home/acme.dump Err mx1.adamsgaard.dk 70 i+.B $HOME/acme.dump Err mx1.adamsgaard.dk 70 i default file for Err mx1.adamsgaard.dk 70 i .B Dump Err mx1.adamsgaard.dk 70 i and Err mx1.adamsgaard.dk 70 1diff --git a/man/man1/rc.1 b/man/man1/rc.1 /src/plan9port/file/man/man1/rc.1.gph mx1.adamsgaard.dk 70 it@@ -806,6 +806,10 @@ is set to its process id. Err mx1.adamsgaard.dk 70 i .B $home Err mx1.adamsgaard.dk 70 i The default directory for Err mx1.adamsgaard.dk 70 i .BR cd . Err mx1.adamsgaard.dk 70 i+Defaults to Err mx1.adamsgaard.dk 70 i+.B $HOME Err mx1.adamsgaard.dk 70 i+or else Err mx1.adamsgaard.dk 70 i+.LR / . Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .B $ifs Err mx1.adamsgaard.dk 70 i The input field separators used in backquote substitutions. Err mx1.adamsgaard.dk 70 1diff --git a/man/man1/sam.1 b/man/man1/sam.1 /src/plan9port/file/man/man1/sam.1.gph mx1.adamsgaard.dk 70 it@@ -1,7 +1,7 @@ Err mx1.adamsgaard.dk 70 i .TH SAM 1 Err mx1.adamsgaard.dk 70 i .ds a \fR*\ \fP Err mx1.adamsgaard.dk 70 i .SH NAME Err mx1.adamsgaard.dk 70 i-sam, B, E, sam.save, samterm, samsave \- screen editor with structural regular expressions Err mx1.adamsgaard.dk 70 i+sam, B, E, sam.save, samterm, samsave \- screen editor with structural regular expressions Err mx1.adamsgaard.dk 70 i .SH SYNOPSIS Err mx1.adamsgaard.dk 70 i .B sam Err mx1.adamsgaard.dk 70 i [ Err mx1.adamsgaard.dk 70 it@@ -43,7 +43,7 @@ The options are Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .B -a Err mx1.adamsgaard.dk 70 i Autoindent. In this mode, when a newline character is typed Err mx1.adamsgaard.dk 70 i-in the terminal interface, Err mx1.adamsgaard.dk 70 i+in the terminal interface, Err mx1.adamsgaard.dk 70 i .I samterm Err mx1.adamsgaard.dk 70 i copies leading white space on the current line to the new line. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -121,7 +121,7 @@ is the beginning of the file. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 i .BI ? regexp ? Err mx1.adamsgaard.dk 70 i The substring that matches the regular expression, Err mx1.adamsgaard.dk 70 i-found by looking toward the end Err mx1.adamsgaard.dk 70 i+found by looking toward the end Err mx1.adamsgaard.dk 70 i .RB ( / ) Err mx1.adamsgaard.dk 70 i or beginning Err mx1.adamsgaard.dk 70 i .RB ( ? ) Err mx1.adamsgaard.dk 70 it@@ -248,7 +248,7 @@ or Err mx1.adamsgaard.dk 70 i is reversed. Err mx1.adamsgaard.dk 70 i .PP Err mx1.adamsgaard.dk 70 i It is an error for a compound address to represent a malformed substring. Err mx1.adamsgaard.dk 70 i-Some useful idioms: Err mx1.adamsgaard.dk 70 i+Some useful idioms: Err mx1.adamsgaard.dk 70 i .IB a1 +- Err mx1.adamsgaard.dk 70 i \%(\f2a1\fB-+\f1) Err mx1.adamsgaard.dk 70 i selects the line containing Err mx1.adamsgaard.dk 70 it@@ -258,7 +258,7 @@ locates the first match of the expression in the file. Err mx1.adamsgaard.dk 70 i (The form Err mx1.adamsgaard.dk 70 i .B 0;// Err mx1.adamsgaard.dk 70 i sets dot unnecessarily.) Err mx1.adamsgaard.dk 70 i-.BI ./ regexp /// Err mx1.adamsgaard.dk 70 i+.BI ./ regexp /// Err mx1.adamsgaard.dk 70 i finds the second following occurrence of the expression, Err mx1.adamsgaard.dk 70 i and Err mx1.adamsgaard.dk 70 i .BI .,/ regexp / Err mx1.adamsgaard.dk 70 it@@ -276,7 +276,7 @@ newline may not appear literally; Err mx1.adamsgaard.dk 70 i .B \en Err mx1.adamsgaard.dk 70 i may be typed for newline; and Err mx1.adamsgaard.dk 70 i .B \e/ Err mx1.adamsgaard.dk 70 i-quotes the delimiter, here Err mx1.adamsgaard.dk 70 i+quotes the delimiter, here Err mx1.adamsgaard.dk 70 i .LR / . Err mx1.adamsgaard.dk 70 i Backslash is otherwise interpreted literally, except in Err mx1.adamsgaard.dk 70 i .B s Err mx1.adamsgaard.dk 70 it@@ -284,7 +284,7 @@ commands. Err mx1.adamsgaard.dk 70 i .PP Err mx1.adamsgaard.dk 70 i Most commands may be prefixed by an address to indicate their range Err mx1.adamsgaard.dk 70 i of operation. Err mx1.adamsgaard.dk 70 i-Those that may not are marked with a Err mx1.adamsgaard.dk 70 i+Those that may not are marked with a Err mx1.adamsgaard.dk 70 i .L * Err mx1.adamsgaard.dk 70 i below. Err mx1.adamsgaard.dk 70 i If a command takes Err mx1.adamsgaard.dk 70 it@@ -347,12 +347,12 @@ Substitute Err mx1.adamsgaard.dk 70 i .I text Err mx1.adamsgaard.dk 70 i for the first match to the regular expression in the range. Err mx1.adamsgaard.dk 70 i Set dot to the modified range. Err mx1.adamsgaard.dk 70 i-In Err mx1.adamsgaard.dk 70 i+In Err mx1.adamsgaard.dk 70 i .I text Err mx1.adamsgaard.dk 70 i the character Err mx1.adamsgaard.dk 70 i .B & Err mx1.adamsgaard.dk 70 i stands for the string Err mx1.adamsgaard.dk 70 i-that matched the expression. Err mx1.adamsgaard.dk 70 i+that matched the expression. Err mx1.adamsgaard.dk 70 i Backslash behaves as usual unless followed by Err mx1.adamsgaard.dk 70 i a digit: Err mx1.adamsgaard.dk 70 i .BI \e d Err mx1.adamsgaard.dk 70 it@@ -500,7 +500,7 @@ Plan 9 command. Err mx1.adamsgaard.dk 70 i .BI \*acd " directory Err mx1.adamsgaard.dk 70 i Change working directory. Err mx1.adamsgaard.dk 70 i If no directory is specified, Err mx1.adamsgaard.dk 70 i-.B $home Err mx1.adamsgaard.dk 70 i+.B $HOME Err mx1.adamsgaard.dk 70 i is used. Err mx1.adamsgaard.dk 70 i .PD Err mx1.adamsgaard.dk 70 i .PP Err mx1.adamsgaard.dk 70 it@@ -543,7 +543,7 @@ For each match of the regular expression in the range, run the command Err mx1.adamsgaard.dk 70 i with dot set to the match. Err mx1.adamsgaard.dk 70 i Set dot to the last match. Err mx1.adamsgaard.dk 70 i If the regular Err mx1.adamsgaard.dk 70 i-expression and its slashes are omitted, Err mx1.adamsgaard.dk 70 i+expression and its slashes are omitted, Err mx1.adamsgaard.dk 70 i .L /.*\en/ Err mx1.adamsgaard.dk 70 i is assumed. Err mx1.adamsgaard.dk 70 i Null string matches potentially occur before every character Err mx1.adamsgaard.dk 70 it@@ -652,7 +652,7 @@ If no address is specified (the Err mx1.adamsgaard.dk 70 i command is a newline) dot is extended in either direction to Err mx1.adamsgaard.dk 70 i line boundaries and printed. Err mx1.adamsgaard.dk 70 i If dot is thereby unchanged, it is set to Err mx1.adamsgaard.dk 70 i-.B .+1 Err mx1.adamsgaard.dk 70 i+.B .+1 Err mx1.adamsgaard.dk 70 i and printed. Err mx1.adamsgaard.dk 70 i .PD Err mx1.adamsgaard.dk 70 i .SS Grouping and multiple changes Err mx1.adamsgaard.dk 70 it@@ -713,7 +713,7 @@ of a rectangle. Err mx1.adamsgaard.dk 70 i from the command window or the whole screen, depending on Err mx1.adamsgaard.dk 70 i where the null rectangle is. Err mx1.adamsgaard.dk 70 i .TF resize Err mx1.adamsgaard.dk 70 i-.TP Err mx1.adamsgaard.dk 70 i+.TP Err mx1.adamsgaard.dk 70 i .B new Err mx1.adamsgaard.dk 70 i Create a new, empty file. Err mx1.adamsgaard.dk 70 i .TP Err mx1.adamsgaard.dk 70 it@@ -819,7 +819,7 @@ typed in a command. Err mx1.adamsgaard.dk 70 i Send the text in dot, or the snarf buffer if Err mx1.adamsgaard.dk 70 i dot is the null string, as if it were typed to the command window. Err mx1.adamsgaard.dk 70 i Saves the sent text in the snarf buffer. Err mx1.adamsgaard.dk 70 i-(Command window only.) Err mx1.adamsgaard.dk 70 i+(Command window only.) Err mx1.adamsgaard.dk 70 i .PD Err mx1.adamsgaard.dk 70 i .SS Simulated buttons Err mx1.adamsgaard.dk 70 i For systems without a three-button mouse, the keyboard modifier Err mx1.adamsgaard.dk 70 .