Dear Jarkko,
Thank you for spotting these problems and suggesting fixes for them! I
am forwarding your e-mail to the R-devel mailing list (removing the
R-help list, which is for different kind of R problems), together with
a patch implementing your suggested changes.
? Thu, 6 Jul 2023 10:12:16 +0300
Jarkko Toivonen <jarkko.toivonen.19 at gmail.com>
?????:> I noticed a few errors in Version 4.3.1 (2023-06-16)
--- doc/manual/R-intro.texi (revision 84676)
+++ doc/manual/R-intro.texi (working copy)
@@ -2594,7 +2594,7 @@
@noindent
does not replace the component @code{u} of the data frame, but rather
-masks it with another variable @code{u} in the working directory at
+masks it with another variable @code{u} in the workspace at
@w{position 1} on the search path. To make a permanent change to the
data frame itself, the simplest way is to resort once again to the
@code{$} notation:
@@ -2631,7 +2631,7 @@
@subsection Working with data frames
A useful convention that allows you to work with many different problems
-comfortably together in the same working directory is
+comfortably together in the same workspace is
@itemize @bullet
@item
@@ -2639,7 +2639,7 @@
in a data frame under a suitably informative name;
@item
when working with a problem attach the appropriate data frame at
- at w{position 2}, and use the working directory at @w{level 1} for
+ at w{position 2}, and use the workspace at @w{level 1} for
operational quantities and temporary variables;
@item
before leaving a problem, add any variables you wish to keep for future
@@ -2646,7 +2646,7 @@
reference to the data frame using the @code{$} form of assignment, and
then @code{detach()};
@item
-finally remove all unwanted variables from the working directory and
+finally remove all unwanted variables from the workspace and
keep it as clean of left-over temporary variables as possible.
@end itemize
@@ -2718,7 +2718,7 @@
rather inflexible. There is a clear presumption by the designers of
@R{} that you will be able to modify your input files using other tools,
such as file editors or Perl at footnote{Under UNIX, the utilities
- at command{sed} or at command{awk} can be used.} to fit in with the
+ at command{sed} or @command{awk} can be used.} to fit in with the
requirements of @R{}. Generally this is very simple.
If variables are to be held mainly in data frames, as we strongly
@@ -3576,8 +3576,15 @@
following to use it safely.
Thus given a @math{n} by @math{1} vector @math{y} and an @math{n} by
- at math{p} matrix @math{X} then @math{X \ y} is defined as
+ at math{p} matrix @math{X} then
@ifnottex
+ at math{X \ y}
+ at end ifnottex
+ at tex
+ at math{X \\ y}
+ at end tex
+is defined as
+ at ifnottex
(X'X)^@{-@}X'y, where (X'X)^@{-@}
@end ifnottex
@tex
I chose to replace the "working directory" metaphor with
"workspace". I
such word use here is correct.
--
Best regards,
Ivan