#316 <pkg>_OVERRIDE_RSYNC undocumented

[hmijail]

I am in the process of developing a package that gets integrated into an ADI BuildRoot build. As such, I have seen that the officially recommended BuildRoot configuration is to use <pkg>_OVERRIDE_SRCDIR or <pkg>_SITE_METHOD = local.

But I have just spent a full evening trying to make those configurations work, and I didn't manage to make rsync be used as expected according to the docs. Until I went into the BuildRoot makefiles and saw that there is a need to define <pkg>_OVERRIDE_RSYNC for it to work.

This flag <pkg>_OVERRIDE_RSYNC seems to be specific to ADI BuildRoot, and looks like it is only mentioned in a blackfin-specific page, in http://blackfin.uclinux.org/doku.php?id=buildroot:build-system:build_a_target . So it is VERY poorly documented.

Even worse, it is mentioned as connected to <pkg>_OVERRIDE_SRCDIR, NOT as connected to <pkg>_SITE_METHOD = local, which is broken without the _OVERRIDE_RSYNC. This seems like a bug to me.

So I would strongly suggest that this _OVERRIDE_RSYNC flag be either fully, prominently documented (Why is it needed? What use cases does it help?) - or removed.