Merge pull request #192 from eecs280staff/vscode-revisions

VS Code Tutorial Revisions

Author: jamesjuett

docs/Makefile

@@ -0,0 +1,15 @@
+# Sample makefile for EECS 280 Setup Tutorials
+
+CXX ?= g++
+CXXFLAGS ?= -Wall -Werror -pedantic -g --std=c++17 -Wno-sign-compare -Wno-comment
+
+# Compile the main executable
+main.exe: main.cpp
+	$(CXX) $(CXXFLAGS) main.cpp -o main.exe
+
+# Remove automatically generated files
+clean :
+	rm -rvf *.exe *~ *.out *.dSYM *.stackdump
+
+# Disable built-in rules
+.SUFFIXES:

docs/images/vscode_macos_017.png

@@ -1,11 +1,21 @@
-// main.cpp
-// Project UID 5366c7e2b77742d5b2142097e51561a5
+// Sample main.cpp for EECS 280 Setup Tutorials
 
-#include "stats.h"
-#include "p1_library.h"
 #include <iostream>
+#include <vector>
 using namespace std;
 
-int main() {
-  cout << "hello from main!\n";
+double sum (const vector<double> &data) {
+  double total = 0;
+  for (size_t i=0; i<data.size(); ++i) {
+    total += data[i];
+  }
+  return total;
 }
+
+int main() {
+  vector<double> data;
+  data.push_back(10);
+  data.push_back(20);
+  data.push_back(30);
+  cout << "sum(data) = " << sum(data) << endl;
+}

docs/images/vscode_macos_030.png

@@ -9,7 +9,7 @@ macOS command line tools
 
 macOS comes with a Terminal and can run UNIX command-line tools directly.
 
-When you see `$` in this tutorial, you should type into your shell the command that comes after the `$`.
+The macOS terminal command prompt ends with a `$`. To follow the steps below, type commands that appear after the `$` and hit enter.
 
 ## Open terminal
 Open the Terminal application which comes with macOS.
@@ -51,7 +51,7 @@ Close your terminal and reopen your terminal.
 Check your install.  Your version might be different.
 ```console
 $ brew --version
-Homebrew 3.6.14
+Homebrew 4.3.18
 ```
 
 ## Install CLI tools
@@ -60,6 +60,36 @@ Use the Homebrew package manager to install a few command line programs.
 $ brew install wget git tree
 ```
 
+## Home Directory
+Run `cd ~`. This will take you to your Ubuntu home directory. Running `pwd` afterward confirms the location. (Your username will be different.)
+
+```console
+$ cd ~
+$ pwd
+/Users/jjuett
+```
+
+Create an EECS 280 folder by running `mkdir ~/eecs280`. Running `ls` afterward confirms the folder has been created.
+
+```console
+$ mkdir ~/eecs280
+$ ls
+Desktop		Downloads	Movies		Pictures	eecs280
+Documents	Library		Music		Public
+```
+
+We highly recommend you store all coding work for EECS 280 projects and labs here.
+
+<div class="primer-spec-callout warning" markdown="1">
+**Pitfall:** Avoid paths that contain spaces. Spaces cause problems with some command line tools.
+
+| Bad Example     | Good Example   |
+|-----------------|----------------|
+| `EECS 280/` | `eecs280/` |
+| `Project 1 Stats/` | `p1-stats/` |
+
+</div>
+
 ## Use CLI tools
 Now would be a great time to take a look at our [CLI Tutorial](cli.html).