Re: documentation/3338

On 2003-07-02 at 01:33 -0600, Jason McIntyre wrote:
> Synopsis: finding docs on partition names

The new paragraph in disklabel(5) is an excellent explanation, thanks.

I'm happy with that and the extra cross-reference in umass(4), so my issues are addressed, but I suspect that you'll have fewer mails to misc/tech if mount_msdos(8) contains some kind of reference -- simply because the sort of person trying to mount msdos areas is more likely to have a background using fdisk partitioning and not disklabel; my patch's mention of "i" was too specific, yes. But some kind of explicit note like:

.Pp
Note that
.Xr disklabel 8
should always be used to determine the device-name to be used, even for .Xr fdisk 8
partitions.

should reduce further the number of false bug-reports filed and mailing-list complaints about device-not-configured errors.

It provides more justification for "RTFM -- how much clearer can we get?" responses. ;^)

Thanks for the continuing improvements, even to oft-overlooked areas like documentation,

-- 
2001: Blogging invented. Promises to change the way people bore strangers with
banal anecdotes about their pets. <
http://www.thelemon.net/issues/timeline.php>

Do you need help?

In addition to our free technical library, Pantek provides professional IT services to companies who utilize Open Source software: Learn more about Pantek's Technical Support offerings Place an order for 24/7/365 Technical Support here Learn more about Pantek, who we are, and what we do Chat with a Live Operator Related openbsd.org Links advocacy announce bugs ipv6 misc ports ports-changes security-announce smp source-changes tech Request more information about Pantek