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