Apply Cristian suggestions

R/rdeephaven/README.md

@@ -66,11 +66,11 @@ Currently, the R client is only supported on Ubuntu 20.04 or 22.04 and must be b
 
 1. Build the Deephaven C++ client (and dependencies) according to the instructions in the
  [Deephaven C++ client installation guide](https://github.com/deephaven/deephaven-core/blob/main/cpp-client/README.md).
- Follow the instructions at least through step 6. At that point you would have both the Deephaven C++ client and any
- C++ libraries it depends on, all installed in a particular directory of your choosing.
- In what follows we assume that directory is `/path/to/dhcpp`.
+ Follow the instructions at least through "Build and Install Deephaven C++ client". After that, you will have both the
+ Deephaven C++ client and any C++ libraries it depends on installed in a particular directory of your choosing.
+ In what follows, we assume that directory is `/path/to/dhcpp`.
 
-2. Set environment variables from the C++ client installation required for building the R client:
+3. Set environment variables from the C++ client installation required for building the R client:
  ```bash
  source /path/to/dhcpp/env.sh
  ```
@@ -80,11 +80,18 @@ Currently, the R client is only supported on Ubuntu 20.04 or 22.04 and must be b
  echo $DHCPP
  echo $LD_LIBRARY_PATH
  echo $NCPUS
- echo $MAKE
+ echo $CMAKE_PREFIX_PATH
  ```
+
+ For faster compilation of the R client and its dependencies (particularly the Arrow R client),
+ use the following command:
+ ```bash
+ export MAKE="make -j$NCPUS"
+ ```
+
  Refer to the instructions on the C++ client installation for more details on the `dhcpp` directory.
 
-3. The C++ client installation will have left you with a local clone of the full [Deephaven Core Git repository](https://github.com/deephaven/deephaven-core).
+4. The C++ client installation will have left you with a local clone of the full [Deephaven Core Git repository](https://github.com/deephaven/deephaven-core).
  Navigate to the `deephaven-core/R/rdeephaven` directory within that clone.
 
  If you prefer to have an isolated directory where the Deephaven R client source code will live, use git's sparse-checkout:
@@ -98,7 +105,7 @@ Currently, the R client is only supported on Ubuntu 20.04 or 22.04 and must be b
  git pull origin main
  ```
 
-4. Start an R console inside the `rdeephaven` directory by running `R`. In that console, install the Deephaven R client dependencies:
+5. Start an R console inside the `rdeephaven` directory by running `R`. In that console, install the Deephaven R client dependencies:
  ```r
  install.packages(c('Rcpp', 'arrow', 'R6', 'dplyr', 'xml2', 'rmarkdown', 'knitr'))
  ```
@@ -108,15 +115,15 @@ Currently, the R client is only supported on Ubuntu 20.04 or 22.04 and must be b
  ```
  This is needed over the typical `install.packages()` to ensure that the vignettes get built and installed.
 
-5. Now, run
+6. Now, run
  ```r
  library(rdeephaven)
  ```
  in the R session, and start using the client!
  
  For an introduction to the package, run `vignette("rdeephaven")`.
 
-6. The `LD_LIBRARY_PATH` environment variable set in step 2 is necessary for loading the R client once it is installed.
+7. The `LD_LIBRARY_PATH` environment variable set in step 2 is necessary for loading the R client once it is installed.
  Therefore, you must set `LD_LIBRARY_PATH` manually at the start of each session by running the following command:
  ```bash
  source /path/to/dhcpp/env.sh