source: postlfs/shells/tcsh.xml

trunk
Last change on this file was 6ae9cf9, checked in by Bruce Dubbs <bdubbs@…>, 7 weeks ago

Update to tcsh-6.24.01.

  • Property mode set to 100644
File size: 8.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/do/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Following URL does has old versions: https://astron.com/pub/tcsh/old/ -->
8 <!ENTITY tcsh-download-http "https://astron.com/pub/tcsh/tcsh-&tcsh-version;.tar.gz">
9 <!ENTITY tcsh-download-ftp "ftp://ftp.astron.com/pub/tcsh/tcsh-&tcsh-version;.tar.gz">
10 <!ENTITY tcsh-md5sum "cc7a973c305884646ece4c6929ffdd10">
11 <!ENTITY tcsh-size "928 KB">
12 <!ENTITY tcsh-buildsize "11 MB (with tests)">
13 <!ENTITY tcsh-time "0.2 SBU (with tests)">
14]>
15
16<sect1 id="tcsh" xreflabel="Tcsh-&tcsh-version;">
17 <?dbhtml filename="tcsh.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Tcsh-&tcsh-version;</title>
24
25 <indexterm zone="tcsh">
26 <primary sortas="a-Tcsh">Tcsh</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Tcsh</title>
31
32 <para>
33 The <application>Tcsh</application> package contains <quote>an
34 enhanced but completely compatible version of the Berkeley Unix C shell
35 (<command>csh</command>)</quote>. This is useful as an alternative shell
36 for those who prefer C syntax to that of the <command>bash</command>
37 shell, and also because some programs require the C shell in order to
38 perform installation tasks.
39 </para>
40
41 &lfs111_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&tcsh-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&tcsh-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &tcsh-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &tcsh-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &tcsh-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &tcsh-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <para condition="html" role="usernotes">User Notes:
78 <ulink url="&blfs-wiki;/tcsh"/></para>
79
80 </sect2>
81
82 <sect2 role="installation">
83 <title>Installation of Tcsh</title>
84<!--
85 <para>
86 First, fix the package for tool chain changes:
87 </para>
88
89<screen><userinput>sed -i 's|SVID_SOURCE|DEFAULT_SOURCE|g' config/linux &amp;&amp;
90sed -i 's|BSD_SOURCE|DEFAULT_SOURCE|g' config/linux</userinput></screen>
91-->
92 <para>
93 Install <application>Tcsh</application> by running the following
94 commands:
95 </para>
96
97<screen><userinput>./configure --prefix=/usr --bindir=/bin &amp;&amp;
98
99make &amp;&amp;
100sh ./tcsh.man2html</userinput></screen>
101
102 <para>
103 To test the results, issue: <command>make check</command>.
104 </para>
105
106 <para>
107 Now, as the <systemitem class="username">root</systemitem> user:
108 </para>
109
110<screen role="root"><userinput>make install install.man &amp;&amp;
111
112ln -v -sf tcsh /bin/csh &amp;&amp;
113ln -v -sf tcsh.1 /usr/share/man/man1/csh.1 &amp;&amp;
114
115install -v -m755 -d /usr/share/doc/tcsh-&tcsh-version;/html &amp;&amp;
116install -v -m644 tcsh.html/* /usr/share/doc/tcsh-&tcsh-version;/html &amp;&amp;
117install -v -m644 FAQ /usr/share/doc/tcsh-&tcsh-version;</userinput></screen>
118
119 </sect2>
120
121 <sect2 role="commands">
122 <title>Command Explanations</title>
123
124 <para>
125 <parameter>--bindir=/bin</parameter>: This installs the
126 <command>tcsh</command> program in <filename
127 class='directory'>/bin</filename> instead of <filename
128 class='directory'>/usr/bin</filename>.
129 </para>
130
131 <para>
132 <command>sh ./tcsh.man2html</command>: This creates HTML documentation
133 from the formatted man page.
134 </para>
135
136 <para>
137 <command>ln -v -sf tcsh /bin/csh</command>: The FHS states that if
138 there is a <application>C</application> shell installed, there should
139 be a symlink from <filename>/bin/csh</filename> to it. This creates
140 that symlink.
141 </para>
142
143 </sect2>
144
145 <sect2 role="configuration">
146 <title>Configuring Tcsh</title>
147
148 <sect3 id="tcsh-config">
149 <title>Config Files</title>
150
151 <para>
152 There are numerous configuration files for the C shell. Examples
153 of these are <filename>/etc/csh.cshrc</filename>,
154 <filename>/etc/csh.login</filename>,
155 <filename>/etc/csh.logout</filename>,
156 <filename>~/.tcshrc</filename>, <filename>~/.cshrc</filename>,
157 <filename>~/.history</filename>, <filename>~/.cshdirs</filename>,
158 <filename>~/.login</filename>, and <filename>~/.logout</filename>. More
159 information on these files can be found in the
160 <filename>tcsh(1)</filename> man page.
161 </para>
162
163 <indexterm zone="tcsh tcsh-config">
164 <primary sortas="e-etc-csh.cshrc">/etc/csh.cshrc</primary>
165 </indexterm>
166
167 <indexterm zone="tcsh tcsh-config">
168 <primary sortas="e-etc-csh.login">/etc/csh.login</primary>
169 </indexterm>
170
171 <indexterm zone="tcsh tcsh-config">
172 <primary sortas="e-etc-csh.logout">/etc/csh.logout</primary>
173 </indexterm>
174
175 <indexterm zone="tcsh tcsh-config">
176 <primary sortas="e-AA.tcshrc">~/.tcshrc</primary>
177 </indexterm>
178
179 <indexterm zone="tcsh tcsh-config">
180 <primary sortas="e-AA.cshrc">~/.cshrc</primary>
181 </indexterm>
182
183 <indexterm zone="tcsh tcsh-config">
184 <primary sortas="e-AA.history">~/.history</primary>
185 </indexterm>
186
187 <indexterm zone="tcsh tcsh-config">
188 <primary sortas="e-AA.cshdirs">~/.cshdirs</primary>
189 </indexterm>
190
191 <indexterm zone="tcsh tcsh-config">
192 <primary sortas="e-AA.login">~/.login</primary>
193 </indexterm>
194
195 <indexterm zone="tcsh tcsh-config">
196 <primary sortas="e-AA.logout">~/.logout</primary>
197 </indexterm>
198
199 </sect3>
200
201 <sect3>
202 <title>Configuration Information</title>
203
204 <para>
205 Update <filename>/etc/shells</filename> to include the C shell
206 program names (as the <systemitem class="username">root</systemitem>
207 user):
208 </para>
209
210<screen role="root"><userinput>cat &gt;&gt; /etc/shells &lt;&lt; "EOF"
211<literal>/bin/tcsh
212/bin/csh</literal>
213EOF</userinput></screen>
214
215 <para>
216 The following <filename>~/.cshrc</filename> provides two alternative
217 colour prompts and coloured <command>ls</command> output. If you prefer
218 a global modification, issue the command as the <systemitem
219 class="username">root</systemitem> user, replacing
220 <filename>~/.cshrc</filename> by <filename>/etc/csh.cshrc</filename>.
221 </para>
222
223<screen><userinput>cat &gt; ~/.cshrc &lt;&lt; "EOF"
224<literal># Original at:
225# https://www.cs.umd.edu/~srhuang/teaching/code_snippets/prompt_color.tcsh.html
226
227# Modified by the BLFS Development Team.
228
229# Add these lines to your ~/.cshrc (or to /etc/csh.cshrc).
230
231# Colors!
232set red="%{\033[1;31m%}"
233set green="%{\033[0;32m%}"
234set yellow="%{\033[1;33m%}"
235set blue="%{\033[1;34m%}"
236set magenta="%{\033[1;35m%}"
237set cyan="%{\033[1;36m%}"
238set white="%{\033[0;37m%}"
239set end="%{\033[0m%}" # This is needed at the end...
240
241# Setting the actual prompt. Two separate versions for you to try, pick
242# whichever one you like better, and change the colors as you want.
243# Just don't mess with the ${end} guy in either line... Comment out or
244# delete the prompt you don't use.
245
246set prompt="${green}%n${blue}@%m ${white}%~ ${green}%%${end} "
247set prompt="[${green}%n${blue}@%m ${white}%~ ]${end} "
248
249# This was not in the original URL above
250# Provides coloured ls
251alias ls ls --color=always
252
253# Clean up after ourselves...
254unset red green yellow blue magenta cyan yellow white end</literal>
255EOF</userinput></screen>
256
257 </sect3>
258
259 </sect2>
260
261 <sect2 role="content">
262 <title>Contents</title>
263
264 <segmentedlist>
265 <segtitle>Installed Program</segtitle>
266 <segtitle>Installed Libraries</segtitle>
267 <segtitle>Installed Directory</segtitle>
268
269 <seglistitem>
270 <seg>tcsh</seg>
271 <seg>None</seg>
272 <seg>/usr/share/doc/tcsh-&tcsh-version;</seg>
273 </seglistitem>
274 </segmentedlist>
275
276 <variablelist>
277 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
278 <?dbfo list-presentation="list"?>
279 <?dbhtml list-presentation="table"?>
280
281 <varlistentry id="tcsh-prog">
282 <term><command>tcsh</command></term>
283 <listitem>
284 <para>
285 is an enhanced but completely compatible version of the
286 Berkeley Unix C shell, <command>csh</command>. It is usable as
287 both an interactive shell and a script processor
288 </para>
289 <indexterm zone="tcsh tcsh-prog">
290 <primary sortas="b-tcsh">tcsh</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294 </variablelist>
295
296 </sect2>
297
298</sect1>
Note: See TracBrowser for help on using the repository browser.