On Mon, Mar 24, 2014 at 06:38:30PM +0000, Duncan wrote:
> Marc MERLIN posted on Sun, 23 Mar 2014 09:25:06 -0700 as excerpted:
> 
> > On Sun, Mar 23, 2014 at 04:18:43PM +0000, Hugo Mills wrote:
> >> On Sun, Mar 23, 2014 at 08:25:17AM -0700, Marc MERLIN wrote:
> >>> 
> >>> What's the syntax for removing a drive that isn't there?
> >> 
> >>    btrfs dev del missing /path
> >> 
> >>    Removes all the missing devices.
> > 
> > Aaah, this worked, thank you.
> > This isn't documented in the 3.12 man page, but I'm guessing it'll be in
> > the upcoming 3.14.
> > 
> > I'll document this in the raid5 page I'm currently writing.
> 
> It's on the wiki as I remembered, covered on the multiple devices page.
> https://btrfs.wiki.kernel.org/index.php/Using_Btrfs_with_Multiple_Devices#Removing_devices

So, I did read the entire wiki, but it's been a while, and either some
things got added since then, or some I just didn't remember because I didn't
need them at the time.
The problem, and we've talked about this before (my plea to make btrfsck put
a "--really-I-read-the-wiki-and-want-this" :) option as well as minimal
instructions in its usage that tell the unsuspecting user it's not what
they're looking for, here too, I carefully re-read the man page for btrfs
and this wasn't mentioned in it, or at least in my copy.
Out of sync docs happens, but I'm hopeful that the man page and tools --help
info can be the canonical place for info, even if they can point to a wiki
link since the average admin will always fail back to --help/--usage and the
man page first before looking for a missing option in a wiki somewhere else.
 
Does that sound reasonable?

Marc
-- 
"A mouse is a device used to point at the xterm you want to type in" - A.S.R.
Microsoft is to operating systems ....
                                      .... what McDonalds is to gourmet cooking
Home page: http://marc.merlins.org/  
--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to