[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Octave-bug-tracker] [bug #52712] some little problems found in octave.p
From: |
anonymous |
Subject: |
[Octave-bug-tracker] [bug #52712] some little problems found in octave.pdf |
Date: |
Thu, 21 Dec 2017 03:51:48 -0500 (EST) |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0 |
URL:
<http://savannah.gnu.org/bugs/?52712>
Summary: some little problems found in octave.pdf
Project: GNU Octave
Submitted by: None
Submitted on: Thu 21 Dec 2017 08:51:45 AM UTC
Category: Documentation
Severity: 3 - Normal
Priority: 5 - Normal
Item Group: Documentation
Status: None
Assigned to: None
Originator Name:
Originator Email: address@hidden
Open/Closed: Open
Discussion Lock: Any
Release: 4.2.1
Operating System: Any
_______________________________________________________
Details:
1.
Chapter 4, page 48, function complex
It seems that "re + im" should be "re + i*im".
2.
Section 6.1.2, page 105
x is a 1x2 struct array, so the text "2-by-1" should be "1-by-2".
3.
Section 6.1.4, page 110, function setfield
Section 12.2.1, page 224, function warning
Section 18.3, page 519, function qz
There are uppercase "XREF" prefix before the function names in the PDF
document only in these three places. I 'grep' the files and find that only
these three places are "xref{XREFfuncname}" but all others are
"xref{XREFfuncname,,funcname}". I'm not very familiar with Texinfo, so I'm
not sure whether this is a bug.
Possible solutions:
diff '--color=auto' -ur a/doc/interpreter/container.txi
b/doc/interpreter/container.txi
--- a/doc/interpreter/container.txi
+++ b/doc/interpreter/container.txi
@@ -258,7 +258,7 @@
@end example
@noindent
-which creates a 2-by-1 structure array with two fields. Another way
+which creates a 1-by-2 structure array with two fields. Another way
to create a structure array is with the @code{struct} function
(@pxref{Creating Structures}). As previously, to print the value of
the structure array, you can type its name:
diff '--color=auto' -ur a/libinterp/corefcn/data.cc
b/libinterp/corefcn/data.cc
--- a/libinterp/corefcn/data.cc
+++ b/libinterp/corefcn/data.cc
@@ -3226,7 +3226,7 @@
@address@hidden@var{x} + 0i}}.
With 2 real arguments, return the complex result
address@hidden@address@hidden + @var{im}}}.
address@hidden@address@hidden + address@hidden
@code{complex} can often be more convenient than expressions such as
@address@hidden + i*b}}.
For example:
diff '--color=auto' -ur a/libinterp/corefcn/error.cc
b/libinterp/corefcn/error.cc
--- a/libinterp/corefcn/error.cc
+++ b/libinterp/corefcn/error.cc
@@ -1456,7 +1456,7 @@
The optional warning identifier @var{id} allows users to enable or disable
warnings tagged by this identifier. A message identifier is a string of the
form @qcode{"NAMESPACE:WARNING-NAME"}. Octave's own warnings use the
address@hidden"Octave"} namespace (@pxref{XREFwarning_ids}). For example:
address@hidden"Octave"} namespace (@pxref{XREFwarning_ids,,warning_ids}). For
example:
@example
@group
diff '--color=auto' -ur a/libinterp/corefcn/qz.cc b/libinterp/corefcn/qz.cc
--- a/libinterp/corefcn/qz.cc
+++ b/libinterp/corefcn/qz.cc
@@ -227,7 +227,7 @@
@end enumerate
Note: @code{qz} performs permutation balancing, but not scaling
-(@pxref{XREFbalance}), which may be lead to less accurate results than
+(@pxref{XREFbalance,,balance}), which may be lead to less accurate results
than
@code{eig}. The order of output arguments was selected for compatibility
with
@sc{matlab}.
@seealso{eig, balance, lu, chol, hess, qr, qzhess, schur, svd}
diff '--color=auto' -ur a/scripts/miscellaneous/setfield.m
b/scripts/miscellaneous/setfield.m
--- a/scripts/miscellaneous/setfield.m
+++ b/scripts/miscellaneous/setfield.m
@@ -46,7 +46,7 @@
## the space character. Using arbitrary strings for field names is
## incompatible with @sc{matlab}, and this usage will emit a warning if the
## warning ID @code{Octave:language-extension} is enabled.
-## @xref{XREFwarning_ids}.
+## @xref{XREFwarning_ids,,warning_ids}.
##
## With the second calling form, set a field of a structure array. The
## input @var{sidx} selects an element of the structure array, @var{field}
_______________________________________________________
Reply to this item at:
<http://savannah.gnu.org/bugs/?52712>
_______________________________________________
Message sent via/by Savannah
http://savannah.gnu.org/
- [Octave-bug-tracker] [bug #52712] some little problems found in octave.pdf,
anonymous <=