Provided by: xview-clients_3.2p1.4-28_i386 bug

NAME

       textedit - XView window- and mouse-based text editor

SYNOPSIS

       textedit   [   generic-tool-arguments   ]   [   -Ea   on   |  off  ]  [
       -adjust_is_pending_delete ] [ -Ei on | off ] [ -auto_indent ] [ -Eo  on
       |  off ] [ -okay_to_overwrite ] [ -Er on | off ] [ -read_only ] [ -Ec N
       ] [ -checkpoint count ] [ -EL lines ] [ -lower_context lines  ]  [  -Em
       pixels  ] [ -margin pixels ] [ -En N ] [ -number_of_lines lines ] [ -ES
       N ] [ -multi_click_space radius ] [ -Et N ] [ -tab_width  tabstop  ]  [
       -ET  N ] [ -multi_click_timeout intrvl ] [ -Eu N ] [ -history_limit max
       ] [ -EU N ] [ -upper_context 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
       -adjust_is_pending_delete
              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 adjust_is_pending_delete Text
              defaults entry.

       -Ei on|off
       -auto_indent
              Choose whether  or  not  to  automatically  indent  newly-opened
              lines.  The default is off.  Corresponds to the auto_indent Text
              default.

       -Eo on|off
       -okay_to_overwrite
              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 Store_self_is_save.

       -Er on|off
       -read_only
              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 checkpoint_frequency.

       -EL lines
       -lower_contextlines
              Specify the minimum number of lines to keep  between  the  caret
              and  the  bottom  of  the  text  subwindow.   The  default is 2.
              Corresponds to lower_context.

       -Em pixels
       -margin pixels
              Set the scrollbar margin width in pixels.   The  default  is  4.
              Corresponds to left_margin.

       -En N
       -number_of_lines lines
              Set the number of lines in the bottom subwindow.  The default is
              45.

       -ES N
       -multi_click_space 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 multi_click_space.

       -Et N
       -tab_width 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 tab_width.

       -ET N
       -multi_click_timeout 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
              multi_click_timeout.

       -Eu N
       -history_limit max
              Set  the maximum number of editing operations that can be undone
              or replayed.  The default is 50.  Corresponds to history_limit.

       -EU  N
       -upper_context 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 upper_context.

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.

       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  selection.   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.

   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.
       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.

   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/.text_extras_menu, 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”.

   User Defined Commands
       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.

FILES

       ~/.textswrc              Specifies bindings of filters to function keys
       /usr/lib/text_extras_menu
                                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.

                                 11 June 1990                      TEXTEDIT(1)