207 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			207 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
.so mnx.mac
 | 
						|
.TH MINED 1x
 | 
						|
.CD "mined \(en \*(M2 editor"
 | 
						|
.SX "mined\fR [\fIfile\fR]
 | 
						|
.FL "\fR(none)"
 | 
						|
.TP 20
 | 
						|
.B mined /user/ast/book.3
 | 
						|
# Edit an existing file
 | 
						|
.TP 20
 | 
						|
.B mined
 | 
						|
# Call editor to create a new file
 | 
						|
.TP 20
 | 
						|
.B ls \(enl | mined
 | 
						|
# Use \fImined\fR as a pager to inspect listing
 | 
						|
.PP
 | 
						|
\fIMined\fR is a simple screen editor.
 | 
						|
At any instant, a window of 24 lines is visible on the screen.
 | 
						|
The current position in the file is shown by the cursor.
 | 
						|
Ordinary characters typed in are inserted at the cursor.
 | 
						|
Control characters and keys on the numeric keypad (at the right-hand side
 | 
						|
of the keyboard) are used to move the cursor and perform other functions.
 | 
						|
.PP
 | 
						|
Commands exist to move forward and backward a word, and delete words
 | 
						|
either in front of the cursor or behind it.
 | 
						|
A word in this context is a sequence of characters delimited on both ends by
 | 
						|
white space (space, tab, line feed, start of file, or end of file).
 | 
						|
The commands for deleting characters and words also work on line feeds, making
 | 
						|
it possible to join two consecutive lines by deleting the line feed between them.
 | 
						|
.PP
 | 
						|
The editor maintains one save buffer (not displayed).
 | 
						|
Commands are present to move text from the file to the buffer, from the buffer
 | 
						|
to the file, and to write the buffer onto a new file.
 | 
						|
If the edited text cannot be written out due to a full disk, it may still
 | 
						|
be possible to copy the whole text to the save buffer and then write it to a
 | 
						|
different file on a different disk with CTRL-Q.
 | 
						|
It may also be possible to escape from the editor with CTRL-S and remove
 | 
						|
some files.
 | 
						|
.PP
 | 
						|
Some of the commands prompt for arguments (file names, search patterns, etc.).
 | 
						|
All commands that might result in loss of the file being edited prompt to ask
 | 
						|
for confirmation.
 | 
						|
.PP
 | 
						|
A key (command or ordinary character) can be repeated
 | 
						|
.I n
 | 
						|
times by typing
 | 
						|
.I "ESC n key"
 | 
						|
where 
 | 
						|
.I ESC
 | 
						|
is the \*(OQescape\*(CQ key.
 | 
						|
.PP
 | 
						|
Forward and backward searching requires a regular expression as the search
 | 
						|
pattern.
 | 
						|
Regular expressions follow the same rules as in the 
 | 
						|
.Ux
 | 
						|
editor,
 | 
						|
.I ed .
 | 
						|
These rules can be stated as:
 | 
						|
.LI
 | 
						|
.IT
 | 
						|
Any displayable character matches itself.
 | 
						|
.IT
 | 
						|
\&. (period) matches any character except line feed.
 | 
						|
.IT
 | 
						|
\&^ (circumflex) matches the start of the line.
 | 
						|
.IT
 | 
						|
\&$ (dollar sign) matches the end of the line.
 | 
						|
.IT
 | 
						|
\&\\c matches the character \fIc\fR (including period, circumflex, etc).
 | 
						|
.IT
 | 
						|
[\fIstring\fR] matches any of the characters in the string.
 | 
						|
.IT
 | 
						|
[^string] matches any of the characters except those in the string.
 | 
						|
.IT
 | 
						|
[\fIx\(eny\fR] matches any characters between \fIx\fR and \fIy\fR (e.g., [\fIa\(enz\fR]).
 | 
						|
.IT
 | 
						|
Pattern\(** matches any number of occurrences of \fIpattern\fR.
 | 
						|
.LX
 | 
						|
Some examples of regular expressions are:
 | 
						|
.HS
 | 
						|
.in +1.25i
 | 
						|
.ta +1.0i
 | 
						|
.ti -1.0i
 | 
						|
The boy	matches the string \*(OQThe boy\*(CQ
 | 
						|
.ti -1.0i
 | 
						|
^$	matches any empty line.
 | 
						|
.ti -1.0i
 | 
						|
^.$	matches any line containing exactly 1 character
 | 
						|
.ti -1.0i
 | 
						|
^A.*\\.$	matches any line starting with an \fIA\fR, ending with a period.
 | 
						|
.ti -1.0i
 | 
						|
^[A\(enZ]*$	matches any line containing only capital letters (or empty).
 | 
						|
.ti -1.0i
 | 
						|
[A\(enZ0\(en9]	matches any line containing either a capital letter or a digit.
 | 
						|
.ti -1.0i
 | 
						|
\&.*X$	matches any line ending in \*(OQX\*(CQ
 | 
						|
.ti -1.0i
 | 
						|
A.*B	matches any line containing an \*(OQA\*(CQ and then a \*(OQB\*(CQ
 | 
						|
.in -1.25i
 | 
						|
.sp
 | 
						|
.PP
 | 
						|
Control characters cannot be entered into a file simply by typing them because
 | 
						|
all of them are editor commands.
 | 
						|
To enter a control character, depress the ALT key, and then while holding it
 | 
						|
down, hit the ESC key.
 | 
						|
Release both ALT and ESC and type the control character.
 | 
						|
Control characters are displayed in reverse video.
 | 
						|
.PP
 | 
						|
The 
 | 
						|
.I mined
 | 
						|
commands are as follows.
 | 
						|
.sp
 | 
						|
.in +1.25i
 | 
						|
.ta +1.0i
 | 
						|
.ti -1.25i
 | 
						|
\fBCURSOR MOTION\fR
 | 
						|
.ti -1.0i
 | 
						|
\fBarrows\fR	Move the cursor in the indicated direction
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-A\fR	Move cursor to start of current line
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-Z\fR	Move cursor to end of current line
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-^\fR	Move cursor to top of screen
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-_\fR	Move cursor to end of screen
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-F\fR	Move cursor forward to start of next word 
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-B\fR	Move cursor backward to start of previous word 
 | 
						|
 | 
						|
.ti -1.25i
 | 
						|
\fBSCREEN MOTION\fR
 | 
						|
.ti -1.0i
 | 
						|
\fBHome key\fR	Move to first character of the file
 | 
						|
.ti -1.0i
 | 
						|
\fBEnd key\fR	Move to last character of the file
 | 
						|
.ti -1.0i
 | 
						|
\fBPgUp key\fR	Scroll window up 23 lines (closer to start of the file)
 | 
						|
.ti -1.0i
 | 
						|
\fBPgDn key\fR	Scroll window down 23 lines (closer to end of the file)
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-U\fR	Scroll window up 1 line
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-D\fR	Scroll window down 1 line
 | 
						|
 | 
						|
.ti -1.25i
 | 
						|
\fBMODIFYING TEXT\fR
 | 
						|
.ti -1.0i
 | 
						|
\fBDel key\fR	Delete the character under the cursor
 | 
						|
.ti -1.0i
 | 
						|
\fBBackspace\fR	Delete the character to left of the cursor
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-N\fR	Delete the next word
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-P\fR	Delete the previous word
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-T\fR	Delete tail of line (all characters from cursor to end of line)
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-O\fR	Open up the line (insert line feed and back up)
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-G\fR	Get and insert a file at the cursor position
 | 
						|
 | 
						|
.ti -1.25i
 | 
						|
\fBBUFFER OPERATIONS\fR
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-@\fR	Set mark at current position for use with CTRL-C and CTRL-K
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-C\fR	Copy the text between the mark and the cursor into the buffer
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-K\fR	Delete text between mark and cursor; also copy it to the buffer
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-Y\fR	Yank contents of the buffer out and insert it at the cursor
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-Q\fR	Write the contents of the buffer onto a file
 | 
						|
 | 
						|
.ti -1.25i
 | 
						|
\fBMISCELLANEOUS\fR
 | 
						|
.ti -1.0i
 | 
						|
\fBnumeric +\fR	Search forward (prompts for regular expression)
 | 
						|
.ti -1.0i
 | 
						|
\fBnumeric \(mi\fR	Search backward (prompts for regular expression)
 | 
						|
.ti -1.0i
 | 
						|
\fBnumeric 5\fR	Display the file status
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-]\fR	Go to specific line
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-R\fR	Global replace \fIpattern\fR with \fIstring\fR (from cursor to end)
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-L\fR	Line replace \fIpattern\fR with \fIstring\fR 
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-W\fR	Write the edited file back to the disk
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-X\fR	Exit the editor
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-S\fR	Fork off a shell (use CTRL-D to get back to the editor)
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-\\\fR	Abort whatever the editor was doing and wait for command
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-E\fR	Erase screen and redraw it
 | 
						|
.ti -1.0i
 | 
						|
\fBCTRL-V\fR	Visit (edit) a new file
 | 
						|
.in -1.25i
 | 
						|
 | 
						|
.SS "Author"
 | 
						|
.PP
 | 
						|
\fIMined\fR was designed by Andy Tanenbaum and written by Michiel Huisjes.
 |