packages icon



 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:  November 14, 2024






 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:  November 14, 2024






 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:  November 14, 2024






 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:  November 14, 2024