NC(1)                  NEdit documentation                  NC(1)



NAME
       nc - Client program for NEdit text editor

SYNOPSYS
       nc [-read] [-create] [-line n | +n] [-do command]
          [-ask] [-noask] [-svrname name] [-svrcmd command]
          [-lm languagemode]
          [-geometry geometry | -g geometry] [-icon | -iconic]
          [-display [host]:server[.screen]]
          [-timeout seconds] [-wait] [-xrm resourcestring]
          [-tabbed] [-untabbed] [-group]
          [-V | -version] [--] [file...]

DESCRIPTION
       nc is the client interface to the NEdit text editor. A
       server can be started explicitly by running NEdit in
       server mode:

        nedit -server

       If no server is running, nc will start one unless config-
       ured otherwise.  Client/server mode is useful for inte-
       grating NEdit with software development environments,
       mailers, and other programs; or just as a quick way to
       open files from the shell command line without starting a
       new NEdit session.

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.

       -do command
           Execute an NEdit macro or action on the file following
           the -do argument on the command line.

           If you use this command without a filename, nc would
           randomly choose one window to focus and execute the
           macro in.

       -ask, -noask
           Instructs nc whether to automatically start a server
           if one is not available. This overrides the X resource
           `nc.autoStart'.

       -svrname name
           Explicitly instructs nc which server to connect to, an
           instance of nedit(1) with a corresponding -svrname
           argument.  By naming servers, you can run several
           simultaneously, and direct files and commands specifi-
           cally to any one.

       -svrcmd command
           The command which nc uses to start an NEdit server. It
           is also settable via the X resource
           `nc.serverCommand', by default, "nedit -server".

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

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

             [x][+|-][[+|-]]

           where `' and `' are the desired width
           and height of the window, and `' and `' 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.

       -icon, -iconic
           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.

       -timeout seconds
           Basic time-out period (in seconds) used in communica-
           tion with an NEdit server.  Default: 10 seconds. Also
           settable via the X resource `nc.timeOut'.

           Under rare conditions (such as a slow connection), it
           may be necessary to increase the time-out period. In
           most cases, the default is fine.

       -wait
           Instructs nc not to return to the shell until all
           files given are closed.

           Normally, nc returns once the files given in its com-
           mand line are opened by the server. When this option
           is given, nc returns only after the last file given in
           this call is closed.  Note that this option affects
           all files, not only the ones following this option in
           the command line.

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

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

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

               % setenv DISPLAY devicename:0

NOTES
       Communication between nc(1) and nedit(1) is through the X
       display. So as long as X windows is set up and working
       properly, nc will work properly as well. nc uses the `DIS-
       PLAY' environment variable, the machine name and your user
       name to find the appropriate server, meaning, if you have
       several machines sharing a common file system, nc will not
       be able to find a server that is running on a machine with
       a different host name, even though it may be perfectly
       appropriate for editing a given file.

       In typical Unix style, arguments affect the files which
       follow them on the command line, for example:

       incorrect:
             nc file.c -line 25

       correct:
             nc -line 25 file.c

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

SEE ALSO
       nedit(1), X(1), mwm(1), ctags(1), etags(1)

AUTHORS
       NEdit was written by Mark Edel, Joy Kyriakopulos, Christo-
       pher 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.

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 excep-
       tion to your version of the file, but you are not obli-
       gated 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.



NEdit 5.5                   2004-07-21                      NC(1)