Changeset 4498 for trunk/manuals

Show
Ignore:
Timestamp:
10/11/08 12:09:02 (3 months ago)
Author:
pmoura
Message:

Modified the built-in methods create_category/4, create_object/4 and create_protocol/3 to accept a variable as the first argument, which will be instantiated to the identifier generated for the new entity.

Location:
trunk/manuals
Files:
6 modified

Legend:

Unmodified
Added
Removed

  • trunk/manuals/refman/builtins/create_category4.html

    r4497 r4498  
    2828Creates a new, dynamic category. This predicate is often used as a primitive to implement high-level category creation methods. 
    2929</p> 
     30<p> 
     31When using Logtalk multi-threaded features, predicates calling this built-in predicate may need to be declared synchronized in order to avoid race conditions.  
     32</p> 
    3033 
    3134<h4>Template and modes</h4> 
    3235 
    33 <pre>create_category(+category_identifier, +list, +list, +list)</pre> 
     36<pre>create_category(?category_identifier, +list, +list, +list)</pre> 
    3437 
    3538<h4>Errors</h4> 
    3639 
    3740<dl> 
    38     <dt>One of the predicate arguments is a variable:</dt> 
     41    <dt>Relations, Directives, or Clauses is a variable:</dt> 
    3942        <dd><code>instantiation_error</code></dd> 
    4043    <dt>Identifier is neither a variable nor a valid category identifier:</dt> 
    … …  
    6467    <div class="copyright"> 
    6568        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    66         <span>Last updated on: October 7, 2008</span> 
     69        <span>Last updated on: October 11, 2008</span> 
    6770    </div> 
    6871    <div class="navbottom"> 

  • trunk/manuals/refman/builtins/create_object4.html

    r4497 r4498  
    2828Creates 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.  
    2929</p> 
     30<p> 
     31When using Logtalk multi-threaded features, predicates calling this built-in predicate may need to be declared synchronized in order to avoid race conditions.  
     32</p> 
    3033 
    3134<h4>Template and modes</h4> 
    3235 
    33 <pre>create_object(+object_identifier, +list, +list, +list)</pre> 
     36<pre>create_object(?object_identifier, +list, +list, +list)</pre> 
    3437 
    3538<h4>Errors</h4> 
    3639 
    3740<dl> 
    38     <dt>One of the predicate arguments is a variable:</dt> 
     41    <dt>Relations, Directives, or Clauses is a variable:</dt> 
    3942        <dd><code>instantiation_error</code></dd> 
    40     <dt>Identifier is not a valid object identifier:</dt> 
     43    <dt>Identifier is neither a variable nor a valid object identifier:</dt> 
    4144        <dd><code>type_error(object_identifier, Identifier)</code></dd> 
    4245    <dt>Identifier is already in use:</dt> 
    … …  
    6972    <div class="copyright"> 
    7073        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    71         <span>Last updated on: October 7, 2008</span> 
     74        <span>Last updated on: October 11, 2008</span> 
    7275    </div> 
    7376    <div class="navbottom"> 

  • trunk/manuals/refman/builtins/create_protocol3.html

    r4497 r4498  
    2828Creates a new, dynamic protocol. This predicate is often used as a primitive to implement high-level protocol creation methods. 
    2929</p> 
     30<p> 
     31When using Logtalk multi-threaded features, predicates calling this built-in predicate may need to be declared synchronized in order to avoid race conditions.  
     32</p> 
    3033 
    3134<h4>Template and modes</h4> 
    3235 
    33 <pre>create_protocol(+protocol_identifier, +list, +list)</pre> 
     36<pre>create_protocol(?protocol_identifier, +list, +list)</pre> 
    3437 
    3538<h4>Errors</h4> 
    3639 
    3740<dl> 
    38     <dt>One of the predicate arguments is a variable:</dt> 
     41    <dt>Either Relations or Directives is a variable:</dt> 
    3942        <dd><code>instantiation_error</code></dd> 
    40     <dt>Identifier is not a valid protocol identifier:</dt> 
     43    <dt>Identifier is neither a variable nor a valid protocol identifier:</dt> 
    4144        <dd><code>type_error(protocol_identifier, Identifier)</code></dd> 
    4245    <dt>Identifier is already in use:</dt> 
    … …  
    6164    <div class="copyright"> 
    6265        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    63         <span>Last updated on: October 7, 2008</span> 
     66        <span>Last updated on: October 11, 2008</span> 
    6467    </div> 
    6568    <div class="navbottom"> 

  • trunk/manuals/userman/categories.html

    r4272 r4498  
    117117<pre>| ?- create_category(Category, Relations, Directives, Clauses).</pre> 
    118118<p> 
    119 The first argument, the name of the new category - a Prolog atom - should not match with an existing entity name. The remaining three arguments correspond to the relations described in the opening category directive and to the category code contents (directives and clauses). 
     119The first argument should be either a variable or the name of the new category (a Prolog atom, which must not match with an existing entity name). The remaining three arguments correspond to the relations described in the opening category directive and to the category code contents (directives and clauses). 
    120120</p> 
    121121<p> 
    … …  
    349349    <div class="copyright"> 
    350350        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    351         <span>Last updated on: April 19, 2008</span> 
     351        <span>Last updated on: October 11, 2008</span> 
    352352    </div> 
    353353    <div class="navbottom"> 

  • trunk/manuals/userman/objects.html

    r4474 r4498  
    218218<pre>| ?- create_object(Object, Relations, Directives, Clauses).</pre> 
    219219<p> 
    220 The first argument, the name of the new object (a Prolog atom or compound term), should not match any existing entity name. The remaining three arguments correspond to the relations described in the opening object directive and to the object code contents (directives and clauses). 
     220The first argument should be either a variable or the name of the new object (a Prolog atom or compound term, which must not match any existing entity name). The remaining three arguments correspond to the relations described in the opening object directive and to the object code contents (directives and clauses). 
    221221</p> 
    222222<p> 
    … …  
    443443    <div class="copyright"> 
    444444        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    445         <span>Last updated on: September 26, 2008</span> 
     445        <span>Last updated on: October 11, 2008</span> 
    446446    </div> 
    447447    <div class="navbottom"> 

  • trunk/manuals/userman/protocols.html

    r3960 r4498  
    7171<pre>| ?- create_protocol(Protocol, Relations, Directives).</pre> 
    7272<p> 
    73 The first argument, the name of the new protocol (a Prolog atom), should not match an existing entity name. The remaining two arguments correspond to the relations described in the opening protocol directive and to the protocol  directives. 
     73The first argument should be either a variable or the name of the new protocol (a Prolog atom, which must not match an existing entity name). The remaining two arguments correspond to the relations described in the opening protocol directive and to the protocol  directives. 
    7474</p> 
    7575<p> 
    … …  
    235235    <div class="copyright"> 
    236236        <span>Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://logtalk.org">Logtalk.org</a></span><br/>  
    237         <span>Last updated on: December 9, 2007</span> 
     237        <span>Last updated on: October 11, 2008</span> 
    238238    </div> 
    239239    <div class="navbottom">