source: postlfs/shells/tcsh.xml@ 45ab6c7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 6 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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