From: <bi...@us...> - 2009-02-11 21:22:22
|
Revision: 4130 http://oorexx.svn.sourceforge.net/oorexx/?rev=4130&view=rev Author: bigrixx Date: 2009-02-11 21:22:20 +0000 (Wed, 11 Feb 2009) Log Message: ----------- image file size fix ups Modified Paths: -------------- docs/trunk/rexxref/fundclasses.sgml docs/trunk/rexxref/ooRexxBufferClass.png docs/trunk/rexxref/ooRexxClasses7.png docs/trunk/rexxref/ooRexxClasses8.png docs/trunk/rexxref/ooRexxClasses9.png docs/trunk/rexxref/ooRexxContextClass.png docs/trunk/rexxref/ooRexxDateTimeClass.odg docs/trunk/rexxref/ooRexxDateTimeClass.png docs/trunk/rexxref/ooRexxIdentityTableClass.odg docs/trunk/rexxref/ooRexxIdentityTableClass.png docs/trunk/rexxref/ooRexxMethodClass.png docs/trunk/rexxref/ooRexxMutableBufferClass.png docs/trunk/rexxref/ooRexxObjectClass.png docs/trunk/rexxref/ooRexxOrderableClass.odg docs/trunk/rexxref/ooRexxOrderableClass.png docs/trunk/rexxref/ooRexxPackageClass.png docs/trunk/rexxref/ooRexxPointerClass.png docs/trunk/rexxref/ooRexxRexxQueueClass.png docs/trunk/rexxref/ooRexxRoutineClass.odg docs/trunk/rexxref/ooRexxRoutineClass.png docs/trunk/rexxref/ooRexxStemClass.odg docs/trunk/rexxref/ooRexxStemClass.png docs/trunk/rexxref/ooRexxStringClass.png docs/trunk/rexxref/ooRexxTableClass.odg docs/trunk/rexxref/ooRexxTableClass.png docs/trunk/rexxref/ooRexxTimeSpanClass.odg docs/trunk/rexxref/ooRexxTimeSpanClass.png docs/trunk/rexxref/ooRexxWeakReferenceClass.png Modified: docs/trunk/rexxref/fundclasses.sgml =================================================================== --- docs/trunk/rexxref/fundclasses.sgml 2009-02-11 17:10:28 UTC (rev 4129) +++ docs/trunk/rexxref/fundclasses.sgml 2009-02-11 21:22:20 UTC (rev 4130) @@ -5367,10 +5367,12 @@ ]]> </programlisting> -<para>Reverses any previous -<emphasis role="bold">setUnguarded</emphasis> messages, restoring the receiver to -the default guarded status. If the receiver is already guarded, a -<emphasis role="bold">setGuarded</emphasis> message has no effect.</para> +<para>Specifies that the method is a guarded method that requires +exclusive access to its scope variable pool to run. +If the receiver is already guarded, a +<emphasis role="bold">setGuarded</emphasis> message has no effect. +Guarded is the default state for method objects. +</para> </section> <section id="mthMethodSetPrivate"><title>setPrivate</title> @@ -5404,9 +5406,8 @@ ]]> </programlisting> -<para>Specifies that a method is a protected method. If a method -object does not receive a <emphasis role="bold">setProtected</emphasis> -message, the method is not protected. +<para>Specifies that a method is a protected method. Method objects are not +protected by default. (See <link linkend="secman">The Security Manager</link> for details.)</para> </section> @@ -5443,17 +5444,15 @@ ]]> </programlisting> -<para>Lets an object run a method even when -another method is active on the same object. If a method object does not receive -a <emphasis role="bold">setUnguarded</emphasis> -message, it requires exclusive use of its object variable pool. -A method can be active for an object only when no other method requiring exclusive +<para>Turns off the guared attribute of the method, allowing this method to +run on an object even if another method has acquired exclusive access to the scope +variable pool. Methods are unguarded by default.</para> +<para> +A guarded method can be active for an object only when no other method requiring exclusive access to the object's variable pool is active in the same object. This restriction does not apply if an object sends itself a message to run a method and it already has exclusive use of the same object variable pool. In this -case, the method runs immediately and has exclusive use of its object variable -pool, regardless of whether it received a -<emphasis role="bold">setUnguarded</emphasis> message.</para> +case, the method runs immediately regardless of its guarded state. </section> <section id="mthMethodSource"><title>source</title> @@ -5544,6 +5543,37 @@ </para> </section> +<section id="mthRoutineLoadExternalRoutine"><title>loadExternalRoutine (Class method)</title> +<indexterm><primary>loadExternalRoutine method</primary> +<secondary>of Routine class</secondary></indexterm> +<indexterm><primary>method</primary> +<secondary>loadExternalRoutine method</secondary> +<tertiary>of Routine class</tertiary></indexterm> +<programlisting> +<![CDATA[ +>>-loadExternalRoutine(name,descriptor)------------------------>< +]]> +</programlisting> +<para>Resolves a native routine in an external library package and returns a +Routine object instance that can used to call the external routine. The +<emphasis role="italic">descriptor</emphasis> is a string containing +blank-delimited tokens that identify the location of the native routine. +function. The first token identifies the type of native routine and must be +"LIBRARY". The second token must identify +the name of the external library. The external library is located using +platform-specific mechanisms for loading libraries. For Unix-based systems, the +library name is case-sensitive. The third token is optional and specifies the +name of the routine within the library package. If not specified, +<emphasis role="italic">name</emphasis> is used. +The routine name is not case sensitive. If the target routine cannot be +resolved, .nil is returned. +</para> +<para><emphasis role="bold">Example:</emphasis></para> +<programlisting> +routine = .Routine~loadExternalRoutine("Pi", "LIBRARY rxmath RxCalcPi") +</programlisting> +</section> + <section id="mthRoutineCall"><title>call</title> <indexterm><primary>call method</primary> <secondary>of Routine class</secondary></indexterm> @@ -5582,33 +5612,6 @@ </para> </section> -<section id="mthRoutineLoadExternalRoutine"><title>loadExternalRoutine</title> -<indexterm><primary>loadExternalRoutine method</primary> -<secondary>of Routine class</secondary></indexterm> -<indexterm><primary>method</primary> -<secondary>loadExternalRoutine method</secondary> -<tertiary>of Routine class</tertiary></indexterm> -<programlisting> -<![CDATA[ ->>-loadExternalRoutine(name,descriptor)------------------------>< -]]> -</programlisting> -<para>Resolves a native routine in an external library package and returns a -Routine object instance that can used to call the external routine. The -<emphasis role="italic">descriptor</emphasis> is a string containing -blank-delimited tokens that identify the location of the native routine. -function. The first token identifies the type of native routine and must be -"LIBRARY". The second token must identify -the name of the external library. The external library is located using -platform-specific mechanisms for loading libraries. For Unix-based systems, the -library name is case-sensitive. The third token is optional and specifies the -name of the routine within the library package. If not specified, -<emphasis role="italic">name</emphasis> is used. -The routine name is not case sensitive. If the target routine cannot be -resolved, .nil is returned. -</para> -</section> - <section id="mthRoutinePackage"><title>package</title> <indexterm><primary>package method</primary> <secondary>of Routine class</secondary></indexterm> Modified: docs/trunk/rexxref/ooRexxBufferClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxClasses7.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxClasses8.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxClasses9.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxContextClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxDateTimeClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxDateTimeClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxIdentityTableClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxIdentityTableClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxMethodClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxMutableBufferClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxObjectClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxOrderableClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxOrderableClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxPackageClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxPointerClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxRexxQueueClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxRoutineClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxRoutineClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxStemClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxStemClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxStringClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxTableClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxTableClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxTimeSpanClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxTimeSpanClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxWeakReferenceClass.png =================================================================== (Binary files differ) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |