[PATCH 1/3] Improve blockpull man entry

[Peter Krempa]

On Fri, Apr 17, 2020 at 14:52:06 +0200, Peter Krempa wrote:
> On Wed, Apr 15, 2020 at 11:34:04 +0000, Sebastian Mitterle wrote:
> > 1. Mention usage of `--base` and `--bandwidth` and fix cmd syntax.
> > 2. Explain valid arguments for `base`.
> > 3. Move explanation for `--keep-relative` to end considering it
> >    less frequent use case because libvirt doesn't create relative
> >    backing chain names.
> > 4. Add reference to documentation for relative paths in backing chains.
> > 
> > Signed-off-by: Sebastian Mitterle <smitterl at redhat.com>
> > ---
> >  docs/manpages/virsh.rst | 19 +++++++++++++------
> >  1 file changed, 13 insertions(+), 6 deletions(-)

[...]

> > +
> > +Using the *--keep-relative* flag will keep the backing chain names
> > +relative (details on `https://www.libvirt.org/kbase/backing_chains.html
> > +<https://www.libvirt.org/kbase/backing_chains.html>`__).
> 
> I don't think this document contains information on relative file paths.

It actually does. Unfortunately it doesn't specify how to take a
snapshot with relative paths thoug. But this is probably okay then.