document about stacked branch

[INADA Naoki]

>> Additionaly, I feel an example in the document doesn't describes when
>> --stacked option is useful.
>>
>>    bzr push --stacked-on sftp://host/project --stacked
>> sftp://host/user/stacked-branch
>>
>> This should be
>>
>>   bzr branch bzr+ssh://example.com/project/trunk my-branch
>>   cd my-branch
>>   (working on my-branch)
>>   bzr push --stacked bzr+ssh://example.com/~/stacked-branch
>>
>> Any thoughts?
>
> The existing example is definitely useful.  Is your concern that
> --stacked is redundant there because it also uses --stacked-on?

Yes. In this example, --stacked doesn't have any effects.


> Your suggested example is ok, but depends on your local my-branch
> having a usable public_location defined (otherwise the pushed branch
> will be stacked on a URL unreachable by most people,
> file:///.../my-branch).  So to be a workable example people can follow
> we need to make sure they also do the necessary configuration.  I'll
> have a stab at it, but I'm not sure I can explain it concisely enough to
> be good documentation.
>
> -Andrew.
>
>

OK, please.


-- 
INADA Naoki  <songofacandy at gmail.com>