Mercurial > octave

changeset 28715:0fcbb0faf7de

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
maint: merge stable to default.
author Rik <rik@octave.org>
date Thu, 10 Sep 2020 14:59:10 -0700
parents e8b7863a7e6b (current diff) d8dcb36bb904 (diff)
children 9beec32ba3d6
files libinterp/corefcn/data.cc libinterp/corefcn/file-io.cc scripts/ode/ode15s.m scripts/ode/ode23.m scripts/ode/ode23s.m scripts/ode/ode45.m scripts/pkg/pkg.m scripts/plot/appearance/legend.m
diffstat 20 files changed, 159 insertions(+), 135 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/basics.txi	Thu Sep 10 17:21:05 2020 -0400
+++ b/doc/interpreter/basics.txi	Thu Sep 10 14:59:10 2020 -0700
@@ -392,11 +392,12 @@
 invoke Octave with the @option{--verbose} option but without the
 @option{--silent} option.
 
-The startup files are always processes in the system's locale charset
-(independent of the .m file encoding that is set e.g. in the GUI properties).
-That is until a user manually sets the .m file encoding (e.g. in one of the
-startup files) and triggers re-parsing the .m files.  This can be done with the
-undocumented core function @code{__mfile_encoding__}:
+The startup files are always processed in the system's locale charset
+(independent of the m-file encoding that is set, for example, in the GUI
+properties).  In other words, the system's locale charset is in effect until a
+user manually sets the m-file encoding (e.g., in one of the startup files) and
+triggers re-parsing of any relevant m-files.  Octave can be forced to use a
+new encoding with the undocumented function @code{__mfile_encoding__}:
 
 @example
 @group
@@ -405,8 +406,8 @@
 @end group
 @end example
 
-This changes the encoding that is used to interpret all subsequently run startup
-and .m files (not including the currently executing file).
+This changes the encoding that is used to interpret all subsequently run
+startup and m-files (not including the currently executing file).
 
 @node Quitting Octave
 @section Quitting Octave
--- a/doc/interpreter/diffeq.txi	Thu Sep 10 17:21:05 2020 -0400
+++ b/doc/interpreter/diffeq.txi	Thu Sep 10 14:59:10 2020 -0700
@@ -150,7 +150,7 @@
     step.
 
     @item @ref{XREFode23s,,ode23s} integrates a system of stiff ODEs (or
-    index-1 DAEs) using a modified second-order Rosenbrock method.
+    index-1 DAEs) using a modified second-order @nospell{Rosenbrock} method.
   @end itemize
 
   @item Linear multistep methods
--- a/doc/interpreter/doccheck/aspell-octave.en.pws	Thu Sep 10 17:21:05 2020 -0400
+++ b/doc/interpreter/doccheck/aspell-octave.en.pws	Thu Sep 10 14:59:10 2020 -0700
@@ -1,8 +1,8 @@
 personal_ws-1.1 en 1
 AbsTol
 accumarray
+acknowledgements
 Acknowledgements
-acknowledgements
 adams
 Affero
 afterwards
@@ -34,8 +34,8 @@
 Autoconf
 autocorrelated
 autocovariances
+Autoload
 autoload
-Autoload
 autoloaded
 Autoloading
 Automake
@@ -50,10 +50,10 @@
 backtrace
 bartlett
 Barycentric
+basevalue
 BaseValue
-basevalue
+bdf
 BDF
-bdf
 benchmarking
 betacdf
 betainc
@@ -87,8 +87,8 @@
 builtin
 Bulleted
 bulleted
+ButtonDownFcn
 buttondownfcn
-ButtonDownFcn
 BV
 BZ
 bzip
@@ -107,7 +107,9 @@
 cdot
 ceil
 cellstr
+cellstrings
 ChangeLog
+charset
 chdir
 Chebyshev
 checkbox
@@ -144,11 +146,11 @@
 colorcube
 colormap
 colormaps
+ColorOrder
 colororder
-ColorOrder
 colperm
+commentstyle
 CommentStyle
-commentstyle
 ComplexEqn
 cond
 condest
@@ -216,11 +218,11 @@
 defaultaxesbox
 defaultuicontrolbackgroundcolor
 deftypefn
+delaunay
 Delaunay
-delaunay
 delaunayn
+DeleteFcn
 deletefcn
-DeleteFcn
 delim
 deltaX
 demi
@@ -228,8 +230,8 @@
 dggsvd
 diag
 diagcomp
+Dialogs
 dialogs
-Dialogs
 diamondsuit
 differentiable
 digamma
@@ -258,6 +260,7 @@
 dx
 dy
 EastOutside
+eastoutside
 Econometrics
 edgecolor
 EdgeLighting
@@ -270,8 +273,8 @@
 elementwise
 elseif
 emacs
+emptyvalue
 EmptyValue
-emptyvalue
 encodings
 endfunction
 endian
@@ -291,10 +294,10 @@
 erfc
 erfi
 errno
+errorbar
 Errorbar
-errorbar
+errorbars
 Errorbars
-errorbars
 errordlg
 ErrorHandler
 ESC
@@ -331,8 +334,8 @@
 fieldname
 fieldnames
 FIFOs
+FileName
 filename
-FileName
 filenames
 filepaths
 Filesystem
@@ -359,8 +362,8 @@
 FreeBSD
 FreeSans
 freespacing
+FreeType
 freetype
-FreeType
 frnd
 Fs
 FSF
@@ -396,8 +399,8 @@
 glibc
 globbing
 glpk
+gls
 GLS
-gls
 glyphs
 GMRES
 Gnuplot
@@ -448,8 +451,8 @@
 hggroups
 hgid
 hgload
+HH
 hh
-HH
 histc
 holomorphic
 horizontalalignment
@@ -467,8 +470,8 @@
 ict
 IDE
 IEC
+ieee
 IEEE
-ieee
 ifelse
 ifft
 ifftn
@@ -480,16 +483,16 @@
 imag
 ImageMagick
 includenan
+indices
 Indices
-indices
 infeasible
 infty
 init
 InitialSlope
 InitialStep
 InitialValue
+inline
 Inline
-inline
 inmax
 inmin
 inpolygon
@@ -520,6 +523,7 @@
 isdir
 ishandle
 ishghandle
+ismember
 isolines
 isosurface
 isosurfaces
@@ -541,8 +545,8 @@
 JConstant
 JDK
 JIS
+JIT
 jit
-JIT
 JPattern
 jpeg
 JPEG
@@ -570,8 +574,8 @@
 ldots
 le
 leaveInPlace
+Leftarrow
 leftarrow
-Leftarrow
 leftrightarrow
 leq
 lfloor
@@ -665,8 +669,8 @@
 mkoctfile
 mldivide
 mmd
+MMM
 mmm
-MMM
 mmmm
 mmmyy
 mmmyyyy
@@ -694,8 +698,8 @@
 nabla
 NAMESPACE
 namespace
+nan
 NaN
-nan
 nancond
 nanflag
 NaNs
@@ -744,7 +748,10 @@
 norminv
 normpdf
 normrnd
+northeastoutside
+northoutside
 NorthOutside
+northwestoutside
 noscal
 noshare
 nrows
@@ -793,23 +800,23 @@
 paperposition
 paperpositionmode
 papersize
+paperunits
 PaperUnits
-paperunits
 parametrically
 parseparams
 pbm
 PBM
 PBMplus
 pc
+PCG
 pcg
-PCG
 pchip
 pcr
+pcre
 PCRE
-pcre
 PCX
+pdf
 PDF
-pdf
 pdflatex
 pentadiagonal
 periodogram
@@ -822,8 +829,8 @@
 piecewise
 pinv
 PixelRegion
+PNG
 png
-PNG
 poisscdf
 poissinv
 poisspdf
@@ -870,20 +877,20 @@
 pushbutton
 pushbuttons
 Pxx
+qhull
 Qhull
-qhull
 QP
 QQ
+QRUPDATE
 qrupdate
-QRUPDATE
 QScintilla
 quadcc
 quadgk
 quadl
 quadpack
 quadv
+Quantile
 quantile
-Quantile
 quantiles
 quantization
 quartic
@@ -908,8 +915,8 @@
 rasterized
 rceil
 rdivide
+readline
 Readline
-readline
 RECT
 recursing
 redistributable
@@ -942,8 +949,8 @@
 restorePrevious
 RET
 retarget
+ReturnOnError
 returnonerror
-ReturnOnError
 rfloor
 rgb
 RGB
@@ -973,8 +980,8 @@
 Sep
 SHA
 shiftdim
+SIGNUM
 signum
-SIGNUM
 sim
 SIMAX
 SIMD
@@ -988,7 +995,10 @@
 skewness
 slcidx
 slx
+southeastoutside
+southoutside
 SouthOutside
+southwestoutside
 sp
 spadesuit
 spalloc
@@ -1019,8 +1029,8 @@
 ss
 sT
 stairstep
+startup
 Startup
-startup
 statinfo
 stdin
 stdout
@@ -1029,8 +1039,8 @@
 str
 strcmp
 streamtube
+streamtubes
 Streamtubes
-streamtubes
 stringanchors
 strncmp
 strncmpi
@@ -1040,8 +1050,8 @@
 struct
 structs
 subarrays
+subclasses
 Subclasses
-subclasses
 subdiagonal
 subdiagonals
 subdirectories
@@ -1061,11 +1071,11 @@
 submenu
 suboptimal
 subprocess
+Subprocesses
 subprocesses
-Subprocesses
 subsasgn
+subscripted
 Subscripted
-subscripted
 subscripting
 subseteq
 subsindex
@@ -1093,10 +1103,10 @@
 svds
 SVG
 svg
+sym
 Sym
-sym
+SYMAMD
 symamd
-SYMAMD
 symbfact
 symrcm
 Syntaxes
@@ -1104,8 +1114,8 @@
 terminal's
 tex
 texi
+texinfo
 Texinfo
-texinfo
 TextAlphaBits
 textarrow
 textbackgroundcolor
@@ -1159,36 +1169,36 @@
 txi
 typedefs
 TypicalX
+ub
 UB
-ub
 uchar
 UHESS
 UI
 Uibuttongroup
 uibuttongroup
 uibuttongroups
+Uicontextmenu
 uicontextmenu
-Uicontextmenu
 Uicontrol
 uicontrol
 uicontrols
 UID
 uimenu
 uint
+uipanel
 Uipanel
-uipanel
 uipanels
+uipushtool
 Uipushtool
-uipushtool
 uipushtools
 uiputfile
 uitab
 uitable
 Uitable
+Uitoggletool
 uitoggletool
-Uitoggletool
+uitoolbar
 Uitoolbar
-uitoolbar
 ulong
 Ultrix
 umfpack
@@ -1257,15 +1267,16 @@
 waitbar
 waitbars
 warndlg
+wav
 WAV
-wav
+WayPoints
 Waypoints
-WayPoints
 waypoints
 wblcdf
 wblinv
 wblpdf
 wblrnd
+westoutside
 WestOutside
 Whitespace
 whitespace
@@ -1278,8 +1289,8 @@
 windowbuttondownfcn
 windowbuttonmotionfcn
 windowbuttonupfcn
+windowstyle
 WindowStyle
-windowstyle
 WIPO
 wireframe
 wlen
--- a/doc/interpreter/external.txi	Thu Sep 10 17:21:05 2020 -0400
+++ b/doc/interpreter/external.txi	Thu Sep 10 14:59:10 2020 -0700
@@ -1758,9 +1758,9 @@
 for all built-in functions are collected in the header file
 @code{builtin-defun-decls.h}.  This feature should be used with care as the
 list of built-in functions can change.  No guarantees can be made that a
-function that is currently a built-in won't be implemented as a .m file or as a
-dynamically linked function in the future.  An example of how to call built-in
-functions from C++ can be seen in the code
+function that is currently a built-in won't be implemented as a @file{.m} file
+or as a dynamically linked function in the future.  An example of how to call
+built-in functions from C++ can be seen in the code
 
 @example
 @EXAMPLEFILE(standalonebuiltin.cc)
--- a/libinterp/corefcn/data.cc	Thu Sep 10 17:21:05 2020 -0400
+++ b/libinterp/corefcn/data.cc	Thu Sep 10 14:59:10 2020 -0700
@@ -3710,9 +3710,9 @@
 @deftypefn {} {} isvector (@var{x})
 Return true if @var{x} is a vector.
 
-A vector is a 2-D array where one of the dimensions is equal to 1 (either 1xN
-or Nx1).  As a consequence of this definition, a 1x1 array (a scalar) is also a
-vector.
+A vector is a 2-D array where one of the dimensions is equal to 1 (either
+@nospell{1xN} or @nospell{Nx1}).  As a consequence of this definition, a 1x1
+array (a scalar) is also a vector.
 @seealso{isscalar, ismatrix, iscolumn, isrow, size}
 @end deftypefn */)
 {
--- a/libinterp/corefcn/file-io.cc	Thu Sep 10 17:21:05 2020 -0400
+++ b/libinterp/corefcn/file-io.cc	Thu Sep 10 14:59:10 2020 -0700
@@ -500,8 +500,8 @@
 character string that specifies whether the file is to be opened for
 reading, writing, or both.  The @var{encoding} is a character string with a
 valid encoding identifier.  This encoding is used when strings are read from
-or written to the file.  By default, the same encoding is used like for reading
-.m files.
+or written to the file.  By default, the same encoding specified for reading
+@file{.m} files is used for interpreting user files.
 
 The second form of the @code{fopen} function returns a vector of file ids
 corresponding to all the currently open files, excluding the
--- a/libinterp/dldfcn/audiodevinfo.cc	Thu Sep 10 17:21:05 2020 -0400
+++ b/libinterp/dldfcn/audiodevinfo.cc	Thu Sep 10 14:59:10 2020 -0700
@@ -89,7 +89,7 @@
 
 The @var{devinfo} structure has two fields @qcode{"input"} and
 @qcode{"output"}.  The value of each field is a structure array with fields
-@qcode{"Name"}, @qcode{@nospell{"DriverVersion"}} and @qcode{"ID"} describing
+@qcode{"Name"}, @nospell{@qcode{"DriverVersion"}} and @qcode{"ID"} describing
 an audio device.
 
 If the optional argument @var{io} is 1, return information about input devices
@@ -103,7 +103,7 @@
 If the optional argument @var{name} is provided, return the ID of the named
 device.
 
-If the optional argument @qcode{@nospell{"DriverVersion"}} is given, return the
+If the optional argument @nospell{@qcode{"DriverVersion"}} is given, return the
 name of the driver for the specified device.
 
 Given a sampling rate, bits per sample, and number of channels for an input or
--- a/scripts/geometry/delaunay.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/geometry/delaunay.m	Thu Sep 10 14:59:10 2020 -0700
@@ -56,7 +56,7 @@
 ## See the documentation for the Qhull library for details
 ## @url{http://www.qhull.org/html/qh-quick.htm#options}.
 ## The default options are @code{@{"Qt", "Qbb", "Qc"@}}.
-## If QHull fails for 2-D input the triangulation is attempted again with
+## If Qhull fails for 2-D input the triangulation is attempted again with
 ## the options @code{@{"Qt", "Qbb", "Qc", "Qz"@}} which may result in
 ## reduced accuracy.
 ##
--- a/scripts/geometry/delaunayn.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/geometry/delaunayn.m	Thu Sep 10 14:59:10 2020 -0700
@@ -50,7 +50,7 @@
 ## @item 4-D and higher: @var{options} = @code{@{"Qt", "Qbb", "Qc", "Qx"@}}
 ## @end itemize
 ##
-## If QHull fails for 2-D input the triangulation is attempted again with
+## If Qhull fails for 2-D input the triangulation is attempted again with
 ## the options @code{@{"Qt", "Qbb", "Qc", "Qz"@}} which may result in
 ## reduced accuracy.
 ##
--- a/scripts/ode/ode15i.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/ode/ode15i.m	Thu Sep 10 14:59:10 2020 -0700
@@ -71,9 +71,9 @@
 ## @w{@code{fieldnames (@var{solution})}} to see the other fields and
 ## additional information returned.
 ##
-## If no output arguments are requested, and no @code{OutputFcn} is specified
-## in @var{ode_opt}, then the @code{OutputFcn} is set to @code{odeplot} and the
-## results of the solver are plotted immediately.
+## If no output arguments are requested, and no @qcode{"OutputFcn"} is
+## specified in @var{ode_opt}, then the @qcode{"OutputFcn"} is set to
+## @code{odeplot} and the results of the solver are plotted immediately.
 ##
 ## If using the @qcode{"Events"} option then three additional outputs may be
 ## returned.  @var{te} holds the time when an Event function returned a zero.
--- a/scripts/ode/ode15s.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/ode/ode15s.m	Thu Sep 10 14:59:10 2020 -0700
@@ -65,9 +65,9 @@
 ## @w{@code{fieldnames (@var{solution})}} to see the other fields and
 ## additional information returned.
 ##
-## If no output arguments are requested, and no @code{OutputFcn} is specified
-## in @var{ode_opt}, then the @code{OutputFcn} is set to @code{odeplot} and the
-## results of the solver are plotted immediately.
+## If no output arguments are requested, and no @qcode{"OutputFcn"} is
+## specified in @var{ode_opt}, then the @qcode{"OutputFcn"} is set to
+## @code{odeplot} and the results of the solver are plotted immediately.
 ##
 ## If using the @qcode{"Events"} option then three additional outputs may be
 ## returned.  @var{te} holds the time when an Event function returned a zero.
--- a/scripts/ode/ode23.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/ode/ode23.m	Thu Sep 10 14:59:10 2020 -0700
@@ -68,9 +68,9 @@
 ## @w{@code{fieldnames (@var{solution})}} to see the other fields and
 ## additional information returned.
 ##
-## If no output arguments are requested, and no @code{OutputFcn} is specified
-## in @var{ode_opt}, then the @code{OutputFcn} is set to @code{odeplot} and the
-## results of the solver are plotted immediately.
+## If no output arguments are requested, and no @qcode{"OutputFcn"} is
+## specified in @var{ode_opt}, then the @qcode{"OutputFcn"} is set to
+## @code{odeplot} and the results of the solver are plotted immediately.
 ##
 ## If using the @qcode{"Events"} option then three additional outputs may be
 ## returned.  @var{te} holds the time when an Event function returned a zero.
--- a/scripts/ode/ode23s.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/ode/ode23s.m	Thu Sep 10 14:59:10 2020 -0700
@@ -31,13 +31,13 @@
 ## @deftypefnx {} {@var{solution} =} ode23s (@dots{})
 ##
 ## Solve a set of stiff Ordinary Differential Equations (stiff ODEs) with a
-## Rosenbrock method of order (2,3).
+## @nospell{Rosenbrock} method of order (2,3).
 ##
 ## @var{fun} is a function handle, inline function, or string containing the
 ## name of the function that defines the ODE: @code{M y' = f(t,y)}.  The
 ## function must accept two inputs where the first is time @var{t} and the
-## second is a column vector of unknowns @var{y}. @var{M} is a constant mass
-## matrix, non-singular and possibly sparse. Set the field @var{Mass} in
+## second is a column vector of unknowns @var{y}.  @var{M} is a constant mass
+## matrix, non-singular and possibly sparse.  Set the field @qcode{"Mass"} in
 ## @var{odeopts} using @var{odeset} to specify a mass matrix.
 ##
 ## @var{trange} specifies the time interval over which the ODE will be
@@ -58,8 +58,9 @@
 ##
 ## The optional fourth argument @var{ode_opt} specifies non-default options to
 ## the ODE solver.  It is a structure generated by @code{odeset}.
-## @code{ode23s} will ignore the following options: "BDF", "InitialSlope",
-## "MassSingular", "MStateDependence", "MvPattern", "MaxOrder", "NonNegative".
+## @code{ode23s} will ignore the following options: @qcode{"BDF"},
+## @qcode{"InitialSlope"}, @qcode{"MassSingular"}, @qcode{"MStateDependence"},
+## @qcode{"MvPattern"}, @qcode{"MaxOrder"}, @qcode{"Non-negative"}.
 ##
 ## The function typically returns two outputs.  Variable @var{t} is a
 ## column vector and contains the times where the solution was found.  The
--- a/scripts/ode/ode45.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/ode/ode45.m	Thu Sep 10 14:59:10 2020 -0700
@@ -68,9 +68,9 @@
 ## @w{@code{fieldnames (@var{solution})}} to see the other fields and
 ## additional information returned.
 ##
-## If no output arguments are requested, and no @code{OutputFcn} is specified
-## in @var{ode_opt}, then the @code{OutputFcn} is set to @code{odeplot} and the
-## results of the solver are plotted immediately.
+## If no output arguments are requested, and no @qcode{"OutputFcn"} is
+## specified in @var{ode_opt}, then the @qcode{"OutputFcn"} is set to
+## @code{odeplot} and the results of the solver are plotted immediately.
 ##
 ## If using the @qcode{"Events"} option then three additional outputs may be
 ## returned.  @var{te} holds the time when an Event function returned a zero.
--- a/scripts/pkg/pkg.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/pkg/pkg.m	Thu Sep 10 14:59:10 2020 -0700
@@ -29,18 +29,19 @@
 ## @deftypefnx {} {[@var{out1}, @dots{}] =} pkg (@var{command}, @dots{} )
 ## Manage or query packages (groups of add-on functions) for Octave.
 ##
-## Packages can be installed globally (i.e. for all users of the system) or
-## locally (i.e. for the current user only).
+## Packages can be installed globally (i.e., for all users of the system) or
+## locally (i.e., for the current user only).
 ##
-## Global packages are by default installed in the "global packages store".
-## That is usually located in a subdirectory of the folder where Octave itself
-## is installed in.  Therefore, Octave needs write access to this folder to
-## install global packages.  That usually means that Octave has to run with root
-## access (or "Run as administrator") to be able to install packages globally.
+## Global packages are installed by default in a system-wide location.  This is
+## usually a subdirectory of the folder where Octave itself is installed.
+## Therefore, Octave needs write access to this folder to install global
+## packages.  That usually means that Octave has to run with root access (or
+## "Run as administrator" on Windows) to be able to install packages globally.
 ##
-## In contrast, local packages are by default installed in the user's profile
-## and are only available to that specific user.  Usually, they can be installed
-## without root access (or administrative privileges).
+## In contrast, local packages are installed by default in the user's
+## home directory (profile on Windows) and are only available to that specific
+## user.  Usually, they can be installed without root access (or administrative
+## privileges).
 ##
 ## For global and local packages, there are separate databases holding the
 ## information about the installed packages.  If some package is installed
@@ -49,13 +50,13 @@
 ## used can also be manipulated by using prefixes and/or using the
 ## @samp{local_list} input argument.  Using these mechanisms, several different
 ## releases of one and the same package can be installed side by side as well
-## (but cannot be loaded simultaneouly).
+## (but cannot be loaded simultaneously).
 ##
-## Packages might dependend on external software and/or other packages.  To be
+## Packages might depend on external software and/or other packages.  To be
 ## able to install such packages, these dependencies should be installed
 ## beforehand.  A package that depends on other package(s) can still be
-## installed using the @qcode{"-nodeps"} flag.  The effects of unsatisfied
-## dependencies on external software --- like libraries --- depends on the
+## installed using the @option{-nodeps} flag.  The effects of unsatisfied
+## dependencies on external software---like libraries---depends on the
 ## individual package.
 ##
 ## Packages must be loaded before they can be used.  When loading a package,
@@ -63,25 +64,26 @@
 ## @enumerate
 ## @item
 ## If the package depends on other packages (and @code{pkg load} is called
-## without the @qcode{"-nodeps"} option), the package is not loaded immediately.
-## Instead, those dependencies are loaded first (recursively if needed).
+## without the @option{-nodeps} option), the package is not loaded
+## immediately.  Instead, those dependencies are loaded first (recursively if
+## needed).
 ##
 ## @item
-## When all dependencies are satified, the package's subdirectories are added to
-## the search path.
+## When all dependencies are satisfied, the package's subdirectories are
+## added to the search path.
 ## @end enumerate
 ##
 ## This load order leads to functions that are provided by dependencies being
 ## potentially shadowed by functions of the same name that are provided by
-## dependers.
+## top-level packages.
 ##
 ## Each time, a package is added to the search path, initialization script(s)
 ## for the package are automatically executed if they are provided by the
 ## package.
 ##
-## Depending on the value of @var{command} and on the number of requested return
-## arguments, @code{pkg} can be used to perform several tasks.  Possible values
-## for @var{command} are:
+## Depending on the value of @var{command} and on the number of requested
+## return arguments, @code{pkg} can be used to perform several tasks.
+## Possible values for @var{command} are:
 ##
 ## @table @samp
 ##
@@ -194,9 +196,9 @@
 ## adds the @code{signal} package and also tries to load its dependency: the
 ## @code{control} package.  Be aware that the functionality of package(s)
 ## loaded will probably be impacted by use of the @option{-nodeps} flag.  Even
-## if necessary dependencies are loaded later, the functionality of depender
-## packages can still be affected because the optimal loading order of may
-## not have been followed.
+## if necessary dependencies are loaded later, the functionality of top-level
+## packages can still be affected because the optimal loading order may not
+## have been followed.
 ##
 ## @item unload
 ## Remove named packages from the path.  After unloading a package it is
@@ -204,9 +206,9 @@
 ## to unload a package that other loaded packages still depend on will result
 ## in an error; no packages will be unloaded in this case.  A package can
 ## be forcibly removed with the @option{-nodeps} flag, but be aware that the
-## functionality of depender packages will likely be affected.  As when loading
-## packages, reloading dependencies after having unloaded them with the
-## @option{-nodeps} flag may not restore all functionality of the depender
+## functionality of dependent packages will likely be affected.  As when
+## loading packages, reloading dependencies after having unloaded them with the
+## @option{-nodeps} flag may not restore all functionality of the dependent
 ## packages as the required loading order may be incorrect.
 ##
 ## @item list
@@ -366,7 +368,7 @@
 ##
 ## @item test
 ## Perform the built-in self tests contained in all functions provided by
-## the named packages.  For example,
+## the named packages.  For example:
 ##
 ## @example
 ## pkg test image
--- a/scripts/pkg/private/get_inverse_dependencies.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/pkg/private/get_inverse_dependencies.m	Thu Sep 10 14:59:10 2020 -0700
@@ -26,7 +26,7 @@
 ## -*- texinfo -*-
 ## @deftypefn {} {@var{installed_pkgs_list} =} get_inverse_dependencies (@var{installed_pkgs_lst})
 ## Find inverse dependencies, if any, for each package, and store in
-## the struct field "invdeps".
+## the struct field @qcode{"invdeps"}.
 ##
 ## @end deftypefn
 
--- a/scripts/plot/appearance/legend.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/plot/appearance/legend.m	Thu Sep 10 14:59:10 2020 -0700
@@ -93,11 +93,13 @@
 ## Following is a subset of supported legend properties:
 ## @c The following table is obtained by copying the output of
 ## @c genpropdoc ("legend", "", {"autoupdate", "box", "location", "numcolumns", "orientation", "string", "textcolor"})
+##
 ## @table @asis
 ##
 ## @item @code{autoupdate}: @qcode{"off"} | @{@qcode{"on"}@}
-## Control whether the number of legend items is updated automatically when objects are added to (or deleted from) the peer axes.
-## For example:
+## Control whether the number of legend items is updated automatically when
+## objects are added to (or deleted from) the peer axes.  For example:
+##
 ## @example
 ## @group
 ## ## Create a single plot with its legend.
@@ -114,17 +116,22 @@
 ## @end group
 ## @end example
 ##
-##
 ## @item @code{box}: @qcode{"off"} | @{@qcode{"on"}@}
 ## Control whether the legend has a surrounding box.
 ##
-##
-## @item @code{location}: @qcode{"best"} | @qcode{"bestoutside"} | @qcode{"east"} | @qcode{"eastoutside"} | @qcode{"none"} | @qcode{"north"} | @{@qcode{"northeast"}@} | @qcode{"northeastoutside"} | @qcode{"northoutside"} | @qcode{"northwest"}| @qcode{"northwestoutside"} | @qcode{"south"} | @qcode{"southeast"} | @qcode{"southeastoutside"} | @qcode{"southoutside"} | @qcode{"southwest"} | @qcode{"southwestoutside"} | @qcode{"west"} | @qcode{"westoutside"}
+## @item @code{location}: @qcode{"best"} | @qcode{"bestoutside"} |
+## @qcode{"east"} | @qcode{"eastoutside"} | @qcode{"none"} | @qcode{"north"} |
+## @{@qcode{"northeast"}@} | @qcode{"northeastoutside"} |
+## @qcode{"northoutside"} | @qcode{"northwest"}| @qcode{"northwestoutside"} |
+## @qcode{"south"} | @qcode{"southeast"} | @qcode{"southeastoutside"} |
+## @qcode{"southoutside"} | @qcode{"southwest"} | @qcode{"southwestoutside"} |
+## @qcode{"west"} | @qcode{"westoutside"}
 ## Control the location of the legend.
 ##
+## @item @code{numcolumns}: scalar interger, def. @code{1}
+## Control the number of columns used in the layout of the legend items.
+## For example:
 ##
-## @item @code{numcolumns}: scalar interger, def. @code{1}
-## Control the number of columns used in the layout of the legend items.  For example:
 ## @example
 ## @group
 ## figure ();
@@ -132,15 +139,17 @@
 ## legend ("numcolumns", 3);
 ## @end group
 ## @end example
-## Setting @code{numcolumns} also forces the @code{numcolumnsmode} property to be set to @qcode{"manual"}.
 ##
+## Setting @code{numcolumns} also forces the @code{numcolumnsmode} property
+## to be set to @qcode{"manual"}.
 ##
 ## @item @code{orientation}: @qcode{"horizontal"} | @{@qcode{"vertical"}@}
-## Control whether the legend items are arranged vertically (column-wise) or horizontally (row-wise).
-##
+## Control whether the legend items are arranged vertically (column-wise) or
+## horizontally (row-wise).
 ##
 ## @item @code{string}: string | cell array of strings
 ## List of labels for the legend items.  For example:
+##
 ## @example
 ## @group
 ## figure ();
@@ -154,7 +163,6 @@
 ## @end group
 ## @end example
 ##
-##
 ## @item @code{textcolor}: colorspec, def. @code{[0   0   0]}
 ## Control the color of the text strings for legend item.
 ##
--- a/scripts/plot/util/gui_mainfcn.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/plot/util/gui_mainfcn.m	Thu Sep 10 14:59:10 2020 -0700
@@ -25,8 +25,8 @@
 ########################################################################
 
 ## -*- texinfo -*-
-## @deftypefn  {} {[@var{@dots{}}] =} gui_mainfcn  (@var{gui_state}, @dots{})
-## Compatibility function for figures created with Matlab's Guide.
+## @deftypefn {} {[@var{@dots{}}] =} gui_mainfcn (@var{gui_state}, @dots{})
+## Compatibility function for figures created with @sc{matlab}'s Guide.
 ##
 ## This function is undocumented and users should not use it in new code.
 ##
--- a/scripts/plot/util/hgtransform.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/plot/util/hgtransform.m	Thu Sep 10 14:59:10 2020 -0700
@@ -31,11 +31,10 @@
 ## Create a graphics transform object.
 ##
 ## FIXME: Need to write documentation.
-## FIXME: Add 'makehgtform' to seealso list when it is implemented.
+## FIXME: Add <makehgtform> to seealso list when it is implemented.
 ## @seealso{hggroup}
 ## @end deftypefn
 
-
 ## FIXME: hgtransform should be a C++ graphics object, not an m-file.
 ##        For the moment (3/7/17), it is quicker to implement something in
 ##        an m-file.  But, this approach requires double the memory (original
--- a/scripts/testfun/__debug_octave__.m	Thu Sep 10 17:21:05 2020 -0400
+++ b/scripts/testfun/__debug_octave__.m	Thu Sep 10 14:59:10 2020 -0700
@@ -30,14 +30,16 @@
 ## Octave process.
 ##
 ## If @var{command_string} is not supplied, it should have a single
-## @qcode{%d} format option that will be replaced by the process ID
+## @code{%d} format option that will be replaced by the process ID
 ## for the current Octave process, as returned by @code{getpid}.  For
 ## example, on Windows systems the following two commands are
 ## equivalent:
 ##
 ## @example
+## @group
 ## __debug_octave__ ()
 ## __debug_octave__ ("start gdb -p %d")
+## @end group
 ## @end example
 ## @end deftypefn