Minor cleanups

2 files changed, 21 insertions, 10 deletions

diff --git a/usr.sbin/afs/src/arlad/AliasDB.5 b/usr.sbin/afs/src/arlad/AliasDB.5
index bf08361533b..19506755397 100644
--- a/usr.sbin/afs/src/arlad/AliasDB.5
+++ b/usr.sbin/afs/src/arlad/AliasDB.5
@@ -36,21 +36,28 @@
 .Os "The Arla Project"
 .Sh NAME
 .Nm AliasDB
-.Nd add alias for cell in DynRoot
+.Nd add alias for an afs cell in dynroot
 .Sh DESCRIPTION
 The file
 .Nm
-add alias for cellname in dynroot, useful to add readwrite mountpoint
+add aliases for afs cellnames in dynroot, useful to add readwrite mountpoints
 in dynroot.
 .Pp
-Each line in the file contain at least two elements with an optional
-third.
+Each line in the file contains at least two elements with an optional
+third element.
 The first element is the cell name to make the alias for. The second
 element is the alias.
-The optional third element is describing the property of the
+The optional third element is describing properties of the
 mountpoint.
 .Pp
-The default property of a mountpoint is that is a readonly mountpoint.
+By default, an alias is a readonly mountpoint, which means that
+.Nm afsd
+will use readonly replicas of volumes, if they exist.
+If an alias set to readwrite,
+.Nm afsd
+will disregard the readonly replicas and use the readwrite volumes only.
+This will seriously limit performance, but maybe necessary to install
+software packages etc.
 .Pp
 Each line that starts with a
 .Sq #
@@ -71,5 +78,5 @@ andrew.cmu.edu	andrew  #andrew is a readonly alias
 .Sh SEE ALSO
 .Xr CellServDB 5 ,
 .Xr DynRootDB 5 ,
-.Xr arlad 8
+.Xr afsd 8
 
diff --git a/usr.sbin/afs/src/arlad/ThisCell.5 b/usr.sbin/afs/src/arlad/ThisCell.5
index 59e4cdd6746..8e7c7dc7b55 100644
--- a/usr.sbin/afs/src/arlad/ThisCell.5
+++ b/usr.sbin/afs/src/arlad/ThisCell.5
@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: ThisCell.5,v 1.4 2003/08/05 08:42:41 hin Exp $
+.\"     $OpenBSD: ThisCell.5,v 1.5 2003/08/05 14:46:01 hin Exp $
 .\"     $arla: ThisCell.5,v 1.10 2003/06/06 12:53:54 hin Exp $
 .\"
 .Dd March 31, 2003
@@ -41,7 +41,7 @@
 .Sh DESCRIPTION
 The file
 .Nm
-specifies which cell the AFS cache manager belongs to. This affects the
+specifies which cell the AFS client belongs to. This affects the
 default cell to use for commands such as
 .Xr pts 1 ,
 .Xr fs 1 ,
@@ -52,9 +52,13 @@ default cell to use for commands such as
 but other cells can still be used (mostly by giving a -cell argument).
 .Pp
 Unless dynroot is used, it also affects where
-the cache manager reads the root of afs, so
+.Nm afsd
+reads the root of afs, so 
 having good connectivity to the default cell is very important.
 .Pp
+The cell specified must be listed in
+.Pa CellServDB Ns .
+.Pp
 .Sh SEE ALSO
 .Xr CellServDB 5 ,
 .Xr DynRootDB 5 ,