textedit is a mouse-oriented text editor that runs within the SunView environment. It creates a window containing two text subwindows. The top subwindow (referred to as the ``scratch'' window) can be used to store small pieces of text. The bottom subwindow (referred to as the ``edit'' window) displays the contents of filename, if given.
The name of the file currently being edited is displayed in the left-hand portion of the frame header. The name of the current working directory is displayed in the right-hand portion.
If textedit hangs, for whatever reason, you can send a SIGHUP 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.
There are several dozen user-specified defaults that affect the behavior of the text-based facilities. See defaultsedit.1 for a complete description. Important defaults entries in the Text category are:
In textedit, the mouse is used to specify a selection, which is a character span to operate on. The mouse is also used to position the insertion point and to invoke a menu of commands.
The assignment of commands to the mouse buttons is:
There are two types of selections: a primary selection is indicated by video-inversion of the span of characters, and tends to persist. A secondary selection is indicated by underlining the span of characters and only exists while one of the four function keys corresponding to the commands Cut, Find, Paste, or Copy, is depressed.
In addition, a selection can be ``pending-delete,'' as indicated by overlaying the span of characters with a light gray pattern. A selection is made pending-delete by holding the CTRL key while clicking the LEFT or MIDDLE mouse buttons. If a primary selection is pending-delete, it is only deleted when characters are inserted, either by type-in or by Paste or Copy. 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 adjust_is_pending_delete 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.
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. 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.
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. CAPSLOCK F1 Forces all subsequently typed alphabetic characters to be upper-case. This key is a toggle; striking it a second time undoes the effect of the first strike.
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.
The default assignment of function keys can be modified using
defaultsedit.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''.
The file /usr/lib/text_extras_menu 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.
The environment variables LC_CTYPE, LANG, and LC_default control the character classification throughout textedit. On entry to textedit, these environment variables are checked in the following order: LC_CTYPE, LANG, and LC_default. When a valid value is found, remaining environment variables for character classification are ignored. For example, a new setting for LANG does not override the current valid character classification rules of LC_CTYPE. When none of the values is valid, the shell character classification defaults to the POSIX.1 ``C'' locale.
[a manual with the abbreviation SVBG]
textedit produces the following exit status codes:
Handling of long lines is incorrect in certain scrolling situations.
There is no way to replay any editing sequence except the most recent.
`textedit newfile' fails if newfile does not exist.
Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97