user documentation

[stuckyb]

The build system has changed in many ways since I wrote the initial user documentation. All of the documentation needs to be reviewed and revised or expanded, as needed.