diff doc/interpreter/dynamic.txi @ 10828:322f43e0e170

Grammarcheck .txi documentation files.
author Rik <octave@nomad.inbox5.com>
date Wed, 28 Jul 2010 12:45:04 -0700
parents 3140cb7a05a1
children a4f482e66b65
line wrap: on
line diff
--- a/doc/interpreter/dynamic.txi	Wed Jul 28 11:57:39 2010 -0700
+++ b/doc/interpreter/dynamic.txi	Wed Jul 28 12:45:04 2010 -0700
@@ -39,16 +39,19 @@
 @itemize @bullet
 @item
 Can I get the same functionality using the Octave scripting language only?
+
 @item
 Is it thoroughly optimized Octave code?  Vectorization of Octave code,
 doesn't just make it concise, it generally significantly improves its
 performance.  Above all, if loops must be used, make sure that the
 allocation of space for variables takes place outside the loops using an
 assignment to a matrix of the right size, or zeros.
+
 @item
 Does it make as much use as possible of existing built-in library
 routines?  These are highly optimized and many do not carry the overhead
 of being interpreted.
+
 @item
 Does writing a dynamically linked function represent useful investment
 of your time, relative to staying in Octave?
@@ -96,7 +99,7 @@
 
 @DOCSTRING(mkoctfile)
 
-Consider the short example
+Consider the short example:
 
 @example
 @group
@@ -115,9 +118,12 @@
 
 @enumerate 1
 @item The function name as it will be seen in Octave,
+
 @item The list of arguments to the function of type @code{octave_value_list},
+
 @item The number of output arguments, which can and often is omitted if
 not used, and
+
 @item The string that will be seen as the help text of the function.
 @end enumerate
 
@@ -128,9 +134,9 @@
 name.  Firstly, it must be a valid Octave function name and so must be a
 sequence of letters, digits and underscores, not starting with a
 digit.  Secondly, as Octave uses the function name to define the filename
-it attempts to find the function in, the function name in the @w{@code{DEFUN_DLD}}
-macro must match the filename of the oct-file.  Therefore, the above
-function should be in a file @file{helloworld.cc}, and it should be
+it attempts to find the function in, the function name in the
+@w{@code{DEFUN_DLD}} macro must match the filename of the oct-file.  Therefore,
+the above function should be in a file @file{helloworld.cc}, and it should be
 compiled to an oct-file using the command
 
 @example
@@ -167,8 +173,10 @@
 @table @code
 @item Matrix
 A double precision matrix class defined in dMatrix.h,
+
 @item ComplexMatrix
 A complex matrix class defined in CMatrix.h, and
+
 @item BoolMatrix
 A boolean matrix class defined in boolMatrix.h.
 @end table
@@ -180,16 +188,20 @@
 @table @code
 @item NDArray
 A double precision array class defined in @file{dNDArray.h}
+
 @item ComplexNDarray
 A complex array class defined in @file{CNDArray.h}
+
 @item boolNDArray
 A boolean array class defined in @file{boolNDArray.h}
+
 @item int8NDArray
 @itemx int16NDArray
 @itemx int32NDArray
 @itemx int64NDArray
 8, 16, 32 and 64-bit signed array classes defined in
 @file{int8NDArray.h}, @file{int16NDArray.h}, etc.
+
 @item uint8NDArray
 @itemx uint16NDArray
 @itemx uint32NDArray
@@ -212,6 +224,7 @@
 @end example
 
 This can be used on all matrix and array types
+
 @item
 Define the dimensions of the matrix or array with a dim_vector.  For
 example
@@ -225,8 +238,9 @@
 @end example
 
 This can be used on all matrix and array types
+
 @item
-Define the number of rows and columns in the matrix.  For example
+Define the number of rows and columns in the matrix.  For example:
 
 @example
 Matrix a (2, 2)
@@ -238,7 +252,7 @@
 These types all share a number of basic methods and operators, a
 selection of which include
 
-@deftypefn Method T& {operator ()} (octave_idx_type)
+@deftypefn  Method T& {operator ()} (octave_idx_type)
 @deftypefnx Method T& elem (octave_idx_type)
 The @code{()} operator or @code{elem} method allow the values of the
 matrix or array to be read or set.  These can take a single argument,
@@ -345,7 +359,7 @@
 @subsection Character Strings in Oct-Files
 
 In Octave a character string is just a special @code{Array} class.
-Consider the example 
+Consider the example:
 
 @example
 @EXAMPLEFILE(stringdemo.cc)
@@ -387,7 +401,7 @@
 
 Note however, that both types of strings are represented by the
 @code{charNDArray} type, and so when assigning to an
-@code{octave_value}, the type of string should be specified.  For example
+@code{octave_value}, the type of string should be specified.  For example:
 
 @example
 @group
@@ -483,8 +497,10 @@
 @table @code
 @item SparseMatrix
 A double precision sparse matrix class
+
 @item SparseComplexMatrix
 A complex sparse matrix class
+
 @item SparseBoolMatrix
 A boolean sparse matrix class
 @end table
@@ -792,7 +808,7 @@
 available from the Octave are equally available with oct-files.
 The basic means of extracting a sparse matrix from an @code{octave_value}
 and returning them as an @code{octave_value}, can be seen in the
-following example
+following example.
 
 @example
 @group
@@ -857,8 +873,11 @@
 
 @enumerate 1
 @item Function Handle
+
 @item Anonymous Function Handle
+
 @item Inline Function
+
 @item String
 @end enumerate
 
@@ -1026,14 +1045,14 @@
 purposes of parameter checking.  These include the methods of the
 octave_value class like @code{is_real_matrix}, etc., but equally include
 more specialized functions.  Some of the more common ones are
-demonstrated in the following example
+demonstrated in the following example.
 
 @example
 @EXAMPLEFILE(paramdemo.cc)
 @end example
 
 @noindent
-and an example of its use is
+An example of its use is:
 
 @example
 @group
@@ -1053,7 +1072,7 @@
 C++ exception handler, where memory allocated by the C++ new/delete
 methods are automatically released when the exception is treated.  When
 writing an oct-file, to allow Octave to treat the user typing @kbd{Control-C},
-the @w{@code{OCTAVE_QUIT}} macro is supplied.  For example
+the @w{@code{OCTAVE_QUIT}} macro is supplied.  For example:
 
 @example
 @group
@@ -1065,19 +1084,19 @@
 @end group
 @end example
 
-The presence of the @w{@code{OCTAVE_QUIT}} macro in the inner loop allows Octave to
-treat the user request with the @kbd{Control-C}.  Without this macro, the user
-must either wait for the function to return before the interrupt is
+The presence of the @w{@code{OCTAVE_QUIT}} macro in the inner loop allows
+Octave to treat the user request with the @kbd{Control-C}.  Without this macro,
+the user must either wait for the function to return before the interrupt is
 processed, or press @kbd{Control-C} three times to force Octave to exit.
 
-The @w{@code{OCTAVE_QUIT}} macro does impose a very small speed penalty, and so for
-loops that are known to be small it might not make sense to include
+The @w{@code{OCTAVE_QUIT}} macro does impose a very small speed penalty, and so
+for loops that are known to be small it might not make sense to include
 @w{@code{OCTAVE_QUIT}}.
 
 When creating an oct-file that uses an external libraries, the function
 might spend a significant portion of its time in the external
-library.  It is not generally possible to use the @w{@code{OCTAVE_QUIT}} macro in
-this case.  The alternative in this case is
+library.  It is not generally possible to use the @w{@code{OCTAVE_QUIT}} macro
+in this case.  The alternative in this case is
 
 @example
 @group
@@ -1103,7 +1122,7 @@
 @EXAMPLEFILE(unwinddemo.cc)
 @end example
 
-As can be seen in the example
+As can be seen in the example:
 
 @example
 @group
@@ -1130,7 +1149,7 @@
 The major issue is that the help string will typically be longer than a
 single line of text, and so the formatting of long help strings need to
 be taken into account.  There are several manners in which to treat this
-issue, but the most common is illustrated in the following example
+issue, but the most common is illustrated in the following example,
 
 @example
 @group
@@ -1228,7 +1247,7 @@
 Octave file "Matrix.h" with operating systems and compilers that don't
 distinguish between filenames in upper and lower case
 
-Consider the short example
+Consider the short example:
 
 @example
 @group
@@ -1338,7 +1357,7 @@
 function @code{mxGetPi} that get the imaginary part.  Both of these
 functions are for use only with double precision matrices.  There also
 exists the generic function @code{mxGetData} and @code{mxGetImagData}
-that perform the same operation on all matrix types.  For example
+that perform the same operation on all matrix types.  For example:
 
 @example
 @group