Subject: kern/15062: spelling and comments on vfs stuff
To: None <gnats-bugs@gnats.netbsd.org>
From: None <lha@stacken.kth.se>
List: netbsd-bugs
Date: 12/27/2001 12:21:56
>Number:         15062
>Category:       kern
>Synopsis:       spelling and comments on vfs stuff
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Dec 27 03:23:00 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Love
>Release:        NetBSD 1.5ZA
>Organization:
	Stacken Computer Club
>Environment:
System: NetBSD nutcracker.stacken.kth.se 1.5ZA NetBSD 1.5ZA (NUTCRACKER) #45: Mon Dec 24 19:45:09 CET 2001 lha@nutcracker.stacken.kth.se:/usr/src/sys/arch/i386/compile/NUTCRACKER i386
Architecture: i386
Machine: i386
>Description:

	I was reading the manpages for vfs stuff and I have some
	comments on the content.

	In vfsops(0) vfs_export_lookup, there is spelling error:
	verigfy -> verify (see patch).

	And in vnodeops(9) I found the following items that would need
	improvments.

	VOP_READDIR, cookies can be used from emulation layer too
	(linux and sunos).

	VOP_ABORTOP, needs to be implemented, or call genfs_abortop.
	is used to release allocated cnp. So it should probably say
	"abort pending namei operation and free resources".

	VOP_BMAP, what does bnp do ? (return physical block)
	-1 is no mapping (a hole).

	For these, I leave it up to someone native/better english
	speaker/writer. From experience I know someone else should
	write them, otherwise you just need to rewrite the whole text.
	
>How-To-Repeat:

	man vfsops
	man vnodeops

>Fix:

Index: share/man/man9/vfsops.9
===================================================================
RCS file: /cvsroot/sharesrc/share/man/man9/vfsops.9,v
retrieving revision 1.2
diff -w -u -r1.2 vfsops.9
--- vfsops.9    2001/10/22 08:21:33     1.2
+++ vfsops.9    2001/12/27 11:11:27
@@ -192,7 +192,7 @@
 The argument
 .Fa nam
 is the address of the networked client.  This function is used by file
-system type specific functions to verigfy that the clinet can access
+system type specific functions to verify that the clinet can access
 the file system.
 .It Fn vfs_getnewfsid "mp"
 Get a new unique file system id type for the file system specified by
>Release-Note:
>Audit-Trail:
>Unformatted: