tcl.xml 2.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <sect1 id="ch-tools-tcl" xreflabel="Tcl">
  2. <title>Installing Tcl-&tcl-version;</title>
  3. <?dbhtml filename="tcl.html" dir="chapter05"?>
  4. <para>The Tcl package contains the Tool Command Language.</para>
  5. <screen>&buildtime; &tcl-time-tools;
  6. &diskspace; &tcl-compsize-tools;</screen>
  7. &aa-tcl-down;
  8. &aa-tcl-dep;
  9. <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
  10. <sect2>
  11. <title>Installation of Tcl</title>
  12. <para>This package and the next two are only installed to be able to run the
  13. test suites for GCC and Binutils. Installing three packages just for testing
  14. purposes may seem like overkill, but it is very reassuring, if not essential,
  15. to know that our most important tools are working properly. Even if you are
  16. not running the test suites here in this chapter as per our recommendation,
  17. these packages are still required for the test suites in the next
  18. chapter.</para>
  19. <para>Prepare Tcl for compilation:</para>
  20. <screen><userinput>cd unix
  21. ./configure --prefix=/tools</userinput></screen>
  22. <para>Build the package:</para>
  23. <screen><userinput>make</userinput></screen>
  24. <para>As discussed earlier, we don't recommend running the test suites for the
  25. temporary tools here in this chapter. If you still want to run the Tcl test
  26. suite anyway, the following command will do so. However, you should be aware
  27. that the Tcl test suite is sometimes known to experience failures under certain
  28. host conditions that are not fully understood. Therefore, test suite failures
  29. here are not surprising, but are not considered critical:</para>
  30. <screen><userinput>TZ=UTC make test</userinput></screen>
  31. <para>The meaning of the make parameter:</para>
  32. <itemizedlist>
  33. <listitem><para><userinput>TZ=UTC</userinput>: This sets the time zone to
  34. Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT), but
  35. only for the duration of the test suite run. This ensures the clock tests are
  36. exercised correctly. More information on the TZ environment variable will be
  37. given later on in <xref linkend="chapter-bootscripts"/>.</para></listitem>
  38. </itemizedlist>
  39. <para>Sometimes package test suites will give false failures. You can
  40. consult the LFS Wiki at <ulink url="&wiki-root;"/> to verify that these
  41. failures are normal. This applies to all tests throughout the book.</para>
  42. <para>Install the package:</para>
  43. <screen><userinput>make install</userinput></screen>
  44. <!-- HACK - Force some whitespace to appease tidy -->
  45. <literallayout></literallayout>
  46. <warning><para><emphasis>Do not remove</emphasis> the
  47. <filename>tcl&tcl-version;</filename> source directory yet, as the next package
  48. will need its internal headers.</para></warning>
  49. <!-- HACK - Force some whitespace to appease tidy -->
  50. <literallayout></literallayout>
  51. <para>Make a necessary symbolic link:</para>
  52. <screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
  53. </sect2>
  54. &aa-tcl-shortdesc;
  55. &aa-tcl-desc;
  56. </sect1>