Update README.md

Author: pebond

README.md

@@ -4,26 +4,26 @@
 ALF(Alice Low-level Frontend) spawns DIM services as an interface with detector FEEs(Front-End Electronics). The DIM services can be accessed through DCS's [FRED](https://gitlab.cern.ch/alialfred/FREDServer).
 
 ## Requirements
-In order to run ALF a DIM Nameserver has to be up and running.
+In order to run ALF a DIM Nameserver has to be up and running. For performance reasons, it is recommended to run the DIM Nameserver on the host running the FRED server.
 
 ## Usage
 
 ### o2-alf
 o2-alf is the binary of the ALF server. The only option it expects is the address of the DIM Nameserver. It can be passed either as a command-line argument or as an environmental variable.
 
 `
-o2-alf --dim-dns-node thedimdns
+o2-alf --dim-dns-node thedimdns.cern.ch
 `
 
 `
-DIM_DNS_NODE=thedimdns o2-alf
+DIM_DNS_NODE=thedimdns.cern.ch o2-alf
 `
 
 ### o2-alf-client
 o2-alf-client is the binary of an ALF client used solely for testing purposes. On top of the DIM Nameserver it expects the hostname of the node hosting the ALF server, the card's serial and the link number as command-line arguments.
 
 `
-o2-alf-client --dim-dns-node thedimdns --alf-id thealfserver --serial 0 --link 4
+o2-alf-client --dim-dns-node thedimdns.cern.ch --alf-id thealfserver --serial 0 --link 4
 `
 
 ## Services
@@ -80,13 +80,13 @@ The services are DIM RPC services. Every RPC is called with a string and expects
 * Parameters:
   * Sequence of SWT word and operation pairs as follows:
     * Operations may be:
-    * SWT word with `write`
-    * `reset` (no SWT word)
-    * `read` (no SWT word)
+    * SWT word with suffix `,write`
+    * `reset` (without SWT word)
+    * `read` (without SWT word)
 * Returns:
   * Sequence of SWT output as follows:
     * `write` always retuns `0`
-    * `read` returns an SWT word
+    * `read` returns the SWT words present in the CRU SWT FIFO
     * `reset` returns nothing
 
 * Example:
@@ -120,7 +120,3 @@ The services are DIM RPC services. Every RPC is called with a string and expects
 * Example:
   * DIM input `0x3\n`
   * DIM output ` `
-
-#### Examples
-
-Examples on making the RPC calls can be seen under [ProgramAlfClient.cxx](apps/ProgramAlfClient.cxx) and [AlfClient.h](src/AlfClient.h).