changeset 11572:7d6d8c1e471f

Grammarcheck Texinfo for files in src directory.
author Rik <octave@nomad.inbox5.com>
date Wed, 19 Jan 2011 17:51:22 -0800
parents 0e414f837c58
children 6f8ffe2c6f76
files src/ChangeLog src/DLD-FUNCTIONS/dlmread.cc src/DLD-FUNCTIONS/filter.cc src/DLD-FUNCTIONS/inv.cc src/DLD-FUNCTIONS/lu.cc src/DLD-FUNCTIONS/quad.cc src/DLD-FUNCTIONS/quadcc.cc src/DLD-FUNCTIONS/rcond.cc src/DLD-FUNCTIONS/regexp.cc src/DLD-FUNCTIONS/strfind.cc src/DLD-FUNCTIONS/typecast.cc src/data.cc src/dirfns.cc src/error.cc src/file-io.cc src/graphics.cc src/help.cc src/input.cc src/load-path.cc src/load-save.cc src/mappers.cc src/oct-hist.cc src/oct-parse.yy src/pager.cc src/pr-output.cc src/pt-binop.cc src/sparse.cc src/strfns.cc src/syscalls.cc src/sysdep.cc src/utils.cc
diffstat 31 files changed, 72 insertions(+), 52 deletions(-) [+]
line wrap: on
line diff
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,15 @@
+2011-01-19  Rik  <octave@nomad.inbox5.com>
+
+	* DLD-FUNCTIONS/dlmread.cc, DLD-FUNCTIONS/filter.cc,
+	DLD-FUNCTIONS/inv.cc, DLD-FUNCTIONS/lu.cc, DLD-FUNCTIONS/quad.cc,
+	DLD-FUNCTIONS/quadcc.cc, DLD-FUNCTIONS/rcond.cc,
+	DLD-FUNCTIONS/regexp.cc, DLD-FUNCTIONS/strfind.cc,
+	DLD-FUNCTIONS/typecast.cc, data.cc, dirfns.cc, error.cc, file-io.cc,
+	graphics.cc, help.cc, input.cc, load-path.cc, load-save.cc, mappers.cc,
+	oct-hist.cc, oct-parse.yy, pager.cc, pr-output.cc, pt-binop.cc,
+	sparse.cc, strfns.cc, syscalls.cc, sysdep.cc, utils.cc: grammarcheck
+	files in src directory.	
+
 2011-01-19  John W. Eaton  <jwe@octave.org>
 
 	* oct-obj.cc (octave_value_list::all_scalars): Check for scalar
--- a/src/DLD-FUNCTIONS/dlmread.cc
+++ b/src/DLD-FUNCTIONS/dlmread.cc
@@ -181,7 +181,7 @@
 \n\
 The \"emptyvalue\" option may be used to specify the value used to fill empty\n\
 fields.  The default is zero.\n\
-@seealso{csvread,textscan,textread,dlmwrite}\n\
+@seealso{csvread, textscan, textread, dlmwrite}\n\
 @end deftypefn")
 {
   octave_value_list retval;
--- a/src/DLD-FUNCTIONS/filter.cc
+++ b/src/DLD-FUNCTIONS/filter.cc
@@ -376,7 +376,7 @@
 @end example\n\
 \n\
 @end ifnottex\n\
-@seealso{filter2,fftfilt,freqz}\n\
+@seealso{filter2, fftfilt, freqz}\n\
 @end deftypefn")
 {
   octave_value_list retval;
--- a/src/DLD-FUNCTIONS/inv.cc
+++ b/src/DLD-FUNCTIONS/inv.cc
@@ -53,7 +53,7 @@
 If called with a sparse matrix, then in general @var{x} will be a full\n\
 matrix requiring significantly more storage.  Avoid forming the inverse\n\
 of a sparse matrix if possible.\n\
-@seealso{ldivide,rdivide}\n\
+@seealso{ldivide, rdivide}\n\
 @end deftypefn")
 {
   octave_value_list retval;
--- a/src/DLD-FUNCTIONS/lu.cc
+++ b/src/DLD-FUNCTIONS/lu.cc
@@ -637,7 +637,7 @@
 The matrix case is done as a sequence of rank-1 updates;\n\
 thus, for large enough k, it will be both faster and more accurate to\n\
 recompute the factorization from scratch.\n\
-@seealso{lu,qrupdate,cholupdate}\n\
+@seealso{lu, qrupdate, cholupdate}\n\
 @end deftypefn")
 {
   octave_idx_type nargin = args.length ();
--- a/src/DLD-FUNCTIONS/quad.cc
+++ b/src/DLD-FUNCTIONS/quad.cc
@@ -214,7 +214,7 @@
 \n\
 Note: because @code{quad} is written in Fortran it\n\
 cannot be called recursively.\n\
-@seealso{quad_options,quadv,quadl,quadgk,quadcc,trapz,dblquad,triplequad}\n\
+@seealso{quad_options, quadv, quadl, quadgk, quadcc, trapz, dblquad, triplequad}\n\
 @end deftypefn")
 {
   octave_value_list retval;
--- a/src/DLD-FUNCTIONS/quadcc.cc
+++ b/src/DLD-FUNCTIONS/quadcc.cc
@@ -1543,7 +1543,7 @@
 well-behaved integrand than other methods such as\n\
 @code{quadgk} or @code{trapz}.\n\
 \n\
-@seealso{quad,quadv,quadl,quadgk,trapz,dblquad,triplequad}\n\
+@seealso{quad, quadv, quadl, quadgk, trapz, dblquad, triplequad}\n\
 @end deftypefn")
 {
 
--- a/src/DLD-FUNCTIONS/rcond.cc
+++ b/src/DLD-FUNCTIONS/rcond.cc
@@ -40,7 +40,7 @@
 The matrix @var{A} must not be sparse.  If the matrix is sparse then\n\
 @code{condest (@var{A})} or @code{rcond (full (@var{A}))} should be used\n\
 instead.\n\
-@seealso{cond,condest}\n\
+@seealso{cond, condest}\n\
 @end deftypefn")
 {
   octave_value retval;
--- a/src/DLD-FUNCTIONS/regexp.cc
+++ b/src/DLD-FUNCTIONS/regexp.cc
@@ -1077,7 +1077,7 @@
 Alternatively, use (?x) in the pattern when PCRE is available.\n\
 \n\
 @end table\n\
-@seealso{regexpi,strfind,regexprep}\n\
+@seealso{regexpi, strfind, regexprep}\n\
 @end deftypefn")
 {
   octave_value_list retval;
@@ -1643,7 +1643,7 @@
 This option is present for compatibility but is ignored.\n\
 \n\
 @end table\n\
-@seealso{regexp,regexpi,strrep}\n\
+@seealso{regexp, regexpi, strrep}\n\
 @end deftypefn")
 {
   octave_value_list retval;
--- a/src/DLD-FUNCTIONS/strfind.cc
+++ b/src/DLD-FUNCTIONS/strfind.cc
@@ -175,7 +175,7 @@
         @}\n\
 @end group\n\
 @end example\n\
-@seealso{findstr,strmatch,regexp,regexpi,find}\n\
+@seealso{findstr, strmatch, regexp, regexpi, find}\n\
 @end deftypefn")
 {
   octave_value retval;
--- a/src/DLD-FUNCTIONS/typecast.cc
+++ b/src/DLD-FUNCTIONS/typecast.cc
@@ -299,7 +299,7 @@
 increasing order of significance, i.e., @code{x(1)} is bit 0, @code{x(2)} is\n\
 bit 1, etc.  The result is a row vector if @var{x} is a row vector, otherwise\n\
 it is a column vector.\n\
-@seealso{bitunpack,typecast}\n\
+@seealso{bitunpack, typecast}\n\
 @end deftypefn")
 {
   octave_value retval;
@@ -404,7 +404,7 @@
 \n\
 The result is a row vector if @var{x} is a row vector; otherwise, it is a\n\
 column vector.\n\
-@seealso{bitpack,typecast}\n\
+@seealso{bitpack, typecast}\n\
 @end deftypefn")
 {
   octave_value retval;
--- a/src/data.cc
+++ b/src/data.cc
@@ -2163,7 +2163,7 @@
 DEFUN (nnz, args, ,
    "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {@var{scalar} =} nnz (@var{a})\n\
-Returns the number of non zero elements in @var{a}.\n\
+Return the number of non zero elements in @var{a}.\n\
 @seealso{sparse}\n\
 @end deftypefn")
 {
@@ -6315,7 +6315,7 @@
   "-*- texinfo -*-\n\
 @deftypefn  {Built-in Function} {} merge (@var{mask}, @var{tval}, @var{fval})\n\
 @deftypefnx {Built-in Function} {} ifelse (@var{mask}, @var{tval}, @var{fval})\n\
-Merges elements of @var{true_val} and @var{false_val}, depending on the\n\
+Merge elements of @var{true_val} and @var{false_val}, depending on the\n\
 value of @var{mask}.  If @var{mask} is a logical scalar, the other two\n\
 arguments can be arbitrary values.  Otherwise, @var{mask} must be a logical\n\
 array, and @var{tval}, @var{fval} should be arrays of matching class, or\n\
--- a/src/dirfns.cc
+++ b/src/dirfns.cc
@@ -89,7 +89,7 @@
 
 DEFUN (cd, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Command} {} cd dir\n\
+@deftypefn  {Command} {} cd dir\n\
 @deftypefnx {Command} {} chdir dir\n\
 Change the current working directory to @var{dir}.  If @var{dir} is\n\
 omitted, the current directory is changed to the user's home\n\
--- a/src/error.cc
+++ b/src/error.cc
@@ -839,7 +839,7 @@
 DEFUN (rethrow, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} rethrow (@var{err})\n\
-Reissues a previous error as defined by @var{err}.  @var{err} is a structure\n\
+Reissue a previous error as defined by @var{err}.  @var{err} is a structure\n\
 that must contain at least the 'message' and 'identifier' fields.  @var{err}\n\
 can also contain a field 'stack' that gives information on the assumed\n\
 location of the error.  Typically @var{err} is returned from\n\
@@ -1477,9 +1477,10 @@
 
 DEFUN (lasterror, args, ,
   "-*- texinfo -*-\n\
-@deftypefn  {Built-in Function} {@var{err} =} lasterror (@var{err})\n\
+@deftypefn  {Built-in Function} {@var{lasterr} =} lasterror ()\n\
+@deftypefnx {Built-in Function} {} lasterror (@var{err})\n\
 @deftypefnx {Built-in Function} {} lasterror ('reset')\n\
-Returns or sets the last error message.  Called without any arguments\n\
+Query or set the last error message.  Called without any arguments\n\
 returns a structure containing the last error message, as well as other\n\
 information related to this error.  The elements of this structure are:\n\
 \n\
--- a/src/file-io.cc
+++ b/src/file-io.cc
@@ -210,7 +210,7 @@
 DEFUN (fclose, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} fclose (@var{fid})\n\
-Closes the specified file.  If successful, @code{fclose} returns 0,\n\
+Close the specified file.  If successful, @code{fclose} returns 0,\n\
 otherwise, it returns -1.\n\
 @seealso{fopen, fseek, ftell}\n\
 @end deftypefn")
@@ -394,7 +394,7 @@
 DEFUN (fskipl, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} fskipl (@var{fid}, @var{count})\n\
-Skips a given number of lines, i.e., discards characters until an end-of-line\n\
+Skip a given number of lines, i.e., discards characters until an end-of-line\n\
 is met exactly @var{count}-times, or end-of-file occurs.\n\
 Returns the number of lines skipped (end-of-line sequences encountered).\n\
 If @var{count} is omitted, it defaults to 1. @var{count} may also be\n\
--- a/src/graphics.cc
+++ b/src/graphics.cc
@@ -5936,7 +5936,7 @@
 DEFUN (reset, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} reset (@var{h}, @var{property})\n\
-Removes any defaults set for the handle @var{h}.  The default figure\n\
+Remove any defaults set for the handle @var{h}.  The default figure\n\
 properties \"position\", \"units\", \"windowstyle\" and\n\
 \"paperunits\" and the default axes properties \"position\" and \"units\"\n\
 are not reset.\n\
@@ -6398,7 +6398,7 @@
 DEFUN (__calc_dimensions__, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} __calc_dimensions__ (@var{axes})\n\
-Internal function. Determine the number of dimensions in a graphics\n\
+Internal function.  Determine the number of dimensions in a graphics\n\
 object, whether 2 or 3.\n\
 @end deftypefn")
 {
@@ -6697,7 +6697,7 @@
 
 DEFUN (__image_pixel_size__, args, ,
    "-*- texinfo -*-\n\
-@deftypefn  {Built-in Function} {@var{px},@var{py}} __image_pixel_size__ (@var{h})\n\
+@deftypefn {Built-in Function} {@var{px}, @var{py}} __image_pixel_size__ (@var{h})\n\
 Internal function: returns the pixel size of the image in normalized units.\n\
 @end deftypefn")
 {
@@ -7049,7 +7049,8 @@
 
 DEFUN (addproperty, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Built-in Function} {} addproperty (@var{name}, @var{h}, @var{type}, [@var{arg}, @dots{}])\n\
+@deftypefn  {Built-in Function} {} addproperty (@var{name}, @var{h}, @var{type})\n\
+@deftypefnx {Built-in Function} {} addproperty (@var{name}, @var{h}, @var{type}, @var{arg}, @dots{})\n\
 Create a new property named @var{name} in graphics object @var{h}.\n\
 @var{type} determines the type of the property to create.  @var{args}\n\
 usually contains the default value of the property, but additional\n\
--- a/src/help.cc
+++ b/src/help.cc
@@ -719,7 +719,7 @@
 
 DEFUN (get_help_text, args, , "-*- texinfo -*-\n\
 @deftypefn {Loadable Function} {[@var{text}, @var{format}] =} get_help_text (@var{name})\n\
-Returns the help text of a given function.\n\
+Return the help text of a given function.\n\
 \n\
 This function returns the raw help text @var{text} and an indication of\n\
 its format for the function @var{name}.  The format indication @var{format}\n\
@@ -793,7 +793,7 @@
 DEFUN (get_help_text_from_file, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Loadable Function} {[@var{text}, @var{format}] =} get_help_text_from_file (@var{fname})\n\
-Returns the help text from the given file.\n\
+Return the help text from the given file.\n\
 \n\
 This function returns the raw help text @var{text} and an indication of\n\
 its format for the function @var{name}.  The format indication @var{format}\n\
--- a/src/input.cc
+++ b/src/input.cc
@@ -1379,12 +1379,13 @@
 character string.  @xref{Strings}.\n\
 \n\
 You can also use ANSI escape sequences if your terminal supports them.\n\
-This can be useful for colouring the prompt. For example,\n\
+This can be useful for colouring the prompt.  For example,\n\
 \n\
 @example\n\
 PS1 (\"\\\\[\\\\033[01;31m\\\\]\\\\s:\\\\#> \\\\[\\\\033[0m\\]\")\n\
 @end example\n\
 \n\
+@noindent\n\
 will give the default Octave prompt a red colouring.\n\
 @seealso{PS2, PS4}\n\
 @end deftypefn")
@@ -1506,7 +1507,7 @@
 DEFUN (filemarker, args, nargout,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} filemarker ()\n\
-Returns or sets the character used to separate filename from the\n\
+Query or set the character used to separate filename from the\n\
 the subfunction names contained within the file.  This can be used in\n\
 a generic manner to interact with subfunctions.  For example,\n\
 \n\
--- a/src/load-path.cc
+++ b/src/load-path.cc
@@ -1931,11 +1931,11 @@
 
 DEFUN (genpath, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Built-in Function} {} genpath (@var{dir})\n\
+@deftypefn  {Built-in Function} {} genpath (@var{dir})\n\
 @deftypefnx {Built-in Function} {} genpath (@var{dir}, @var{skip}, @dots{})\n\
 Return a path constructed from @var{dir} and all its subdirectories.\n\
 If additional string parameters are given, the resulting path will \n\
-exclude directories with those names.\
+exclude directories with those names.\n\
 @end deftypefn")
 {
   octave_value retval;
@@ -2106,7 +2106,7 @@
 Directories added to the path must exist.\n\
 \n\
 In addition to accepting individual directory arguments, lists of\n\
-directory names separated by @code{pathsep} are also accepted.  For example,\n\
+directory names separated by @code{pathsep} are also accepted.  For example:\n\
 \n\
 @example\n\
 addpath (\"dir1:/dir2:~/dir3\");\n\
@@ -2217,7 +2217,7 @@
 Remove @var{dir1}, @dots{} from the current function search path.\n\
 \n\
 In addition to accepting individual directory arguments, lists of\n\
-directory names separated by @code{pathsep} are also accepted.  For example,\n\
+directory names separated by @code{pathsep} are also accepted.  For example:\n\
 \n\
 @example\n\
 rmpath (\"dir1:/dir2:~/dir3\");\n\
--- a/src/load-save.cc
+++ b/src/load-save.cc
@@ -554,7 +554,7 @@
 
 DEFUN (load, args, nargout,
   "-*- texinfo -*-\n\
-@deftypefn {Command} {} load file\n\
+@deftypefn  {Command} {} load file\n\
 @deftypefnx {Command} {} load options file\n\
 @deftypefnx {Command} {} load options file v1 v2 @dots{}\n\
 @deftypefnx {Command} {} S = load(\"options\", \"file\", \"v1\", \"v2\", @dots{})\n\
@@ -1450,7 +1450,7 @@
 
 DEFUN (save, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Command} {} save file\n\
+@deftypefn  {Command} {} save file\n\
 @deftypefnx {Command} {} save options file\n\
 @deftypefnx {Command} {} save options file @var{v1} @var{v2} @dots{}\n\
 @deftypefnx {Command} {} save options file -struct @var{STRUCT} @var{f1} @var{f2} @dots{}\n\
--- a/src/mappers.cc
+++ b/src/mappers.cc
@@ -540,7 +540,7 @@
 DEFUN (erf, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Mapping Function} {} erf (@var{z})\n\
-Computes the error function,\n\
+Compute the error function,\n\
 @tex\n\
 $$\n\
  {\\rm erf} (z) = {2 \\over \\sqrt{\\pi}}\\int_0^z e^{-t^2} dt\n\
@@ -604,7 +604,7 @@
 DEFUN (erfinv, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Mapping Function} {} erfinv (@var{x})\n\
-Computes the inverse error function, i.e., @var{y} such that\n\
+Compute the inverse error function, i.e., @var{y} such that\n\
 \n\
 @example\n\
   erf(@var{y}) == @var{x}\n\
@@ -639,7 +639,7 @@
 DEFUN (erfc, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Mapping Function} {} erfc (@var{z})\n\
-Computes the complementary error function,\n\
+Compute the complementary error function,\n\
 @tex\n\
 $1 - {\\rm erf} (z)$.\n\
 @end tex\n\
@@ -669,7 +669,7 @@
 DEFUN (erfcx, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Mapping Function} {} erfcx (@var{z})\n\
-Computes the scaled complementary error function,\n\
+Compute the scaled complementary error function,\n\
 @tex\n\
 $z^2 (1 - {\\rm erf} (z))$.\n\
 @end tex\n\
@@ -869,7 +869,7 @@
 DEFUN (gamma, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Mapping Function} {} gamma (@var{z})\n\
-Computes the Gamma function,\n\
+Compute the Gamma function,\n\
 @tex\n\
 $$\n\
  \\Gamma (z) = \\int_0^\\infty t^{z-1} e^{-t} dt.\n\
--- a/src/oct-hist.cc
+++ b/src/oct-hist.cc
@@ -678,8 +678,8 @@
 @w{@env{OCTAVE_HISTCONTROL}}.\n\
 \n\
 The value of @code{history_control} is a colon-separated list of values\n\
-controlling how commands are saved on the history list.   If the list\n\
-of values includes @code{ignorespace},  lines which begin with a space\n\
+controlling how commands are saved on the history list.  If the list\n\
+of values includes @code{ignorespace}, lines which begin with a space\n\
 character are not saved in the history list.  A value of @code{ignoredups}\n\
 causes lines matching the previous history entry to not be saved.\n\
 A value of @code{ignoreboth} is shorthand for @code{ignorespace} and\n\
--- a/src/oct-parse.yy
+++ b/src/oct-parse.yy
@@ -3816,6 +3816,7 @@
 autoload (\"foo\", \"bar.oct\");\n\
 @end example\n\
 \n\
+@noindent\n\
 will load the function @code{foo} from the file @code{bar.oct}.  The above\n\
 when @code{bar.oct} is not in the same directory or uses like\n\
 \n\
@@ -4013,7 +4014,7 @@
 
 DEFUN (mfilename, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Built-in Function} {} mfilename ()\n\
+@deftypefn  {Built-in Function} {} mfilename ()\n\
 @deftypefnx {Built-in Function} {} mfilename (@code{\"fullpath\"})\n\
 @deftypefnx {Built-in Function} {} mfilename (@code{\"fullpathext\"})\n\
 Return the name of the currently executing file.  At the top-level,\n\
@@ -4207,8 +4208,10 @@
 are passed on to the named function.  For example,\n\
 \n\
 @example\n\
+@group\n\
 feval (\"acos\", -1)\n\
      @result{} 3.1416\n\
+@end group\n\
 @end example\n\
 \n\
 @noindent\n\
@@ -4442,10 +4445,12 @@
 string is evaluated, as the following example shows:\n\
 \n\
 @example\n\
+@group\n\
 eval ('error (\"This is a bad example\");',\n\
       'printf (\"This error occurred:\\n%s\\n\", lasterr ());');\n\
      @print{} This error occurred:\n\
         This is a bad example\n\
+@end group\n\
 @end example\n\
 @end deftypefn")
 {
--- a/src/pager.cc
+++ b/src/pager.cc
@@ -489,7 +489,7 @@
 
 DEFUN (more, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Command} {} more\n\
+@deftypefn  {Command} {} more\n\
 @deftypefnx {Command} {} more on\n\
 @deftypefnx {Command} {} more off\n\
 Turn output pagination on or off.  Without an argument, @code{more}\n\
--- a/src/pr-output.cc
+++ b/src/pr-output.cc
@@ -3732,7 +3732,7 @@
 
 DEFUN (format, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Command} {} format\n\
+@deftypefn  {Command} {} format\n\
 @deftypefnx {Command} {} format options\n\
 Reset or specify the format of the output produced by @code{disp} and\n\
 Octave's normal echoing mechanism.  This command only affects the display\n\
--- a/src/pt-binop.cc
+++ b/src/pt-binop.cc
@@ -265,12 +265,12 @@
 DEFUN (do_braindead_shortcircuit_evaluation, args, nargout,
   "-*- texinfo -*-\n\
 @deftypefn  {Built-in Function} {@var{val} =} do_braindead_shortcircuit_evaluation ()\n\
-@deftypefnx  {Built-in Function} {@var{old_val} =} do_braindead_shortcircuit_evaluation (@var{new_val})\n\
+@deftypefnx {Built-in Function} {@var{old_val} =} do_braindead_shortcircuit_evaluation (@var{new_val})\n\
 Query or set the internal variable that controls whether Octave will\n\
 do short-circuit evaluation of @samp{|} and @samp{&} operators inside the\n\
 conditions of if or while statements.\n\
 \n\
-This feature is only provided for compatibility with Matlab and should\n\
+This feature is only provided for compatibility with @sc{matlab} and should\n\
 not be used unless you are porting old code that relies on this feature.\n\
 \n\
 To obtain short-circuit behavior for logical expressions in new programs,\n\
--- a/src/sparse.cc
+++ b/src/sparse.cc
@@ -209,7 +209,7 @@
 DEFUN (spalloc, args, ,
     "-*- texinfo -*-\n\
 @deftypefn {Loadable Function} {@var{s} =} spalloc (@var{m}, @var{n}, @var{nz})\n\
-Creates a @var{m}-by-@var{n} sparse matrix with pre-allocated space for at\n\
+Create an @var{m}-by-@var{n} sparse matrix with pre-allocated space for at\n\
 most @var{nz} nonzero elements.  This is useful for building the matrix\n\
 incrementally by a sequence of indexed assignments.  Subsequent indexed\n\
 assignments will reuse the pre-allocated memory, provided they are of one of\n\
--- a/src/strfns.cc
+++ b/src/strfns.cc
@@ -734,7 +734,7 @@
 DEFUNX ("strcmpi", Fstrcmpi, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} strcmpi (@var{s1}, @var{s2})\n\
-Returns 1 if the character strings @var{s1} and @var{s2} are the same,\n\
+Return 1 if the character strings @var{s1} and @var{s2} are the same,\n\
 disregarding case of alphabetic characters, and 0 otherwise.\n\
 \n\
 If either @var{s1} or @var{s2} is a cell array of strings, then an array\n\
@@ -791,7 +791,7 @@
 DEFUNX ("strncmpi", Fstrncmpi, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} strncmpi (@var{s1}, @var{s2}, @var{n})\n\
-Returns 1 if the first @var{n} character of @var{s1} and @var{s2} are the\n\
+Return 1 if the first @var{n} character of @var{s1} and @var{s2} are the\n\
 same, disregarding case of alphabetic characters, and 0 otherwise.\n\
 \n\
 If either @var{s1} or @var{s2} is a cell array of strings, then an array\n\
--- a/src/syscalls.cc
+++ b/src/syscalls.cc
@@ -1817,7 +1817,7 @@
 #if defined (O_TRUNC)
 DEFUNX ("O_TRUNC", FO_TRUNC, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Built-in Variable} O_TRUNC ()\n\
+@deftypefn {Built-in Function} O_TRUNC ()\n\
 Return the numerical value of the file status flag that may be\n\
 returned by @code{fcntl} to indicate that if file exists, it should\n\
 be truncated when writing.\n\
--- a/src/sysdep.cc
+++ b/src/sysdep.cc
@@ -751,7 +751,7 @@
 DEFUN (tilde_expand, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} tilde_expand (@var{string})\n\
-Performs tilde expansion on @var{string}.  If @var{string} begins with a\n\
+Perform tilde expansion on @var{string}.  If @var{string} begins with a\n\
 tilde character, (@samp{~}), all of the characters preceding the first\n\
 slash (or all characters, if there is no slash) are treated as a\n\
 possible user name, and the tilde and the following characters up to the\n\
--- a/src/utils.cc
+++ b/src/utils.cc
@@ -685,7 +685,7 @@
 DEFUN (undo_string_escapes, args, ,
   "-*- texinfo -*-\n\
 @deftypefn {Built-in Function} {} undo_string_escapes (@var{s})\n\
-Converts special characters in strings back to their escaped forms.  For\n\
+Convert special characters in strings back to their escaped forms.  For\n\
 example, the expression\n\
 \n\
 @example\n\