Re: [Docutils-users] Re: halt_level and exit_level

[David G. <go...@py...>]

Felix Wiemann wrote:
 > Docutils should raise an exception at Warning, Error or Severe, but
 > not exit, at least when called from within a Python script.

All you have to do is enable the "traceback" setting then, with
"halt_level" set to 2.  That allows an exception to go uncaught,
usually causing a traceback.

 > IIRC we had that behaviour in 0.3 or so, and it was pretty
 > convenient:

The current catch-exceptions-by-default behavior was added because
tracebacks from front-end tools are not end-user-friendly.  I've
updated the docs & help text to clarify the situation.

Perhaps "traceback" ought to be enabled by default in general, but
disabled by default in docutils.core.publish_cmdline.  Config files &
command-line options would still be able to override.

-- 
David Goodger <http://python.net/~goodger>