Provided by: xview-clients_3.2p1.4-28.1_amd64 bug


       textedit - XView window- and mouse-based text editor


       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


       This  command  is  available  with  the  OpenWindows  environment.   For information about
       installing OpenWindows, refer to the OpenWindows Installation and Start-Up Guide.


       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.


              textedit accepts the XView generic tool arguments described in the XView  Reference

       -Ea on|off
              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
              Choose  whether  or not to automatically indent newly-opened lines.  The default is
              off.  Corresponds to the auto_indent Text default.

       -Eo on|off
              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
              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
              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

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


       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 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  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
       Open                L7                  Makes the window iconic (or normal, if it is already
       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


       ~/.textswrc              Specifies bindings of filters to function keys
                                Specifies  bindings  of  filters  for  the extras menu pull-right
       /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             Edited  version  of  filename;  generated  in  response  to fatal
                                internal errors
       /tmp/Text*               Editing session logs



       Introduction to the OpenWindows User Environment


       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
              4      abnormal termination during initialization, usually due to a missing file or
                     running out of swap space


       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)