| tcsh.man (69408) | tcsh.man (83098) |
|---|---|
| 1.\" Copyright (c) 1980, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 62 unchanged lines hidden (view full) --- 71.\" new features in NEW FEATURES and referenced external commands in SEE 72.\" ALSO. 73.\" 74.\" - tcsh.man2html depends heavily on the specific nroff commands used in the 75.\" man page when the script was written. Please stick closely to the style 76.\" used here if you can. In particular, please don't use nroff commands 77.\" which aren't already used herein. 78.\" | 1.\" Copyright (c) 1980, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 62 unchanged lines hidden (view full) --- 71.\" new features in NEW FEATURES and referenced external commands in SEE 72.\" ALSO. 73.\" 74.\" - tcsh.man2html depends heavily on the specific nroff commands used in the 75.\" man page when the script was written. Please stick closely to the style 76.\" used here if you can. In particular, please don't use nroff commands 77.\" which aren't already used herein. 78.\" |
| 79.TH TCSH 1 "19 November 2000" "Astron 6.10.00" | 79.TH TCSH 1 "2 September 2001" "Astron 6.11.00" |
| 80.SH NAME 81tcsh \- C shell with file name completion and command line editing 82.SH SYNOPSIS 83.B tcsh \fR[\fB\-bcdefFimnqstvVxX\fR] [\fB\-Dname\fR[\fB=value\fR]] [arg ...] 84.br 85.B tcsh \-l 86.SH DESCRIPTION 87\fItcsh\fR is an enhanced but completely compatible version of the Berkeley --- 115 unchanged lines hidden (view full) --- 203The shell may read \fI/etc/csh.login\fR before instead of after 204\fI/etc/csh.cshrc\fR, and \fI~/.login\fR before instead of after 205\fI~/.tcshrc\fR or \fI~/.cshrc\fR and \fI~/.history\fR, if so compiled; 206see the \fBversion\fR shell variable. (+) 207.PP 208Non-login shells read only \fI/etc/csh.cshrc\fR and \fI~/.tcshrc\fR 209or \fI~/.cshrc\fR on startup. 210.PP | 80.SH NAME 81tcsh \- C shell with file name completion and command line editing 82.SH SYNOPSIS 83.B tcsh \fR[\fB\-bcdefFimnqstvVxX\fR] [\fB\-Dname\fR[\fB=value\fR]] [arg ...] 84.br 85.B tcsh \-l 86.SH DESCRIPTION 87\fItcsh\fR is an enhanced but completely compatible version of the Berkeley --- 115 unchanged lines hidden (view full) --- 203The shell may read \fI/etc/csh.login\fR before instead of after 204\fI/etc/csh.cshrc\fR, and \fI~/.login\fR before instead of after 205\fI~/.tcshrc\fR or \fI~/.cshrc\fR and \fI~/.history\fR, if so compiled; 206see the \fBversion\fR shell variable. (+) 207.PP 208Non-login shells read only \fI/etc/csh.cshrc\fR and \fI~/.tcshrc\fR 209or \fI~/.cshrc\fR on startup. 210.PP |
| 211For examples of startup files, please consult 212\fIhttp://tcshrc.sourceforge.net\fR. 213.PP |
|
| 211Commands like \fIstty\fR(1) and \fItset\fR(1), 212which need be run only once per login, usually go in one's \fI~/.login\fR file. 213Users who need to use the same set of files with both \fIcsh\fR(1) and 214\fItcsh\fR can have only a \fI~/.cshrc\fR which checks for the existence of the 215\fBtcsh\fR shell variable (q.v.) before using \fItcsh\fR-specific commands, 216or can have both a \fI~/.cshrc\fR and a \fI~/.tcshrc\fR which \fIsource\fRs 217(see the builtin command) \fI~/.cshrc\fR. 218The rest of this manual uses `\fI~/.tcshrc\fR' to mean `\fI~/.tcshrc\fR or, --- 1658 unchanged lines hidden (view full) --- 1877There are various ways to run commands and take other actions automatically 1878at various times in the ``life cycle'' of the shell. They are summarized here, 1879and described in detail under the appropriate \fBBuiltin commands\fR, 1880\fBSpecial shell variables\fR and \fBSpecial aliases\fR. 1881.PP 1882The \fIsched\fR builtin command puts commands in a scheduled-event list, 1883to be executed by the shell at a given time. 1884.PP | 214Commands like \fIstty\fR(1) and \fItset\fR(1), 215which need be run only once per login, usually go in one's \fI~/.login\fR file. 216Users who need to use the same set of files with both \fIcsh\fR(1) and 217\fItcsh\fR can have only a \fI~/.cshrc\fR which checks for the existence of the 218\fBtcsh\fR shell variable (q.v.) before using \fItcsh\fR-specific commands, 219or can have both a \fI~/.cshrc\fR and a \fI~/.tcshrc\fR which \fIsource\fRs 220(see the builtin command) \fI~/.cshrc\fR. 221The rest of this manual uses `\fI~/.tcshrc\fR' to mean `\fI~/.tcshrc\fR or, --- 1658 unchanged lines hidden (view full) --- 1880There are various ways to run commands and take other actions automatically 1881at various times in the ``life cycle'' of the shell. They are summarized here, 1882and described in detail under the appropriate \fBBuiltin commands\fR, 1883\fBSpecial shell variables\fR and \fBSpecial aliases\fR. 1884.PP 1885The \fIsched\fR builtin command puts commands in a scheduled-event list, 1886to be executed by the shell at a given time. 1887.PP |
| 1885The \fIbeepcmd\fR, \fIcwdcmd\fR, \fIperiodic\fR, \fIprecmd\fR, and \fIpostcmd\fR | 1888The \fIbeepcmd\fR, \fIcwdcmd\fR, \fIperiodic\fR, \fIprecmd\fR, \fIpostcmd\fR, 1889and \fIjobcmd\fR |
| 1886\fBSpecial aliases\fR can be set, respectively, to execute commands when the shell wants 1887to ring the bell, when the working directory changes, every \fBtperiod\fR | 1890\fBSpecial aliases\fR can be set, respectively, to execute commands when the shell wants 1891to ring the bell, when the working directory changes, every \fBtperiod\fR |
| 1888minutes, before each prompt, and before each command gets executed. | 1892minutes, before each prompt, before each command gets executed, after each 1893command gets executed, and when a job is started or is brought into the 1894foreground. |
| 1889.PP 1890The \fBautologout\fR shell variable can be set to log out or lock the shell 1891after a given number of minutes of inactivity. 1892.PP 1893The \fBmail\fR shell variable can be set to check for new mail periodically. 1894.PP 1895The \fBprintexitvalue\fR shell variable can be set to print the exit status 1896of commands which exit with a status other than zero. --- 946 unchanged lines hidden (view full) --- 2843Adds each \fIshared-library\fR to the current environment. There is no way 2844to remove a shared library. (Domain/OS only) 2845.TP 8 2846.B jobs \fR[\fB\-l\fR] 2847Lists the active jobs. With \fB\-l\fR, lists process 2848IDs in addition to the normal information. On TCF systems, prints 2849the site on which each job is executing. 2850.PP | 1895.PP 1896The \fBautologout\fR shell variable can be set to log out or lock the shell 1897after a given number of minutes of inactivity. 1898.PP 1899The \fBmail\fR shell variable can be set to check for new mail periodically. 1900.PP 1901The \fBprintexitvalue\fR shell variable can be set to print the exit status 1902of commands which exit with a status other than zero. --- 946 unchanged lines hidden (view full) --- 2849Adds each \fIshared-library\fR to the current environment. There is no way 2850to remove a shared library. (Domain/OS only) 2851.TP 8 2852.B jobs \fR[\fB\-l\fR] 2853Lists the active jobs. With \fB\-l\fR, lists process 2854IDs in addition to the normal information. On TCF systems, prints 2855the site on which each job is executing. 2856.PP |
| 2851.B kill \fR[\fB\-\fIsignal\fR] \fB%\fIjob\fR|\fIpid\fR ... | |
| 2852.PD 0 2853.TP 8 | 2857.PD 0 2858.TP 8 |
| 2859.B kill \fR[\fB\-s \fIsignal\fR] \fB%\fIjob\fR|\fIpid\fR ... 2860.PD 0 2861.TP 8 |
|
| 2854.B kill \-l | 2862.B kill \-l |
| 2855The first form sends the specified \fIsignal\fR (or, if none is given, 2856the TERM (terminate) signal) to the specified jobs or processes. | 2863The first and second forms sends the specified \fIsignal\fR (or, if none 2864is given, the TERM (terminate) signal) to the specified jobs or processes. |
| 2857\fIjob\fR may be a number, a string, `', `%', `+' or `\-' as described 2858under \fBJobs\fR. 2859Signals are either given by number or by name (as given in 2860\fI/usr/include/signal.h\fR, stripped of the prefix `SIG'). 2861There is no default \fIjob\fR; saying just `kill' does not send a signal 2862to the current job. If the signal being sent is TERM (terminate) 2863or HUP (hangup), then the job or process is sent a 2864CONT (continue) signal as well. | 2865\fIjob\fR may be a number, a string, `', `%', `+' or `\-' as described 2866under \fBJobs\fR. 2867Signals are either given by number or by name (as given in 2868\fI/usr/include/signal.h\fR, stripped of the prefix `SIG'). 2869There is no default \fIjob\fR; saying just `kill' does not send a signal 2870to the current job. If the signal being sent is TERM (terminate) 2871or HUP (hangup), then the job or process is sent a 2872CONT (continue) signal as well. |
| 2865The second form lists the signal names. | 2873The third form lists the signal names. |
| 2866.PD 2867.ig \" Obsolete tcsh command 2868.TP 8 2869.B linedit \fR(+) 2870A synonym for the \fIecho\fR builtin command. 2871.. 2872.TP 8 2873.B limit \fR[\fB\-h\fR] [\fIresource\fR [\fImaximum-use\fR]] --- 544 unchanged lines hidden (view full) --- 3418This will put the hostname and working directory on the title bar but 3419only the hostname in the icon manager menu. 3420.PP 3421Note that putting a \fIcd\fR, \fIpushd\fR or \fIpopd\fR in \fIcwdcmd\fR 3422may cause an infinite loop. It is the author's opinion that anyone doing 3423so will get what they deserve. 3424.RE 3425.TP 8 | 2874.PD 2875.ig \" Obsolete tcsh command 2876.TP 8 2877.B linedit \fR(+) 2878A synonym for the \fIecho\fR builtin command. 2879.. 2880.TP 8 2881.B limit \fR[\fB\-h\fR] [\fIresource\fR [\fImaximum-use\fR]] --- 544 unchanged lines hidden (view full) --- 3426This will put the hostname and working directory on the title bar but 3427only the hostname in the icon manager menu. 3428.PP 3429Note that putting a \fIcd\fR, \fIpushd\fR or \fIpopd\fR in \fIcwdcmd\fR 3430may cause an infinite loop. It is the author's opinion that anyone doing 3431so will get what they deserve. 3432.RE 3433.TP 8 |
| 3434.B jobcmd 3435Runs before each command gets executed, or when the command changes state. 3436This is similar to \fIpostcmd\fR, but it does not print builtins. 3437.RS +8 3438.IP "" 4 3439> alias jobcmd 'echo \-n "^[]2\e;\e!#^G"' 3440.PP 3441then executing \fIvi foo.c\fR will put the command string in the xterm title bar. 3442.RE 3443.TP 8 |
|
| 3426.B helpcommand 3427Invoked by the \fBrun-help\fR editor command. The command name for which help 3428is sought is passed as sole argument. 3429For example, if one does 3430.RS +8 3431.IP "" 4 3432> alias helpcommand '\e!:1 --help' 3433.PP --- 176 unchanged lines hidden (view full) --- 3610directory stack substitutions, etc. 3611One can change the stack arbitrarily by setting \fBdirstack\fR, 3612but the first element (the current working directory) is always correct. 3613See also the \fBcwd\fR and \fBowd\fR shell variables. 3614.TP 8 3615.B dspmbyte \fR(+) 3616If set to `euc', it enables display and editing EUC-kanji(Japanese) code. 3617If set to `sjis', it enables display and editing Shift-JIS(Japanese) code. | 3444.B helpcommand 3445Invoked by the \fBrun-help\fR editor command. The command name for which help 3446is sought is passed as sole argument. 3447For example, if one does 3448.RS +8 3449.IP "" 4 3450> alias helpcommand '\e!:1 --help' 3451.PP --- 176 unchanged lines hidden (view full) --- 3628directory stack substitutions, etc. 3629One can change the stack arbitrarily by setting \fBdirstack\fR, 3630but the first element (the current working directory) is always correct. 3631See also the \fBcwd\fR and \fBowd\fR shell variables. 3632.TP 8 3633.B dspmbyte \fR(+) 3634If set to `euc', it enables display and editing EUC-kanji(Japanese) code. 3635If set to `sjis', it enables display and editing Shift-JIS(Japanese) code. |
| 3636If set to `big5', it enables display and editing Big5(Chinese) code. |
|
| 3618If set to the following format, it enables display and editing of original 3619multi-byte code format: 3620.RS +8 3621.IP "" 4 3622> set dspmbyte = 0000....(256 bytes)....0000 3623.PP 3624The table requires \fBjust\fR 256 bytes. Each character of 256 characters 3625corresponds (from left to right) to the ASCII codes 0x00, 0x01, ... 0xff. Each --- 149 unchanged lines hidden (view full) --- 3775with more than one word. Changing directory takes precedence over 3776executing a like-named command, but it is done after alias 3777substitutions. Tilde and variable expansions work as expected. 3778.TP 8 3779.B inputmode \fR(+) 3780If set to `insert' or `overwrite', puts the editor into that input mode 3781at the beginning of each line. 3782.TP 8 | 3637If set to the following format, it enables display and editing of original 3638multi-byte code format: 3639.RS +8 3640.IP "" 4 3641> set dspmbyte = 0000....(256 bytes)....0000 3642.PP 3643The table requires \fBjust\fR 256 bytes. Each character of 256 characters 3644corresponds (from left to right) to the ASCII codes 0x00, 0x01, ... 0xff. Each --- 149 unchanged lines hidden (view full) --- 3794with more than one word. Changing directory takes precedence over 3795executing a like-named command, but it is done after alias 3796substitutions. Tilde and variable expansions work as expected. 3797.TP 8 3798.B inputmode \fR(+) 3799If set to `insert' or `overwrite', puts the editor into that input mode 3800at the beginning of each line. 3801.TP 8 |
| 3802.B killdup \fR(+) 3803Controls handling of duplicate entries in the kill ring. If set to 3804`all' only unique strings are entered in the kill ring. If set to 3805`prev' and the last killed string is the same as the current killed 3806string, then the current string is not entered in the ring. If set 3807to `erase' and the same string is found in the kill ring, the old 3808string is erased and the current one is inserted. 3809.TP 8 3810.B killring \fR(+) 3811Indicates the number of killed strings to keep in memory. Set to `30' 3812by default. If unset or set to less than `2', the shell will only 3813keep the most recently killed string. 3814.TP 8 |
|
| 3783.B listflags \fR(+) 3784If set to `x', `a' or `A', or any combination thereof (e.g., `xA'), they 3785are used as flags to \fIls\-F\fR, making it act like `ls \-xF', `ls 3786\-Fa', `ls \-FA' or a combination (e.g., `ls \-FxA'): `a' shows all 3787files (even if they start with a `.'), `A' shows all files but `.' and 3788`..', and `x' sorts across instead of down. If the second word of 3789\fBlistflags\fR is set, it is used as the path to `ls(1)'. 3790.TP 8 --- 371 unchanged lines hidden (view full) --- 4162editor command \fInormalize-path\fR (bound by default to ^X-n) when necessary. 4163.PP 4164Some examples are in order. First, let's set up some play directories: 4165.IP "" 4 4166> cd /tmp 4167.br 4168> mkdir from from/src to 4169.br | 3815.B listflags \fR(+) 3816If set to `x', `a' or `A', or any combination thereof (e.g., `xA'), they 3817are used as flags to \fIls\-F\fR, making it act like `ls \-xF', `ls 3818\-Fa', `ls \-FA' or a combination (e.g., `ls \-FxA'): `a' shows all 3819files (even if they start with a `.'), `A' shows all files but `.' and 3820`..', and `x' sorts across instead of down. If the second word of 3821\fBlistflags\fR is set, it is used as the path to `ls(1)'. 3822.TP 8 --- 371 unchanged lines hidden (view full) --- 4194editor command \fInormalize-path\fR (bound by default to ^X-n) when necessary. 4195.PP 4196Some examples are in order. First, let's set up some play directories: 4197.IP "" 4 4198> cd /tmp 4199.br 4200> mkdir from from/src to 4201.br |
| 4170> ln \-s from/src to/dist | 4202> ln \-s from/src to/dst |
| 4171.PP 4172Here's the behavior with \fBsymlinks\fR unset, 4173.IP "" 4 | 4203.PP 4204Here's the behavior with \fBsymlinks\fR unset, 4205.IP "" 4 |
| 4174> cd /tmp/to/dist; echo $cwd | 4206> cd /tmp/to/dst; echo $cwd |
| 4175.br | 4207.br |
| 4176/tmp/to/dist | 4208/tmp/to/dst |
| 4177.br 4178> cd ..; echo $cwd 4179.br 4180/tmp/from 4181.PP 4182here's the behavior with \fBsymlinks\fR set to `chase', 4183.IP "" 4 4184> cd /tmp/to/dst; echo $cwd 4185.br 4186/tmp/from/src 4187.br 4188> cd ..; echo $cwd 4189.br 4190/tmp/from 4191.PP 4192here's the behavior with \fBsymlinks\fR set to `ignore', 4193.IP "" 4 | 4209.br 4210> cd ..; echo $cwd 4211.br 4212/tmp/from 4213.PP 4214here's the behavior with \fBsymlinks\fR set to `chase', 4215.IP "" 4 4216> cd /tmp/to/dst; echo $cwd 4217.br 4218/tmp/from/src 4219.br 4220> cd ..; echo $cwd 4221.br 4222/tmp/from 4223.PP 4224here's the behavior with \fBsymlinks\fR set to `ignore', 4225.IP "" 4 |
| 4194> cd /tmp/to/dist; echo $cwd | 4226> cd /tmp/to/dst; echo $cwd |
| 4195.br 4196/tmp/to/dst 4197.br 4198> cd ..; echo $cwd 4199.br 4200/tmp/to 4201.PP 4202and here's the behavior with \fBsymlinks\fR set to `expand'. 4203.IP "" 4 | 4227.br 4228/tmp/to/dst 4229.br 4230> cd ..; echo $cwd 4231.br 4232/tmp/to 4233.PP 4234and here's the behavior with \fBsymlinks\fR set to `expand'. 4235.IP "" 4 |
| 4204> cd /tmp/to/dist; echo $cwd | 4236> cd /tmp/to/dst; echo $cwd |
| 4205.br 4206/tmp/to/dst 4207.br 4208> cd ..; echo $cwd 4209.br 4210/tmp/to 4211.br | 4237.br 4238/tmp/to/dst 4239.br 4240> cd ..; echo $cwd 4241.br 4242/tmp/to 4243.br |
| 4212> cd /tmp/to/dist; echo $cwd | 4244> cd /tmp/to/dst; echo $cwd |
| 4213.br 4214/tmp/to/dst 4215.br 4216> cd ".."; echo $cwd 4217.br 4218/tmp/from 4219.br 4220> /bin/echo .. --- 743 unchanged lines hidden (view full) --- 4964substitutions on a single line to 20. 4965.SH "SEE ALSO" 4966csh(1), emacs(1), ls(1), newgrp(1), sh(1), setpath(1), stty(1), su(1), 4967tset(1), vi(1), x(1), access(2), execve(2), fork(2), killpg(2), 4968pipe(2), setrlimit(2), sigvec(2), stat(2), umask(2), vfork(2), wait(2), 4969malloc(3), setlocale(3), tty(4), a.out(5), termcap(5), environ(7), 4970termio(7), Introduction to the C Shell 4971.SH VERSION | 4245.br 4246/tmp/to/dst 4247.br 4248> cd ".."; echo $cwd 4249.br 4250/tmp/from 4251.br 4252> /bin/echo .. --- 743 unchanged lines hidden (view full) --- 4996substitutions on a single line to 20. 4997.SH "SEE ALSO" 4998csh(1), emacs(1), ls(1), newgrp(1), sh(1), setpath(1), stty(1), su(1), 4999tset(1), vi(1), x(1), access(2), execve(2), fork(2), killpg(2), 5000pipe(2), setrlimit(2), sigvec(2), stat(2), umask(2), vfork(2), wait(2), 5001malloc(3), setlocale(3), tty(4), a.out(5), termcap(5), environ(7), 5002termio(7), Introduction to the C Shell 5003.SH VERSION |
| 4972This manual documents tcsh 6.10.00 (Astron) 2000-11-19. | 5004This manual documents tcsh 6.11.00 (Astron) 2001-09-02. |
| 4973.SH AUTHORS 4974.PD 0 4975.TP 2 4976William Joy 4977Original author of \fIcsh\fR(1) 4978.TP 2 4979J.E. Kulp, IIASA, Laxenburg, Austria 4980Job control and directory stack features --- 168 unchanged lines hidden --- | 5005.SH AUTHORS 5006.PD 0 5007.TP 2 5008William Joy 5009Original author of \fIcsh\fR(1) 5010.TP 2 5011J.E. Kulp, IIASA, Laxenburg, Austria 5012Job control and directory stack features --- 168 unchanged lines hidden --- |