Summary: | tunefs(8) man page doesn't describe arguments. | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Product: | Documentation | Reporter: | Gary W. Swearingen <swear> | ||||||||
Component: | Manual Pages | Assignee: | freebsd-bugs (Nobody) <bugs> | ||||||||
Status: | Open --- | ||||||||||
Severity: | Affects Only Me | CC: | doc, felix.the.red | ||||||||
Priority: | Normal | Keywords: | patch | ||||||||
Version: | Latest | ||||||||||
Hardware: | Any | ||||||||||
OS: | Any | ||||||||||
Attachments: |
|
Description
Gary W. Swearingen
2002-01-24 22:20:01 UTC
Please slip this into the tunefs(8) man page file too: .Sh FILES .Bl -tag -width /etc/fstab -compact .It Pa /etc/fstab read to determine the device file for a specified mount point .El State Changed From-To: open->patched Slightly modified version of your patch committed to -current, will MFC upon re@ approval. Thanks!! Responsible Changed From-To: freebsd-doc->trhodes Slightly modified version of your patch committed to -current, will MFC upon re@ approval. Thanks!! State Changed From-To: patched->closed Committed to -stable! Thanks! PR 34239 should be re-opened. The PR was closed last May with: Slightly modified version of your patch committed to -current, will MFC upon re@ approval. In fact, the 2 most serious of the 6 identified problems and fixes were ignored, along with 2 other ones. The fact that the manpage doesn't describe it's arguments (as opposed to its options) is a problem which should be fixed. The fact that the synopsis is wrong about the last argument being optional is a problem which should be fixed. The problems of the lousy argument names and the misuse of "flags" are less important and I'll not complain futher about those. Rather than fixing the Synopsis from using "[special | filesystem]" to "special | filesystem" or (better) "{special | filesystem}" and describing both, it would be better to just use "filesystem" and explain that with something like this (ala dump(8)): +.Pp +The file system to be tuned is specified by the argument +.Ar filesystem , +as either its device-special file or its mount point +(if that is in a standard entry in +.Pa /etc/fstab ) . State Changed From-To: closed->open Reopen as a request by submitter. On 09 Feb 2003 16:29:31 -0800 swear@attbi.com (Gary W. Swearingen) wrote: > PR 34239 should be re-opened. > Hi Gary, I've reopened the PR as per your request. Unfortunatly I don't know when I'll have some free time to look over it. My free time has dwindled a tad as I get deeper into the current semester. -- Tom Rhodes For bugs matching the following criteria: Status: In Progress Changed: (is less than) 2014-06-01 Reset to default assignee and clear in-progress tags. Mail being skipped Created attachment 228737 [details]
tunefs(8) patch
Consolidate the file system / device special argument into one argument, filesystem.
Describe how tunefs searches for the filesystem or device to work with.
Note that tunefs can work with file system images.
Created attachment 228738 [details]
tunefs.c patch
Modify usage to match documentation change.
|