Documentation updates

README.md

@@ -63,11 +63,13 @@ the issue.)
 # Sockets
 ## TCP
 On Windows DCD will use TCP sockets to communicate between the client and server.
-Other operating systems can use TCP sockets if the client and server use the `--tcp`
-command-line switch.
+DCD can use TCP sockets on other operating systems if the client and server use
+the `--tcp` or `--port` command-line switches.
 
 ## UNIX domain sockets
 Operating systems that support UNIX domain sockets will use them by default.
+The path to the socket file can be overriden with the `--socketFile` option.
+These are the default paths:
 
 #### OSX
 The socket will be created at `/var/tmp/dcd-${UID}.socket`
@@ -75,7 +77,7 @@ The socket will be created at `/var/tmp/dcd-${UID}.socket`
 #### Linux/BSD
 The client and server will attempt to create the socket in the following locations:
 * `${XDG_RUNTIME_DIR}/dcd.socket`
-* `/tmp/dcd-${UID}.socket`
+* `/tmp/dcd-${UID}.socket` if `XDG_RUNTIME_DIR` is not defined.
 
 # Client
 Because DCD is designed to be used from a text editor, this section is written
@@ -214,7 +216,7 @@ in place of a file being edited.)
 #Server
 The server must be running for the DCD client to provide autocomplete information.
 In future versions the client may start the server if it is not running, but for
-now it must be started manually or by an editor plugin.
+now it must be started manually or (usually) by an editor plugin.
 
 ## Configuration Files
 The server will attempt to read the file ```${XDG_CONFIG_HOME}/dcd/dcd.conf```
@@ -235,7 +237,7 @@ What you actually want is this:
 	/usr/include/dmd/phobos
 
 ##Shut down the server
-The server can be shut down by running the client with the correct option:
+The server can be shut down by running the client with the `--shutdown` option:
 
 	dcd-client --shutdown
 
@@ -245,4 +247,5 @@ Import directories can be specified on the command line at startup:
 	dcd-server -I/home/user/code/one -I/home/user/code/two
 
 ## Port number
-The ```--port``` or ```-p``` option lets you specify the port number that the server will listen on.
+The ```--port``` or ```-p``` option lets you specify the port number that the
+server will listen on. The default port is 9166.

man1/dcd-client.1

@@ -1,4 +1,4 @@
-.TH dcd-client 1 "Jan 15 2016" "" https://github.com/Hackerpilot/DCD
+.TH dcd-client 1 "Mar 3 2016" "" https://github.com/Hackerpilot/DCD
 .SH NAME
 dcd-client \- autocompletion client for the D programming language
 .PD
@@ -36,9 +36,7 @@ position is measured in bytes from the beginning of the source code.
 .RS
 Choose the port number on which
 .B dcd-client
-listens. This has no effect unless
-.B dcd-client
-is being run on Windows or the \-\-tcp switch is used.
+listens. This switch implies \-\-tcp.
 .RE
 .B \-\-tcp
 .RS
@@ -49,7 +47,7 @@ Windows.
 .I filePath
 .RS
 Set the path to use for the UNIX domain socket. Has no effect if the \-\-tcp
-switch is used.
+or \-\-port switches are used.
 .RE
 .B \-I
 .I directory

man1/dcd-server.1

@@ -1,4 +1,4 @@
-.TH dcd-server 1 "Jan 15 2016" "" https://github.com/Hackerpilot/DCD
+.TH dcd-server 1 "Mar 3 2016" "" https://github.com/Hackerpilot/DCD
 .SH NAME
 dcd-server \- autocompletion server for the D programming language
 .PD
@@ -22,9 +22,7 @@ dcd-server \- autocompletion server for the D programming language
 .RS
 Choose the port number on which
 .B dcd-server
-listens. This has no effect unless
-.B dcd-server
-is being run on Windows or the \-\-tcp switch is used.
+listens. This switch implies \-\-tcp.
 .RE
 .B \-\-tcp
 .RS
@@ -35,7 +33,7 @@ Windows.
 .I filePath
 .RS
 Set the path to use for the UNIX domain socket. Has no effect if the \-\-tcp
-switch is used.
+or \-\-port switches are used.
 .RE
 .B \-\-logLevel
 .I level