[PATCH] hgrc.5: document ui.traceback

[Brodie Rao]

On Oct 27, 2009, at 4:04 PM, Brodie Rao wrote:

> # HG changeset patch
> # User Brodie Rao <me+hg at dackz.net>
> # Date 1256582485 14400
> # Node ID 027ee8ed914c4f1de0a7cd88dc1373f7fb53d346
> # Parent  20b91f91f9cadfc2de79e7a2ecc07302b05ebca1
> hgrc.5: document ui.traceback
>
> diff --git a/doc/hgrc.5.txt b/doc/hgrc.5.txt
> --- a/doc/hgrc.5.txt
> +++ b/doc/hgrc.5.txt
> @@ -805,6 +805,10 @@ merge-tools section.
> ``timeout``
>     The timeout used when a lock is held (in seconds), a negative  
> value
>     means no timeout. Default is 600.
> +``traceback``
> +    Include tracebacks in error messages. NOTE: Not all error  
> messages will
> +    have tracebacks; unhandled errors will print tracebacks  
> regardless.
> +    True or False. Default is False.
> ``username``
>     The committer of a changeset created when running "commit".
>     Typically a person's name and email address, e.g. "Fred Widget

Actually, I'm not sure if this description is ideal, but I think it's  
an improvement.

Maybe it should include examples of when ui.traceback would have an  
effect on an error message? It looks like it's only used when loading  
extensions/hooks, when there's an httplib error, and in dispatch for  
various show-stopping exceptions.

Should the hg -v help description for --traceback be clarified as  
well? Currently it's "print traceback on exception".