docs/103956: [ patch ] [ handbook ] add a section about NFS locking to Handbook

[Simon L. Nielsen]

The following reply was made to PR docs/103956; it has been noted by GNATS.

From: "Simon L. Nielsen" <simon at FreeBSD.org>
To: Roman Bogorodskiy <novel at FreeBSD.org>
Cc: bug-followup at FreeBSD.org, Remko Lodder <remko at elvandar.org>
Subject: Re: docs/103956: [ patch ] [ handbook ] add a section about NFS locking to Handbook
Date: Sun, 8 Oct 2006 19:30:23 +0200

 On 2006.10.05 15:05:59 +0400, Roman Bogorodskiy wrote:
 > Update - fixed problems reported by remko.
 
 >      <sect2>
 > +      <title>Locking</title>
 > +      
 > +      <para>Some applications (e.g. <application>mutt</application>)
 > +        require file locking to operate correctly.  In the case of
 > +        <acronym>NFS</acronym>, <application>rpc.lockd</application>
 > +        can be used for file locking.  To enable it, add the following
 > +        to the <filename>/etc/rc.conf</filename> file on both client
 > +        and server (it is assumed that <acronym>NFS</acronym>
 > +        client and server are configured already):</para>
 > +	
 > +      <programlisting>rpc_lockd_enable="YES"
 > +rpc_statd_enable="YES"</programlisting>
 > +	
 > +      <para>Start the application by using:</para>
 
 Here should be an extra newline.
 
 > +      <screen>&prompt.root; <userinput>/etc/rc.d/nfslocking start</userinput></screen>
 > +
 > +      <para>However, there is one more way of doing locking in
 > +        <acronym>NFS</acronym> available.  It is possible to pass 
 > +        <option>-L</option> to &man.mount.nfs.8;, but it is suitable
 > +        for local locking only.  Refer to &man.mount.nfs.8; for
 > +        details.</para>
 
 How about instead, something like:
 
 	If real locking between the NFS clients and NFS server is not
 	required, it is possible to let the NFS client do locking
 	locally by passing -L to &man.mount.nfs.8;.  Refer to the
 	&man.mount.nfs.8; manual page for further details.
 
 ?
 
 You also have a bit of end-of-line whitespace which should be removed.
 
 > +    </sect2>
 > +
 > +    <sect2>
 >        <title>Practical Uses</title>
 >  
 >        <para><acronym>NFS</acronym> has many practical uses.  Some of
 
 
 -- 
 Simon L. Nielsen