- made fixes to hkl

- Introduced a help system
- introduced a module for handling automatic updates of files during
  long measurements
- Added a circular buffer and handling facilities to varlog
- Upgraded documentation


SKIPPED:
	psi/faverage.h
	psi/nxamor.tex
	psi/pimotor.h
	psi/pimotor.tex

doc/user/samenv.htm

@@ -225,15 +225,17 @@ can be achieved by using the drive command.
 and <b>log frequency</b> (both below) 
 </DL>
 <h3>Logging </h3>
-The values of any sample environement device can be logged. There are two 
+The values of any sample environement device can be logged. There are three 
 features:
 <ul>
 <li>Logging to a file wih a configurable time intervall between log
 file entries.
 <li>Sums are kept internally which allow the calculation of the mean
 value and the standard deviation at all times.
+<li>A circular buffer holding 1000 timestamps plus values is
+automatically updated.  
 </ul>
-The last system is automatically switched on after the first drive or
+The last two systems are automatically switched on after the first drive or
 run command on the environment device completed.
 This system is run through the following commands.
 <DL>
@@ -245,7 +247,7 @@ standard deviation.
 values and prints them. 
 <DT>name log frequency val
 <DD> With a parameter sets, without a parameter requests the logging intervall 
-for the log file. 
+for the log file and the circular buffer. 
 This parameter specifies the time intervall in seconds
  between log records. The default is 300 seconds. 
 <DT>name log file filename
@@ -255,12 +257,22 @@ Logging will happen any 5 minutes initially. The logging frequency
  of the form date time value. The name of the file must be specified relative
  to the SICS server.
 <DT>name log flush
-<DD>DigitalUnix buffers output heavily. With this command an update of
+<DD>Unix buffers output heavily. With this command an update of
 the file can be enforced.
 <DT>name log status
 <DD>Queries if logging to file is currently happening or not.
 <DT>name log close  
 <DD> Stops logging data to the file.
+<dt>name log tosicsdata dataname
+<dd>copies the content of the circular buffer to a sicsdata
+buffer. This is used by graphical clients to display the content of
+the circular buffer.
+<dt>name log dump
+<dd>Prints the content of the circular log buffer to screen. 
+<dt>name log dumptofile filename
+<dd>Prints the content of the circular log buffer into the file
+specified as filename. Note, this file is on the computer where the
+SICS server resides.  
 </DL>
 </P>
 
@@ -509,7 +521,7 @@ At SANS there is a Eurotherm temperature controller for the sample heater.
 with the following command. The eurotherm needs to be connected with a 
  nullmodem adapter.
 <BLOCKQUOTE>
-evfactory new name euro Mac-PC Mac-port Mac-channel
+evfactory new name euro computer port channel
 </BLOCKQUOTE>
 </p>
 <p>
@@ -663,19 +675,19 @@ device. The LTC-11 behaves like a normal SICS environment control device
 plus a few additional commands. An LTC-11 can be configured into SICS with
 the following command:
 <BLOCKQUOTE>
-evfactory new name ltc11 Mac-PC Mac-port Mac-channel
+evfactory new name ltc11 computer port  channel
 </BLOCKQUOTE>
 </p>
 <p>
 name is a placeholder for the name of the device within SICS. A good
 suggestion is temperature.
-ltc11 is the keyword for selecting the LTC-11 driver. Mac-PC is the name of
-the Macintosh PC to which the controller has been connected, Mac-Port is the
-port number at which the Macintosh-PC's serial port server listens.
-Mac-channel is the RS-232 channel to which the controller has been
+ltc11 is the keyword for selecting the LTC-11 driver. Computer is the name of
+the computer running David Maden's SerPortServer program, port is the
+port number at which the SerPortServer program listens.
+Channel is the RS-232 channel to which the controller has been
 connected. For example (at DMC):
 <pre>
-evfactory new temperature ltc11 lnsp18.psi.ch 4000 6
+evfactory new temperature ltc11 localhost 4000 6
 </pre>
 </p>
 <p>