Issue #58: osPrereqs docs finished? [ci skip]

Author: dalehenrich

Diff for: docs/osPrereqs/OSX10.9.md

@@ -1,22 +1,38 @@
 # GsDevKit prerequisites for OS X10.9
 
+1. [Install Basic Prerequisites (required)](#install-basic-prerequisites-required)
+3. [Install ssh (optional)](#install-ssh-optional)
+4. [X11 Client (optional)](#install-x11-client-optional)
+2. [osPrereqs Installation Script (optional)](#osPrereqs-installation-script-optional)
+
+If you are undecided about whether or not you should install the optional packages, read the section on [Client/Server Configurations][4].
+
+##Install Basic Prerequisites (required)
+
 The following programs must be installed on OS X 10.9 for GsDefKit and tODE to function:
 
   - git
   - wget
 
-To install git, [follow these instructions][2].
+To install `git`, [follow these instructions][2].
 
 To install `wget`, first [install brew][1] then:
 
 ```
 brew install wget
 ```
 
-###X11
-X11 is not required for GsDevKit or Pharo, however, if you want to use [vsd][4], then you need to [install X11][3].
+##Install ssh (optional)
+ssh is installed on Mac OS X by default, so no additional steps are needed.
+
+###Install X11 Client (optional)
+To install X11 [follow these instructions][3].
+
+###osPrereqs Installation Script (optional)
+Currently the [osPrereqs script][5] does not support OS X.
 
 [1]: http://coolestguidesontheplanet.com/setting-up-os-x-mavericks-and-homebrew/
 [2]: http://git-scm.com/book/en/v2/Getting-Started-Installing-Git#Installing-on-Mac
 [3]: http://xquartz.macosforge.org/landing/
-[4]: http://gemtalksystems.com/products/vsd/
+[4]: osPrereqs.md#clientserver-configurations
+[5]: ../../bin/osPrereqs

Diff for: docs/osPrereqs/osPrereqs.md

@@ -24,8 +24,18 @@ I recommend that you install the two optional packages [SSH](#ssh) and [X11 Clie
 If you are undecided, then please read the section on [Client/Server Configurations](#clientserver-configurations) to help you make up your mind.
 
 ###SSH
+Platform-specific installation instructions:
+
+- [ssh for Ubuntu 12.04][65]
+- [ssh for Ubuntu 14.04][66]
+- [ssh for OS X10.9][67]
 
 ###X11 Client
+Platform-specific installation instructions:
+
+- [X11 Client for Ubuntu 12.04][75]
+- [X11 Client for Ubuntu 14.04][76]
+- [X11 Client for OS X10.9][77]
 
 ##Client/Server Configurations
 A [GemStone server][8] is made up of several different processes:
@@ -86,3 +96,15 @@ Depending upon network latency and whether or not you are comfortable opening po
 [15]: http://gemtalksystems.com/licensing/#CWELicensing
 [16]: ../x11ForwardingForRemoteDisplays.md#x11-forwarding-for-remote-servers
 [17]: ../portForwardingForRemoteLogins.md#using-port-forwarding-for-remote-gemstone-servers
+
+[55]: ubuntu12.04.md
+[56]: ubuntu14.04.md
+[57]: OSX10.9.md
+
+[65]: ubuntu12.04.md#install-ssh-optional
+[66]: ubuntu14.04.md#install-ssh-optional
+[67]: OSX10.9.md#install-ssh-optional
+
+[75]: ubuntu12.04.md#install-x11-client-optional
+[76]: ubuntu14.04.md#install-x11-client-optional
+[77]: OSX10.9.md#install-x11-client-optional

Diff for: docs/osPrereqs/ubuntu12.04.md

@@ -1,36 +1,11 @@
 # GsDevKit prerequisites for Ubuntu 12.04 
-It is recommended that you [Install ssh (optional)](#install-ssh-optional), since you can [run a script to the install prerequisite packages](#osPrereqs-bash-script).
 
-If you decide not to [run the script](#osPrereqs-bash-script), then following the manual instrructions in each section:
-
-3. [Install ssh (optional)](#install-ssh-optional)
-   - [osPrereqs bash script](#osPrereqs-bash-script)
 1. [Install Basic Prerequisites (required)](#install-basic-prerequisites-required)
-2. [Install X11 Client (optional)](#install-x11-client-optional)
-
-##Install ssh (optional)
-I recommend that you start by [installing ssh][2] on your server.
-Besides making it possible to use to use [X11 forwarding][1], it makes life working on your server much easier being able to use `ssh` for access and `scp` for moving files back an forth.
-Keep in mind that `ssh` is not required, so read up on the web about [best practices using ssh][4] before installing:
-
-```
-sudo apt-get -y update
-sudo apt-get -y install openssh-client
-sudo apt-get -y install openssh-server
-```
-
-If you have installed `ssh`, you can log into your server with `ssh` and continue with the installation steps.
-
-###osPrereqs bash script
-If you have installed `ssh` and you've got a checkout of gsDevKit on your server, you can use scp to copy the [osPrereqs script][3] from your server to the Ubunutu 12.04 box and save copy and pasting.
-
-The following script copys `osPrereqs`, logs into your vm and installs the [basic prerequisites](#install-basic-prerequisites) and the [X11 client](#install-x11-client):
+3. [Install ssh (optional)](#install-ssh-optional)
+4. [X11 Client (optional)](#install-x11-client-optional)
+2. [osPrereqs Installation Script (optional)](#osPrereqs-installation-script-optional)
 
-```
-scp $GS_HOME/bin/osPrereqs [email protected]:/home/notroot
-ssh 192.168.100.132 -l notroot
-./osPrereqs -X -o ubuntu12.04
-```
+If you are undecided about whether or not you should install the optional packages, read the section on [Client/Server Configurations][1].
 
 ##Install Basic Prerequisites (required)
 
@@ -53,16 +28,27 @@ sudo apt-get -y install pstack
 sudo /bin/su -c "echo 'kernel.yama.ptrace_scope = 0' >>/etc/sysctl.d/10-ptrace.conf"
 ```
 
-##X11 Client (optional)
-If you want run the Pharo client using [X11 forwarding][1] with `ssh`, then you need to install the **X11 client**:
+##Install ssh (optional)
+Before installing [ssh][2] on your server, read up on the web about [best practices using ssh][4].
+
+```
+sudo apt-get -y update
+sudo apt-get -y install openssh-client
+sudo apt-get -y install openssh-server
+```
+
+##Install X11 Client (optional)
 
 ```
 sudo apt-get -y install libgl1-mesa-dev:i386
 sudo apt-get -y install libxcb-dri2-0:i386
 ```
- 
-[1]: http://unix.stackexchange.com/questions/12755/how-to-forward-x-over-ssh-from-ubuntu-machine
-[2]: https://help.ubuntu.com/12.04/serverguide/openssh-server.html
+
+###osPrereqs Installation Script (optional)
+The [osPreregs script][3] is a bash script that can be used to install the prerequisites (including optional packages).
+
+[1]: osPrereqs.md#clientserver-configurations
+[2]: https://help.ubuntu.com/14.04/serverguide/openssh-server.html
 [3]: ../../bin/osPrereqs
 [4]: http://www.cyberciti.biz/tips/linux-unix-bsd-openssh-server-best-practices.html
 

Diff for: docs/osPrereqs/ubuntu14.04.md

@@ -1,40 +1,11 @@
 # GsDevKit prerequisites for Ubuntu 14.04 
-It is recommended that you [Install ssh (optional)](#install-ssh-optional).
-Besides the obvious advantages of secure remote logins and secure remote file copying, ssh gives you flexibility to:
-  - run tODE locally and log into remote servers via **ssh port forwarding**
-  - run tODE on remote server and host display on local X server via **ssh X11 forwarding**
-  - use the osprereqs script to install the platform prerequisites
 
-If you decide not to [run the script](#osPrereqs-bash-script), then following the manual instructions in each section:
-
-3. [Install ssh (optional)](#install-ssh-optional)
-   - [osPrereqs bash script](#osPrereqs-bash-script)
 1. [Install Basic Prerequisites (required)](#install-basic-prerequisites-required)
-2. [X11 forwarding](#install-x11-forwarding-optional)
-
-##Install ssh (optional)
-I recommend that you start by [installing ssh][2] on your server.
-Besides making it possible to use to use [X11 forwarding][1], it makes life working on your server much easier being able to use `ssh` for access and `scp` for moving files back an forth.
-Keep in mind that `ssh` is not required, so read up on the web about [best practices using ssh][4] before installing:
-
-```
-sudo apt-get -y update
-sudo apt-get -y install openssh-client
-sudo apt-get -y install openssh-server
-```
-
-If you have installed `ssh`, you can log into your server with `ssh` and continue with the installation steps.
-
-###osPrereqs bash script
-If you have installed `ssh` and you've got a checkout of gsDevKit on your server, you can use scp to copy the [osPrereqs script][3] from your server to the Ubunutu 14.04 box and save copy and pasting.
-
-The following script copys `osPrereqs`, logs into your vm and installs the [basic prerequisites](#install-basic-prerequisites) and the [X11 client](#install-x11-client):
+3. [Install ssh (optional)](#install-ssh-optional)
+4. [X11 Client (optional)](#install-x11-client-optional)
+2. [osPrereqs Installation Script (optional)](#osPrereqs-installation-script-optional)
 
-```
-scp $GS_HOME/bin/osPrereqs [email protected]:/home/notroot
-ssh 192.168.100.132 -l notroot
-./osPrereqs -X -o ubuntu14.04
-```
+If you are undecided about whether or not you should install the optional packages, read the section on [Client/Server Configurations][1].
 
 ##Install Basic Prerequisites (required)
 
@@ -56,16 +27,27 @@ sudo apt-get -y install pstack
 sudo /bin/su -c "echo 'kernel.yama.ptrace_scope = 0' >>/etc/sysctl.d/10-ptrace.conf"
 ```
 
-##X11 forwardingIf you want run the Pharo client using [X11 forwarding][1] with `ssh`, then you need to install the **X11 client**:
+##Install ssh (optional)
+Before installing [ssh][2] on your server, read up on the web about [best practices using ssh][4].
+
+```
+sudo apt-get -y update
+sudo apt-get -y install openssh-client
+sudo apt-get -y install openssh-server
+```
+
+##Install X11 Client (optional)
 
 ```
 sudo apt-get -y install libgl1-mesa-dev:i386
 sudo apt-get -y install libxcb-dri2-0:i386
 ```
 
-[1]: http://unix.stackexchange.com/questions/12755/how-to-forward-x-over-ssh-from-ubuntu-machine
+###osPrereqs Installation Script (optional)
+The [osPreregs script][3] is a bash script that can be used to install the prerequisites (including optional packages).
+
+[1]: osPrereqs.md#clientserver-configurations
 [2]: https://help.ubuntu.com/14.04/serverguide/openssh-server.html
 [3]: ../../bin/osPrereqs
 [4]: http://www.cyberciti.biz/tips/linux-unix-bsd-openssh-server-best-practices.html
 
-