misc/60420: file systems should have man pages

["campbell+netbsd%mumble.net@localhost via gnats" <gnats-admin%NetBSD.org@localhost>]

>Number:         60420
>Category:       misc
>Synopsis:       file systems should have man pages
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Jul 06 20:40:00 +0000 2026
>Originator:     Taylor R Campbell
>Release:        
>Organization:
The NetFFS Documentation
>Environment:
>Description:

	What are sysvbfs and v7fs for/from?  What variants of ufs
	(freebsd, apple, ...) are supported?  What are ffsv1 vs ffsv2
	or ffsv2ea?  How are those versions different from UFS1 vs UFS2
	superblock format?  What performance characteristics are the
	different file systems or options expected to exhibit, like
	vanilla vs async vs sync vs wapbl ffs?

	These are all questions I would like to find the answers to in
	a man page about each file system.  Instead, the information is
	scattered throughout several different places:

	mount(8) -- fs-independent but a lot of ffs-specific info
	mount_ffs(8) -- ffs-specific but not much here
	mount_v7fs(8)
	newfs(8) -- ffs-specific and various format information here
	tunefs(8) -- tells how to toggle between logging and no logging

>How-To-Repeat:

	try to answer the above questions

>Fix:

	Yes, please!