Debug options

[Martin Pool]

On 5 October 2011 00:30, Vincent Ladeuil <vila+bzr at canonical.com> wrote:
>>>>>> Eli Zaretskii <eliz at gnu.org> writes:
>
>    >> From: Martin Pool <mbp at canonical.com>
>    >> Date: Thu, 29 Sep 2011 14:24:04 +1000
>    >> Cc: Bazaar <bazaar at lists.canonical.com>
>    >>
>    >> For "how to diagnose", something like running 'bzr push
>    >> log+sftp://whatever' will write into ~/.bzr.log all the file
>    >> operations, which might give you a clue.
>
>    > Does the "log+" thing work for all the other protocols as well?
>
> It should.
>
>    > I have never before seen anyone here requesting such a log, only
>    > requests for adding the -Dhpss (in this case, -Dsftp) switch.
>
> Right, we don't use it very often.
>
>    > It would be good to know which one does what, and perhaps have
>    > them mentioned in the docs.  How about a "Troubleshooting" section
>    > in the docs?  Or maybe extend the "Debug Flags" section to talk
>    > about more than just options?
>
> `bzr help debug-flags ` is indeed at
> http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/debug-flags-help.html

I think Eli still has a good point that having a user-oriented
'troubleshooting tips' page would be useful.  That can point to the
debug flags.

m