Changeset 4497 for trunk/manuals

Timestamp:

10/11/08 09:55:29 (3 months ago)

Author:

pmoura

Message:

Minor documentation improvements.

Location:

trunk/manuals

Files:

• index.html (modified) (1 diff)
• refman/builtins/create_category4.html (modified) (2 diffs)
• refman/builtins/create_object4.html (modified) (1 diff)
• refman/builtins/create_protocol3.html (modified) (2 diffs)
• refman/refman.sh (modified) (1 diff)
• userman/index.html (modified) (1 diff)
• userman/inheritance.html (modified) (3 diffs)
• userman/predicates.html (modified) (2 diffs)
• userman/userman.header (modified) (1 diff)
• userman/userman.sh (modified) (1 diff)

trunk/manuals/index.html

@@ -32 +32 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/> 
-        <span>Last updated on: October 7, 2008</span>
+        <span>Last updated on: October 11, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/builtins/create_category4.html

@@ -26 +26 @@
 <pre>create_category(Identifier, Relations, Directives, Clauses)</pre>
 <p>
-Creates a new, dynamic category.
+Creates a new, dynamic category. This predicate is often used as a primitive to implement high-level category creation methods.
 </p>
 
@@ -64 +64 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/> 
-        <span>Last updated on: May 23, 2008</span>
+        <span>Last updated on: October 7, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/builtins/create_object4.html

@@ -26 +26 @@
 <pre>create_object(Identifier, Relations, Directives, Clauses)</pre>
 <p>
-Creates a new, dynamic object. The word <a class="glossary" title="Go to glossary definition" href="../../glossary.html#object"><em>object</em></a> is used here as a generic term. This predicate can be used to create new prototypes, instances, and classes. This predicate is often used as a primitive to implement object creation methods. 
+Creates a new, dynamic object. The word <a class="glossary" title="Go to glossary definition" href="../../glossary.html#object"><em>object</em></a> is used here as a generic term. This predicate can be used to create new prototypes, instances, and classes. This predicate is often used as a primitive to implement high-level object creation methods. 
 </p>
 

trunk/manuals/refman/builtins/create_protocol3.html

@@ -26 +26 @@
 <pre>create_protocol(Identifier, Relations, Directives)</pre>
 <p>
-Creates a new, dynamic protocol.
+Creates a new, dynamic protocol. This predicate is often used as a primitive to implement high-level protocol creation methods.
 </p>
 
@@ -61 +61 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/> 
-        <span>Last updated on: May 23, 2008</span>
+        <span>Last updated on: October 7, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/refman.sh

@@ -11 +11 @@
 ## ================================================================
 
-css2xslfo=/Applications/XML/CSSToXSLFO/css2xslfo1_5_2.jar
+css2xslfo=/Applications/XML/CSSToXSLFO/css2xslfo1_6.jar
 
 xslt_proc=xsltproc

trunk/manuals/userman/index.html

@@ -304 +304 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>
-        <span>Last updated on: October 4, 2008</span>
+        <span>Last updated on: October 11, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/userman/inheritance.html

@@ -25 +25 @@
 The inheritance mechanisms found on object-oriented programming languages allow us the specialization of previously defined objects, avoiding the unnecessary repetition of code. In the context of logic programming, we can interpret inheritance as a form of theory extension: an object will virtually contain, besides its own predicates, all the predicates inherited from other objects that are not redefined by itself.
 </p>
+<p>
+Logtalk uses a depth-first lookup procedure for finding predicate declarations and predicate definitions, as explained below. The <a title="Consult reference manual" href="../refman/directives/alias3.html"><code>alias/3</code></a> predicate directive may be used to solve inheritance conflicts and for defining alternative names for inherited predicates.
+</p>
 
 <h2 id="inheritance_protocol">Protocol inheritance</h2>
@@ -35 +38 @@
 
 <p>
-The search order for predicate declarations is first the object, second the implemented protocols (and the protocols that these may extend), third the imported categories (and the protocols that they may implement), and last the objects that the object extends. This search is performed in a depth-first way. When an object inherits two different declarations for the same predicate, by default only the first one will be considered.
+The search order for predicate declarations is first the object, second the implemented protocols (and the protocols that these may extend), third the imported categories (and the protocols that they may implement), and last the objects that the object extends. This search is performed in a depth-first way. When an object inherits two different declarations for the same predicate, by default, only the first one will be considered.
 </p>
 
@@ -251 +254 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/> 
-        <span>Last updated on: February 13, 2007</span>
+        <span>Last updated on: October 11, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/userman/predicates.html

@@ -148 +148 @@
 <pre>:- dynamic(foo/1).</pre>
 <p>
-This directive may also be used to declare dynamic grammar rule non-terminals. As each Logtalk entity is compiled independently from other entities, this directive must be included in every object that contains a definition for the described predicate (even if the predicate declaration is inherited from other object or imported from a category). If we omit the dynamic declaration then the predicate definition will be compiled to static code. Note that any static object may declare and define dynamic predicates.
+This directive may also be used to declare dynamic grammar rule non-terminals. As each Logtalk entity is compiled independently from other entities, this directive must be included in every object that contains a definition for the described predicate (even if the predicate declaration is inherited from other object or imported from a category). If we omit the dynamic declaration then the predicate definition will be compiled static. In the case of dynamic objects, static predicates cannot be redefined using the database built-in methods (despite being internally compiled to dynamic code).
+</p>
+<p>
+Note that static objects may declare and define dynamic predicates.
 </p>
 
@@ -676 +679 @@
     <div class="copyright">
         <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/> 
-        <span>Last updated on: July 17, 2008</span>
+        <span>Last updated on: October 11, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/userman/userman.header

@@ -36 +36 @@
         <span>http://logtalk.org/</span>
     </p>
-    <p class="date">Last updated on October 4, 2008</p>
+    <p class="date">Last updated on October 11, 2008</p>
 </div>
 

trunk/manuals/userman/userman.sh

@@ -11 +11 @@
 ## ================================================================
 
-css2xslfo=/Applications/XML/CSSToXSLFO/css2xslfo1_5_2.jar
+css2xslfo=/Applications/XML/CSSToXSLFO/css2xslfo1_6.jar
 
 xslt_proc=xsltproc