[Gd-chatter] r11250 - trunk/www/books/drm
cpage at gwydiondylan.org
cpage at gwydiondylan.org
Tue Apr 10 00:24:02 CEST 2007
Author: cpage
Date: Tue Apr 10 00:23:23 2007
New Revision: 11250
Modified:
trunk/www/books/drm/Arithmetic_Operations.html
trunk/www/books/drm/Assignment.html
trunk/www/books/drm/Auxiliary_Rule_Sets.html
trunk/www/books/drm/BNF.html
trunk/www/books/drm/Background_and_Goals.html
trunk/www/books/drm/Bindings.html
trunk/www/books/drm/Built-In_Classes.html
trunk/www/books/drm/Built-In_Classes_Overview.html
trunk/www/books/drm/Built-In_Functions.html
trunk/www/books/drm/Built-In_Functions_Overview.html
trunk/www/books/drm/Built-In_Macros_and_Special_Definitions.html
trunk/www/books/drm/Classes.html
trunk/www/books/drm/Coercing_and_Copying_Objects.html
trunk/www/books/drm/Collection_Alignment.html
trunk/www/books/drm/Collection_Alteration_and_Allocation.html
trunk/www/books/drm/Collection_Classes.html
trunk/www/books/drm/Collection_Keys.html
trunk/www/books/drm/Collection_Operations.html
trunk/www/books/drm/Collections_Overview.html
trunk/www/books/drm/Condition_Classes.html
trunk/www/books/drm/Condition_Messages.html
trunk/www/books/drm/Conditional_Execution.html
trunk/www/books/drm/Conditions_Background.html
trunk/www/books/drm/Conditions_Overview.html
trunk/www/books/drm/Constructing_and_Initializing_Instances.html
trunk/www/books/drm/Declaring_Characteristics_of_Classes.html
trunk/www/books/drm/Declaring_Characteristics_of_Generic_Functions.html
trunk/www/books/drm/Define_Sealed_Domain.html
trunk/www/books/drm/Defining_a_New_Collection_Class.html
trunk/www/books/drm/Definition_Macros.html
trunk/www/books/drm/Dylan_Interchange_Format.html
trunk/www/books/drm/Element_Types.html
trunk/www/books/drm/Equality_and_Comparison.html
trunk/www/books/drm/Exception_Handling.html
trunk/www/books/drm/Explicitly_Known_Objects.html
trunk/www/books/drm/Expressions.html
trunk/www/books/drm/Extensible_Grammar.html
trunk/www/books/drm/Function_Application.html
trunk/www/books/drm/Function_Calls.html
trunk/www/books/drm/Function_Classes.html
trunk/www/books/drm/Function_Macros.html
trunk/www/books/drm/Functional_Operations.html
trunk/www/books/drm/Functions_Overview.html
trunk/www/books/drm/Glossary.html
trunk/www/books/drm/Hygiene.html
trunk/www/books/drm/Instance_Creation_and_Initialization.html
trunk/www/books/drm/Introspective_Operations_on_Conditions.html
trunk/www/books/drm/Iteration.html
trunk/www/books/drm/Iteration_Stability_and_Natural_Order.html
trunk/www/books/drm/Language_Overview.html
trunk/www/books/drm/Lexical_Grammar.html
trunk/www/books/drm/Lexical_Syntax.html
trunk/www/books/drm/Libraries.html
trunk/www/books/drm/Libraries_and_Modules.html
trunk/www/books/drm/Limited_Collection_Types.html
trunk/www/books/drm/Limited_Types.html
trunk/www/books/drm/Local_Declaration_Macros.html
trunk/www/books/drm/Local_Declarations.html
trunk/www/books/drm/Macro_Names.html
trunk/www/books/drm/Macros_Overview.html
trunk/www/books/drm/Macros_Syntax.html
trunk/www/books/drm/Method_Dispatch.html
trunk/www/books/drm/Modules.html
trunk/www/books/drm/Multiple_Values.html
trunk/www/books/drm/Mutability.html
trunk/www/books/drm/Naming_Conventions.html
trunk/www/books/drm/Nonlocal_Exits_and_Cleanup_Clauses.html
trunk/www/books/drm/Number_Classes.html
trunk/www/books/drm/Object_Classes.html
trunk/www/books/drm/Operations_on_Conditions.html
trunk/www/books/drm/Operations_on_Functions.html
trunk/www/books/drm/Operators.html
trunk/www/books/drm/Order_of_Execution.html
trunk/www/books/drm/Parameter_Lists.html
trunk/www/books/drm/Pattern_Variable_Constraints.html
trunk/www/books/drm/Patterns.html
trunk/www/books/drm/Phrase_Grammar.html
trunk/www/books/drm/Preface.html
trunk/www/books/drm/Program_Control_Overview.html
trunk/www/books/drm/Reflective_Operations_on_Functions.html
trunk/www/books/drm/Reflective_Operations_on_Types.html
trunk/www/books/drm/Rewrite_Rule_Examples.html
trunk/www/books/drm/Rewrite_Rules.html
trunk/www/books/drm/Sealing_Overview.html
trunk/www/books/drm/Signalers_Conditions_and_Handlers.html
trunk/www/books/drm/Simple_Object_Classes.html
trunk/www/books/drm/Singletons.html
trunk/www/books/drm/Slots.html
trunk/www/books/drm/Special_Treatment_of_Names.html
trunk/www/books/drm/Statement_Macros.html
trunk/www/books/drm/Syntax_Overview.html
trunk/www/books/drm/Tables.html
trunk/www/books/drm/Templates.html
trunk/www/books/drm/Top-Level_Definitions.html
trunk/www/books/drm/Type_Classes.html
trunk/www/books/drm/Type_Protocol.html
trunk/www/books/drm/Types_and_Classes_Overview.html
trunk/www/books/drm/Union_Types.html
Log:
Job: website
Cleaned up and normalized HTML fragment anchors in the DRM. Moved some around so
they refer to the correct text. Changed many to mark the relevant text within
the anchor tag instead of using empty tags. Fixed some broken cross-reference
links.
Modified: trunk/www/books/drm/Arithmetic_Operations.html
==============================================================================
--- trunk/www/books/drm/Arithmetic_Operations.html (original)
+++ trunk/www/books/drm/Arithmetic_Operations.html Tue Apr 10 00:23:23 2007
@@ -1099,8 +1099,8 @@
<a name="HEADING-100-179"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1653">abs</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1654"></a>Returns the absolute value of its
- argument.</p>
+ <p class="short-description"><a name="XREF-1654">Returns the absolute value of its
+ argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1173,8 +1173,8 @@
<a name="HEADING-100-193"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1658">logxor</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1659"></a>Returns the bitwise exclusive or of
- its integer arguments.</p>
+ <p class="short-description"><a name="XREF-1659">Returns the bitwise exclusive or of
+ its integer arguments.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1207,8 +1207,8 @@
<a name="HEADING-100-199"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1660">logand</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1661"></a>Returns the bitwise and of its
- integer arguments.</p>
+ <p class="short-description"><a name="XREF-1661">Returns the bitwise and of its
+ integer arguments.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1241,8 +1241,8 @@
<a name="HEADING-100-205"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1662">lognot</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1663"></a>Returns the bitwise not of its
- integer argument.</p>
+ <p class="short-description"><a name="XREF-1663">Returns the bitwise not of its
+ integer argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1275,8 +1275,8 @@
<a name="HEADING-100-211"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1664">logbit?</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1665"></a>Tests the value of a particular bit
- in its integer argument.</p>
+ <p class="short-description"><a name="XREF-1665">Tests the value of a particular bit
+ in its integer argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1315,8 +1315,8 @@
<a name="HEADING-100-219"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1666">ash</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1667"></a>Performs an arithmetic shift on its
- first argument.</p>
+ <p class="short-description"><a name="XREF-1667">Performs an arithmetic shift on its
+ first argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1366,8 +1366,8 @@
<a name="HEADING-100-230"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1669">lcm</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1670"></a>Returns the least common multiple of
- its two arguments.</p>
+ <p class="short-description"><a name="XREF-1670">Returns the least common multiple of
+ its two arguments.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1407,8 +1407,8 @@
<a name="HEADING-100-239"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1671">gcd</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1672"></a>Returns the greatest common divisor
- of its two arguments.</p>
+ <p class="short-description"><a name="XREF-1672">Returns the greatest common divisor
+ of its two arguments.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
Modified: trunk/www/books/drm/Assignment.html
==============================================================================
--- trunk/www/books/drm/Assignment.html (original)
+++ trunk/www/books/drm/Assignment.html Tue Apr 10 00:23:23 2007
@@ -148,10 +148,10 @@
<code> ⇒</code> 110
*foo*
<code> ⇒</code> 110</pre>
- <p><a name="IX-454"></a><a name="IX-455"></a>The following examples show the use
- of <code>:=</code> as shorthand for calling a setter function. In general, using this syntax to
- call a function <var>fun</var> is equivalent to calling the
- function <code><var>fun</var>-setter</code>.</p>
+ <p>The following examples show the use of <code>:=</code> as <a name="IX-454">shorthand for
+ calling a setter function</a>. In general, using this syntax to call a
+ function <var>fun</var> is equivalent to calling the
+ function <a name="IX-455"><code><var>fun</var>-setter</code></a>.</p>
<pre class="code">
define variable *foo* = vector (10, 6, 8, 5);
element(*foo*, 2)
Modified: trunk/www/books/drm/Auxiliary_Rule_Sets.html
==============================================================================
--- trunk/www/books/drm/Auxiliary_Rule_Sets.html (original)
+++ trunk/www/books/drm/Auxiliary_Rule_Sets.html Tue Apr 10 00:23:23 2007
@@ -133,14 +133,13 @@
<a name="HEADING-84-0"></a>
<a name="UID-Macros-1862"></a>
- <h1 class="section-title">Auxiliary Rule Sets</h1>
- <p><a name="IX-1265"></a>Auxiliary rule sets are
- like <a name="IX-1266"></a>subroutines for rewrite rules. An auxiliary rule set
- rewrites the value of a pattern variable after it is bound by a pattern and before it is
- substituted into a template. Auxiliary rule sets only come into play after a pattern has
- matched; the failure of all patterns in an auxiliary rule set to match causes the entire
- macro call to be declared invalid, rather than back-tracking and trying the next pattern in
- the calling rule set.</p>
+ <h1 class="section-title"><a name="IX-1265">Auxiliary Rule Sets</a></h1>
+ <p>Auxiliary rule sets are like <a name="IX-1266"></a>subroutines for rewrite rules. An
+ auxiliary rule set rewrites the value of a pattern variable after it is bound by a pattern
+ and before it is substituted into a template. Auxiliary rule sets only come into play after
+ a pattern has matched; the failure of all patterns in an auxiliary rule set to match causes
+ the entire macro call to be declared invalid, rather than back-tracking and trying the next
+ pattern in the calling rule set.</p>
<p>See the definition of <var>aux-rule-sets</var>
in <a href="Phrase_Grammar#XREF-2122"><q>Auxiliary Rule Sets</q> on page 430</a>.</p>
<p>A <em class="BNFCaps">symbol</em> flags the beginning of an auxiliary rule set. For
Modified: trunk/www/books/drm/BNF.html
==============================================================================
--- trunk/www/books/drm/BNF.html (original)
+++ trunk/www/books/drm/BNF.html Tue Apr 10 00:23:23 2007
@@ -134,7 +134,7 @@
<h2 class="subsection-title">General Notes</h2>
<p>Dylan <a name="IX-2091">syntax</a> can be parsed with
an <a name="IX-2092">LALR(1)</a> <a name="IX-2093">grammar.</a></p>
- <p><a name="IX-2094"></a>This appendix uses some special notation to make the
+ <p>This appendix uses some special <a name="IX-2094">notation</a> to make the
presentation of the grammar more readable.</p>
<ul>
<li>The <sub class="BNF"><i>opt</i></sub> suffix means that the preceding item is
@@ -169,7 +169,7 @@
definitions and case-body). The grammar can be made LALR(1) through well-known standard
transformations implemented by most parser generators.</p>
<a name="HEADING-116-11"></a>
- <h2 class="subsection-title"><a name="IX-2095"></a>Lexical Notes</h2>
+ <h2 class="subsection-title"><a name="IX-2095">Lexical Notes</a></h2>
<p>In the lexical grammar, the various elements that come together to form a single token on
the right-hand sides of rules must <var>not</var> be separated by whitespace, so that the end
result will be a single token. This is in contrast to the phrase grammar, where each element
Modified: trunk/www/books/drm/Background_and_Goals.html
==============================================================================
--- trunk/www/books/drm/Background_and_Goals.html (original)
+++ trunk/www/books/drm/Background_and_Goals.html Tue Apr 10 00:23:23 2007
@@ -127,7 +127,7 @@
<a name="HEADING-6-0"></a>
<a name="UID-Introduction-2118"></a>
- <h1 class="section-title"><a name="IX-169"></a>Background and Goals</h1>
+ <h1 class="section-title"><a name="IX-169">Background and Goals</a></h1>
<p>Dylan is a general-purpose, high-level programming language, designed for use in
application and systems programming. Dylan includes garbage collection, type-safety, error
recovery, a module system, and programmer control over runtime extensibility of
Modified: trunk/www/books/drm/Bindings.html
==============================================================================
--- trunk/www/books/drm/Bindings.html (original)
+++ trunk/www/books/drm/Bindings.html Tue Apr 10 00:23:23 2007
@@ -151,7 +151,7 @@
initialize or assign the binding to a value that is not of the correct type.</p>
<p>A binding is either <dfn id="IX-227">constant</dfn>
or <dfn id="IX-228">variable</dfn>. A constant
- (or <a name="IX-229"></a>read-only) binding always has the same value. In contrast, a
+ (or <a name="IX-229">read-only</a>) binding always has the same value. In contrast, a
variable (or writable) binding can have its value changed, using the assignment
operator <code>:=</code>. Most bindings in a typical Dylan module are constant.</p>
Modified: trunk/www/books/drm/Built-In_Classes.html
==============================================================================
--- trunk/www/books/drm/Built-In_Classes.html (original)
+++ trunk/www/books/drm/Built-In_Classes.html Tue Apr 10 00:23:23 2007
@@ -131,7 +131,7 @@
<a name="LINK-Built-In_Classes-firstpage"></a><a name="HEADING-87-0"></a>
<a name="UID-Built-In_Classes-1378"></a>
- <h1 class="chapter-title"><a name="XREF-1359"></a>The Built-In Classes</h1>
+ <h1 class="chapter-title"><a name="XREF-1359">The Built-In Classes</a></h1>
<h2 class="chapter-title">Contents</h2>
<ul class="TOC">
Modified: trunk/www/books/drm/Built-In_Classes_Overview.html
==============================================================================
--- trunk/www/books/drm/Built-In_Classes_Overview.html (original)
+++ trunk/www/books/drm/Built-In_Classes_Overview.html Tue Apr 10 00:23:23 2007
@@ -132,9 +132,8 @@
<a name="HEADING-88-0"></a>
<a name="UID-Built-In_Classes-12650"></a>
- <h1 class="section-title">Overview</h1>
- <p><a name="IX-1360"></a>This chapter contains an entry for every class defined by
- Dylan.</p>
+ <h1 class="section-title"><a name="IX-1360">Overview</a></h1>
+ <p>This chapter contains an entry for every class defined by Dylan.</p>
<p>The superclasses listed for a class <var>C</var> are those classes defined by the Dylan
language from which <var>C</var> most directly inherits. They are not required to be the
direct superclasses of <var>C</var>, because implementations are free to insert
@@ -147,10 +146,10 @@
free. A class may be specified as instantiable. If it is not, then it is
uninstantiable. <a href="Sealing">Chapter 9, <q>Sealing,</q></a> contains a complete
description of these characteristics.</p>
- <p><a name="IX-1361"></a><a name="IX-1362"></a>An implementation may choose to
- impose fewer restrictions than specified. For example, a class specified as sealed may be
- left open, and a class specified as primary may be left free. However, any program that
- takes advantage of this liberality will not be portable.</p>
+ <p><a name="IX-1361"></a>An implementation may choose to impose fewer restrictions than
+ specified. For example, a class specified as sealed may be left open, and a class specified
+ as primary may be left free. However, any program that takes advantage of
+ this <a name="IX-1362">liberality</a> will not be portable.</p>
<p>Each class entry includes tables of operations defined on the class. These tables are cross
references to <a href="Built-In_Functions">Chapter 12, <q>The Built-In Functions,</q></a>
and represent redundant information. A function, generic function, or method is listed under
Modified: trunk/www/books/drm/Built-In_Functions.html
==============================================================================
--- trunk/www/books/drm/Built-In_Functions.html (original)
+++ trunk/www/books/drm/Built-In_Functions.html Tue Apr 10 00:23:23 2007
@@ -134,7 +134,7 @@
<a name="LINK-Built-In_Functions-firstpage"></a><a name="HEADING-96-0"></a>
<a name="UID-Built-In_Functions-20426"></a>
- <h1 class="chapter-title"><a name="XREF-1527"></a>The Built-In Functions</h1>
+ <h1 class="chapter-title"><a name="XREF-1527">The Built-In Functions</a></h1>
<h2 class="chapter-title">Contents</h2>
<ul class="TOC">
Modified: trunk/www/books/drm/Built-In_Functions_Overview.html
==============================================================================
--- trunk/www/books/drm/Built-In_Functions_Overview.html (original)
+++ trunk/www/books/drm/Built-In_Functions_Overview.html Tue Apr 10 00:23:23 2007
@@ -135,16 +135,15 @@
<a name="HEADING-97-0"></a>
<a name="UID-Built-In_Functions-20433"></a>
- <h1 class="section-title">Overview</h1>
- <p><a name="IX-1528"></a>This chapter contains an entry for each function defined by
- Dylan.</p>
- <p><a name="IX-1529"></a>The functions described below are annotated either as
+ <h1 class="section-title"><a name="IX-1528">Overview</a></h1>
+ <p>This chapter contains an entry for each function defined by Dylan.</p>
+ <p>The functions described below are <a name="IX-1529">annotated</a> either as
an <q>open generic function</q> or as a <q>function.</q></p>
- <p>A function specified as an <q><a name="IX-1530"></a>open generic function</q> can be
+ <p>A function specified as an <q><a name="IX-1530">open generic function</a></q> can be
extended through the addition of programmer defined methods. The signature of the generic
function constrains which methods can be added through the congruency rules described
on <a href="Parameter_Lists#XREF-837">page 93</a>. The signature does not imply a set
- of <a name="IX-1531"></a>predefined methods. For example, the signature
+ of predefined <a name="IX-1531">methods</a>. For example, the signature
of <code>+</code> is <code>(<object>, <object>)</code>, but the predefined
methods on <code>+</code> only cover subtypes of <code><number></code>. Particular
behavior of the function is given in its description and in the description of its
@@ -152,7 +151,7 @@
<p><a name="IX-1532"></a>A function specified as a <q>function</q> cannot portably be
extended through the addition of methods. Implementations are free to implement these
functions as open generic functions, but programs that take advantage of
- such <a name="IX-1533"></a>liberality will not be portable. The signature of such a
+ such <a name="IX-1533">liberality</a> will not be portable. The signature of such a
function specifies the types of the arguments to which the function may be applicable, but
does not necessarily imply that the function is applicable to all instances of the
types. The exact behavior of the function is given in its description.</p>
@@ -161,7 +160,7 @@
this liberality will not be portable.</p>
<p>When a method is specified, it describes the behavior of a generic function when applied to
arguments of particular types. It does not imply that this behavior is implemented by a
- single method. A method described as <q><a name="IX-1534"></a>sealed</q> specifies a
+ single method. A method described as <q><a name="IX-1534">sealed</a></q> specifies a
sealed domain covering the generic function and specializers of the method.</p>
<p>Where a sealed domain is specified, implementations are free to seal the domain or leave
the domain unsealed. Portable programs should not rely on the domain being
Modified: trunk/www/books/drm/Built-In_Macros_and_Special_Definitions.html
==============================================================================
--- trunk/www/books/drm/Built-In_Macros_and_Special_Definitions.html (original)
+++ trunk/www/books/drm/Built-In_Macros_and_Special_Definitions.html Tue Apr 10 00:23:23 2007
@@ -128,7 +128,7 @@
<a name="LINK-Built-In_Macros-firstpage"></a><a name="HEADING-110-0"></a>
<a name="UID-Built-In_Macros-711"></a>
- <h1 class="chapter-title"><a name="XREF-1995"></a>The Built-In Macros and Special Definitions</h1>
+ <h1 class="chapter-title"><a name="XREF-1995">The Built-In Macros and Special Definitions</a></h1>
<h2 class="chapter-title">Contents</h2>
<ul class="TOC">
Modified: trunk/www/books/drm/Classes.html
==============================================================================
--- trunk/www/books/drm/Classes.html (original)
+++ trunk/www/books/drm/Classes.html Tue Apr 10 00:23:23 2007
@@ -139,8 +139,8 @@
<a name="HEADING-41-0"></a>
<a name="UID-Types_and_Classes-361"></a>
- <h1 class="section-title"><a name="IX-561"></a>Classes</h1>
- <p><a name="IX-562"></a>Classes are used to define the inheritance, structure, and
+ <h1 class="section-title"><a name="IX-561">Classes</a></h1>
+ <p><a name="IX-562">Classes</a> are used to define the inheritance, structure, and
initialization of objects.</p>
<p>Every object is a <dfn id="IX-563">direct instance</dfn> of exactly one class, and a
general instance of the <dfn id="IX-564">general superclasses</dfn> of that class.</p>
@@ -151,7 +151,7 @@
the <dfn id="IX-566">initialization protocol</dfn>.</p>
<a name="HEADING-41-5"></a>
<a name="UID-Types_and_Classes-5438"></a>
- <h2 class="subsection-title"><a name="IX-567"></a>Features of Classes</h2>
+ <h2 class="subsection-title"><a name="IX-567">Features of Classes</a></h2>
<p>There are four features of classes. These features relate to each other, but can be
declared independently.</p>
<ul>
@@ -176,14 +176,14 @@
</ul>
<a name="HEADING-41-11"></a>
<a name="UID-Types_and_Classes-2532"></a>
- <h2 class="subsection-title"><a name="IX-577"></a>Creating Classes</h2>
+ <h2 class="subsection-title"><a name="IX-577">Creating Classes</a></h2>
<p>New classes may be created by calling <code id="IX-578">make</code>
on <code><class></code>, or with the definition <code id="IX-579">define
class</code>. In most programs the latter is more commonly used.</p>
<p>When a class is created with <code>make</code>, it is instantiated and returned just like
any other object. The options available when creating a class with <code>make</code> are
described on <a href="Type_Classes#XREF-1372">page 191</a>.</p>
- <p><a name="IX-580"></a>When a class is created with <code>define class</code> it is
+ <p><a name="IX-580">When a class is created</a> with <code>define class</code> it is
used to initialize a new module binding. <code>define class</code> allows the specification
of superclasses, slots, initialization behavior, and options related to sealing. The
complete syntax of <code>define class</code> is given
@@ -203,7 +203,7 @@
</pre>
<a name="HEADING-41-19"></a>
<a name="UID-Types_and_Classes-5460"></a>
- <h2 class="subsection-title"><a name="IX-582"></a><a name="XREF-583"></a>Class Inheritance</h2>
+ <h2 class="subsection-title"><a name="XREF-583"></a><a name="IX-582">Class Inheritance</a></h2>
<p>When a class is created, its <dfn id="IX-584">direct superclasses</dfn> are
specified. The new class directly inherits from these classes; it is
a <dfn id="IX-585">direct subclass</dfn> of each of these classes. There can be no
@@ -215,14 +215,14 @@
an <dfn id="IX-586">indirect subclass</dfn> of <var>C<em><sub>2</sub></em></var>
and <var>C<em><sub>3</sub></em></var>. A <dfn id="IX-587">general subclass</dfn> is a
direct or indirect subclass.</p>
- <p>Inheritance cannot be <a name="IX-588"></a>circular. A class cannot be its own
+ <p>Inheritance cannot be <a name="IX-588">circular</a>. A class cannot be its own
general subclass.</p>
<p>A class is a subtype of each of its general superclasses.</p>
<p>Every class is a general subclass of <code><object></code>.<a name="IX-589"></a></p>
<a name="HEADING-41-25"></a>
<a name="UID-Types_and_Classes-7969"></a>
- <h2 class="subsection-title"><a name="XREF-590"></a><a name="IX-591"></a>Computing the Class Precedence List</h2>
- <p>The definition of a class specifies a <a name="IX-592"></a>total ordering on that
+ <h2 class="subsection-title"><a name="XREF-590"></a><a name="IX-591">Computing the Class Precedence List</a></h2>
+ <p>The definition of a class specifies a <a name="IX-592">total ordering</a> on that
class and its direct superclasses. This ordering is called the <dfn id="IX-593">local
precedence order</dfn>. In the local precedence order:</p>
<ul>
@@ -255,11 +255,11 @@
class. Computing the class precedence list for <var>C</var> requires computing the class
precedence lists for its superclasses. This does not lead to infinite recursion because
circular class inheritance is prohibited.</p>
- <p><a name="IX-595"></a>Note that because the class precedence lists of the direct
- superclasses are consistent with their local precedence orders and with the class precedence
- lists of their direct superclasses, and so on, the class precedence list for <var>C</var> is
- consistent with the local precedence orders and class precedence lists of all its superclasses
- and not just the direct superclasses.</p>
+ <p>Note that because the class precedence lists of the direct superclasses
+ are <a name="IX-595">consistent</a> with their local precedence orders and with the class
+ precedence lists of their direct superclasses, and so on, the class precedence list
+ for <var>C</var> is consistent with the local precedence orders and class precedence lists
+ of all its superclasses and not just the direct superclasses.</p>
<p>The merge of several sequences is a sequence that contains each of the elements of the
several input sequences. An element that appears in more than one of the input sequences
appears only once in the output sequence. If two elements appear in the same input sequence,
Modified: trunk/www/books/drm/Coercing_and_Copying_Objects.html
==============================================================================
--- trunk/www/books/drm/Coercing_and_Copying_Objects.html (original)
+++ trunk/www/books/drm/Coercing_and_Copying_Objects.html Tue Apr 10 00:23:23 2007
@@ -197,7 +197,7 @@
<a name="HEADING-101-0"></a>
<a name="UID-Built-In_Functions-19913"></a>
- <h1 class="section-title"><a name="IX-1674"></a>Coercing and Copying Objects</h1>
+ <h1 class="section-title"><a name="IX-1674">Coercing and Copying Objects</a></h1>
<p>The following functions are used to coerce, copy, or simply return objects.</p>
<a name="HEADING-101-2"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1675">identity</code> </span><span class="attributes-summary">[Function]</span></h4>
@@ -236,7 +236,7 @@
<a name="HEADING-101-8"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1677">values</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="IX-1678"></a>Returns its arguments as multiple values.</p>
+ <p class="short-description">Returns its arguments as <a name="IX-1678">multiple values</a>.</p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -360,13 +360,14 @@
<code> ⇒</code> "Foo"</pre>
</dd>
</dl>
+ <a name="IX-1681"></a>
<a name="HEADING-101-36"></a>
<a name="UID-Built-In_Functions-2983"></a>
<h2 class="subsection-title">Coercing Case</h2>
<a name="HEADING-101-37"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1681"></a><a name="IX-1682"></a>as-uppercase</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code><a name="IX-1682">as-uppercase</a></code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1683"></a>Coerces an object to uppercase.</p>
+ <p class="short-description"><a name="XREF-1683">Coerces an object to uppercase.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -412,7 +413,7 @@
<a name="HEADING-101-48"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1684">as-uppercase!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1685"></a>Coerces an object to uppercase in place.</p>
+ <p class="short-description"><a name="XREF-1685">Coerces an object to uppercase in place.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -455,7 +456,7 @@
<a name="HEADING-101-57"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1686">as-lowercase</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1687"></a>Coerces an object to lowercase.</p>
+ <p class="short-description"><a name="XREF-1687">Coerces an object to lowercase.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -501,7 +502,7 @@
<a name="HEADING-101-68"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1688">as-lowercase!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="IX-1671"></a>Coerces an object to lowercase in place.</p>
+ <p class="short-description"><a name="IX-1671">Coerces an object to lowercase in place.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -546,7 +547,7 @@
<a name="HEADING-101-78"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1691">shallow-copy</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1692"></a>Returns a copy of its argument.</p>
+ <p class="short-description"><a name="XREF-1692">Returns a copy of its argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -590,8 +591,8 @@
<a name="HEADING-101-87"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1693">type-for-copy</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1694"></a>Returns an appropriate type for
- creating mutable copies of its argument.</p>
+ <p class="short-description"><a name="XREF-1694">Returns an appropriate type for
+ creating mutable copies of its argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
Modified: trunk/www/books/drm/Collection_Alignment.html
==============================================================================
--- trunk/www/books/drm/Collection_Alignment.html (original)
+++ trunk/www/books/drm/Collection_Alignment.html Tue Apr 10 00:23:23 2007
@@ -134,13 +134,13 @@
<a name="HEADING-65-0"></a>
<a name="UID-Collections-2808"></a>
- <h1 class="section-title"><a name="XREF-1021"></a>Collection Alignment</h1>
- <p><a name="IX-1022"></a>Some operations on collections are defined to allow the use of
- more than a single collection. For example, some looping functions accept any number of
- collections and operate on these collections in parallel. Each pass through the loop uses one
- element from each collection. The presence of collections that are unstable under iteration
- can create problems for multi-collection operations unless special care is taken. If iteration
- is effectively performed in random order, then naively performing parallel iterations over two
+ <h1 class="section-title"><a name="XREF-1021"></a><a name="IX-1022">Collection Alignment</a></h1>
+ <p>Some operations on collections are defined to allow the use of more than a single
+ collection. For example, some looping functions accept any number of collections and operate
+ on these collections in parallel. Each pass through the loop uses one element from each
+ collection. The presence of collections that are unstable under iteration can create
+ problems for multi-collection operations unless special care is taken. If iteration is
+ effectively performed in random order, then naively performing parallel iterations over two
different collections would randomly combine values from the two collections. This would
presumably have no meaning.</p>
<p>To prevent such random combinations, operations on more than one collection must in general
@@ -162,8 +162,8 @@
target collection is not considered during alignment. Rather, only the source collections are
aligned. New keys may be added to the target collection during the course of the iteration,
and keys may be given new values. Other keys are left undisturbed.</p>
- <p><a name="IX-1024"></a>It is only possible to align collections that have identical
- key tests.<a name="IX-1025"></a></p>
+ <p><a name="IX-1024">It is only possible to align collections that have identical
+ key tests.</a><a name="IX-1025"></a></p>
</div>
Modified: trunk/www/books/drm/Collection_Alteration_and_Allocation.html
==============================================================================
--- trunk/www/books/drm/Collection_Alteration_and_Allocation.html (original)
+++ trunk/www/books/drm/Collection_Alteration_and_Allocation.html Tue Apr 10 00:23:23 2007
@@ -134,11 +134,11 @@
<a name="HEADING-64-0"></a>
<a name="UID-Collections-3519"></a>
- <h1 class="section-title"><a name="XREF-1013"></a>Collection Alteration and Allocation</h1>
- <p><a name="IX-1014"></a>The contents of a collection are the key/value pairs stored in
- the collection. The contents are said to be <dfn>altered</dfn> when:</p>
+ <h1 class="section-title"><a name="XREF-1013"></a><a name="IX-1014">Collection Alteration and Allocation</a></h1>
+ <p>The contents of a collection are the key/value pairs stored in the collection. The contents
+ are said to be <dfn>altered</dfn> when:</p>
<ul>
- <li><a name="IX-1015"></a>Keys are added or removed (according to the collection's key
+ <li><a name="IX-1015">Keys are added or removed</a> (according to the collection's key
test).</li>
<li>The value of a key (according to the key test) changes (as tested
by <code>==</code>).</li>
@@ -150,7 +150,7 @@
documented to do so, functions do not destructively modify their arguments.</p>
<p>The <code>!</code> convention, described on <a href="Naming_Conventions#XREF-342">page
24</a>, is used to indicate some destructive operations.</p>
- <p><a name="IX-1017"></a>Unless explicity noted, destructive operations are not required
+ <p>Unless explicity noted, <a name="IX-1017">destructive operations</a> are not required
to leave their arguments in a well-defined state. More particularly, a destructive operation
does not in general turn the argument into the result. It may reuse components of the argument
or alter the argument in some unpredictable way in order to produce the result. As a general
@@ -158,7 +158,7 @@
<p>A collection <var>C </var>is <dfn id="IX-1018">fresh</dfn> if modification of any
pre-existing collection's contents can never modify the contents of <var>C</var> and if
modifications to <var>C</var> can never modify the contents of any pre-existing
- collection. <a name="IX-1019"></a>Immutable collections cannot be modified, so a fresh
+ collection. <a name="IX-1019">Immutable collections</a> cannot be modified, so a fresh
immutable collection can share structure with other immutable collections.</p>
<p>For example, given that <code><pair></code> is mutable and the result of a call
to <code>list</code> is a fresh instance of <code><pair></code>, we can guarantee that
Modified: trunk/www/books/drm/Collection_Classes.html
==============================================================================
--- trunk/www/books/drm/Collection_Classes.html (original)
+++ trunk/www/books/drm/Collection_Classes.html Tue Apr 10 00:23:23 2007
@@ -205,7 +205,7 @@
<a name="HEADING-93-0"></a>
<a name="UID-Built-In_Classes-9369"></a>
- <h1 class="section-title"><a name="XREF-1398"></a><a name="IX-1399"></a>Collections</h1>
+ <h1 class="section-title"><a name="XREF-1398"></a><a name="IX-1399">Collections</a></h1>
<p>This section describes the built-in collections, Dylan's aggregate data structures.</p>
<p>Collections are used to hold groups of objects. Collections support iteration as well as
random access through collection keys. An overview of collections is given
@@ -213,7 +213,7 @@
<p><a href="#XREF-1400">Figure 11-4</a> shows the built-in collection classes and some of
their characteristics.</p>
<p class="figure"><strong>Figure</strong> <strong>11-4</strong>
- <a name="XREF-1400"></a>The Collection Classes</p>
+ <a name="XREF-1400">The Collection Classes</a></p>
<div class="figure wide" style="min-width: 715px">
<!-- min-width is necessary to prevent the surrounding box from being layed out narrower
@@ -383,9 +383,9 @@
<td><p><a href="Collection_Operations#XREF-1714">298</a></p></td>
</tr><tr>
<td><p><code>forward-iteration-protocol</code></p></td>
- <td><p><a href="Constructing_and_Initializing_Instances#IX-1540">Returns a group
- of functions used to iterate over the elements of a collection.</a></p></td>
- <td><p><a href="Constructing_and_Initializing_Instances#IX-1540">337</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1540">Returns a group of functions used to
+ iterate over the elements of a collection.</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1540">337</a></p></td>
</tr><tr>
<td><p><code>backward-iteration-protocol</code></p></td>
<td><p><a href="Collection_Operations#XREF-1850">Returns a group of functions used
@@ -489,7 +489,7 @@
<dt><span>Description:</span></dt>
<dd>
<p>The class of collections whose keys are consecutive integers starting from zero.</p>
- <p><a name="IX-1404"></a>Sequences must be stable under iteration, and the iteration
+ <p><a name="IX-1404">Sequences must be stable under iteration</a>, and the iteration
order must match the order of keys. Thus, the key associated with a sequence's iteration
state can be determined by keeping a counter in parallel with the iteration state.</p>
<p><code><a name="IX-1405"></a><a name="IX-1406"></a><a name="IX-1407"></a><a name="IX-1408"></a><a name="IX-1409"></a><a name="IX-1410"></a><a name="IX-1411"></a><a name="IX-1412"></a><a name="IX-1413"></a><a name="IX-1414"></a><a name="IX-1415"></a><a name="IX-1416"></a></code>
@@ -901,8 +901,8 @@
<dd>
<p>The class of collections that may grow or shrink to accommodate adding or removing
elements.</p>
- <p><a name="IX-1423"></a>Stretchy collections
- allow <code id="IX-1424">element-setter </code>to be called with a key that is not
+ <p><a name="IX-1423">Stretchy collections</a>
+ allow <code id="IX-1424">element-setter</code> to be called with a key that is not
present in the collection, expanding the collection as necessary to add a new element in
that case. Each concrete subclass of <code><stretchy-collection></code> must
provide or inherit a method for <code>element-setter </code>that behaves as follows when
@@ -941,9 +941,9 @@
</dl>
<a name="HEADING-93-1239"></a>
<a name="UID-Built-In_Classes-420"></a>
- <h2 class="subsection-title">Arrays</h2>
+ <h2 class="subsection-title"><a name="IX-1425">Arrays</a></h2>
<a name="HEADING-93-1240"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1425"></a><a name="XREF-1426"></a><a name="IX-1427"></a><array></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1426"></a><code id="IX-1427"><array></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
<hr class="item-title" />
<p>The class of sequences whose elements are arranged according to a Cartesian coordinate
system.</p>
@@ -983,7 +983,7 @@
subclasses of <code><array></code> that are used for this purpose. These concrete
subclasses have no specified names, and their names are not exported by the Dylan
module.</p>
- <p><a name="IX-1428"></a>When a single-dimensional array is created, the array
+ <p>When a <a name="IX-1428">single-dimensional array</a> is created, the array
created will be an instance of <code><vector></code>.</p>
<p>Each concrete subclass of <code><array></code> must either provide or inherit
implementations of the
@@ -1092,9 +1092,9 @@
</dl>
<a name="HEADING-93-1510"></a>
<a name="UID-Built-In_Classes-16948"></a>
- <h2 class="subsection-title">Vectors</h2>
+ <h2 class="subsection-title"><a name="IX-1430">Vectors</a></h2>
<a name="HEADING-93-1511"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1430"></a><a name="IX-1431"></a><a name="XREF-1432"></a><vector></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1432"></a><code id="IX-1431"><vector></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
<hr class="item-title" />
<p>The class of arrays of rank one (i.e., exactly one dimension).</p>
<dl class="Cliche">
@@ -1180,7 +1180,7 @@
</dd>
</dl>
<a name="HEADING-93-1652"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1434"></a><a name="XREF-1435"></a><simple-vector></code> </span><span class="attributes-summary">[Sealed Abstract Instantiable Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1435"></a><code id="IX-1434"><simple-vector></code> </span><span class="attributes-summary">[Sealed Abstract Instantiable Class]</span></h4>
<hr class="item-title" />
<p>A predefined subclass of <code><vector></code> that provides an efficient
implementation of fixed-length vectors.</p>
@@ -1202,14 +1202,14 @@
<dt><span>Description:</span></dt>
<dd>
<p>The class of simple and efficient vectors.</p>
- <p><a name="IX-1436"></a>The class <code><simple-vector></code> provides a
- constant time implementation for the <code>element</code>
- and <code>element-setter </code>functions. This property is shared by all subtypes
- of <code><simple-vector></code>.</p>
+ <p><a name="IX-1436">The class <code><simple-vector></code> provides a constant time
+ implementation for the <code>element</code> and <code>element-setter</code>
+ functions. This property is shared by all subtypes
+ of <code><simple-vector></code>.</a></p>
<p>Calling <code>make</code> on a <code><simple-vector></code> returns an instance
of <code><simple-object-vector></code>. The size of a simple vector cannot be
changed after the simple vector has been created.</p>
- <p><a name="IX-1437"></a>Vector literals (created with
+ <p><a name="IX-1437">Vector literals</a> (created with
the <code>#[</code>…<code>]</code> syntax) are general instances
of <code><simple-vector></code>.</p>
<p>The element type of <code><simple-vector></code> is <code>indefinite ⇐
@@ -1356,7 +1356,7 @@
<a name="UID-Built-In_Classes-25928"></a>
<h2 class="subsection-title">Deques</h2>
<a name="HEADING-93-1863"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1441"></a><a name="XREF-1442"></a><deque></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1442"></a><code id="IX-1441"><deque></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
<hr class="item-title" />
<p>The class of double-ended queues.</p>
<dl class="Cliche">
@@ -1454,12 +1454,11 @@
</dl>
<a name="HEADING-93-2045"></a>
<a name="UID-Built-In_Classes-423"></a>
- <h2 class="subsection-title"><a name="IX-1443"></a>Lists</h2>
+ <h2 class="subsection-title"><a name="IX-1443">Lists</a></h2>
<p>Lists are constructed by linking together instances
- of <code><pair></code>. The <a name="IX-1444"></a>head of a list contains an
- element, and the <a name="IX-1445"></a>tail of the list contains a pointer to the next
- pair in the list. The list ends when the tail of a pair contains something besides another
- pair.</p>
+ of <code><pair></code>. The <a name="IX-1444">head</a> of a list contains an element,
+ and the <a name="IX-1445">tail</a> of the list contains a pointer to the next pair in the
+ list. The list ends when the tail of a pair contains something besides another pair.</p>
<p>A <dfn id="IX-1446">proper list</dfn> has a final pair with a tail containing the
empty list.</p>
<p>An <dfn id="IX-1447">improper list</dfn> does not have a final pair with a tail
@@ -1473,7 +1472,7 @@
<p>When treated as a collection, the elements of a list are the heads of successive pairs in
the list.</p>
<a name="HEADING-93-2050"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1448"></a><a name="XREF-1449"></a><list></code> </span><span class="attributes-summary">[Sealed Instantiable Abstract Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1449"></a><code id="IX-1448"><list></code> </span><span class="attributes-summary">[Sealed Instantiable Abstract Class]</span></h4>
<hr class="item-title" />
<p>The class of linked lists.</p>
<dl class="Cliche">
@@ -1657,7 +1656,7 @@
<a name="UID-Built-In_Classes-427"></a>
<h2 class="subsection-title">Ranges</h2>
<a name="HEADING-93-2364"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1453"></a><a name="XREF-1454"></a><range></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1454"></a><code id="IX-1453"><range></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
<hr class="item-title" />
<p>The class of arithmetic sequences.</p>
<dl class="Cliche">
@@ -1785,9 +1784,9 @@
</dl>
<a name="HEADING-93-2560"></a>
<a name="UID-Built-In_Classes-428"></a>
- <h2 class="subsection-title">Strings</h2>
+ <h2 class="subsection-title"><a name="IX-1456">Strings</a></h2>
<a name="HEADING-93-2561"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1455"></a><a name="IX-1456"></a><string></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1455"><string></code> </span><span class="attributes-summary">[Open Abstract Instantiable Class]</span></h4>
<hr class="item-title" />
<p>The class of sequences with elements that are characters.</p>
<dl class="Cliche">
@@ -1965,17 +1964,16 @@
</dl>
<a name="HEADING-93-2809"></a>
<a name="UID-Built-In_Classes-429"></a>
- <h2 class="subsection-title">Tables</h2>
- <p><a name="IX-1460"></a>Also called a hash table, a table is an unordered mapping
- between arbitrary keys and elements. Tables are the only predefined collections that are
- unstable under iteration.</p>
+ <h2 class="subsection-title"><a name="IX-1460">Tables</a></h2>
+ <p>Also called a hash table, a table is an unordered mapping between arbitrary keys and
+ elements. Tables are the only predefined collections that are unstable under iteration.</p>
<p>Tables are stretchy in that they allow the addition and removal of
keys. <code><table></code> and its subclasses are the only predefined classes that are
stretchy but are not stretchy sequences.</p>
<p>For a complete description of tables, see <a href="Tables#XREF-1036"><q>Tables</q> on
page 122</a>.</p>
<a name="HEADING-93-2813"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1461"></a><a name="XREF-1462"></a><table></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="XREF-1462"></a><code id="IX-1461"><table></code> </span><span class="attributes-summary">[Open Abstract Instantiable Primary Class]</span></h4>
<hr class="item-title" />
<p>The class of tables (also known as hash tables).</p>
<dl class="Cliche">
@@ -2026,18 +2024,18 @@
<th><p>Page</p></th>
</tr><tr>
<td><p><code>forward-iteration-protocol</code></p></td>
- <td><p><a href="Constructing_and_Initializing_Instances#IX-1540">Returns a group
- of functions used to iterate over the elements of a collection.</a></p></td>
- <td><p><a href="Constructing_and_Initializing_Instances#IX-1540">337</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1540">Returns a group of functions used to
+ iterate over the elements of a collection.</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1540">337</a></p></td>
</tr><tr>
<td><p><code>table-protocol</code></p></td>
- <td><p><a href="Collection_Operations#XREF-1852">Returns functions used to
- implement the iteration protocol for tables.</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1852">Returns functions used to implement
+ the iteration protocol for tables.</a></p></td>
<td><p><a href="Collection_Operations#XREF-1852">340</a></p></td>
</tr><tr>
<td><p><code>remove-key!</code></p></td>
- <td><p><a href="Collection_Operations#XREF-1840">Modifies an explicit key
- collection so it no longer has a particular key.</a></p></td>
+ <td><p><a href="Collection_Operations#XREF-1840">Modifies an explicit key collection
+ so it no longer has a particular key.</a></p></td>
<td><p><a href="Collection_Operations#XREF-1840">335</a></p></td>
</tr><tr>
<td><p><code>element</code></p></td>
Modified: trunk/www/books/drm/Collection_Keys.html
==============================================================================
--- trunk/www/books/drm/Collection_Keys.html (original)
+++ trunk/www/books/drm/Collection_Keys.html Tue Apr 10 00:23:23 2007
@@ -134,13 +134,13 @@
<a name="HEADING-61-0"></a>
<a name="UID-Collections-3027"></a>
- <h1 class="section-title"><a name="XREF-996"></a>Collection Keys</h1>
- <p><a name="IX-997"></a>All collections in Dylan are keyed. That is, all collections can
- be viewed abstractly as partial functions that map keys to elements. (This choice precludes
- pure sets from being considered collections, although it is straightforward simply to ignore
- the keys for a collection and consider it simply as a set of elements.)
- The <code id="IX-998">element</code> function implements this partial mapping of keys
- to elements.</p>
+ <h1 class="section-title"><a name="XREF-996"></a><a name="IX-997">Collection Keys</a></h1>
+ <p>All collections in Dylan are keyed. That is, all collections can be viewed abstractly as
+ partial functions that map keys to elements. (This choice precludes pure sets from being
+ considered collections, although it is straightforward simply to ignore the keys for a
+ collection and consider it simply as a set of elements.)
+ The <code id="IX-998">element</code> function implements this partial mapping of keys to
+ elements.</p>
<p>Every collection has a <dfn id="IX-999">key test</dfn>, which is the test used for
determining whether a given key matches a key in the collection. The key test of a
collection can be accessed using the <code id="IX-1000">key-test</code> function.</p>
Modified: trunk/www/books/drm/Collection_Operations.html
==============================================================================
--- trunk/www/books/drm/Collection_Operations.html (original)
+++ trunk/www/books/drm/Collection_Operations.html Tue Apr 10 00:23:23 2007
@@ -353,10 +353,10 @@
<a name="HEADING-102-0"></a>
<a name="UID-Built-In_Functions-3130"></a>
- <h1 class="section-title"><a name="XREF-1696"></a>Collection Operations</h1>
- <p><a name="IX-1697"></a>The generic functions described in this section have predefined
- methods for the built-in collection classes (and sequence classes, where appropriate). The
- details of these predefined methods have not yet been specified.</p>
+ <h1 class="section-title"><a name="XREF-1696"></a><a name="IX-1697">Collection Operations</a></h1>
+ <p>The generic functions described in this section have predefined methods for the built-in
+ collection classes (and sequence classes, where appropriate). The details of these
+ predefined methods have not yet been specified.</p>
<p>Note to implementors: Functions such as <code>map</code>, <code>map-as</code> that return a
new collection cannot rely on the type they instantiate having a valid default
for <code>fill:</code>. Therefore, when the size of the result is nonzero, these functions
@@ -365,11 +365,11 @@
making the collection.</p>
<a name="HEADING-102-3"></a>
<a name="UID-Built-In_Functions-21096"></a>
- <h2 class="subsection-title">Collection Properties</h2>
+ <h2 class="subsection-title"><a name="IX-1698">Collection Properties</a></h2>
<a name="HEADING-102-4"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1698"></a><a name="IX-1699"></a>empty?</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1699">empty?</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1700"></a>Returns true if its argument is empty.</p>
+ <p class="short-description"><a name="XREF-1700">Returns true if its argument is empty.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -468,7 +468,7 @@
<a name="HEADING-102-29"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1703">size-setter</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1704"></a>Sets the size of an object.</p>
+ <p class="short-description"><a name="XREF-1704">Sets the size of an object.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -520,7 +520,7 @@
<a name="HEADING-102-40"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1705">rank</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1706"></a>Returns the number of dimensions of an array.</p>
+ <p class="short-description"><a name="XREF-1706">Returns the number of dimensions of an array.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -559,7 +559,7 @@
<a name="HEADING-102-48"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1707">row-major-index</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1708"></a>Returns the row-major-index position of an array element.</p>
+ <p class="short-description"><a name="XREF-1708">Returns the row-major-index position of an array element.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -604,7 +604,7 @@
<a name="HEADING-102-58"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1709">dimensions</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1710"></a>Returns the dimensions of an array.</p>
+ <p class="short-description"><a name="XREF-1710">Returns the dimensions of an array.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -646,7 +646,7 @@
<a name="HEADING-102-66"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1711">dimension</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1712"></a>Returns the size of a specified dimension of an array.</p>
+ <p class="short-description"><a name="XREF-1712">Returns the size of a specified dimension of an array.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -690,7 +690,7 @@
<a name="HEADING-102-76"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1713">key-test</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1714"></a>Returns the function used by its collection argument to compare keys.</p>
+ <p class="short-description"><a name="XREF-1714">Returns the function used by its collection argument to compare keys.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -782,11 +782,11 @@
</dl>
<a name="HEADING-102-95"></a>
<a name="UID-Built-In_Functions-415"></a>
- <h2 class="subsection-title">Selecting Elements</h2>
+ <h2 class="subsection-title"><a name="IX-1719">Selecting Elements</a></h2>
<a name="HEADING-102-96"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1718"><a name="IX-1719"></a>element</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1718">element</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><code><a name="XREF-1720"></a></code>Returns the collection element associated with a particular key.</p>
+ <p class="short-description"><a name="XREF-1720">Returns the collection element associated with a particular key.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -845,7 +845,7 @@
<a name="HEADING-102-113"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1721">element-setter</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1722"></a>Sets the collection element associated with a particular key.</p>
+ <p class="short-description"><a name="XREF-1722">Sets the collection element associated with a particular key.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -919,7 +919,7 @@
<a name="HEADING-102-133"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1723">aref</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1724"></a>Returns the array element indicated by a set of indices.</p>
+ <p class="short-description"><a name="XREF-1724">Returns the array element indicated by a set of indices.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -964,7 +964,7 @@
<a name="HEADING-102-143"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1725">aref-setter </code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1726"></a>Sets the array element indicated by a set of indices.</p>
+ <p class="short-description"><a name="XREF-1726">Sets the array element indicated by a set of indices.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1014,7 +1014,7 @@
<a name="HEADING-102-155"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1727">first</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1728"></a>Returns the first element of a sequence.</p>
+ <p class="short-description"><a name="XREF-1728">Returns the first element of a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1052,7 +1052,7 @@
<a name="HEADING-102-163"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1729">second</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1730"></a>Returns the second element of a sequence.</p>
+ <p class="short-description"><a name="XREF-1730">Returns the second element of a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1087,7 +1087,7 @@
<a name="HEADING-102-170"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1731">third</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1732"></a>Returns the third element of a sequence.</p>
+ <p class="short-description"><a name="XREF-1732">Returns the third element of a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1122,7 +1122,7 @@
<a name="HEADING-102-177"></a>
<h4 class="item-title"><span class="signature"><code id="XREF-1637">first-setter</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1734"></a>Sets the first element of a mutable sequence.</p>
+ <p class="short-description"><a name="XREF-1734">Sets the first element of a mutable sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1162,7 +1162,7 @@
<a name="HEADING-102-185"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1735">second-setter</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1736"></a>Sets the second element of a mutable sequence.</p>
+ <p class="short-description"><a name="XREF-1736">Sets the second element of a mutable sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1198,7 +1198,7 @@
<a name="HEADING-102-192"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1737">third-setter</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1738"></a>Sets the third element of a mutable sequence.</p>
+ <p class="short-description"><a name="XREF-1738">Sets the third element of a mutable sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1276,7 +1276,7 @@
<a name="HEADING-102-208"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1741">last-setter</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1742"></a>Sets the last element of a mutable sequence.</p>
+ <p class="short-description"><a name="XREF-1742">Sets the last element of a mutable sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1329,7 +1329,7 @@
<a name="HEADING-102-219"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1743">head</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1744"></a>Returns the head of a list.</p>
+ <p class="short-description"><a name="XREF-1744">Returns the head of a list.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1372,7 +1372,7 @@
<a name="HEADING-102-227"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1745">tail</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1746"></a>Returns the tail of a list.</p>
+ <p class="short-description"><a name="XREF-1746">Returns the tail of a list.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1415,7 +1415,7 @@
<a name="HEADING-102-235"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1747">head-setter</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1748"></a>Sets the head of a pair.</p>
+ <p class="short-description"><a name="XREF-1748">Sets the head of a pair.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1459,7 +1459,7 @@
<a name="HEADING-102-244"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1749">tail-setter</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1750"></a>Sets the tail of a pair.</p>
+ <p class="short-description"><a name="XREF-1750">Sets the tail of a pair.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1510,11 +1510,11 @@
</dl>
<a name="HEADING-102-253"></a>
<a name="UID-Built-In_Functions-29552"></a>
- <h2 class="subsection-title">Adding and Removing Elements</h2>
+ <h2 class="subsection-title"><a name="IX-1752">Adding and Removing Elements</a></h2>
<a name="HEADING-102-254"></a>
- <h4 class="item-title"><span class="signature"><code><a name="IX-1752"></a><a name="IX-1753"></a>add</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1753">add</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1754"></a>Adds an element to a sequence.</p>
+ <p class="short-description"><a name="XREF-1754">Adds an element to a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1562,7 +1562,7 @@
<a name="HEADING-102-264"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1755">add!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1756"></a>Adds an element to a sequence.</p>
+ <p class="short-description"><a name="XREF-1756">Adds an element to a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1629,7 +1629,7 @@
<a name="HEADING-102-280"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1757">add-new</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1758"></a>Adds a new element to a sequence.</p>
+ <p class="short-description"><a name="XREF-1758">Adds a new element to a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1681,7 +1681,7 @@
<a name="HEADING-102-291"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1759">add-new!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1760"></a>Adds a new element to a sequence.</p>
+ <p class="short-description"><a name="XREF-1760">Adds a new element to a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1733,7 +1733,7 @@
<a name="HEADING-102-302"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1761">remove</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="IX-1762"></a><a name="XREF-1763"></a>Removes an element from a sequence.</p>
+ <p class="short-description"><a name="IX-1762"></a><a name="XREF-1763">Removes an element from a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1793,7 +1793,7 @@
<a name="HEADING-102-314"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1764">remove!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1765"></a>Removes an element from a sequence.</p>
+ <p class="short-description"><a name="XREF-1765">Removes an element from a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1860,7 +1860,7 @@
<a name="HEADING-102-331"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1766">push</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1767"></a>Adds an element to the front of a deque.</p>
+ <p class="short-description"><a name="XREF-1767">Adds an element to the front of a deque.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1897,7 +1897,7 @@
<a name="HEADING-102-339"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1768">pop</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1769"></a>Removes and returns the first element of a deque.</p>
+ <p class="short-description"><a name="XREF-1769">Removes and returns the first element of a deque.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1932,7 +1932,7 @@
<a name="HEADING-102-346"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1770">push-last</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1771"></a>Adds an element to the end of a deque.</p>
+ <p class="short-description"><a name="XREF-1771">Adds an element to the end of a deque.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -1969,7 +1969,7 @@
<a name="HEADING-102-354"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1772">pop-last</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1773"></a>Removes and returns an element from the end of a deque.</p>
+ <p class="short-description"><a name="XREF-1773">Removes and returns an element from the end of a deque.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2004,11 +2004,11 @@
</dl>
<a name="HEADING-102-361"></a>
<a name="UID-Built-In_Functions-9856"></a>
- <h2 class="subsection-title"><a name="IX-1776"></a>Reordering Elements</h2>
+ <h2 class="subsection-title"><a name="IX-1776">Reordering Elements</a></h2>
<a name="HEADING-102-362"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1777">reverse</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1778"></a>Returns a sequence with elements in the reverse order of its argument sequence.</p>
+ <p class="short-description"><a name="XREF-1778">Returns a sequence with elements in the reverse order of its argument sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2060,7 +2060,7 @@
<a name="HEADING-102-373"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1779">reverse!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1780"></a>Returns a sequence with elements in the reverse order of its argument sequence.</p>
+ <p class="short-description"><a name="XREF-1780">Returns a sequence with elements in the reverse order of its argument sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2118,7 +2118,7 @@
<a name="HEADING-102-384"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1781">sort</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1782"></a>Returns a sequence containing the elements of its argument sequence, sorted.</p>
+ <p class="short-description"><a name="XREF-1782">Returns a sequence containing the elements of its argument sequence, sorted.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2178,7 +2178,7 @@
<a name="HEADING-102-395"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1783">sort!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1784"></a>Returns a sequence containing the elements of its argument sequence, sorted.</p>
+ <p class="short-description"><a name="XREF-1784">Returns a sequence containing the elements of its argument sequence, sorted.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2243,11 +2243,11 @@
</dl>
<a name="HEADING-102-407"></a>
<a name="UID-Built-In_Functions-2737"></a>
- <h2 class="subsection-title"><a name="IX-1786"></a>Set Operations</h2>
+ <h2 class="subsection-title"><a name="IX-1786">Set Operations</a></h2>
<a name="HEADING-102-408"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1787">intersection</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1788"></a>Returns the intersection of two sequences.</p>
+ <p class="short-description"><a name="XREF-1788">Returns the intersection of two sequences.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2305,7 +2305,7 @@
<a name="HEADING-102-421"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1789">union</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1790"></a>Returns the union of two sequences.</p>
+ <p class="short-description"><a name="XREF-1790">Returns the union of two sequences.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2360,7 +2360,7 @@
<a name="HEADING-102-433"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1791">remove-duplicates</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1792"></a>Returns a sequence without duplicates.</p>
+ <p class="short-description"><a name="XREF-1792">Returns a sequence without duplicates.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2412,7 +2412,7 @@
<a name="HEADING-102-443"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1793">remove-duplicates!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1794"></a>Returns a sequence without duplicates.</p>
+ <p class="short-description"><a name="XREF-1794">Returns a sequence without duplicates.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2469,9 +2469,9 @@
<a name="UID-Built-In_Functions-2699"></a>
<h2 class="subsection-title">Subsequence Operations</h2>
<a name="HEADING-102-454"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1796">copy-sequence </code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1798"></a><code id="IX-1796">copy-sequence</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1797"></a><a name="IX-1798"></a>Returns a freshly allocated copy of some subsequence of a sequence.</p>
+ <p class="short-description"><a name="XREF-1797">Returns a freshly allocated copy of some subsequence of a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2514,15 +2514,17 @@
copy-sequence (hamlet, start: 2, end: 4)
<code> ⇒</code> #("or", "not")</pre>
<a name="HEADING-102-463"></a>
- <h5 class="method-signature"><span class="signature"><code>copy-sequence</code> <var>range</var> <code>#key</code> <var>start end</var> ⇒ <var>new-range</var> </span><span class="attributes-summary">[Sealed G.F. Method]</span></h5>
+ <h5 class="method-signature"><span class="signature"><code>copy-sequence</code> <var>range</var> <code>#key</code> <var>start end</var> ⇒ <var>new-range</var> </span><span class="attributes-summary">[Sealed G.F. Method]</span></h5>
<p>When applied to a range, <code>copy-sequence</code> returns another range, even though
the <code>type-for-copy</code> of a range is the <code><list></code> class.</p>
</dd>
</dl>
<a name="HEADING-102-465"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1799">concatenate</code> </span><span class="attributes-summary">[Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1799">concatenate</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1800"></a>Returns the concatenation of one or more sequences in a sequence of a type determined by the <code>type-for-copy</code> of its first argument.</p>
+ <p class="short-description"><a name="XREF-1800">Returns the concatenation of one or more
+ sequences in a sequence of a type determined by the <code>type-for-copy</code> of its first
+ argument.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2569,9 +2571,9 @@
</dd>
</dl>
<a name="HEADING-102-475"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1801">concatenate-as </code> </span><span class="attributes-summary">[Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1801">concatenate-as</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1802"></a>Returns the concatenation of one or more sequences in a sequence of a specified type.</p>
+ <p class="short-description"><a name="XREF-1802">Returns the concatenation of one or more sequences in a sequence of a specified type.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2622,7 +2624,7 @@
<a name="HEADING-102-486"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1803">replace-subsequence!</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1804"></a>Replaces a portion of a sequence with the elements of another sequence.</p>
+ <p class="short-description"><a name="XREF-1804">Replaces a portion of a sequence with the elements of another sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2689,7 +2691,7 @@
<a name="HEADING-102-500"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1805">subsequence-position</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1806"></a>Returns the position where a pattern appears in a sequence.</p>
+ <p class="short-description"><a name="XREF-1806">Returns the position where a pattern appears in a sequence.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2741,10 +2743,10 @@
</dl>
<a name="HEADING-102-511"></a>
<a name="UID-Built-In_Functions-3007"></a>
- <h2 class="subsection-title">Mapping and Reducing</h2>
+ <h2 class="subsection-title"><a name="IX-1808">Mapping and Reducing</a></h2>
<a name="HEADING-102-512"></a>
<h3 class="sub-subsection-title">Simple Mapping</h3>
- <p><a name="IX-1807"></a><a name="IX-1808"></a>The following mapping functions
+ <p>The following <a name="IX-1807">mapping functions</a>
(<code>do</code>, <code>map</code>, <code>map-as</code>, <code>map-into</code>, <code>any?</code>, <code>every?</code>)
iterate over a number of source collections. Each time through the iteration, a function is
applied to one element from each of the source collections. The number of arguments to the
@@ -2753,7 +2755,7 @@
<a name="HEADING-102-515"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1809">do</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1810"></a>Iterates over one or more collections for side effect.</p>
+ <p class="short-description"><a name="XREF-1810">Iterates over one or more collections for side effect.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2801,9 +2803,9 @@
</dd>
</dl>
<a name="HEADING-102-524"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1811">map</code> </span><span class="attributes-summary">[Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><code id="IX-1811">map</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1812"></a>Iterates over one or more collections and collects the results in a freshly allocated collection.</p>
+ <p class="short-description"><a name="XREF-1812">Iterates over one or more collections and collects the results in a freshly allocated collection.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2852,9 +2854,9 @@
</dd>
</dl>
<a name="HEADING-102-534"></a>
- <h4 class="item-title"><code id="IX-1813">map-as</code><span class="attributes-summary"> [Function]</span> </h4>
+ <h4 class="item-title"><code id="IX-1813">map-as</code> <span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1814"></a>Iterates over one or more collections and collects the results in a freshly allocated collection of a specified type.</p>
+ <p class="short-description"><a name="XREF-1814">Iterates over one or more collections and collects the results in a freshly allocated collection of a specified type.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2914,7 +2916,7 @@
<a name="HEADING-102-544"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1815">map-into</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1816"></a>Iterates over one or more collections and collects the results in an existing mutable collection.</p>
+ <p class="short-description"><a name="XREF-1816">Iterates over one or more collections and collects the results in an existing mutable collection.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -2979,9 +2981,9 @@
</dd>
</dl>
<a name="HEADING-102-558"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1817">any? </code> </span><span class="attributes-summary">[Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1819"></a><code id="IX-1817">any?</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1818"></a><a name="IX-1819"></a>Returns the first true value obtained by iterating over one or more collections.</p>
+ <p class="short-description"><a name="XREF-1818">Returns the first true value obtained by iterating over one or more collections.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3029,9 +3031,9 @@
</dd>
</dl>
<a name="HEADING-102-568"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1820">every? </code> </span><span class="attributes-summary">[Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1822"></a><code id="IX-1820">every?</code> </span><span class="attributes-summary">[Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1821"></a><a name="IX-1822"></a>Returns true if a predicate returns true when applied to all corresponding elements of a set of collections.</p>
+ <p class="short-description"><a name="XREF-1821">Returns true if a predicate returns true when applied to all corresponding elements of a set of collections.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3083,7 +3085,7 @@
<a name="HEADING-102-579"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1823">reduce</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1824"></a>Combines the elements of a collection and a seed value into a single value by repeatedly applying a binary function.</p>
+ <p class="short-description"><a name="XREF-1824">Combines the elements of a collection and a seed value into a single value by repeatedly applying a binary function.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3138,7 +3140,7 @@
<a name="HEADING-102-590"></a>
<h4 class="item-title"><span class="signature"><code id="IX-1825">reduce1</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1826"></a>Combines the elements of a collection into a single value by repeatedly applying a binary function, using the first element of the collection as the seed value.</p>
+ <p class="short-description"><a name="XREF-1826">Combines the elements of a collection into a single value by repeatedly applying a binary function, using the first element of the collection as the seed value.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3184,9 +3186,9 @@
</dd>
</dl>
<a name="HEADING-102-601"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1827">choose</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1829"></a><code id="IX-1827">choose</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1828"></a><a name="IX-1829"></a>Returns those elements of a sequence that satisfy a predicate.</p>
+ <p class="short-description"><a name="XREF-1828">Returns those elements of a sequence that satisfy a predicate.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3225,9 +3227,9 @@
</dd>
</dl>
<a name="HEADING-102-609"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1830">choose-by </code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1832"></a><code id="IX-1830">choose-by</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1831"></a><a name="IX-1832"></a>Returns those elements of a sequence that correspond to those in another sequence that satisfy a predicate.</p>
+ <p class="short-description"><a name="XREF-1831">Returns those elements of a sequence that correspond to those in another sequence that satisfy a predicate.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3272,9 +3274,9 @@
<a name="HEADING-102-618"></a>
<h3 class="sub-subsection-title">Other Mapping Functions</h3>
<a name="HEADING-102-619"></a>
- <h4 class="item-title"><span class="signature"><code id="IX-1833">member?</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
+ <h4 class="item-title"><span class="signature"><a name="IX-1835"></a><code id="IX-1833">member?</code> </span><span class="attributes-summary">[Open Generic Function]</span></h4>
<hr class="item-title" />
- <p class="short-description"><a name="XREF-1834"></a>Returns true if a collection contains a particular value.</p>
+ <p class="short-description"><a name="XREF-1834">Returns true if a collection contains a particular value.</a></p>
<dl class="Cliche">
<dt><span>Signature:</span></dt>
<dd>
@@ -3307,8 +3309,8 @@
</dd>
<dt><span>Description:</span></dt>
<dd>
- <p><a name="IX-1835"></a>Returns true if <var>collection</var>
- contains <var>value</var> as determined by <var>test</var>. Otherwise returns false.</p>
+ <p>Returns true if <var>collection</var> contains <var>value</var> as determined
+ by <var>test</var>. Otherwise returns false.</p>
<p>The <var>test</var> function may be noncommutative: it is always called
with &l