···5566(* Commands *)
7788-type info = Cmdliner_info.Cmd.t
99-let info = Cmdliner_info.Cmd.make
88+type info = Cmdliner_info.Cmd_info.t
99+let info = Cmdliner_info.Cmd_info.make
10101111type 'a t =
1212| Cmd of info * 'a Cmdliner_term.parser
1313| Group of info * ('a Cmdliner_term.parser option * 'a t list)
14141515-let make i t =
1616- let info = Cmdliner_info.Cmd.add_args i (Cmdliner_term.argset t) in
1515+let make info t =
1616+ let info = Cmdliner_info.Cmd_info.add_args info (Cmdliner_term.argset t) in
1717 Cmd (info, Cmdliner_term.parser t)
18181919let v = make
20202121-let get_info = function Cmd (i, _) | Group (i, _) -> i
2121+let get_info = function Cmd (info, _) | Group (info, _) -> info
2222let get_children_infos = function
2323| Cmd _ -> assert false | Group (_, (_, cs)) -> List.map get_info cs
24242525-let group ?default i cmds =
2525+let group ?default info cmds =
2626 let args, parser = match default with
2727 | None -> None, None
2828 | Some t -> Some (Cmdliner_term.argset t), Some (Cmdliner_term.parser t)
2929 in
3030 let children = List.map get_info cmds in
3131- let i = Cmdliner_info.Cmd.with_children i ~args ~children in
3232- Group (i, (parser, cmds))
3131+ let info = Cmdliner_info.Cmd_info.with_children info ~args ~children in
3232+ Group (info, (parser, cmds))
33333434-let name c = Cmdliner_info.Cmd.name (get_info c)
3434+let name c = Cmdliner_info.Cmd_info.name (get_info c)
35353636let name_trie cmds =
3737 let add acc cmd =
3838- let i = get_info cmd in
3939- let name = Cmdliner_info.Cmd.name i in
3838+ let info = get_info cmd in
3939+ let name = Cmdliner_info.Cmd_info.name info in
4040 match Cmdliner_trie.add acc name cmd with
4141 | `New t -> t
4242 | `Replaced (cmd', _) ->
4343- let i' = get_info cmd' and kind = "command" in
4343+ let info' = get_info cmd' and kind = "command" in
4444 invalid_arg @@
4545- Cmdliner_base.err_multi_def ~kind name Cmdliner_info.Cmd.doc i i'
4545+ Cmdliner_base.err_multi_def ~kind name
4646+ Cmdliner_info.Cmd_info.doc info info'
4647 in
4748 List.fold_left add Cmdliner_trie.empty cmds
48494950let list_names cmds =
5050- let cmd_name c = Cmdliner_info.Cmd.name (get_info c) in
5151+ let cmd_name c = Cmdliner_info.Cmd_info.name (get_info c) in
5152 List.sort String.compare (List.rev_map cmd_name cmds)
+1-1
vendor/opam/cmdliner/src/cmdliner_cmd.mli
···5566(** Commands and their information. *)
7788-type info = Cmdliner_info.Cmd.t
88+type info = Cmdliner_info.Cmd_info.t
991010val info :
1111 ?deprecated:string -> ?man_xrefs:Cmdliner_manpage.xref list ->
+4-4
vendor/opam/cmdliner/src/cmdliner_completion.ml
···26262727let pp_opt_names ~err_ppf ~subst ~prefix ppf cmd =
2828 let info = Cmdliner_cmd.get_info cmd in
2929- let set = Cmdliner_info.Cmd.args info in
2929+ let set = Cmdliner_info.Cmd_info.args info in
3030 if not (Cmdliner_info.Arg.Set.is_empty set) then begin
3131- let arg_infos = Cmdliner_info.Cmd.args info in
3131+ let arg_infos = Cmdliner_info.Cmd_info.args info in
3232 pp_group ppf "Options";
3333 Cmdliner_info.Arg.Set.iter (pp_opt ~err_ppf ~subst ~prefix ppf) arg_infos
3434 end
···4949let pp_subcmds ~err_ppf ~subst ~prefix ppf cmd =
5050 pp_group ppf "Subcommands";
5151 let complete_cmd cmd =
5252- let name = Cmdliner_info.Cmd.name cmd in
5252+ let name = Cmdliner_info.Cmd_info.name cmd in
5353 (* FIXME subst is wrong here. *)
5454- let doc = Cmdliner_info.Cmd.styled_doc ~errs:err_ppf ~subst cmd in
5454+ let doc = Cmdliner_info.Cmd_info.styled_doc ~errs:err_ppf ~subst cmd in
5555 pp_item ppf ~prefix (name, doc)
5656 in
5757 List.iter complete_cmd (Cmdliner_cmd.get_children_infos cmd)
+21-21
vendor/opam/cmdliner/src/cmdliner_docgen.ml
···4747(* Command docs *)
48484949let invocation ?(sep = " ") ?(ancestors = []) cmd =
5050- let names = List.rev_map Cmdliner_info.Cmd.name (cmd :: ancestors) in
5050+ let names = List.rev_map Cmdliner_info.Cmd_info.name (cmd :: ancestors) in
5151 esc @@ String.concat sep names
52525353let synopsis_pos_arg a =
···7474 then strf "$(b,%s)[=$(i,%s)]" (esc n) (esc var)
7575 else strf "$(b,%s) [$(i,%s)]" (esc n) (esc var)
76767777-let deprecated cmd = match Cmdliner_info.Cmd.deprecated cmd with
7777+let deprecated cmd = match Cmdliner_info.Cmd_info.deprecated cmd with
7878| None -> "" | Some _ -> "(Deprecated) "
79798080let synopsis ?(show_help = false) ?ancestors cmd =
8181 let show_help = if show_help then " [$(b,--help)]" else "" in
8282- match Cmdliner_info.Cmd.children cmd with
8282+ match Cmdliner_info.Cmd_info.children cmd with
8383 | [] ->
8484 let rev_cli_order (a0, _) (a1, _) =
8585 Cmdliner_info.Arg.rev_pos_cli_order a0 a1
8686 in
8787- let args = Cmdliner_info.Cmd.args cmd in
8787+ let args = Cmdliner_info.Cmd_info.args cmd in
8888 let oargs, pargs =
8989 Cmdliner_info.Arg.(Set.partition (fun a _ -> is_opt a) args)
9090 in
···120120 strf "%s$(b,%s)%s %s%s"
121121 (deprecated cmd) (invocation ?ancestors cmd) show_help oargs pargs
122122 | _cmds ->
123123- let subcmd = match Cmdliner_info.Cmd.has_args cmd with
123123+ let subcmd = match Cmdliner_info.Cmd_info.has_args cmd with
124124 | false -> "$(i,COMMAND)" | true -> "[$(i,COMMAND)]"
125125 in
126126 strf "%s$(b,%s)%s %s …" (deprecated cmd) (invocation ?ancestors cmd)
127127 show_help subcmd
128128129129let cmd_doc cmd =
130130- let depr = match Cmdliner_info.Cmd.deprecated cmd with
130130+ let depr = match Cmdliner_info.Cmd_info.deprecated cmd with
131131 | None -> "" | Some msg -> msg ^ " "
132132 in
133133- depr ^ Cmdliner_info.Cmd.doc cmd
133133+ depr ^ Cmdliner_info.Cmd_info.doc cmd
134134135135-let cmd_docs ei = match Cmdliner_info.(Cmd.children (Eval.cmd ei)) with
135135+let cmd_docs ei = match Cmdliner_info.(Cmd_info.children (Eval.cmd ei)) with
136136| [] -> []
137137| cmds ->
138138 let add_cmd acc cmd =
139139 let syn = synopsis cmd in
140140- (Cmdliner_info.Cmd.docs cmd, `I (syn, cmd_doc cmd)) :: acc
140140+ (Cmdliner_info.Cmd_info.docs cmd, `I (syn, cmd_doc cmd)) :: acc
141141 in
142142 let by_sec_by_rev_name (s0, `I (c0, _)) (s1, `I (c1, _)) =
143143 let c = compare s0 s1 in
···211211 if not Cmdliner_info.Arg.(is_pos a && (docv a = "" || doc a = ""))
212212 then (a :: acc) else acc
213213 in
214214- let args = Cmdliner_info.Cmd.args @@ Cmdliner_info.Eval.cmd ei in
214214+ let args = Cmdliner_info.Cmd_info.args @@ Cmdliner_info.Eval.cmd ei in
215215 let args = Cmdliner_info.Arg.Set.fold keep_arg args [] in
216216 let args = List.sort by_sec_by_arg args in
217217 let args = List.rev_map (arg_to_man_item ~errs ~subst ~buf) args in
···233233 let item = `I (label, Cmdliner_manpage.subst_vars ~errs ~subst buf doc) in
234234 (Cmdliner_info.Exit.info_docs einfo, item) :: acc
235235 in
236236- let exits = Cmdliner_info.Cmd.exits @@ Cmdliner_info.Eval.cmd ei in
236236+ let exits = Cmdliner_info.Cmd_info.exits @@ Cmdliner_info.Eval.cmd ei in
237237 let exits = List.sort Cmdliner_info.Exit.info_order exits in
238238 let exits = List.fold_left add_exit_item [] exits in
239239 let exits = List.stable_sort by_sec (* sort by section *) exits in
···276276 in
277277 (* Arg envs before term envs is important here: if the same is mentioned
278278 both in an arg and in a term the substs of the arg are allowed. *)
279279- let args = Cmdliner_info.Cmd.args @@ Cmdliner_info.Eval.cmd ei in
280280- let tenvs = Cmdliner_info.Cmd.envs @@ Cmdliner_info.Eval.cmd ei in
279279+ let args = Cmdliner_info.Cmd_info.args @@ Cmdliner_info.Eval.cmd ei in
280280+ let tenvs = Cmdliner_info.Cmd_info.envs @@ Cmdliner_info.Eval.cmd ei in
281281 let init = Cmdliner_info.Env.Set.empty, [] in
282282 let acc = Cmdliner_info.Arg.Set.fold add_arg_envs args init in
283283 let _, envs = List.fold_left add_env acc tenvs in
···291291let xref_docs ~errs ei =
292292 let main = Cmdliner_info.Eval.main ei in
293293 let to_xref = function
294294- | `Main -> Cmdliner_info.Cmd.name main, 1
294294+ | `Main -> Cmdliner_info.Cmd_info.name main, 1
295295 | `Tool tool -> tool, 1
296296 | `Page (name, sec) -> name, sec
297297 | `Cmd c ->
298298 (* N.B. we are handling only the first subcommand level here *)
299299- let cmds = Cmdliner_info.Cmd.children main in
300300- let mname = Cmdliner_info.Cmd.name main in
301301- let is_cmd cmd = Cmdliner_info.Cmd.name cmd = c in
299299+ let cmds = Cmdliner_info.Cmd_info.children main in
300300+ let mname = Cmdliner_info.Cmd_info.name main in
301301+ let is_cmd cmd = Cmdliner_info.Cmd_info.name cmd = c in
302302 if List.exists is_cmd cmds then strf "%s-%s" mname c, 1 else
303303 (Format.fprintf errs "xref %s: no such command name@." c; "doc-err", 0)
304304 in
305305 let xref_str (name, sec) = strf "%s(%d)" (esc name) sec in
306306- let xrefs = Cmdliner_info.Cmd.man_xrefs @@ Cmdliner_info.Eval.cmd ei in
306306+ let xrefs = Cmdliner_info.Cmd_info.man_xrefs @@ Cmdliner_info.Eval.cmd ei in
307307 let xrefs = match main == Cmdliner_info.Eval.cmd ei with
308308 | true -> List.filter (fun x -> x <> `Main) xrefs (* filter out default *)
309309 | false -> xrefs
···346346 sm
347347348348let text ~errs ei =
349349- let man = Cmdliner_info.Cmd.man @@ Cmdliner_info.Eval.cmd ei in
349349+ let man = Cmdliner_info.Cmd_info.man @@ Cmdliner_info.Eval.cmd ei in
350350 let sm = Cmdliner_manpage.smap_of_blocks man in
351351 let sm = ensure_s_name ei sm in
352352 let sm = ensure_s_synopsis ei sm in
···355355356356let title ei =
357357 let main = Cmdliner_info.Eval.main ei in
358358- let exec = String.capitalize_ascii (Cmdliner_info.Cmd.name main) in
358358+ let exec = String.capitalize_ascii (Cmdliner_info.Cmd_info.name main) in
359359 let cmd = Cmdliner_info.Eval.cmd ei in
360360 let ancestors = Cmdliner_info.Eval.ancestors ei in
361361 let name = String.uppercase_ascii (invocation ~sep:"-" ~ancestors cmd) in
362362 let center_header = esc @@ strf "%s Manual" exec in
363363 let left_footer =
364364- let version = match Cmdliner_info.Cmd.version main with
364364+ let version = match Cmdliner_info.Cmd_info.version main with
365365 | None -> "" | Some v -> " " ^ v
366366 in
367367 esc @@ strf "%s%s" exec version
+14-12
vendor/opam/cmdliner/src/cmdliner_eval.ml
···2424let err_argv = "argv array must have at least one element"
25252626let add_stdopts ei =
2727- let docs = Cmdliner_info.Cmd.stdopts_docs (Cmdliner_info.Eval.cmd ei) in
2727+ let docs = Cmdliner_info.Cmd_info.stdopts_docs (Cmdliner_info.Eval.cmd ei) in
2828 let vargs, vers =
2929- match Cmdliner_info.Cmd.version (Cmdliner_info.Eval.main ei) with
2929+ match Cmdliner_info.Cmd_info.version (Cmdliner_info.Eval.main ei) with
3030 | None -> Cmdliner_info.Arg.Set.empty, None
3131 | Some _ ->
3232 let vers = Cmdliner_arg.stdopt_version ~docs in
···3434 in
3535 let help = Cmdliner_arg.stdopt_help ~docs in
3636 let args = Cmdliner_info.Arg.Set.union vargs (Cmdliner_term.argset help) in
3737- let cmd = Cmdliner_info.Cmd.add_args (Cmdliner_info.Eval.cmd ei) args in
3737+ let cmd = Cmdliner_info.Cmd_info.add_args (Cmdliner_info.Eval.cmd ei) args in
3838 help, vers, Cmdliner_info.Eval.with_cmd ei cmd
39394040let run_parser ~catch ei cl f =
···7575 (* For now we simply keep backward compat. [cmd] should be
7676 a name from main's children. *)
7777 let main = Cmdliner_info.Eval.main ei in
7878- let is_cmd t = Cmdliner_info.Cmd.name t = cmd in
7979- let children = Cmdliner_info.Cmd.children main in
7878+ let is_cmd t = Cmdliner_info.Cmd_info.name t = cmd in
7979+ let children = Cmdliner_info.Cmd_info.children main in
8080 let cmd = List.find is_cmd children in
8181 let _, _, ei = add_stdopts (Cmdliner_info.Eval.with_cmd ei cmd) in
8282 ei
···110110let do_deprecated_msgs ~env err_ppf cl ei =
111111 let cmd_info = Cmdliner_info.Eval.cmd ei in
112112 let deprecated = Cmdliner_cline.deprecated ~env cl in
113113- match Cmdliner_info.Cmd.deprecated cmd_info, deprecated with
113113+ match Cmdliner_info.Cmd_info.deprecated cmd_info, deprecated with
114114 | None, [] -> ()
115115 | depr_cmd, deprs ->
116116 let open Cmdliner_base in
···119119 in
120120 let subst = Cmdliner_info.Eval.doclang_subst ei in
121121 let pp_cmd_msg ppf cmd =
122122- match Cmdliner_info.Cmd.styled_deprecated ~subst ~errs:err_ppf cmd with
122122+ match
123123+ Cmdliner_info.Cmd_info.styled_deprecated ~subst ~errs:err_ppf cmd
124124+ with
123125 | "" -> ()
124126 | msg ->
125125- let name = Cmdliner_info.Cmd.name cmd in
127127+ let name = Cmdliner_info.Cmd_info.name cmd in
126128 Fmt.pf ppf "@[%a command %a:@[ %a@]@]"
127129 Fmt.deprecated () Fmt.code_or_quote name Fmt.styled_text msg
128130 in
···208210 let ei = Cmdliner_info.Eval.make ~cmd:cmd_info ~ancestors ~env ~err_ppf in
209211 add_stdopts ei
210212 in
211211- let cmd_args_info = Cmdliner_info.Cmd.args (Cmdliner_info.Eval.cmd ei) in
213213+ let cmd_args_info = Cmdliner_info.Cmd_info.args (Cmdliner_info.Eval.cmd ei) in
212214 let cline =
213215 Cmdliner_cline.create ~legacy_prefixes ~for_completion cmd_args_info args
214216 in
···261263 let version = if version_opt then Some "dummy" else None in
262264 let cmd_info, parser =
263265 let args, parser = Cmdliner_term.argset t, Cmdliner_term.parser t in
264264- let cmd_info = Cmdliner_info.Cmd.make ?version "dummy" in
265265- Cmdliner_info.Cmd.add_args cmd_info args, parser
266266+ let cmd_info = Cmdliner_info.Cmd_info.make ?version "dummy" in
267267+ Cmdliner_info.Cmd_info.add_args cmd_info args, parser
266268 in
267269 let help, version, ei =
268270 let err_ppf = Format.make_formatter (fun _ _ _ -> ()) (fun () -> ()) in
···270272 let ei = Cmdliner_info.Eval.make ~cmd:cmd_info ~ancestors ~env ~err_ppf in
271273 add_stdopts ei
272274 in
273273- let cmd_arg_infos = Cmdliner_info.Cmd.args (Cmdliner_info.Eval.cmd ei) in
275275+ let cmd_arg_infos = Cmdliner_info.Cmd_info.args (Cmdliner_info.Eval.cmd ei) in
274276 let cline =
275277 Cmdliner_cline.create
276278 ~peek_opts:true ~legacy_prefixes ~for_completion cmd_arg_infos args
+4-4
vendor/opam/cmdliner/src/cmdliner_info.ml
···261261262262(* Commands *)
263263264264-module Cmd = struct
264264+module Cmd_info = struct
265265 type t = Arg.cmd
266266 let make
267267 ?deprecated ?(man_xrefs = [`Main]) ?(man = []) ?(envs = [])
···326326 let main (i : t) = match List.rev i.ancestors with [] -> i.cmd | m :: _ -> m
327327 let with_cmd (i : t) cmd = { i with cmd }
328328329329- let doclang_name n = strf "$(b,%s)" (Cmd.escaped_name n)
329329+ let doclang_name n = strf "$(b,%s)" (Cmd_info.escaped_name n)
330330 let doclang_names names =
331331 strf "$(b,%s)" (Cmdliner_manpage.escape (String.concat " " names))
332332···336336 | "cmd.parent" ->
337337 let ancestors = ancestors i in
338338 if ancestors = [] then Some (doclang_name (main i)) else
339339- Some (doclang_names (List.rev_map Cmd.name ancestors))
339339+ Some (doclang_names (List.rev_map Cmd_info.name ancestors))
340340 | "iname" | "cmd" ->
341341- Some (doclang_names (List.rev_map Cmd.name (cmd i :: ancestors i)))
341341+ Some (doclang_names (List.rev_map Cmd_info.name (cmd i :: ancestors i)))
342342 | _ -> None
343343end
344344
+8-8
vendor/opam/cmdliner/src/cmdliner_info.mli
···138138 end
139139end
140140141141-(** Commands. *)
142142-module Cmd : sig
141141+(** Command information. *)
142142+module Cmd_info : sig
143143 type t
144144 val make :
145145 ?deprecated:string -> ?man_xrefs:Cmdliner_manpage.xref list ->
···183183module Eval : sig
184184 type t
185185 val make :
186186- cmd:Cmd.t -> ancestors:Cmd.t list -> env:(string -> string option) ->
187187- err_ppf:Format.formatter -> t
186186+ cmd:Cmd_info.t -> ancestors:Cmd_info.t list ->
187187+ env:(string -> string option) -> err_ppf:Format.formatter -> t
188188189189- val cmd : t -> Cmd.t
190190- val main : t -> Cmd.t
191191- val ancestors : t -> Cmd.t list (* root is last *)
189189+ val cmd : t -> Cmd_info.t
190190+ val main : t -> Cmd_info.t
191191+ val ancestors : t -> Cmd_info.t list (* root is last *)
192192 val env_var : t -> string -> string option
193193 val err_ppf : t -> Format.formatter
194194- val with_cmd : t -> Cmd.t -> t
194194+ val with_cmd : t -> Cmd_info.t -> t
195195 val doclang_subst : t -> Cmdliner_manpage.subst
196196end
197197
+2-2
vendor/opam/cmdliner/src/cmdliner_msg.ml
···7878(* Other messages *)
79798080let pp_version ppf ei =
8181- match Cmdliner_info.Cmd.version (Cmdliner_info.Eval.main ei) with
8181+ match Cmdliner_info.Cmd_info.version (Cmdliner_info.Eval.main ei) with
8282 | None -> assert false
8383 | Some v -> Fmt.pf ppf "@[%s@]@." v
84848585-let exec_name ei = Cmdliner_info.Cmd.name (Cmdliner_info.Eval.main ei)
8585+let exec_name ei = Cmdliner_info.Cmd_info.name (Cmdliner_info.Eval.main ei)
86868787let pp_exec_msg ppf ei = Fmt.pf ppf "%s:" (exec_name ei)
8888
+5-3
vendor/opam/cmdliner/src/cmdliner_term.ml
···64646565let main_name =
6666 Cmdliner_info.Arg.Set.empty,
6767- (fun ei _ -> Ok (Cmdliner_info.Cmd.name @@ Cmdliner_info.Eval.main ei))
6767+ (fun ei _ -> Ok (Cmdliner_info.Cmd_info.name @@ Cmdliner_info.Eval.main ei))
68686969let choice_names =
7070 Cmdliner_info.Arg.Set.empty,
7171 (fun ei _ ->
7272 (* N.B. this keeps everything backward compatible. We return the command
7373 names of main's children *)
7474- let name t = Cmdliner_info.Cmd.name t in
7575- let choices = Cmdliner_info.Cmd.children (Cmdliner_info.Eval.main ei) in
7474+ let name t = Cmdliner_info.Cmd_info.name t in
7575+ let choices =
7676+ Cmdliner_info.Cmd_info.children (Cmdliner_info.Eval.main ei)
7777+ in
7678 Ok (List.rev_map name choices))
77797880let with_used_args (al, v) : (_ * string list) t =