doc.sh

操作系统源代码

X.\"
X.de Cm
X.if "\\$1"0" \t\\$2\t\\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
X.if "\\$1"1" \s-2[line]\s+2\t\\$2\t\\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
X.if "\\$1"2" \s-2[line][,line]\s+2\t\\$2\t\\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
X..
X.if t .ds Q ``
X.if t .ds U ''
X.if n .ds Q "
X.if n .ds U "
X\s+2LINES	COMMAND	ARGUMENTS\s-2
X.Cm 0 ab[br] [short] [expanded form]
X.Cm 1 a[ppend][!]
X.Cm 0 ar[gs] [files]
X.Cm 0 cc [files]
X.Cm 0 cd[!] [directory]
X.Cm 2 c[hange]
X.Cm 0 chd[ir][!] [directory]
X.Cm 2 co[py] line
X.Cm 0 col[or] [when] [[\*Qlight\*U] color] [\*Qon\*U color]
X.Cm 2 d[elete] [\*Ux]
X.Cm 0 dig[raph][!] [XX [Y]]
X.Cm 0 e[dit][!] [file]
X.Cm 0 er[rlist][!] [errlist]
X.Cm 0 f[ile] [file]
X.Cm 2 g[lobal] /regexp/ command
X.Cm 1 i[nsert]
X.Cm 2 j[oin][!]
X.Cm 2 l[ist]
X.Cm 0 mak[e] [target]
X.Cm 0 map[!] key mapped_to
X.Cm 1 ma[rk]  \*Ux
X.Cm 0 mk[exrc]
X.Cm 2 m[ove] line
X.Cm 0 n[ext][!] [files]
X.Cm 0 N[ext][!]
X.Cm 2 nu[mber]
X.Cm 2 p[rint]
X.Cm 1 pu[t] [\*Ux]
X.Cm 0 q[uit][!]
X.Cm 1 r[ead] file
X.Cm 0 rew[ind][!]
X.Cm 0 se[t] [options]
X.Cm 0 so[urce] file
X.Cm 2 s[ubstitute] /regexp/replacement/[p][g][c]
X.Cm 0 ta[g][!] tagname
X.Cm 0 una[bbr] [short]
X.Cm 0 u[ndo]
X.Cm 0 unm[ap][!] key
X.Cm 0 ve[rsion]
X.Cm 2 v[global] /regexp/ command
X.Cm 0 vi[sual] [filename]
X.Cm 0 wq 
X.Cm 2 w[rite][!] [[>>]file]
X.Cm 0 x[it][!]
X.Cm 2 y[ank] [\*Ux]
X.Cm 2 ! command
X.Cm 2 < 
X.Cm 2 = 
X.Cm 2 > 
X.Cm 2 & 
X.Cm 0 @ "" \*Ux
X.DE
X.TA
X.PP
XTo use colon mode commands, you must switch from visual command
Xmode to colon command mode.
XThe visual mode commands to do this are ":" for a single colon command,
Xor "Q" for many colon mode commands.
X.NH 2
XLine Specifiers
X.PP
XLine specifiers are always optional.
XThe first line specifier of most commands usually defaults to the current line.
XThe second line specifier usually defaults to be the same
Xas the first line specifier.
XExceptions are :write, :global, and :vglobal, which act on all lines of the
Xfile by default, and :!, which acts on no lines by default.
X.PP
XLine specifiers consist of an absolute part and a relative part.
XThe absolute part of a line specifier may be either an explicit line number,
Xa mark, a dot to denote the current line, a dollar sign to denote the last
Xline of the file, or a forward or backward search.
X.PP
XAn explicit line number is simply a decimal number, expressed as a
Xstring of digits.
X.PP
XA mark is typed in as an apostrophe followed by a letter.
XMarks must be set before they can be used.
XYou can set a mark in visual command mode by typing "m" and a letter,
Xor you can set it in colon command mode via the "mark" command.
X.PP
XA forward search is typed in as a regular expression surrounded by
Xslash characters; searching begins at the default line.
XA backward search is typed in as a regular expression surrounded by
Xquestion marks; searching begins at the line before the default line.
X.PP
XIf you omit the absolute part, then the default line is used.
X.PP
XThe relative part of a line specifier is typed as a "+" or "-" character
Xfollowed by a decimal number.
XThe number is added to or subtracted from the absolute part
Xof the line specifier to produce the final line number.
X.PP
XAs a special case, the % character may be used to specify all lines of the file.
XIt is roughly equivelent to saying 1,$.
XThis can be a handy shortcut.
X.PP
XSome examples:
X.LD
X.ps
X.ta 0.5i 1.8i
X	:p	print the current line
X	:37p	print line 37
X	:'gp	print the line which contains mark g
X	:/foo/p	print the next line that contains "foo"
X	:$p	print the last line of the file
X	:20,30p	print lines 20 through 30
X	:1,$p	print all lines of the file
X	:%p	print all lines of the file
X	:/foo/-2,+4p	print 5 lines around the next "foo"
X.TA
X.DE
X.NH 2
XText Entry Commands
X.if n .ul 0
X.ID
X.ps
X[line] append
X[line][,line] change ["x]
X[line] insert
X.DE
X.PP
XThe \fBa\fRppend command inserts text after the specified line.
X.PP
XThe \fBi\fRnsert command inserts text before the specified line.
X.PP
XThe \fBc\fRhange command copies the range of lines into a cut buffer,
Xdeletes them, and inserts new text where the old text used to be.
X.PP
XFor all of these commands, you indicate the end of the text you're
Xinserting by hitting ^D or by entering a line which contains only a
Xperiod.
X.NH 2
XCut & Paste Commands
X.if n .ul 0
X.ID
X.ps
X[line][,line] delete ["x]
X[line][,line] yank ["x]
X[line] put ["x]
X[line][,line] copy line
X[line][,line] to line
X[line][,line] move line
X.DE
X.PP
XThe \fBd\fRelete command copies the specified range of lines into a
Xcut buffer, and then deletes them.
X.PP
XThe \fBy\fRank command copies the specified range of lines into a cut
Xbuffer, but does *not* delete them.
X.PP
XThe \fBpu\fRt command inserts text from a cut buffer after the
Xspecified line.
X.PP
XThe \fBco\fRpy and \fBt\fRo commands yank the specified range of lines and
Xthen immediately paste them after some other line.
X.PP
XThe \fBm\fRove command deletes the specified range of lines and then
Ximmediately pastes them after some other line.
XIf the destination line comes after the deleted text,
Xthen it will be adjusted automatically to account for the deleted lines.
X.NH 2
XDisplay Text Commands
X.if n .ul 0
X.ID
X.ps
X[line][,line] print
X[line][,line] list
X[line][,line] number
X.DE
X.PP
XThe \fBp\fRrint command displays the specified range of lines.
X.PP
XThe \fBnu\fRmber command displays the lines, with line numbers.
X.PP
XThe \fBl\fRist command also displays them, but it is careful to make
Xcontrol characters visible.
X.NH 2
XGlobal Operations Commands
X.if n .ul 0
X.ID
X.ps
X[line][,line] global /regexp/ command
X[line][,line] vglobal /regexp/ command
X.DE
X.PP
XThe \fBg\fRlobal command searches through the lines of the specified range
X(or through the whole file if no range is specified)
Xfor lines that contain a given regular expression.
XIt then moves the cursor to each of these lines and
Xruns some other command on them.
X.PP
XThe \fBv\fRglobal command is similar, but it searches for lines that \fIdon't\fR
Xcontain the regular expression.
X.NH 2
XLine Editing Commands
X.if n .ul 0
X.ID
X.ps
X[line][,line] join[!]
X[line][,line] ! program
X[line][,line] <
X[line][,line] >
X[line][,line] substitute /regexp/replacement/[p][g][c]
X[line][,line] &
X.DE
X.PP
XThe \fBj\fRoin command catenates all lines in the specified range together
Xto form one big line.
XIf only a single line is specified, then the following line is catenated
Xonto it.
XThe normal ":join" inserts one or two spaces between the lines;
Xthe ":join!" variation (with a '!') doesn't insert spaces.
X.PP
XThe \fB!\fR command runs an external filter program,
Xand feeds the specified range of lines to it's stdin.
XThe lines are then replaced by the output of the filter.
XA typical example would be ":'a,'z!sort" to sort the lines 'a,'z.
X.PP
XThe \fB<\fR and \fB>\fR commands shift the specified range of lines left or right,
Xnormally by the width of 1 tab character.
XThe "shiftwidth" option determines the shifting amount.
X.PP
XThe \fBs\fRubstitute command finds the regular expression in each line,
Xand replaces it with the replacement text.
XThe "p" option causes the altered lines to be printed.
XThe "g" option permits all instances of the regular expression
Xto be found & replaced.
X(Without "g", only the first occurrence in each line is replaced.)
XThe "c" option asks for confirmation before each substitution.
X.PP
XThe \fB&\fR command repeats the previous substitution command.
XActually, "&" is equivelent to "s//~/" with the same options as last time.
XIt searches for the last regular expression that you specified for any purpose,
Xand replaces it with the the same text
Xthat was used in the previous substitution.
X.NH 2
XUndo Command
X.if n .ul 0
X.ID
X.ps
Xundo
X.DE
X.PP
XThe \fBu\fRndo command restores the file to the state it was in before
Xyour most recent command which changed text.
X.NH 2
XConfiguration & Status Commands
X.if n .ul 0
X.ID
X.ps
Xmap[!] [key mapped_to]
Xunmap[!] key
Xabbr [word expanded_form_of_word]
Xunabbr word
Xdigraph[!] [XX [Y]]
Xset [options]
Xmkexrc
X[line] mark "x
Xvisual
Xversion
X[line][,line] =
Xfile [file]
Xsource file
X@ "x
Xcolor [when] [["light"] color] ["on" color]
X.DE
X.PP
XThe \fBma\fRp command allows you to configure \*E to recognize your function keys,
Xand treat them as though they transmitted some other sequence of characters.
XNormally this mapping is done only when in the visual command mode,
Xbut with the [!] present it will map keys under input and replace modes as well.
XWhen this command is given with no arguments,
Xit prints a table showing all mappings currently in effect.
XWhen called with two arguments, the first is the sequence that your
Xfunction key really sends, and the second is the sequence that you want
X\*E to treat it as having sent.
XAs a special case, if the first argument is a number then \*E will map the
Xcorresponding function key;
Xfor example, ":map 7 dd" will cause the <F7> key to delete a line.
X.PP
XThe \fBunm\fRap command removes key definitions that were made via the map command.
X.PP
XThe \fBab\fRbr command is used to define/list a table of abbreviations.
XThe table contains both the abbreviated form and the fully spelled-out form.
XWhen you're in visual input mode, and you type in the abbreviated form,
X\*E will replace the abbreviated form with the fully spelled-out form.
XWhen this command is called without arguments, it lists the table;
Xwith two or more arguments, the first argument is taken as the abbreviated
Xform, and the rest of the command line is the fully-spelled out form.
X.PP
XThe \fBuna\fRbbr command deletes entries from the abbr table.
X.PP
XThe \fBdi\fRgraph command allows you to display the set of digraphs that \*E is
Xusing, or add/remove a digraph.
XTo list the set of digraphs, use the digraph command with no arguments.
XTo add a digraph, you should give the digraph command two arguments.
XThe first argument is the two ASCII characters that are to be combined;
Xthe second is the non-ASCII character that they represent.
XThe non-ASCII character's most significant bit is automatically set by the
Xdigraph command, unless to append a ! to the command name.
XRemoval of a digraph is similar to adding a digraph, except that you should
Xleave off the second argument.
X.PP
XThe \fBse\fRt command allows you examine or set various options.
XWith no arguments, it displays the values of options that have been changed.
XWith the single argument "all" it displays the values of all options,
Xregardless of whether they've been explicitly set or not.
XOtherwise, the arguments are treated as options to be set.
X.PP
XThe \fBmk\fRexrc command saves the current configuration to a file
Xcalled ".exrc" in the current directory.
X.PP
XThe mar\fBk\fR command defines a named mark to refer to a specific place
Xin the file.
XThis mark may be used later to specify lines for other commands.
X.PP
XThe \fBvi\fRsual command puts the editor into visual mode.
XInstead of emulating ex, \*E will start emulating vi.
X.PP
XThe \fBve\fRrsion command tells you that what version of \*E this is.
X.PP
XThe \fB=\fR command tells you what line you specified, or,
Xif you specified a range of lines, it will tell you both endpoints and