1NC(1) NEdit documentation NC(1)
2
6 nedit-client - Client program for NEdit text editor
7
9 nedit-client [-read] [-create] [-line n | +n] [-do command]
10 [-ask] [-noask] [-svrname name] [-svrcmd command]
11 [-lm languagemode]
12 [-geometry geometry | -g geometry] [-icon | -iconic]
13 [-display [host]:server[.screen]]
14 [-timeout seconds] [-wait] [-xrm resourcestring]
15 [-tabbed] [-untabbed] [-group]
16 [-V | -version] [-h | -help] [--] [file...]
17
19 nedit-client is the client interface to the NEdit text editor. A server
20 can be started explicitly by running NEdit in server mode:
21 nedit -server
23 If no server is running, nedit-client will start one unless configured
25 otherwise. Client/server mode is useful for integrating NEdit with
26 software development environments, mailers, and other programs; or just
27 as a quick way to open files from the shell command line without
28 starting a new NEdit session.
29
31 -read
32 Open the file read-only regardless of the actual file protection.
33 -create
35 Don't warn about file creation when a file doesn't exist.
36 -line n, +n
38 Go to line number n.
39 -do command
41 Execute an NEdit macro or action on the file following the -do
42 argument on the command line.
43 If you use this command without a filename, nedit-client would
45 randomly choose one window to focus and execute the macro in.
46 -ask, -noask
48 Instructs nedit-client whether to automatically start a server if
49 one is not available. This overrides the X resource `nc.autoStart'.
50 -svrname name
52 Explicitly instructs nedit-client which server to connect to, an
53 instance of nedit(1) with a corresponding -svrname argument. By
54 naming servers, you can run several simultaneously, and direct
55 files and commands specifically to any one.
56 -svrcmd command
58 The command which nedit-client uses to start an NEdit server. It is
59 also settable via the X resource `nc.serverCommand', by default,
60 "nedit -server".
61 -lm languagemode
63 Initial language mode used for editing succeeding files.
64 -geometry geometry, -g geometry
66 The initial size and/or location of editor windows. The argument
67 geometry has the form:
68 [<width>x<height>][+|-][<xoffset>[+|-]<yoffset>]
70 where `<width>' and `<height>' are the desired width and height of
72 the window, and `<xoffset>' and `<yoffset>' are the distance from
73 the edge of the screen to the window, + for top or left, - for
74 bottom or right. -geometry can be specified for individual files on
75 the command line.
76 -icon, -iconic
78 Initial window state for succeeding files.
79 -display [host]:server[.screen]
81 The name of the X server to use. host specifies the machine, server
82 specifies the display server number, and screen specifies the
83 screen number. host or screen can be omitted and default to the
84 local machine, and screen 0.
85 -timeout seconds
87 Basic time-out period (in seconds) used in communication with an
88 NEdit server. Default: 10 seconds. Also settable via the X
89 resource `nc.timeOut'.
90 Under rare conditions (such as a slow connection), it may be
92 necessary to increase the time-out period. In most cases, the
93 default is fine.
94 -wait
96 Instructs nedit-client not to return to the shell until all files
97 given are closed.
98 Normally, nedit-client returns once the files given in its command
100 line are opened by the server. When this option is given, nedit-
101 client returns only after the last file given in this call is
102 closed. Note that this option affects all files, not only the ones
103 following this option in the command line.
104 -xrm resourcestring
106 Set the value of an X resource to override a default value.
107 -tabbed
109 Open all subsequent files in new tabs. Resets -group option.
110 -untabbed
112 Open all subsequent files in new windows. Resets -group option.
113 -group
115 Open all subsequent files as tabs in a new window.
116 -V, -version
118 Prints version and build information, to be mentioned when
119 reporting bugs and problems.
120 -h, -help
122 Prints the command line help and then exits.
123 -- Treats all subsequent arguments as file names, even if they start
125 with a dash. This is so NEdit can access files that begin with the
126 dash character.
127
129 DISPLAY
130 NEdit requires an X-based workstation or X-Terminal. If you have
131 used telnet or rlogin to access the host Unix system, set the Unix
132 environment variable for your display:
133 % setenv DISPLAY devicename:0
135
137 Communication between nedit-client(1) and nedit(1) is through the X
138 display. So as long as X windows is set up and working properly, nedit-
139 client will work properly as well. nedit-client uses the `DISPLAY'
140 environment variable, the machine name and your user name to find the
141 appropriate server, meaning, if you have several machines sharing a
142 common file system, nedit-client will not be able to find a server that
143 is running on a machine with a different host name, even though it may
144 be perfectly appropriate for editing a given file.
145 In typical Unix style, arguments affect the files which follow them on
147 the command line, for example:
148 incorrect:
150 nedit-client file.c -line 25
151 correct:
153 nedit-client -line 25 file.c
154 For more information see NEdit's online help, or nedit.doc in the NEdit
156 distribution kit.
157
159 nedit(1), X(1), mwm(1), ctags(1), etags(1)
160
162 NEdit was written by Mark Edel, Joy Kyriakopulos, Christopher Conrad,
163 Jim Clark, Arnulfo Zepeda-Navratil, Suresh Ravoor, Tony Balinski, Max
164 Vohlken, Yunliang Yu, Donna Reid, Arne Forlie, Eddy De Greef, Steve
165 LoBasso, Alexander Mai, Scott Tringali, Thorsten Haude, Steve Haehn,
166 Andrew Hood, Nathaniel Gray, and TK Soh.
167
169 This program is free software; you can redistribute it and/or modify it
170 under the terms of the GNU General Public License as published by the
171 Free Software Foundation; either version 2 of the License, or (at your
172 option) any later version.
173 In addition, as a special exception to the GNU GPL, the copyright
175 holders give permission to link the code of this program with the Motif
176 and Open Motif libraries (or with modified versions of these that use
177 the same license), and distribute linked combinations including the
178 two. You must obey the GNU General Public License in all respects for
179 all of the code used other than linking with Motif/Open Motif. If you
180 modify this file, you may extend this exception to your version of the
181 file, but you are not obligated to do so. If you do not wish to do so,
182 delete this exception statement from your version.
183 This program is distributed in the hope that it will be useful, but
185 WITHOUT ANY WARRANTY; without even the implied warranty of
186 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
187 General Public License in the Help section "Distribution Policy" for
188 more details.
189NEdit 5.7 2023-07-20 NC(1)