[PATCH] docs/vfs_btrfs: add link to server-side copy wiki page

David Disseldorp ddiss at suse.de
Fri Nov 15 05:33:37 MST 2013


Thanks for the feedback Volker...

On Fri, 15 Nov 2013 12:46:52 +0100
Volker Lendecke <Volker.Lendecke at SerNet.DE> wrote:

> On Fri, Nov 15, 2013 at 12:20:16PM +0100, David Disseldorp wrote:
> > The wiki page at https://wiki.samba.org/index.php/Server-Side_Copy does
> > a better job of describing server-side copy with the aid of diagrams.
> > 
> > Signed-off-by: David Disseldorp <ddiss at samba.org>
> > ---
> >  docs-xml/manpages/vfs_btrfs.8.xml | 6 +++++-
> >  1 file changed, 5 insertions(+), 1 deletion(-)
> > 
> > diff --git a/docs-xml/manpages/vfs_btrfs.8.xml b/docs-xml/manpages/vfs_btrfs.8.xml
> > index 01f788c..669aa35 100644
> > --- a/docs-xml/manpages/vfs_btrfs.8.xml
> > +++ b/docs-xml/manpages/vfs_btrfs.8.xml
> > @@ -43,6 +43,9 @@
> >  		module maps the request to a Btrfs clone range IOCTL, instead
> >  		of performing reads and writes required by a traditional copy.
> >  		Doing so saves storage capacity and greatly reduces disk IO.
> > +
> > +		See https://wiki.samba.org/index.php/Server-Side_Copy for
> > +		further details.
> 
> Hmm. Not sure about putting wiki links into manpages. For me
> manpages are the definitive source, but I may just be old.

The link is provided as a supplement for the existing "definitive" man
page documentation.
I had similar concerns, but noticed that mkfsbtrfs(8) does the same.
I'll wait to see whether there are other objections :-).

Cheers, David


More information about the samba-technical mailing list