TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
NAME
textedit - XView window- and mouse-based text editor
SYNOPSIS
textedit [ generic-tool-arguments ] [ -Ea on | off ] [
-adjustispendingdelete ] [ -Ei on | off ] [ -autoindent ] [ -Eo on |
off ] [ -okaytooverwrite ] [ -Er on | off ] [ -readonly ] [ -Ec N ] [
-checkpoint count ] [ -EL lines ] [ -lowercontext lines ] [ -Em pixels ]
[ -margin pixels ] [ -En N ] [ -numberoflines lines ] [ -ES N ] [
-multiclickspace radius ] [ -Et N ] [ -tabwidth tabstop ] [ -ET N ] [
-multiclicktimeout intrvl ] [ -Eu N ] [ -historylimit max ] [ -EU N ]
[ -uppercontext lines ] filename
AVAILABILITY
This command is available with the OpenWindows environment. For
information about installing OpenWindows, refer to the OpenWindows
Installation and Start-Up Guide.
DESCRIPTION
textedit is a window-based XView application that provides both mouse and
pointer operations and keyboard accelerators for the editing of text. In
general, text editing throughout the OpenWindows user environment uses
textedit conventions, both in text display areas such as mail message
windows and command panel text fields.
textedit operates via a set of command panel buttons and text fields and
a set of menus and submenus accessible from the main editing window.
OPTIONS
generic-tool-arguments
textedit accepts the XView generic tool arguments described in the
XView Reference Manual.
-Ea on|off
-adjustispendingdelete
Choose whether or not an adjustment to a selection makes the
selection pending-delete. The default is off. This option
corresponds to, and overrides, the adjustispendingdelete Text
defaults entry.
-Ei on|off
-autoindent
Choose whether or not to automatically indent newly-opened lines.
The default is off. Corresponds to the autoindent Text default.
-Eo on|off
-okaytooverwrite
Set behavior to the Store as New File menu item. If on a Store as
New File to the current file is treated as a Save Current File. If
off (the standard default), Store as New File operations using the
current filename results in an error message. Corresponds to
Storeselfissave.
10/89 Page 1
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
-Er on|off
-readonly
Turn read-only mode on or off. When on, text cannot be modified.
-Ec N
-checkpoint count
Checkpoint after every count editing operation. If count is 0 (the
standard default), no checkpointing takes place. Each character
typed, each Paste, and each Cut counts as an editing operation.
Corresponds to checkpointfrequency.
-EL lines
-lowercontextlines
Specify the minimum number of lines to keep between the caret and
the bottom of the text subwindow. The default is 2. Corresponds
to lowercontext.
-Em pixels
-margin pixels
Set the scrollbar margin width in pixels. The default is 4.
Corresponds to leftmargin.
-En N
-numberoflines lines
Set the number of lines in the bottom subwindow. The default is
45.
-ES N
-multiclickspace radius
Set the radius in pixels, within which clicks must occur to be
treated as a multi-click selection. The default is 3 pixels.
Corresponds to multiclickspace.
-Et N
-tabwidth tabstop
Set the number of SPACE characters displayed per TAB stop. The
default is 8. This option has no effect on the characters in the
file. Corresponds to tabwidth.
-ET N
-multiclicktimeout intrvl
Set the interval, in milliseconds, within which any two clicks must
occur to be treated as a multi-click selection. The default is 390
milliseconds. Corresponds to multiclicktimeout.
-Eu N
-historylimit max
Set the maximum number of editing operations that can be undone or
replayed. The default is 50. Corresponds to historylimit.
Page 2 10/89
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
-EU N
-uppercontext lines
Set the minimum number of lines to keep between the caret and the
top of the text subwindow. The default is 2. Corresponds to
uppercontext.
USAGE
textedit is part of the OpenWindows user environment. For a descriptions
of the basic concepts of OpenWindows, see the OpenWindows User's Guide.
Signal Processing
If textedit hangs, for whatever reason, you can send a SIGHUP......s0
signal to its process ID, which forces it to write any changes (if
possible):
kill -HUP pid
The edits are written to the file textedit.pid in its working directory.
If that fails, textedit successively tries to write to a file by that
name in /var/tmp, and then /tmp. In addition, whenever textedit catches
a fatal signal, such as SIGILL, it tries to write out the edits before
aborting.
Defaults Options
You can specify a number of defaults using the .Xdefaults file that
affect the behavior of the text-based facilities. See xview(1) for more
detailed information.
Selections
Selections in textedit are defined as selected portions of text to which
editing operations can be applied. For example, a selection can be
deleted, moved, copied, etc.
textedit provides two types of selections: primary and secondary.
Primary selections allow you to select a set of text on which to perform
an editing function. Secondary selections allow you to define a second
block of text without undefining your primary text selection or
repositioning your cursor. Being able to define two sets of text at once
allows you to take advantage of the advanced editing functions described
below in the section called Function Keys.
10/89 Page 3
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
Using a Mouse and Pointer:
Single characters can be selected using the SELECT.
Blocks of text can be selected by selecting a starting point
with the SELECT and selecting an ending point with ADJUST.
Or blocks of text can be selected using OPEN LOOK's wipe
through feature by pointing at a beginning character and
depressing the select button while moving the pointer to the
end of a block of text.
Selections can also be made by sing clicking (rapidly pressing)
the select button. Click once to select a single letter; click
twice to select a word; click three times to select a complete
line of text; click four times to select the entire document
being edited.
Visual Feedback
All primary selections are indicated visually by inverse video
of the text selected and are pending delete. Pending delete
selections are replaced if you type or paste while the text is
selected.
Secondary selections that are not pending delete are indicated
by underlining of the text.
Secondary selections pending delete are indicated by
underlining of the text and strike through of the individual
characters.
Secondary Selections
Secondary selections are made using any of the selection methods
described above in addition to holding down one of the four
function keys corresponding to the commands Cut, Find, Paste, or
Copy.
Secondary selections are made pending delete by holding the CTRL
key when making the secondary If a secondary selection is pending-
delete, it is deleted when the function key is released, except in
the case of the Find, which deselects the secondary selection.
You can make adjusted selections switch to pending-delete using the
adjustispendingdelete defaults entry, or the -Ea option. In this
case, CTRL-Middle makes the selection not pending-delete.
Commands that operate on the primary selection do so even if the
primary selection is not in the window that issued the command.
Inserting Text and Command Characters
For the most part, typing any of the standard keys either inserts the
corresponding character at the insertion point, or erases characters.
However, certain key combinations are treated as commands. Some of the
most useful are:
Command Character Description
Cut-Primary META-X Erases, and moves to the Clipboard, the primary selection.
Page 4 10/89
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
Find-Primary META-F Searches the text for the pattern specified by the primary
selection or by the Clipboard, if there is no primary selection.
Copy-to-Clipboard META-C Copies the primary selection to the Clipboard.
Paste-Clipboard META-V Inserts the Clipboard contents at the insertion point.
Copy-then-Paste META-P Copies the primary selection to the insertion point (through
the Clipboard).
Go-to-EOF CTRL-RETURN Moves the insertion point to the end of the text, positioning
the text so that the insertion point is visible.
Function Keys
The commands indicated by use of the function keys are:
Command Sun-2|3 Key Description
Stop L1 Aborts the current command.
Again L2 Repeats the previous editing sequence since a
primary selection was made.
Undo L4 Undoes a prior editing sequence.
Front L5 Makes the window completely visible (or
hides it, if it is already exposed).
Copy L6 Copies the primary selection, either to the
Clipboard or at the closest end of the secondary
selection.
Open L7 Makes the window iconic (or normal, if it is already
iconic).
Paste L8 Copies either the secondary selection or the Clipboard at
the insertion point.
Find L9 Searches for the pattern specified by, in order, the
secondary selection, the primary selection, or the Clipboard.
Cut L10 Erases, and moves to the Clipboard, either the primary or
the secondary selection.
Help F1 Produces help text.
Find usually searches the text forwards, towards the end. Holding down
the SHIFT key while invoking Find searches backward through the text,
towards the beginning. If the pattern is not found before the search
encounters either extreme, it wraps around and continues from the other
extreme. Find starts the search at the appropriate end of the primary
selection, if the primary selection is in the subwindow that the search
is made in; otherwise it starts at the insertion point, unless the
subwindow cannot be edited, in which case it starts at the beginning of
the text.
CTRL-Find invokes the Find and Replace pop-up frame.
10/89 Page 5
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
Menu Items
File A pull-right menu item for file operations.
Edit A pull-right menu item equivalent of the editing function keys.
The Edit submenu provides Again, Undo, Copy, Paste, and Cut
(same as function keys L2, L4, L6, L8, and L10).
Display A pull-right menu item for controlling the way text is
displayed and line display format.
Find A pull-right menu item for find and delimiter matching
operations.
Extras A user definable pull-right menu item. The Extras standard
submenu is controlled by /usr/lib/.textextrasmenu, which has
the same format as .rootmenu file. This can be overridden in
two ways:
1) Change the value of the .Xdefaults parameter
text.extrasMenuFilename to the correct file path.
2) Set the environment variable EXTRASMENU to the file
desired.
Note that option 1 overrides option 2 if both are used.
For more information see the DeskSet Environment Reference
Guide . See also xview(1).
Only those items that are active appear as normal text in the menu; inactive
items (which are inappropriate at the time) are grayed out.
Page 6 10/89
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
User Defined Commands
The file /usr/lib/textextrasmenu specifies filter programs that are
included in the text subwindow Extras pull-right menu item. The file
~/.textswrc specifies filter programs that are assigned to (available)
function keys. These filters are applied to the contents of the primary
selection. Their output is entered at the caret.
The file /usr/lib/textswrc is a sample containing a set of useful
filters. It is not read automatically.
FILES
~/.textswrc Specifies bindings of filters to function keys
/usr/lib/textextrasmenu
Specifies bindings of filters for the extras
menu pull-right items
/usr/bin Contains useful filters, including shift_lines
and capitalize.
filename% Prior version of filename is available here
after a Save Current File menu operation
textedit.pid Edited version of filename; generated in
response to fatal internal errors
/tmp/Text* Editing session logs
SEE ALSO
kill(1)
Introduction to the OpenWindows User Environment
DIAGNOSTICS
Cannot open file 'filename', aborting!
filename does not exist or cannot be
read.
textedit produces the following exit status codes:
0 normal termination
1 standard OpenWindows help message was printed
2 help message was requested and printed
3 abnormal termination in response to a signal, usually due to
an internal error
4 abnormal termination during initialization, usually due to a
missing file or running out of swap space
BUGS
Multi-click to change the current selection does not work for Adjust
Selection.
Handling of long lines is incorrect in certain scrolling situations.
There is no way to replay any editing sequence except the most recent.
10/89 Page 7
TEXTEDIT(1) UNIX System V(11 June 1990) TEXTEDIT(1)
Page 8 10/89