joe.1.in

举世闻名的joe记事本源程序

.TH JOE 1
.SH Name
joe \- Joe's Own Editor
.SH Syntax
.B joe [global-options] [ [local-options] filename ]...

.B jstar [global-options] [ [local-options] filename ]...

.B jmacs [global-options] [ [local-options] filename ]...

.B rjoe [global-options] [ [local-options] filename ]...

.B jpico [global-options] [ [local-options] filename ]...
.SH Description
JOE is a powerful ASCII-text screen editor.  It has a "mode-less" user
interface which is similar to many user-friendly PC editors.  Users of
Micro-Pro's WordStar or Borland's "Turbo" languages will feel at home.  JOE
is a full featured UNIX screen-editor though, and has many features for
editing programs and text.

JOE also emulates several other editors.  JSTAR is a close imitation of
WordStar with many "JOE" extensions.  JPICO is a close imitation of the
Pine mailing system's PICO editor, but with many extensions and
improvements.  JMACS is a GNU-EMACS imitation.  RJOE is a restricted
version of JOE, which allows you to edit only the files specified on the
command line.

Although JOE is actually five different editors, it still requires only one
executable, but one with five different names.  The name of the editor with
an "rc" appended gives the name of JOE's initialization file, which
determines the personality of the editor.

JOE is free software;  you can distribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation.  I have no plans for turning JOE into a commercial or share-ware
product.  JOE is available over the Internet from
\fBwww.sourceforge.net/projects/joe-editor\fR.

.SH Usage 

To start the editor, type \fBjoe\fR followed by zero or more names of files
you want to edit.  Each file name may be preceded by a local option setting
(see the local options table which follows).  Other global options, which
apply to the editor as a whole, may also be placed on the command line (see
the global options table which follows).  If you are editing a new file, you
can either give the name of the new file when you invoke the editor, or in
the editor when you save the new file.  A modified syntax for file names is
provided to allow you to edit program output, standard input/output, or
sections of files or devices.  See the section \fBFilenames\fR below for
details.

Once you are in the editor, you can type in text and use special
control-character sequences to perform other editing tasks.  To find out
what the control-character sequences are, read the rest of this man page or
type \fB^K H\fR for help in the editor.

Now for some obscure computer-lore:

The \fB^\fR means that you hold down the \fBControl\fR key while pressing
the following key (the same way the \fBShift\fR key works for uppercase
letters).  A number of control-key sequences are duplicated on other keys,
so that you don't need to press the control key: \fBESC\fR will work in
place of \fB^[\fR, \fBDel\fR will work in place of \fB^?\fR, \fBBackspace\fR
will work in place of \fB^H\fR, \fBTab\fR will work in place of \fB^I\fR,
\fBReturn\fR or \fBEnter\fR will work in place of \fB^M\fR and
\fBLinefeed\fR will work in place of \fB^J\fR.  Some keyboards may give you
trouble with some control keys.  \fB^_\fR, \fB^^\fR and \fB^@\fR can usually
be entered without pressing shift (I.E., try \fB^-\fR, \fB^6\fR and
\fB^2\fR).  Other keyboards may reassign these to other keys.  Try:
\fB^.\fR, \fB^,\fR and \fB^/\fR.  \fB^SPACE\fR can usually be used in place
of \fB^@\fR.  \fB^\\\fR and \fB^]\fR are interpreted by many communication
programs, including telnet and kermit.  Usually you just hit the key twice
to get it to pass through the communication program.

Once you have typed \fB^K H\fR, the first help window appears at the top of
the screen.  You can continue to enter and edit text while the help window
is on.  To page through other topics, hit ^[, and ^[. (that is, ESC , and
ESC .).  Use \fB^K H\fR to dismiss the help window.

You can customize the keyboard layout, the help screens and a number of
behavior defaults by copying JOE's initialization file (usually
\fB@JOERC@/joerc\fR) to \fB.joerc\fR in your home directory and then
by modifying it.  See the section \fBjoerc\fR below.

To have JOE used as your default editor for e-mail and News, you need to set
the \fBEDITOR\fR and \fBVISUAL\fR environment variables in your shell
initialization file (\fB.cshrc\fR or \fB.profile\fR) to refer to JOE (joe
usually resides as \fB@BINDIR@/joe\fR).

There are a number of other obscure invocation parameters which may have to
be set, particularly if your terminal screen is not updating as you think it
should.  See the section \fBEnvironment variables\fR below.

.SH Command Line Options

The following global options may be specified on the command line:

.IP -asis
Characters with codes above 127 will be sent to the terminal as-is, instead
of as inverse of the corresponding character below 128.  If this does not
work, check your terminal server.

.IP -backpath\ path
If this option is given, backup files will be stored in the specified
directory instead of in each file's original directory.

.IP -baud\ nnn
Set the baud rate for the purposes of terminal screen optimization.  Joe
inserts delays for baud rates below 19200, which bypasses tty buffering so
that typeahead will interrupt the screen output.  Scrolling commands will
not be used for 38400 baud.  This is useful for X-terms and other console
ttys which really aren't going over a serial line.

.IP -beep
Joe will beep on command errors and when the cursor goes past extremes.

.IP -columns\ nnn
Sets the number of screen columns.

.IP -csmode
Continued search mode: a search immediately following a search will repeat
the previous search instead of prompting for new string.  This is useful for
the the ^[S and ^[R commands and for when joe is trying to be emacs.

.IP -dopadding
Joe usually assumes that there is some kind of flow control between it and
the tty.  If there isn't, this option will make joe output extra ^@s to the
tty as specified by the termcap entry.  The extra ^@s allow the terminal to
catch up after long terminal commands.

.IP -exask
This option makes ^KX verify the file name that it's about to write.

.IP -force
This option makes sure that the last line of the file has a line-feed which
it's saved.

.IP -help
The editor will start with the help screen on if this option is given.

.IP -keepup
Normally the column number and control-key prefix fields of the status lines
are on a one second delay to reduce CPU consumption, but with this option
they are updated after each key-stroke.

.IP -lightoff
The block highlighting will go away after any block command if this option
is given.

.IP -lines\ nnn
Sets the number of screen lines.

.IP -marking
Text between ^KB and the cursor is highlighted (use with -lightoff and a
modified joerc file to have drop-anchor style block selection).

.IP -mid
If this option is set and the cursor moves off the window, the window will
be scrolled so that the cursor is in the center.  This option is forced on
slow terminals which don't have scrolling commands.

.IP -nobackups
This option prevents backup files.

.IP -nonotice
This option prevent the copyright notice from being displayed when the
editor starts.

.IP -nosta
This option eliminates the top-most status line.  It's nice for when you
only want to see your text on the screen or if you're using a vt52.

.IP -noxon
Attempt to turn off ^S/^Q processing.  This is useful for when joe is trying
to be WordStar or EMACS.

.IP -orphan
When this option is active, extra files on the command line will be placed
in orphaned buffers instead of in extra windows.  This is useful for when
joe is trying to be emacs.

.IP -pg\ nnn
This specifies the number of lines to keep after PgUp/PgDn (^U/^V).  If -1
is given, half the window is kept.

.IP -skiptop\ nnn
Don't use the top nnn lines of the screen.  Useful for when joe is used as a
BBS editor.

.LP
Each of these options may be specified in the joerc file as well.  In
addition, the NOXON, BAUD, LINES, COLUMNS and DOPADDING options may be
specified with environment variables.

The JOETERM environment variable may be set to override the regular TERM
environment variable for specifying your terminal type.

The following options may be specified before each filename on the command
line:

.IP +nnn
The cursor starts on the specified line.

.IP -crlf
Joe uses CR-LF as the end of line sequence instead of just LF.  This is for
editing MS-DOS or VMS files.

.IP -wordwrap
Joe wraps the previous word when you type past the right margin.

.IP -autoindent
When you hit Return on an indented line, the indentation is duplicated onto
the new line.

.IP -overwrite
Typing overwrites existing characters instead of inserting before them.

.IP -lmargin\ nnn
Sets the left margin.

.IP -rmargin\ nnn
Sets the right margin.

.IP -tab\ nnn
Sets the tab width.

.IP -indentc\ nnn
Sets the indentation character for ^K, and ^K. (32 for SPACE, 9 for TAB).

.IP -istep\ nnn
Sets the indentation step for ^K, and ^K..

.IP -linums
Line numbers are displayed before each line.

.IP -rdonly
The file is read only.

.IP -keymap\ name
Use an alternate section of the joerc file for the key sequence bindings.

.LP
These options can also be specified in the joerc file.  They can be set
depending on the file-name extension.  Programs (.c, .h or .p extension)
usually have autoindent enabled.  Wordwrap is enabled on other files, but rc
files have it disabled.

.SH Editing Tasks
.SS Basic Editing

When you type characters into the editor, they are normally inserted into
the file being edited (or appended to the file if the cursor is at the end
of the file).  This is the normal operating mode of the editor.  If you want
to replace some existing text, you have to delete the old text before or
after you type in the replacement text.  The \fBBackspace\fR key can be used
for deleting text: move the cursor to right after the text you want to
delete and hit \fBBackspace\fR a number of times.  

Hit the \fBEnter\fR or \fBReturn\fR key to insert a line-break.  For 
example, if the cursor was in the middle of a line and you hit \fBReturn\fR, 
the line would be split into two lines with the cursor appearing at the 
beginning of the second line.  Hit \fBBackspace\fR at the beginning of a 
line to eliminate a line-break.

Use the arrow keys to move around the file.  If your keyboard doesn't have