Bug 29143

Summary: List of man pages that need to be written
Product: Documentation Reporter: Mike Pritchard <mpp>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Mike Pritchard 2001-07-22 13:10:00 UTC 
Here is a list of man pages that need to be written.  They are all
currently referenced by existing man pages.  These would make good tasks
for someone looking to get into documentation, or learn more about
kernel internals by writing the man pages.

Here is the list (culled from PR# 26065):

Current man page xref      Missing man page
----------------------------------------------
 kvm_nlist(3)              kldsym(2)
 BUS_SETUP_INTR(9)         BUS_TEARDOWN_INTR(9)
 VFS_UNMOUNT(9)            vflush(9)
 VOP_LOOKUP(9)             VOP_ABORTOP(9)
 boot(9)                   at_shutdown(9)
 boot(9)                   vfs_unmountall(9)
 cpu_switch(9)             issignal(9)
 mi_switch(9)              issignal(9)

Fix: 

Write the missing man pages.
How-To-Repeat: 	
	read one of the above man pages and try to locate the non-existing
	man page it references :-)
Comment 1 Ceri Davies freebsd_committer freebsd_triage 2002-04-02 20:28:10 UTC 
On Sun, Jul 22, 2001 at 07:01:10AM -0500, Mike Pritchard wrote:
> Here is the list (culled from PR# 26065):
> 
> Current man page xref      Missing man page
> ----------------------------------------------
>  kvm_nlist(3)              kldsym(2)

kldsym(2) now exists.

>  BUS_SETUP_INTR(9)         BUS_TEARDOWN_INTR(9)

BUS_TEARDOWN_INTR(9) now exists.

>  VFS_UNMOUNT(9)            vflush(9)

vflush(9) now exists.

>  VOP_LOOKUP(9)             VOP_ABORTOP(9)

VOP_LOOKUP(9) no longer references this.

>  boot(9)                   at_shutdown(9)

boot(9) no longer references at_shutdown(9).

>  boot(9)                   vfs_unmountall(9)

vfs_unmountall(9) now exists.

>  cpu_switch(9)             issignal(9)
>  mi_switch(9)              issignal(9)

These two are actually the same manpage, mi_switch(9).
issignal(9) is still referenced from it, is declared in
src/sys/signalvar.h, and seems to have been in the very first
import of the code. I have no idea where we can get this manpage
or who to ask to get one written.

davidc seems to have helped get the vflush(9) manpage committed
though - any ideas here, Chad ?

Ceri

-- 
keep a mild groove on
Comment 2 Chad David freebsd_committer freebsd_triage 2002-06-10 04:04:20 UTC 
State Changed
From-To: open->closed

issignal(9) is included in the new signal.9 man page.