File: cDebug.mli

package info (click to toggle)
coq-doc 8.20.0-2
  • links: PTS, VCS
  • area: non-free
  • in suites: forky, sid, trixie
  • size: 46,708 kB
  • sloc: ml: 234,429; sh: 4,686; python: 3,359; ansic: 2,644; makefile: 842; lisp: 172; javascript: 87; xml: 24; sed: 2
file content (52 lines) | stat: -rw-r--r-- 1,955 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
(************************************************************************)
(*         *   The Coq Proof Assistant / The Coq Development Team       *)
(*  v      *         Copyright INRIA, CNRS and contributors             *)
(* <O___,, * (see version control and CREDITS file for authors & dates) *)
(*   \VV/  **************************************************************)
(*    //   *    This file is distributed under the terms of the         *)
(*         *     GNU Lesser General Public License Version 2.1          *)
(*         *     (see LICENSE file for the text of the license)         *)
(************************************************************************)

type flag

type t = (unit -> Pp.t) -> unit

(** Creates a debug component, which may be used to print debug
    messages.

    A debug component is named by the string [name]. It is either
    active or inactive.

    The special component ["all"] may be used to control all components.

    There is also a special component ["backtrace"] to control
    backtrace recording.
*)
val create : name:string -> unit -> t

(** Useful when interacting with a component from code, typically when
    doing something more complicated than printing.

    Note that the printer function prints some metadata compared to
    [ fun pp -> if get_flag flag then Feedback.msg_debug (pp ()) ]
 *)
val create_full : name:string -> unit -> flag * t

val get_flag : flag -> bool

val set_flag : flag -> bool -> unit

(** [get_flags] and [set_flags] use the user syntax: a comma separated
    list of activated "component" and "-component"s. [get_flags] starts
    with "all" or "-all" and lists all components after it (even if redundant). *)
val get_flags : unit -> string

(** Components not mentioned are not affected (use the "all" component
    at the start if you want to reset everything). *)
val set_flags : string -> unit

val set_debug_all : bool -> unit

val misc : flag
val pp_misc : t