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] [-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 configured otherwise.
       Client/server mode is useful for integrating NEdit with software devel-
       opment 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. Note that other files mentioned in
           the command line are not affected.

           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 specifically to any one.

       -svrcmd command
           The command which nc uses to start an NEdit server. It is also set-
           table 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:

             [(width)x(height)][+.”‚-][(xoffset)[+.”‚-](yoffset)]

           where `(width)` and `(height)` are the desired width and height of
           the window, and `(xoffset)` and `(yoffset)` are the distance from
           the edge of the screen to the window, + for top or left, - for bot-
           tom 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 communication 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 neces-
           sary 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 command 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.

       -V, -version
           Prints version and build information, to be mentioned when report-
           ing 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 prop-
       erly as well. nc uses the `DISPLAY` 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, 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, and Nathaniel Gray.

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.

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



3rd Berkeley Distribution          NEdit 5.4                             NC(1)