From kry|ov@r00t @end|ng |rom gm@||@com  Mon Jul 10 17:37:30 2023
From: kry|ov@r00t @end|ng |rom gm@||@com (Ivan Krylov)
Date: Mon, 10 Jul 2023 18:37:30 +0300
Subject: [Rd] [R] Errors in "An introduction to R"
In-Reply-To: <4caaf4ba-0072-8040-5e0b-77a2f5725004@gmail.com>
References: <4caaf4ba-0072-8040-5e0b-77a2f5725004@gmail.com>
Message-ID: <20230710183730.16f332b8@arachnoid>

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



[Rd] [R] Errors in "An introduction to R"
Ivan Krylov