improve man page

man/fai.conf.5

@@ -1,5 +1,5 @@
 .\"                                      Hey, EMACS: -*- nroff -*-
-.TH fai.conf 5 "23 October 2011" "FAI 4.0"
+.TH fai.conf 5 "18 January 2012" "FAI 4.0"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -48,14 +48,14 @@ below.
 .BR fai.conf
 defines the essential options to successfully start a FAI run.
 
-.SH OPTIONS
+.SH VARIABLES
 .BR fai.conf
 is sourced by
 .BR fai (8)
-and thus must be valid
+and other scripts of fai and thus must be valid
 .BR bash (1)
 code.
-All options described below are variables that must be assigned to using
+All variables described below are variables that must be assigned to use
 .BR bash (1)
 syntax.
 
@@ -84,8 +84,7 @@ HTTP: http://<server>/<filename>
 where <filename> is a (compressed) tar archive. For verification purposes, also
 an
 .BR md5sum (1)
-generated hash must exist at the same location as <filename>, with the suffix
-\.md5 replacing the suffix of <filename>.
+generated hash must exist at the same location as <filename>.md5.
 
 .TP
 \fBLOGUSER\fP Account name on the install server to save log files and call
@@ -116,9 +115,16 @@ If defined, install clients mount the NFS share to $MNTPOINT.
 Syntax: <host>:<exported directory>
 
 .SH SEE ALSO
+
+.BR fai (8),
+.BR fai\-make-nfsroot (8),
+.BR fai\-setup (8),
+.BR fai\-mirror (1),
+.BR fai\-cd (8)
+
 .br
-This file is part of FAI (Fully Automatic Installation).  See the FAI manual
-for more information on how to use ainsl.  The FAI homepage is http://fai-project.org.
+This file is part of FAI (Fully Automatic Installation).  See the FAI
+manual for more information.  The FAI homepage is http://fai-project.org.
 
 .SH AUTHOR
 This man page was written by Michael Tautschnig <mt@debian.org>.