source: archive/tcl.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

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

  • Property mode set to 100644
File size: 9.4 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 <!ENTITY tcl-download-http "&sourceforge-dl;/tcl/tcl&tcl-version;-src.tar.gz">
8 <!ENTITY tcl-download-ftp " ">
9 <!ENTITY tcl-md5sum "97c55573f8520bcab74e21bfd8d0aadc">
10 <!ENTITY tcl-size "9.7 MB">
11 <!ENTITY tcl-buildsize "67 MB (including html documentation)">
12 <!ENTITY tcl-time "0.7 SBU (add 2.7 SBU for tests)">
13
14 <!ENTITY tcl-doc-download "&sourceforge-dl;/tcl/tcl&tcl-version;-html.tar.gz">
15 <!ENTITY tcl-doc-md5sum "a012711241ba3a5bd4a04e833001d489">
16 <!ENTITY tcl-doc-size "1.2 MB">
17
18 <!-- Ensure this is updated when Tcl moves from the 8.6.x branch -->
19 <!ENTITY tcl-ver "8.6">
20 <!ENTITY tdbc-ver "1.1.1">
21 <!ENTITY itcl-ver "4.2.0">
22 <!ENTITY thread-ver "2.8.5">
23 <!ENTITY sqlite3-ver "3.30.1.2">
24]>
25
26<sect1 id="tcl" xreflabel="Tcl-&tcl-version;">
27 <?dbhtml filename="tcl.html"?>
28
29 <sect1info>
30 <date>$Date$</date>
31 </sect1info>
32
33 <title>Tcl-&tcl-version;</title>
34
35 <indexterm zone="tcl">
36 <primary sortas="a-Tcl">Tcl</primary>
37 </indexterm>
38
39 <sect2 role="package">
40 <title>Introduction to Tcl</title>
41
42 <para>
43 The <application>Tcl</application> package contains the Tool Command
44 Language, a robust general-purpose scripting language.
45 </para>
46
47 &lfs91_checked;
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>
53 Download (HTTP): <ulink url="&tcl-download-http;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download (FTP): <ulink url="&tcl-download-ftp;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download MD5 sum: &tcl-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download size: &tcl-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &tcl-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &tcl-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
84 <itemizedlist spacing="compact">
85 <title>Optional Documentation</title>
86 <listitem>
87 <para>
88 Download (HTTP): <ulink url="&tcl-doc-download;"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Download MD5 sum: &tcl-doc-md5sum;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Download size: &tcl-doc-size;
99 </para>
100 </listitem>
101 </itemizedlist>
102
103 <para condition="html" role="usernotes">User Notes:
104 <ulink url="&blfs-wiki;/tcl"/>
105 </para>
106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of Tcl</title>
110
111 <para>
112 This package is also installed in LFS during the bootstrap phase.
113 As it is not installed during Chapter 6 of LFS, installation instructions
114 are included here in BLFS.
115 </para>
116
117 <para>
118 If you downloaded the optional documentation, unpack the tarball
119 by issuing the following command:
120 </para>
121
122<screen><userinput>tar -xf ../tcl&tcl-version;-html.tar.gz --strip-components=1</userinput></screen>
123
124 <para>
125 Install <application>Tcl</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>export SRCDIR=`pwd` &amp;&amp;
130
131cd unix &amp;&amp;
132
133./configure --prefix=/usr \
134 --mandir=/usr/share/man \
135 $([ $(uname -m) = x86_64 ] &amp;&amp; echo --enable-64bit) &amp;&amp;
136make &amp;&amp;
137
138sed -e "s#$SRCDIR/unix#/usr/lib#" \
139 -e "s#$SRCDIR#/usr/include#" \
140 -i tclConfig.sh &amp;&amp;
141
142sed -e "s#$SRCDIR/unix/pkgs/tdbc&tdbc-ver;#/usr/lib/tdbc&tdbc-ver;#" \
143 -e "s#$SRCDIR/pkgs/tdbc&tdbc-ver;/generic#/usr/include#" \
144 -e "s#$SRCDIR/pkgs/tdbc&tdbc-ver;/library#/usr/lib/tcl8.6#" \
145 -e "s#$SRCDIR/pkgs/tdbc&tdbc-ver;#/usr/include#" \
146 -i pkgs/tdbc&tdbc-ver;/tdbcConfig.sh &amp;&amp;
147
148sed -e "s#$SRCDIR/unix/pkgs/itcl&itcl-ver;#/usr/lib/itcl&itcl-ver;#" \
149 -e "s#$SRCDIR/pkgs/itcl&itcl-ver;/generic#/usr/include#" \
150 -e "s#$SRCDIR/pkgs/itcl&itcl-ver;#/usr/include#" \
151 -i pkgs/itcl&itcl-ver;/itclConfig.sh &amp;&amp;
152
153unset SRCDIR</userinput></screen>
154
155
156 <para>
157 To test the results, issue: <command>make test</command>.
158 <!-- Tests known to fail: cmdAH.test and tdbcodbc.test. 8.6.9: No
159 failures -->
160 </para>
161
162 <para>
163 Now, as the <systemitem class="username">root</systemitem> user:
164 </para>
165
166<screen role="root"><userinput>make install &amp;&amp;
167make install-private-headers &amp;&amp;
168ln -v -sf tclsh&tcl-ver; /usr/bin/tclsh &amp;&amp;
169chmod -v 755 /usr/lib/libtcl&tcl-ver;.so</userinput></screen>
170
171 <para>
172 If you downloaded the optional documentation, install it by issuing
173 the following commands as the
174 <systemitem class="username">root</systemitem> user:
175 </para>
176
177<screen role="root"><userinput>mkdir -v -p /usr/share/doc/tcl-&tcl-version; &amp;&amp;
178cp -v -r ../html/* /usr/share/doc/tcl-&tcl-version;</userinput></screen>
179
180 </sect2>
181
182 <sect2 role="commands">
183 <title>Command Explanations</title>
184
185 <para>
186 <parameter>$([ $(uname -m) = x86_64 ] &amp;&amp; echo
187 --enable-64bit)</parameter>: This switch is used to enable 64 bit
188 support in <application>Tcl</application> on 64 bit operating
189 systems.
190 </para>
191
192 <para>
193 <command>make install-private-headers</command>: This command is
194 used to install the <application>Tcl</application> library interface
195 headers used by other packages if they link to the
196 <application>Tcl</application> library.
197 </para>
198
199 <para>
200 <command>ln -v -sf tclsh&tcl-ver; /usr/bin/tclsh</command>: This
201 command is used to create a compatibility symbolic link to the
202 <command>tclsh&tcl-ver;</command> file as many packages expect a file
203 named <command>tclsh</command>.
204 </para>
205
206 <para>
207 <command>sed -e ...</command>: The <application>Tcl</application> package
208 expects that its source tree is preserved so that packages depending on
209 it for their compilation can utilize it. These <command>sed</command>
210 remove the references to the build directory and replace them with saner
211 system-wide locations.
212 </para>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Libraries</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>
226 sqlite3_analyzer, tclsh, and tclsh&tcl-ver;
227 </seg>
228 <seg>
229 libtcl&tcl-ver;.so and libtclstub&tcl-ver;.a
230 </seg>
231 <seg>
232 /usr/lib/itcl&itcl-ver;,
233 /usr/lib/sqlite&sqlite3-ver;
234 /usr/lib/tcl8,
235 /usr/lib/tcl&tcl-ver;,
236 /usr/lib/tdbc&tdbc-ver;,
237 /usr/lib/tdbcmysql&tdbc-ver;,
238 /usr/lib/tdbcodbc&tdbc-ver;,
239 /usr/lib/tdbcpostgres&tdbc-ver;,
240 /usr/lib/thread&thread-ver;,
241 /usr/share/doc/tcl-&tcl-version;, and
242 /usr/share/man/mann
243 </seg>
244 </seglistitem>
245 </segmentedlist>
246
247 <variablelist>
248 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
249 <?dbfo list-presentation="list"?>
250 <?dbhtml list-presentation="table"?>
251
252 <varlistentry id="sqlite3_analyzer">
253 <term><command>sqlite3_analyzer</command></term>
254 <listitem>
255 <para>
256 is a program to analyze sqlite3 database files and output a report
257 that gives information on size and storage efficiency for the
258 database and it's tables and indexes.
259 </para>
260 <indexterm zone="tcl sqlite3_analyzer">
261 <primary sortas="b-sqlite3_analyzer">sqlite3_analyzer</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="tclsh">
267 <term><command>tclsh</command></term>
268 <listitem>
269 <para>
270 is a symlink to the <command>tclsh&tcl-ver;</command> program.
271 </para>
272 <indexterm zone="tcl tclsh">
273 <primary sortas="b-tclsh">tclsh</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="tclsh-eight">
279 <term><command>tclsh&tcl-ver;</command></term>
280 <listitem>
281 <para>
282 is a simple shell containing the
283 <application>Tcl</application> interpreter.
284 </para>
285 <indexterm zone="tcl tclsh-eight">
286 <primary sortas="b-tclsh&tcl-ver;">tclsh&tcl-ver;</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="libtcl">
292 <term><filename class="libraryfile">libtcl&tcl-ver;.so</filename></term>
293 <listitem>
294 <para>
295 contains the API functions required by
296 <application>Tcl</application>.
297 </para>
298 <indexterm zone="tcl libtcl">
299 <primary sortas="c-libtcl">libtcl&tcl-ver;.so</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 </variablelist>
305
306 </sect2>
307
308</sect1>
Note: See TracBrowser for help on using the repository browser.