man page for grub-probe

[ael]

As a new potential user of grub2, even after scanning the grub2 wiki, I 
find the man page for grub-probe incomprehensible.

1) -d, --device
              given argument is a system device, not a path

Ok, so what does "system device" mean in this context? Maybe something 
like (hdn,m) ? I can only guess from knowledge of legacy grub. What 
about a new user who has never user any sort of grub? If there was a 
reference at the end of the man page to other man pages or other places 
where this is defined, it might be acceptable. Or maybe just a tiny 
example such as

     given argument is a system device, not a path, eg -d (hd1,2)

{I have no idea if the above is actually right which just emphasizes the 
problem with the man page.}

2)
# grub-probe  /dev/fd0
grub-probe: error: Cannot open `/boot/grub/device.map'

So how is the device map created? And is  /boot/grub/device.map being 
sought on the /dev/fd0 file system? Presumably not.
Again the man page gives no clue about where to look or what to do.

-m, --device-map=FILE
              use FILE as the device map [default=/boot/grub/device.map]

needs to give a pointer for info.

3) -t, --target=(fs|fs_uuid|drive|device|partmap|abstraction)
              print filesystem module, GRUB drive,  system  device, 
partition
              map module or abstraction module [default=fs]

So I tried
  # grub-probe -v -t /dev/fd0 /dev/fd0
and just got:

Try ``grub-probe --help'' for more information

Of course, --help gave no help :-)


I could go on, but I hope that the point is clear. As a new user, who 
even has a small amount of experience with several boot loaders, but who 
only needs to look at them rather infrequently, I am lost here.

OK with lots of time and searching and probably needing to install and 
read source, I will probably eventually fathom what is needed, but just 
a few extra lines in the man page might make all of that unnecessary.
I would offer to a patch, if only I knew what those extra lines should 
be :-)

ael