NAME

       NEdit - Text Editor

SYNOPSYS

       nedit [-read] [-create] [-line n | +n] [-server]
             [-do command] [-tags file] [-tabs n]
             [-wrap] [-nowrap] [-autowrap]
             [-autoindent] [-noautoindent]
             [-autosave] [-noautosave]
             [-lm languagemode] [-rows n] [-columns n]
             [-font font]
             [-geometry|-g geometry] [-iconic] [-noiconic]
             [-display [host]:server[.screen]]
             [-xrm resourcestring]
             [-svrname name] [-import file]
             [-background|-bg color] [-foreground|-fg color]
             [-tabbed] [-untabbed] [-group]
             [-V|-version] [-h|-help] [--] [file...]

DESCRIPTION

       NEdit is a standard GUI (Graphical User Interface) style text editor for programs and
       plain-text files. It provides mouse based editing and a streamlined editing style, based
       on popular Macintosh and MS Windows editors, for users of X workstations and X terminals.

OPTIONS

       -read
           Open the file read-only regardless of the actual file protection.

       -create
           Don't warn about file creation when a file doesn't exist.

       -line n, +n
           Go to line number n.

       -server
           Designate this session as an NEdit server, for processing commands from the nc(1)
           program. nc(1) can be used to interface NEdit to code development environments,
           mailers, etc., or just as a quick way to open files from the shell command line
           without starting a new NEdit session.

       -do command
           Execute an NEdit macro or action on the file following the -do argument on the command
           line. -do is particularly useful from the nc(1) program, where `nc -do' can remotely
           execute commands in an nedit -server session.

       -tags file
           Load a file of directions for finding definitions of program subroutines and data
           objects. The file must be of the format generated by Exuberant Ctags, or the standard
           Unix ctags(1) command.

       -tabs n
           Set tab stops every n characters.

       -wrap, -nowrap
           Wrap long lines at the right edge of the window rather than continuing them past it.
           (Continuous Wrap mode)

       -autowrap, -noautowrap
           Wrap long lines when the cursor reaches the right edge of the window by inserting
           newlines at word boundaries. (Auto Newline Wrap mode)

       -autoindent, -noautoindent
           Maintain a running indent.

       -autosave, -noautosave
           Maintain a backup copy of the file being edited under the name ~filename (on Unix) or
           _filename (on VMS).

       -lm languagemode
           Initial language mode used for editing succeeding files.

       -rows n
           Default height in characters for an editing window.

       -columns n
           Default width in characters for an editing window.

       -font font, -fn font
           Font for text being edited. Font for menus and dialogs can be set with -xrm
           "*fontList:font".

       -geometry geometry, -g geometry
           The initial size and/or location of editor windows. The argument geometry has the
           form:

             [<width>x<height>][+|-][<xoffset>[+|-]<yoffset>]

           where C`<width>' and "<height>" are the desired width and height of the window, and
           <xoffset> and C`<yoffset>' are the distance from the edge of the screen to the window,
           + for top or left, - for bottom or right. -geometry can be specified for individual
           files on the command line.

       -iconic, -noiconic
           Initial window state for succeeding files.

       -display [host]:server[.screen]
           The name of the X server to use. host specifies the machine, server specifies the
           display server number, and screen specifies the screen number.  host or screen can be
           omitted and default to the local machine, and screen 0.

       -background color, -bg color
           Background color. The background color for text can be set separately with -xrm
           "nedit*text.background: color".

       -foreground color, -fg color
           Foreground color. The foreground color for text can be set separately with -xrm
           "nedit*text.foreground: color".

       -xrm resourcestring
           Set the value of an X resource to override a default value.

       -svrname name
           When starting nedit in server mode, name the server, such that it responds to requests
           only when nc(1) is given a corresponding -svrname argument. By naming servers, you can
           run several simultaneously, and direct files and commands specifically to any one.
           Specifying a non-empty name automatically designates this session as an NEdit server,
           as though -server were specified.

       -import file
           Loads an additional preferences file on top of the existing defaults saved in your
           nedit.rc file.  To incorporate macros, language modes, and highlight patterns and
           styles written by other users, run nedit with -import <file>, then re-save your
           nedit.rc file with Preferences->Save Defaults.

       -tabbed
           Open all subsequent files in new tabs. Resets -group option.

       -untabbed
           Open all subsequent files in new windows. Resets -group option.

       -group
           Open all subsequent files as tabs in a new window.

       -V, -version
           Prints version and build information, to be mentioned when reporting bugs and
           problems.

       -h, -help
           Prints the command line help and then exits.

       --  Treats all subsequent arguments as file names, even if they start with a dash.  This
           is so NEdit can access files that begin with the dash character.

ENVIRONMENT

       DISPLAY
           NEdit requires an X-based workstation or X-Terminal. If you have used  telnet or
           rlogin to access the host Unix system, set the Unix environment variable for your
           display:

           csh-type shells:

              % setenv DISPLAY devicename:0

           sh-type shells:

              % DISPLAY=devicename:0 && export DISPLAY

       NEDIT_HOME
           This environment variable can be set to the name of a directory. This directory will
           then be used instead of `$HOME/.nedit' as the base directory for NEdit's special files
           (see section FILES, below).

           This variable is new to NEdit 5.4.

FILES

       From version 5.4 on, NEdit creates a directory in which NEdit's special files reside. This
       directory is named '.nedit' by default.

       nedit.rc
           This is an X resource file which contains most user settings for NEdit. It is read at
           startup and written by selecting the item 'Save Defaults...' in the Preferences menu.
           Do not edit this file by hand, all settings can be reached via the 'Default Settings'
           menu.

       nedit.history
           The list of recently opened files. Do not edit this file by hand.

       autoload.nm
           A file that can contain a number of NEdit Macro Language statements and subroutine
           definitions. The statements will be executed when an NEdit server starts, the
           subroutines will be loaded for later reference.  This file will not be created or
           modified by NEdit (unless you load it and edit it of course).

       Note that NEdit still supports the older names for these files, which were used by version
       5.3 and below. These file names are `$HOME/.nedit', `$HOME/.neditdb' and
       `$HOME/.neditmacro', respectively. The old naming scheme will be used if NEdit detects
       that `$HOME/.nedit' is a regular file and NEDIT_HOME isn't set.

       See also the entry for NEDIT_HOME under ENVIRONMENT, above.

NOTES

       For more information see NEdit's online help, or nedit.doc in the NEdit distribution kit.

       NEdit sources, executables, additional documentation, and contributed software are
       available from the NEdit web site at http://nedit.org.

SEE ALSO

       nc(1), X(1), mwm(1), ctags(1), etags(1)

AUTHORS

       NEdit was written by Mark Edel, Joy Kyriakopulos, Christopher Conrad, Jim Clark, Arnulfo
       Zepeda-Navratil, Suresh Ravoor, Tony Balinski, Max Vohlken, Yunliang Yu, Donna Reid, Arne
       Forlie, Eddy De Greef, Steve LoBasso, Alexander Mai, Scott Tringali, Thorsten Haude, Steve
       Haehn, Andrew Hood, Nathaniel Gray, and TK Soh.

       The regular expression matching routines used in NEdit are adapted (with permission) from
       original code written by Henry Spencer at the University of Toronto.

       Syntax highlighting patterns and smart indent macros were contributed by: Simon T.
       MacDonald,  Maurice Leysens, Matt Majka, Alfred Smeenk, Alain Fargues, Christopher Conrad,
       Scott Markinson, Konrad Bernloehr, Ivan Herman, Patrice Venant, Christian Denat, Philippe
       Couton, Max Vohlken, Markus Schwarzenberg, Himanshu Gohel, Steven C. Kapp, Michael
       Turomsha, John Fieber, Chris Ross, Nathaniel Gray, Joachim Lous, Mike Duigou, Seak Teng-
       Fong, Joor Loohuis, Mark Jones, and Niek van den Berg.

COPYRIGHT

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       In addition, as a special exception to the GNU GPL, the copyright holders give permission
       to link the code of this program with the Motif and Open Motif libraries (or with modified
       versions of these that use the same license), and distribute linked combinations including
       the two. You must obey the GNU General Public License in all respects for all of the code
       used other than linking with Motif/Open Motif. If you modify this file, you may extend
       this exception to your version of the file, but you are not obligated to do so. If you do
       not wish to do so, delete this exception statement from your version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License in the Help section "Distribution Policy" for more
       details.