diff options
Diffstat (limited to 'docs/programmer_reference/tcl.html')
| -rw-r--r-- | docs/programmer_reference/tcl.html | 136 |
1 files changed, 83 insertions, 53 deletions
diff --git a/docs/programmer_reference/tcl.html b/docs/programmer_reference/tcl.html index 906cbe42..69c8cca7 100644 --- a/docs/programmer_reference/tcl.html +++ b/docs/programmer_reference/tcl.html @@ -14,13 +14,11 @@ <body> <div xmlns="" class="navheader"> <div class="libver"> - <p>Library Version 11.2.5.3</p> + <p>Library Version 12.1.6.1</p> </div> <table width="100%" summary="Navigation header"> <tr> - <th colspan="3" align="center">Chapter 21. - Berkeley DB Extensions: Tcl - </th> + <th colspan="3" align="center">Chapter 21. Berkeley DB Extensions: Tcl </th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="sequence.html">Prev</a> </td> @@ -34,9 +32,7 @@ <div class="titlepage"> <div> <div> - <h2 class="title"><a id="tcl"></a>Chapter 21. - Berkeley DB Extensions: Tcl - </h2> + <h2 class="title"><a id="tcl"></a>Chapter 21. Berkeley DB Extensions: Tcl </h2> </div> </div> </div> @@ -54,12 +50,12 @@ <dl> <dt> <span class="sect2"> - <a href="tcl.html#idp3187200">Installing as a Tcl Package</a> + <a href="tcl.html#idp2951744">Installing as a Tcl Package</a> </span> </dt> <dt> <span class="sect2"> - <a href="tcl.html#idp3177840">Loading Berkeley DB with Tcl</a> + <a href="tcl.html#idp2941624">Loading Berkeley DB with Tcl</a> </span> </dt> </dl> @@ -98,77 +94,113 @@ <dl> <dt> <span class="sect2"> - <a href="tcl.html#idp3187200">Installing as a Tcl Package</a> + <a href="tcl.html#idp2951744">Installing as a Tcl Package</a> </span> </dt> <dt> <span class="sect2"> - <a href="tcl.html#idp3177840">Loading Berkeley DB with Tcl</a> + <a href="tcl.html#idp2941624">Loading Berkeley DB with Tcl</a> </span> </dt> </dl> </div> - <p>Berkeley DB includes a dynamically loadable Tcl API, which requires that -Tcl/Tk 8.5 or later already be installed on your system. You can -download a copy of Tcl from the <a class="ulink" href="http://www.tcl.tk" target="_top">Tcl -Developer Xchange</a> Web site.</p> - <p>This document assumes that you already configured Berkeley DB for Tcl -support, and you have built and installed everything where you want it -to be. If you have not done so, see -<a href="../installation/build_unix_conf.html" class="olink">Configuring Berkeley DB</a> or <a href="../installation/build_win_tcl.html" class="olink">Building the Tcl API</a> in the Berkeley DB Installation and Build Guide for more -information.</p> + <p> + Berkeley DB includes a dynamically loadable Tcl API, which + requires that Tcl/Tk 8.5 or later already be installed on your + system. You can download a copy of Tcl from the <a class="ulink" href="http://www.tcl.tk" target="_top">Tcl Developer Xchange</a> Web + site. + </p> + <p> + This document assumes that you already configured Berkeley + DB for Tcl support, and you have built and installed + everything where you want it to be. If you have not done so, + see <a href="../installation/build_unix_conf.html" class="olink">Configuring Berkeley DB</a> or <a href="../installation/build_win_tcl.html" class="olink">Building the Tcl API</a> in the + Berkeley DB Installation and Build Guide for more information. + </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp3187200"></a>Installing as a Tcl Package</h3> + <h3 class="title"><a id="idp2951744"></a>Installing as a Tcl Package</h3> </div> </div> </div> - <p>Once enabled, the Berkeley DB shared library for Tcl is automatically installed -as part of the standard installation process. However, if you want to be -able to dynamically load it as a Tcl package into your script, there are -several steps that must be performed:</p> + <p> + Once enabled, the Berkeley DB shared library for Tcl is + automatically installed as part of the standard + installation process. However, if you want to be able to + dynamically load it as a Tcl package into your script, + there are several steps that must be performed: + </p> <div class="orderedlist"> <ol type="1"> - <li>Run the Tcl shell in the install directory.</li> - <li>Append this directory to your auto_path variable.</li> - <li>Run the pkg_mkIndex proc, giving the name of the Berkeley DB Tcl library.</li> + <li> + Run the Tcl shell in the install + directory. + </li> + <li> + Append this directory to your auto_path + variable. + </li> + <li> + Run the pkg_mkIndex proc, giving the name of the + Berkeley DB Tcl library. + </li> </ol> </div> - <p>For example:</p> + <p> + For example: + </p> <pre class="programlisting"># tclsh8.5 -% lappend auto_path /usr/local/BerkeleyDB.5.2/lib -% pkg_mkIndex /usr/local/BerkeleyDB.5.2/lib libdb_tcl-5.2.so</pre> - <p>Note that your Tcl and Berkeley DB version numbers may differ from the -example, and so your tclsh and library names may be different.</p> +% lappend auto_path /usr/local/BerkeleyDB.6.0/lib +% pkg_mkIndex /usr/local/BerkeleyDB.6.0/lib libdb_tcl-6.0.so</pre> + <p> + Note that your Tcl and Berkeley DB version numbers may + differ from the example, and so your tclsh and library + names may be different. + </p> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp3177840"></a>Loading Berkeley DB with Tcl</h3> + <h3 class="title"><a id="idp2941624"></a>Loading Berkeley DB with Tcl</h3> </div> </div> </div> - <p>The Berkeley DB package may be loaded into the user's interactive Tcl script -(or wish session) via the <span class="bold"><strong>load</strong></span> command. For example:</p> - <pre class="programlisting">load /usr/local/BerkeleyDB.5.2/lib/libdb_tcl-5.2.so</pre> - <p>Note that your Berkeley DB version numbers may differ from the example, and so -the library name may be different.</p> - <p>If you installed your library to run as a Tcl package, Tcl application -scripts should use the <span class="bold"><strong>package</strong></span> command to indicate to the Tcl -interpreter that it needs the Berkeley DB package and where to find it. For -example:</p> - <pre class="programlisting">lappend auto_path "/usr/local/BerkeleyDB.5.2/lib" + <p> + The Berkeley DB package may be loaded into the user's + interactive Tcl script (or wish session) via the <span class="bold"><strong>load</strong></span> command. For + example: + </p> + <pre class="programlisting">load /usr/local/BerkeleyDB.6.0/lib/libdb_tcl-6.0.so</pre> + <p> + Note that your Berkeley DB version numbers may differ + from the example, and so the library name may be + different. + </p> + <p> + If you installed your library to run as a Tcl package, + Tcl application scripts should use the <span class="bold"><strong>package</strong></span> command to indicate to + the Tcl interpreter that it needs the Berkeley DB package + and where to find it. For example: + </p> + <pre class="programlisting">lappend auto_path "/usr/local/BerkeleyDB.6.0/lib" package require Db_tcl</pre> - <p>No matter which way the library gets loaded, it creates a command named -<span class="bold"><strong>berkdb</strong></span>. All the Berkeley DB functionality is accessed via this -command and additional commands it creates on behalf of the application. -A simple test to determine whether everything is loaded and ready is to -display the library version, as follows:</p> + <p> + No matter which way the library gets loaded, it creates + a command named <span class="bold"><strong>berkdb</strong></span>. + All the Berkeley DB functionality is accessed via this + command and additional commands it creates on behalf of + the application. A simple test to determine whether + everything is loaded and ready is to display the library + version, as follows: + </p> <pre class="programlisting">berkdb version -string</pre> - <p>This should return you the Berkeley DB version in a string format.</p> + <p> + This should return you the Berkeley DB version in a + string format. + </p> </div> </div> </div> @@ -181,9 +213,7 @@ display the library version, as follows:</p> <td width="40%" align="right"> <a accesskey="n" href="tcl_using.html">Next</a></td> </tr> <tr> - <td width="40%" align="left" valign="top">Chapter 20. - Sequences - </td> + <td width="40%" align="left" valign="top">Chapter 20. Sequences </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> |