[texdoc] diagnostics

Manuel Pégourié-Gonnard mpg at elzevir.fr
Mon Feb 22 13:38:56 CET 2010

Manuel Pégourié-Gonnard a écrit :
> Too bad. Maybe I should check if DISPLAY is set before trying to display
> anything on Unix? Then I could issue a warning message before trying to lauch
> the viewer. (And/or default to list mode.)

texdoc issues a warning now.

mpg at roth:~% texdoc -w live
texdoc warning: DISPLAY is not set. Things may go wrong with you viewer.
texdoc warning: Try --list if you want results to be listed, not displayed.
mpg at roth:~% Error: Can't open display:

Hope it's ok. The point is, viewer are usually launched asynchronously ('xpdf
foobar.pdf &') so I can't really check the exit status.

> I guess I should rework this whole verbosity stuff. How about the following:
> -v, --verbose	Be more verbose.
> -q, --quiet	Be less verbose.
> -v could not be repeated, and would display the viewer command before launching
> it, and maybe a few other informations.
> -q would suppress warnings, -q -q would suppress even errors (except internal
> errors, since I'm not sure how to suppress them). (And of course one would like
> to be able to say -qq rather than -q -q but that's another problem.)
Finally, making -q -q work was a bit hard and didn't seem so useful, so here is
what I did:

  -q, --quiet           Suppress warnings and most error messages.
  -v, --verbose         Print additional information (eg, viewer command).
  -d, --debug[=list]    Print debug info for selected items (default: all).

Also, I suppressed the uselessly verbose parts of --debug output so that it's
only about 200 lines long now. (And now any debug option implies --verbose.)

-v=N and --verbosity-level=N are still accepted for compatibility, but they are
not advertised any more, and a warning message is issued.

I'll review a few other things, update the manual, and push the result to TL.


More information about the texdoc mailing list