|
1 --- tcsh-6.19.00/tcsh.man.orig Tue May 26 12:16:43 2015 |
|
2 +++ tcsh-6.19.00/tcsh.man Tue May 26 12:16:55 2015 |
|
3 @@ -77,6 +77,9 @@ |
|
4 .\" used here if you can. In particular, please don't use nroff commands |
|
5 .\" which aren't already used herein. |
|
6 .\" |
|
7 +.\" modified to reference existing Solaris man pages, to add the Solaris |
|
8 +.\" stability classification, and to add a note about source availability. |
|
9 +.\" |
|
10 .TH TCSH 1 "21 May 2015" "Astron 6.19.00" |
|
11 .SH NAME |
|
12 tcsh \- C shell with file name completion and command line editing |
|
13 @@ -151,7 +154,7 @@ |
|
14 .TP 4 |
|
15 .B \-m |
|
16 The shell loads \fI~/.tcshrc\fR even if it does not belong to the effective |
|
17 -user. Newer versions of \fIsu\fR(1) can pass \fB\-m\fR to the shell. (+) |
|
18 +user. Newer versions of \fIsu\fR(8) can pass \fB\-m\fR to the shell. (+) |
|
19 .TP 4 |
|
20 .B \-n |
|
21 The shell parses commands but does not execute them. |
|
22 @@ -202,7 +205,7 @@ |
|
23 Remaining arguments are placed in the \fBargv\fR shell variable. |
|
24 .SS "Startup and shutdown" |
|
25 A login shell begins by executing commands from the system files |
|
26 -\fI/etc/csh.cshrc\fR and \fI/etc/csh.login\fR. |
|
27 +\fI/etc/.cshrc\fR and \fI/etc/.login\fR. |
|
28 It then executes commands from files in the user's \fBhome\fR directory: |
|
29 first \fI~/.tcshrc\fR (+) |
|
30 or, if \fI~/.tcshrc\fR is not found, \fI~/.cshrc\fR, |
|
31 @@ -210,17 +213,17 @@ |
|
32 then \fI~/.login\fR, |
|
33 and finally \fI~/.cshdirs\fR (or the value of the \fBdirsfile\fR shell variable) (+). |
|
34 The shell may read \fI/etc/csh.login\fR before instead of after |
|
35 -\fI/etc/csh.cshrc\fR, and \fI~/.login\fR before instead of after |
|
36 +\fI/etc/.cshrc\fR, and \fI~/.login\fR before instead of after |
|
37 \fI~/.tcshrc\fR or \fI~/.cshrc\fR and \fI~/.history\fR, if so compiled; |
|
38 see the \fBversion\fR shell variable. (+) |
|
39 .PP |
|
40 -Non-login shells read only \fI/etc/csh.cshrc\fR and \fI~/.tcshrc\fR |
|
41 +Non-login shells read only \fI/etc/.cshrc\fR and \fI~/.tcshrc\fR |
|
42 or \fI~/.cshrc\fR on startup. |
|
43 .PP |
|
44 For examples of startup files, please consult |
|
45 \fIhttp://tcshrc.sourceforge.net\fR. |
|
46 .PP |
|
47 -Commands like \fIstty\fR(1) and \fItset\fR(1), |
|
48 +Commands like \fIstty\fR(1) and \fItset\fR(1B), |
|
49 which need be run only once per login, usually go in one's \fI~/.login\fR file. |
|
50 Users who need to use the same set of files with both \fIcsh\fR(1) and |
|
51 \fItcsh\fR can have only a \fI~/.cshrc\fR which checks for the existence of the |
|
52 @@ -1974,7 +1977,7 @@ |
|
53 and changing the \fBLANG\fR or \fBLC_CTYPE\fR environment variables |
|
54 causes a check for possible changes in these respects. |
|
55 .PP |
|
56 -When using the system's NLS, the \fIsetlocale\fR(3) function is called |
|
57 +When using the system's NLS, the \fIsetlocale\fR(3C) function is called |
|
58 to determine appropriate character code/classification and sorting |
|
59 (e.g., a 'en_CA.UTF-8' would yield "UTF-8" as a character code). |
|
60 This function typically examines the \fBLANG\fR and \fBLC_CTYPE\fR |
|
61 @@ -2672,7 +2675,7 @@ |
|
62 sequences of the BSD and/or System V versions of \fIecho\fR; see \fIecho\fR(1). |
|
63 .TP 8 |
|
64 .B echotc \fR[\fB\-sv\fR] \fIarg\fR ... (+) |
|
65 -Exercises the terminal capabilities (see \fItermcap\fR(5)) in \fIargs\fR. |
|
66 +Exercises the terminal capabilities (see \fIterminfo\fR(5)) in \fIargs\fR. |
|
67 For example, 'echotc home' sends the cursor to the home position, |
|
68 \&'echotc cm 3 10' sends it to column 3 and row 10, and |
|
69 \&'echotc ts 0; echo "This is a test."; echotc fs' prints "This is a test." |
|
70 @@ -2723,7 +2726,7 @@ |
|
71 of the current shell. This is usually used to execute commands |
|
72 generated as the result of command or variable substitution, |
|
73 because parsing occurs before these substitutions. |
|
74 -See \fItset\fR(1) for a sample use of \fIeval\fR. |
|
75 +See \fItset\fR(1B) for a sample use of \fIeval\fR. |
|
76 .TP 8 |
|
77 .B exec \fIcommand\fR |
|
78 Executes the specified command in place of the current shell. |
|
79 @@ -3331,7 +3334,7 @@ |
|
80 .TP 8 |
|
81 .B settc \fIcap value \fR(+) |
|
82 Tells the shell to believe that the terminal capability \fIcap\fR |
|
83 -(as defined in \fItermcap\fR(5)) has the value \fIvalue\fR. |
|
84 +(as defined in \fIterminfo\fR(5)) has the value \fIvalue\fR. |
|
85 No sanity checking is done. |
|
86 Concept terminal users may have to `settc xn no' to get proper |
|
87 wrapping at the rightmost column. |
|
88 @@ -3384,7 +3387,7 @@ |
|
89 .B suspend |
|
90 Causes the shell to stop in its tracks, much as if it had |
|
91 been sent a stop signal with \fB^Z\fR. This is most often used to |
|
92 -stop shells started by \fIsu\fR(1). |
|
93 +stop shells started by \fIsu\fR(8). |
|
94 .PP |
|
95 .B switch (\fIstring\fB) |
|
96 .br |
|
97 @@ -3418,12 +3421,12 @@ |
|
98 .PD |
|
99 .TP 8 |
|
100 .B telltc \fR(+) |
|
101 -Lists the values of all terminal capabilities (see \fItermcap\fR(5)). |
|
102 +Lists the values of all terminal capabilities (see \fIterminfo\fR(5)). |
|
103 .TP 8 |
|
104 .B termname \fR[\fIterminal type\fR] \fR(+) |
|
105 Tests if \fIterminal type\fR (or the current value of \fBTERM\fR if no |
|
106 -\fIterminal type\fR is given) has an entry in the hosts termcap(5) or |
|
107 -terminfo(5) database. Prints the terminal type to stdout and returns 0 |
|
108 +\fIterminal type\fR is given) has an entry in the hosts |
|
109 +terminfo(5) database. Prints the terminal type to stdout and returns 0 |
|
110 if an entry is present otherwise returns 1. |
|
111 .TP 8 |
|
112 .B time \fR[\fIcommand\fR] |
|
113 @@ -4655,8 +4658,8 @@ |
|
114 The system's NLS is used; default for systems with NLS |
|
115 .TP 6 |
|
116 lf |
|
117 -Login shells execute \fI/etc/csh.login\fR before instead of after |
|
118 -\fI/etc/csh.cshrc\fR and \fI~/.login\fR before instead of after |
|
119 +Login shells execute \fI/etc/.login\fR before instead of after |
|
120 +\fI/etc/.cshrc\fR and \fI~/.login\fR before instead of after |
|
121 \fI~/.tcshrc\fR and \fI~/.history\fR. |
|
122 .TP 6 |
|
123 dl |
|
124 @@ -4683,7 +4686,7 @@ |
|
125 unless the \fBnokanji\fR shell variable is set |
|
126 .TP 6 |
|
127 sm |
|
128 -The system's \fImalloc\fR(3) is used |
|
129 +The system's \fImalloc\fR(3C) is used |
|
130 .TP 6 |
|
131 hb |
|
132 The `#!<program> <args>' convention is emulated when executing shell scripts |
|
133 @@ -4760,7 +4763,8 @@ |
|
134 .PD |
|
135 .PP |
|
136 %M and %m are available on only systems that store the remote hostname in |
|
137 -\fI/etc/utmp\fR. |
|
138 +\fI/etc/utmp\fR or |
|
139 +\fI/etc/utmpx\fR. |
|
140 If unset, `%n has %a %l from %m.' is used, or `%n has %a %l.' on systems |
|
141 which don't store the remote hostname. |
|
142 .RE |
|
143 @@ -4778,7 +4782,7 @@ |
|
144 The number of columns in the terminal. See \fBTerminal management\fR. |
|
145 .TP 8 |
|
146 .B DISPLAY |
|
147 -Used by X Window System (see \fIX\fR(1)). |
|
148 +Used by X Window System (see \fIX\fR(7)). |
|
149 If set, the shell does not set \fBautologout\fR (q.v.). |
|
150 .TP 8 |
|
151 .B EDITOR |
|
152 @@ -4794,7 +4798,7 @@ |
|
153 .TP 8 |
|
154 .B HOST \fR(+) |
|
155 Initialized to the name of the machine on which the shell |
|
156 -is running, as determined by the \fIgethostname\fR(2) system call. |
|
157 +is running, as determined by the \fIgethostname\fR(3C) library call. |
|
158 .TP 8 |
|
159 .B HOSTTYPE \fR(+) |
|
160 Initialized to the type of machine on which the shell |
|
161 @@ -5031,7 +5035,7 @@ |
|
162 NeXTs use \fI/etc/cshrc.std\fR. |
|
163 A/UX, AMIX, Cray and IRIX have no equivalent in \fIcsh\fR(1), |
|
164 but read this file in \fItcsh\fR anyway. |
|
165 -Solaris 2.x does not have it either, but \fItcsh\fR reads \fI/etc/.cshrc\fR. (+) |
|
166 +Solaris 2.x does not have it either, but \fItcsh\fR reads \fI/etc/.cshrc\fR. |
|
167 .TP 16 |
|
168 .I /etc/csh.login |
|
169 Read by login shells after \fI/etc/csh.cshrc\fR. |
|
170 @@ -5237,11 +5241,11 @@ |
|
171 To detect looping, the shell restricts the number of \fIalias\fR |
|
172 substitutions on a single line to 20. |
|
173 .SH "SEE ALSO" |
|
174 -csh(1), emacs(1), ls(1), newgrp(1), sh(1), setpath(1), stty(1), su(1), |
|
175 -tset(1), vi(1), x(1), access(2), execve(2), fork(2), killpg(2), |
|
176 -pipe(2), setrlimit(2), sigvec(2), stat(2), umask(2), vfork(2), wait(2), |
|
177 -malloc(3), setlocale(3), tty(4), a.out(5), termcap(5), environ(7), |
|
178 -termio(7), Introduction to the C Shell |
|
179 +csh(1), emacs(1), ls(1), newgrp(1), sh(1), stty(1), su(8), |
|
180 +tset(1B), vi(1), X(7), access(2), execve(2), fork(2), killpg(3C), |
|
181 +pipe(2), setrlimit(2), sigvec(3UCB), stat(2), umask(2), vfork(2), wait(2), |
|
182 +malloc(3C), setlocale(3C), tty(7D), a.out(4), terminfo(5), environ(5), |
|
183 +termio(7I), Introduction to the C Shell |
|
184 .SH VERSION |
|
185 This manual documents tcsh 6.19.00 (Astron) 2015-05-21. |
|
186 .SH AUTHORS |
|
187 @@ -5420,3 +5424,9 @@ |
|
188 reporting bugs in, and suggesting new additions to each and every version |
|
189 .PP |
|
190 Richard M. Alderson III, for writing the `T in tcsh' section |
|
191 + |
|
192 +.SH "NOTES" |
|
193 +.PP |
|
194 +It is no longer possible for variables to have a '-' or a '=' within the |
|
195 +name. Any variables of this form will generate a 'setenv: Syntax error' |
|
196 +error message. |