1NC(1)                         NEdit documentation                        NC(1)
2
3
4

NAME

6       nedit-client - Client program for NEdit text editor
7

SYNOPSYS

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

DESCRIPTION

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
22        nedit -server
23
24       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

OPTIONS

31       -read
32           Open the file read-only regardless of the actual file protection.
33
34       -create
35           Don't warn about file creation when a file doesn't exist.
36
37       -line n, +n
38           Go to line number n.
39
40       -do command
41           Execute an NEdit macro or action on the file following the -do
42           argument on the command line.
43
44           If you use this command without a filename, nedit-client would
45           randomly choose one window to focus and execute the macro in.
46
47       -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
51       -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
57       -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
62       -lm languagemode
63           Initial language mode used for editing succeeding files.
64
65       -geometry geometry, -g geometry
66           The initial size and/or location of editor windows. The argument
67           geometry has the form:
68
69             [<width>x<height>][+|-][<xoffset>[+|-]<yoffset>]
70
71           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
77       -icon, -iconic
78           Initial window state for succeeding files.
79
80       -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
86       -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
91           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
95       -wait
96           Instructs nedit-client not to return to the shell until all files
97           given are closed.
98
99           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
105       -xrm resourcestring
106           Set the value of an X resource to override a default value.
107
108       -tabbed
109           Open all subsequent files in new tabs. Resets -group option.
110
111       -untabbed
112           Open all subsequent files in new windows. Resets -group option.
113
114       -group
115           Open all subsequent files as tabs in a new window.
116
117       -V, -version
118           Prints version and build information, to be mentioned when
119           reporting bugs and problems.
120
121       -h, -help
122           Prints the command line help and then exits.
123
124       --  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

ENVIRONMENT

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
134               % setenv DISPLAY devicename:0
135

NOTES

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
146       In typical Unix style, arguments affect the files which follow them on
147       the command line, for example:
148
149       incorrect:
150             nedit-client file.c -line 25
151
152       correct:
153             nedit-client -line 25 file.c
154
155       For more information see NEdit's online help, or nedit.doc in the NEdit
156       distribution kit.
157

SEE ALSO

159       nedit(1), X(1), mwm(1), ctags(1), etags(1)
160

AUTHORS

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
174       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
184       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.
189
190
191
192NEdit 5.7                         2023-07-20                             NC(1)
Impressum