1 files changed, 78 insertions, 39 deletions
diff --git a/usr.sbin/cached/cached.conf.5 b/usr.sbin/cached/cached.conf.5
index 46c3c84..6e5bec1 100644
--- a/usr.sbin/cached/cached.conf.5
+++ b/usr.sbin/cached/cached.conf.5
@@ -29,81 +29,120 @@
 .Os
 .Sh NAME
 .Nm cached.conf
-.Nd "caching daemon configuration file manual page"
-.Sh "DESCRIPTION"
+.Nd "caching daemon configuration file"
+.Sh DESCRIPTION
+The
 .Nm
+file
 is used by the
 .Xr cached 8
 daemon and is read on its startup.
-Its syntax is mostly similar to the nscd.conf syntax in Linux and Solaris.
-It has some differences, though - see them below.
+Its syntax is mostly similar to the
+.Pa nscd.conf
+syntax in
+.Tn Linux
+and
+.Tn Solaris .
+It has some differences, though \[em] see them below.
 .Pp
-Each line specifies either an attribute and a value, or an attribute,
-a cachename and a value.
-Usual cachenames are passwd, groups, hosts, services, protocols and rpc.
-You can also use any other cachename (for example, if some third-party
+Each line specifies either an attribute and a
+.Ar value ,
+or an attribute, a
+.Ar cachename
+and a
+.Ar value .
+Usual cachenames are
+.Dq Li passwd ,
+.Dq Li groups ,
+.Dq Li hosts ,
+.Dq Li services ,
+.Dq Li protocols
+and
+.Dq Li rpc .
+You can also use any other
+.Ar cachename
+(for example, if some third-party
 application uses nsswitch).
-.Pp
-.Bl -tag -width Pair
-.It Sy threads [value]
+.Bl -tag -width indent
+.It Va threads Op Ar value
 Number of threads, which would listen for connections and process requests.
 The minimum is 1.
 The default value is 8.
-.It Sy enable-cache [cachename] [yes|no]
-Enables or disables the cache for specified cachename.
-.It Sy positive-time-to-live [cachename] [value]
+.It Va enable-cache Oo Ar cachename Oc Op Cm yes | no
+Enables or disables the cache for specified
+.Ar cachename .
+.It Va positive-time-to-live Oo Ar cachename Oc Op Ar value
 Sets the TTL (time-to-live) for the specified cache in seconds.
 Larger values can increase system's performance, but they also can affect
 the cache coherence.
 The default value is 3600.
-.It Sy positive-policy [cachename] [fifo|lru|lfu]
+.It Va positive-policy Oo Ar cachename Oc Op Cm fifo | lru | lfu
 The policy that is applied to erase some of the cache elements, when the
-size limit of the given cachename is exceeded.
-Possible policies are: fifo (first-in-first-out), lru (least-recently-used),
-lfu (least-frequently-used).
-The default policy is lru.
-.It Sy negative-time-to-live [cachename] [value]
+size limit of the given
+.Ar cachename
+is exceeded.
+Possible policies are:
+.Cm fifo
+(first-in-first-out),
+.Cm lru
+(least-recently-used), and
+.Cm lfu
+(least-frequently-used).
+The default policy is
+.Cm lru .
+.It Va negative-time-to-live Oo Ar cachename Oc Op Ar value
 The TTL of the negative cached elements in seconds.
 The larger values can significantly increase system performance in some
 environments (when dealing with files with UIDs, which are not in system
 databases, for example).
 This number should be kept low to avoid the cache coherence problems.
 The default value is 60.
-.It Sy negative-policy [cachename] [fifo|lru|lfu]
+.It Va negative-policy Oo Ar cachename Oc Op Cm fifo | lru | lfu
 The same as the positive-policy, but this one is applied to the negative
-elements of the given cachename.
+elements of the given
+.Ar cachename .
 The default policy is fifo.
-.It Sy suggested-size [cachename] [value]
+.It Va suggested-size Oo Ar cachename Oc Op Ar value
 This is the internal hash table size.
 The value should be a prime number for optimum performance.
 You should only change this value when the number of cached elements is
 significantly (in 5-10 times) greater then the default hash table size (255).
-.It Sy keep-hot-count [cachename] [value]
-The size limit of the cache with the given cachename.
+.It Va keep-hot-count Oo Ar cachename Oc Op Ar value
+The size limit of the cache with the given
+.Ar cachename .
 When it is exceeded, the policy will be applied.
 The default value is 2048.
-.It Sy perform-actual-lookups [cachename] [yes|no]
+.It Va perform-actual-lookups Oo Ar cachename Oc Op Cm yes | no
 If enabled, the
 .Xr cached 8
 does not simply receive and cache the NSS-requests results, but performs
 all the lookups by itself and only returns the responses.
-If this feature is enabled, then for the given cachename
+If this feature is enabled, then for the given
+.Ar cachename
 .Xr cached 8
 will act similarly to the NSCD.
 .Pp
-.Pa NOTE:
-this feature is currently experimental - it supports only passwd, groups and
-services cachenames.
+.Sy NOTE :
+this feature is currently experimental \[em] it supports only
+.Dq Li passwd ,
+.Dq Li groups
+and
+.Dq Li services
+cachenames.
 .El
-.Sh "NOTES"
-You can use
-.Sq #
+.Sh NOTES
+You can use the
+.Ql #
 symbol at the beginning of the line for comments.
-.Sh "SEE ALSO"
+.Sh FILES
+.Bl -tag -width ".Pa /etc/cached.conf" -compact
+.It Pa /etc/cached.conf
+.El
+.Sh SEE ALSO
 .Xr cached 8
-.Sh "AUTHORS"
-Michael Bushkov
-.Aq bushman@rsu.ru
-.Sh "BUGS"
-To report bugs or suggestions please mail me
+.Sh AUTHORS
+.An Michael Bushkov
 .Aq bushman@rsu.ru
+.Sh BUGS
+Please send bug reports and suggestions to
+.Aq bushman@rsu.ru .