Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 develop-
     ment environments, mailers, and other programs; or just as a quick way to
     open files from the shell command line without starting a new NEdit ses-
     sion.

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 geome-
	 try 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 ma-
	 chine, 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 af-
	 fects 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 environ-
	 ment 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 ma-
     chines 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, Alexan-
     der 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 un-
     der 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 li-
     cense), 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 oblig-
     ated 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 FIT-
     NESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License in the
     Help section "Distribution Policy" for more details.

NEdit release of		   2026-04-28				   NC(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nclient&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help