Changeset 4524 for trunk/manuals

Timestamp:

10/20/08 19:20:18 (3 months ago)

Author:

pmoura

Message:

Added an optimization and security compiler option, "complements", that allows objects to be compiled with support for complementing categories either enabled or disabled. The default value (set in the config files) is "off" (disabled).

Added an optimization and security compiler option, "dynamic_declarations", that allows objects to be compiled with support for dynamic declaration of predicates (using the built-in database methods asserta/1 and assertz/1) either enabled or disabled. The default value (set in the config files) is "off" (disabled).

Updated the "complements" example to use the new "complements" compiler option. Update the "dynpred" example to use the new "dynamic_declarations" compiler option.

Location:

trunk/manuals

Files:

• index.html (modified) (1 diff)
• refman/index.html (modified) (1 diff)
• refman/methods/asserta1.html (modified) (2 diffs)
• refman/methods/assertz1.html (modified) (2 diffs)
• refman/refman.header (modified) (1 diff)
• userman/categories.html (modified) (2 diffs)
• userman/index.html (modified) (1 diff)
• userman/running.html (modified) (2 diffs)
• userman/userman.header (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 19, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/index.html

@@ -321 +321 @@
     <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 19, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/methods/asserta1.html

@@ -27 +27 @@
 asserta((Head:-Body))</pre>
 <p>
-Asserts a clause as the first one for an object's dynamic predicate. If the predicate is not already declared, then a dynamic predicate declaration is added to the object.
+Asserts a clause as the first one for an object's dynamic predicate. If the predicate is not already declared, then a dynamic predicate declaration is added to the object (assuming that the compiler option <code>dynamic_declarations</code> was switched on when the object was created or compiled).
 </p>
 <p>
@@ -68 +68 @@
     <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 12, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/methods/assertz1.html

@@ -27 +27 @@
 assertz((Head:-Body))</pre>
 <p>
-Asserts a clause as the last one for an object's dynamic predicate. If the predicate is not already declared, then a dynamic predicate declaration is added to the object.
+Asserts a clause as the last one for an object's dynamic predicate. If the predicate is not already declared, then a dynamic predicate declaration is added to the object (assuming that the compiler option <code>dynamic_declarations</code> was switched on when the object was created or compiled).
 </p>
 <p>
@@ -68 +68 @@
     <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 12, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/refman/refman.header

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

trunk/manuals/userman/categories.html

@@ -68 +68 @@
 :- end_category.</pre>
 <p>
-This allows us to add new functionality to existing objects without requiring access or modifications to their source code. Common uses are adding logging or debugging functionality to a set of objects.
+This allows us to add new functionality to existing objects without requiring access or modifications to their source code. Common uses are adding logging or debugging functionality to a set of objects. Complemented objects need to be compiled with the <code>complements</code> compiler option switched on.
 </p>
 <p>
@@ -349 +349 @@
     <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 17, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

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 17, 2008</span>
+        <span>Last updated on: October 20, 2008</span>
     </div>
     <div class="navbottom">

trunk/manuals/userman/running.html

@@ -167 +167 @@
         <dt><code>debug(Option)</code></dt>
             <dd>Controls the compilation of source files in debug mode (the Logtalk built-in debugger can only be used with files compiled in this mode). Possible option values are <code>on</code> and <code>off</code> (the usual default).</dd>
+    </dl>
+    <dl>
+        <dt><code>complements(Option)</code></dt>
+            <dd>Allows objects to be compiled with support for complementing categories turned off in order to improve performance and security. Possible option values are <code>on</code> and <code>off</code> (the usual default). This option can be used on a per-object basis. Note that changing this option is of no consequence for objects already compiled and loaded.</dd>
+    </dl>
+    <dl>
+        <dt><code>dynamic_declarations(Option)</code></dt>
+            <dd>Allows objects to be compiled with support for dynamic declaration of new predicates turned off in order to improve performance and security. Possible option values are <code>on</code> and <code>off</code> (the usual default). This option can be used on a per-object basis. Note that changing this option is of no consequence for objects already compiled and loaded.</dd>
     </dl>
     <dl>
@@ -521 +529 @@
     <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 20, 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 17, 2008</p>
+    <p class="date">Last updated on October 20, 2008</p>
 </div>