R help - Jul 2023 - Errors in "An introduction to R"

Hi,

Thanks for the great manual! I noticed a few errors in Version 4.3.1 
(2023-06-16), though.

Early in the document a "working directory" refers to a file system 
directory, such as ~/work. It is also discussed whether
separate working directories should be used for separate analyses (page 
6). However, in sections 6.3.2 - 6.3.4, the term "working directory"
seems to refer to environment (or workspace). This is very confusing, 
especially in section 6.3.3, where it is written "to work with many 
different problems comfortably together in the same working directory". 
Maybe the word "environment" or "workspace" should be used
instead of
"working directory" in sections 6.3.2 - 6.3.4.

Footnote on page 30: space missing in "orawk".

Page 42, section 10.1: backslash between X and y is not shown in "Thus 
given a n by 1 vector y and an n by p matrix X then X y is defined as".

Jarkko

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