EDITOR(1) X Version 11 EDITOR(1)
5.2.1996
NAME
editor - a text editor for X with drag and drop and accents
capabilities.
SYNTAX
editor [ -toolkitoption ...] [ filename ] [ line-number ]
OPTIONS
Editor accepts all of the standard X Toolkit command line options (see
X(1)). The order of the command line options is not important.
filename
Specifies the file that is to be loaded during start-up. This
is the file which will be edited. If a file is not specified,
editor lets you load a file or create a new file after it has
started up. The filename `-' means to read from standard
input. When reading from stdin, editor will quit if it reaches
end of file without reading anything from stdin.
line-number
Specifies the current line number after start-up.
DESCRIPTION
Editor provides a window consisting of the following three areas:
Menus Section A set of pull-down menus hopefully allowing
you to do everything you want with the text
file.
Filename Display Displays the name of the file currently being
edited, and whether this file is Read - Write
or Read Only. You can also drag and drop a
file in this area and the editor will
automatically load this file (provided you
are using the DND drag and drop protocol). If
the file is saved you can drag the file name
from this area too.
Edit Window Displays the text of the file that you are
editing or creating.
EDITING
The Athena Text widget is used for the three sections of this
application that allow text input. The characters typed will go to
the Text widget that the pointer cursor is currently over. If the
pointer cursor is not over a Text widget then the keypresses will have
no effect on the application.
MENUS
File Provides commands dealing with loading, saving and printing
the text file and of course quitting editor. All fileselection
- 1 - Formatted: October 26, 2025
EDITOR(1) X Version 11 EDITOR(1)
5.2.1996
are done by a fileselector popup. Warning popup messages will
appear if the selected command is going to discard changes.
Edit Provides special editing commands for cutting, pasting,
indenting and unindenting a selected textblock.
Jump Provides commands for jumping to a linenumber, textbeginning,
textending, selection start and selection end.
Search Provides commands for searching and replaceing text. The
activated popup allows you to search, replace once, replace in
a query mode or to replace all. Although commands for finding
the corresponding bracket to a selected bracket and for
checking the bracket hierachy all over the text are available.
Known brackets are "{,},[,],(,),/*,*/".
Special Provides some special commands for setting some edit options,
calling the sed stream editor, displaying a helpfile and
getting a copyright information.
Commands
Provides a panel for performing Unix commands on the whole
textfile or the current text selection. The result is diplayed
in another editor window. Also commands can be predefined by
the user (see commands RESOURCE).
Pipes Provides a panel for performing Unix commands on the whole
textfile or the current text selection. The result replaces
the current text selection. Also commands can be predefined by
the user (see pipes RESOURCE).
RESOURCES
For editor the available resources are:
enableBackups (Class EnableBackups)
Specifies that, when edits made to an existing file are saved,
editor is to copy the original version of that file to
file<suffix> before it saves the changes. The default value
for this resource is "off", stating that no backups should be
created.
backupNameSuffix (Class BackupNameSuffix)
Specifies a string that is to be appended to the backup
filename. The default is to append the string ".BAK".
printCommand (Class PrintCommand)
Specifies a command for printing the current file. An "%f" in
the string is expanded to the filename which has to be printed
(A copy of the current file in the tmp directory). "%t" is
expanded to the real filename. The default command is "lpr -p
-T %t %f".
- 2 - Formatted: October 26, 2025
EDITOR(1) X Version 11 EDITOR(1)
5.2.1996
autoIndent (Class AutoIndent)
Specifies whether to autoindent by default or not. The default
is to autoindent.
*editWindow.autoFill (Class AutoFill)
Specifies whether to break a line when the user attempts to
type into the right margin or not.
*editWindow.wrap (Class Wrap)
Specifies default wrapmode for lines longer than the
textwindow. Values are never, word and line. The default
value is never.
tabsize (Class Tabsize)
Specifies the default tabsize in characters. The default value
is 8.
textheight (Class Textheight)
Specifies the default height of the textwindow in number of
characters. The default value is 40.
textwidth (Class Textwidth)
Specifies the default width of the textwindow in number of
characters. The default value is 80.
maxScrollbreak (Class MaxScrollbreak)
Specifies how many cursor up/down events with the same serial
number should be ignored.
insertranslations (Class Insertranslations)
Keybindings in Insert mode
overwritetranslations (Class Overwritetranslations)
Keybindings in Overwrite mode
commands (Class Commands) pipes (Class Pipes)
Each command has the format "<Menu entry> <Tab> <Command
string>\n\". Here is a short example with some useful
commands. It may be placed in the users "~/.Xdefaults" file:
editor*commands: Make make\n\
CC cc $stripped.c -o $stripped
editor*pipes: Date date
The following variables are set and may be used in a command:
$selection: Filename of the temporary file containing the
current selection
$tempfile : Filename of the temporary saved text file
- 3 - Formatted: October 26, 2025
EDITOR(1) X Version 11 EDITOR(1)
5.2.1996
$filename : Filename of the edited file
$stripped : Stripped Filename (without postfix and path) of
the edited file
ENVIRONMENT
DISPLAY to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides the global
resources stored in the RESOURCE_MANAGER property.
FILES
<LIBDIR>/X11/app-defaults/editor - specifies required resources
<LIBDIR>/X11/editor/editor.help - help text
<LIBDIR> stands for "/usr/lib" (X11 Release 5 or earlier) or
"/usr/X11R6/lib" (since X11 Release 6).
SEE ALSO
X(1), xrdb(1), xedit(1), Athena Widget Set
COPYRIGHT
See X(1) for a full statement of rights and permissions.
AUTHORS
Randolf Werner, University Koblenz, Germany
Karl-Heinz Staudt, University Koblenz, Germany
Chris D. Peterson, MIT X Consortium
Cesar A.R. Crusius, UFSC, Brazil
- 4 - Formatted: October 26, 2025
