This seems to be primarily a documentation bug.
I've found it to be extremely useful to use the source location rather than the checkout location, because it lets me do:
[sftp://host/path/to/base] public_location = http://host/base public_location:policy=appendpath
And then *all* of my branches on that public server can send an email with the correct location. (http://host/base/branchname)
But I can respect that it could be documented more clearly.
Also, I would recommend the other plugins switch to the same model.
This seems to be primarily a documentation bug.
I've found it to be extremely useful to use the source location rather than the checkout location, because it lets me do:
[sftp:// host/path/ to/base] host/base location: policy= appendpath
public_location = http://
public_
And then *all* of my branches on that public server can send an email with the correct location. (http:// host/base/ branchname)
But I can respect that it could be documented more clearly.
Also, I would recommend the other plugins switch to the same model.