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] [-h | -help] [--] [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
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 specifically 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:
[<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
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 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
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 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.
-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:
% 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 `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.
In FreeBSD, nc is installed as nclient so it does not conflict with the
netcat port which also installs an nc.
SEE ALSOnedit(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.
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.
5.6 2014-12-28 NC(1)
