Document all functions, global and static variables, and sysctls.

Includes some minor whitespace changes, and re-ordering to be able to document
properly (e.g, grouping of variables and the SYSCTL macro calls for them, where
the documentation has been added.)

Reviewed by:	phk (but all errors are mine)

1 files changed, 9 insertions, 3 deletions

diff --git a/sys/kern/vfs_vnops.c b/sys/kern/vfs_vnops.c
index 5ea1a61..6300fe2 100644
--- a/sys/kern/vfs_vnops.c
+++ b/sys/kern/vfs_vnops.c
@@ -266,14 +266,14 @@ vn_close(vp, flags, cred, td)
 	return (error);
 }
 
+/*
+ * Sequential heuristic - detect sequential operation
+ */
 static __inline
 int
 sequential_heuristic(struct uio *uio, struct file *fp)
 {
 
-	/*
-	 * Sequential heuristic - detect sequential operation
-	 */
 	if ((uio->uio_offset == 0 && fp->f_seqcount > 0) ||
 	    uio->uio_offset == fp->f_nextoff) {
 		/*
@@ -499,6 +499,9 @@ vn_statfile(fp, sb, td)
 	return (error);
 }
 
+/*
+ * Stat a vnode; implementation for the stat syscall
+ */
 int
 vn_stat(vp, sb, td)
 	struct vnode *vp;
@@ -891,6 +894,9 @@ vfs_write_resume(mp)
 	wakeup(&mp->mnt_flag);
 }
 
+/*
+ * Implement kqueues for files by translating it to vnode operation.
+ */
 static int
 vn_kqfilter(struct file *fp, struct knote *kn)
 {