package b0

You can search for identifiers within the package.

in-package search v0.2.0

Software construction and deployment kit

Install

Dune Dependency

erratique.ch Readme Changelog ISC; BSD-2-Clause License Edit opam file Versions (6)

Authors

T

The b0 programmers

Maintainers

Daniel Bünzli

Sources

b0-0.0.1.tbz

sha256=dba2fc571f39f3b8e87ee55c77bdec7ec6a5ddc7d99b8b20aeda848af546be04

md5=51ee1d66acc4d7f87bdceac1341b7711

doc/b00_kit/B00_pager/index.html

Module `B00_pager`

Pager interaction.

Environment variables

module Env : sig ... end

Environment variables.

val envs : unit -> Cmdliner.Term.env_info list

envs () describe the PAGER and TERM environment variable for cmdliner.

Paging

val find : 
  ?search:B00_std.Fpath.t list ->
  don't:bool ->
  unit ->
  (B00_std.Cmd.t option, string) Stdlib.result

find ~search ~don't finds a suitable pager. This is (in order):

Ok None if don't is true or if the TERM environment variable is dumb or undefined.
Ok (Some pager) if pager is a tool invocation parsed from the PAGER environment variable that can be found via Os.Cmd.find ?search.
Ok (Some pager) if either less or more can be found (in that order) via Os.Cmd.find ?search.
Ok None otherwise.

val page_stdout : B00_std.Cmd.t option -> (unit, string) Stdlib.result

page_stdout pager setups the program so that if pager is Some cmd, the standard output of the program is redirected to a spawn of cmd with the following twists:

If the environment variable LESS is undefined in the current environment it is set to LESS=FRX for the spawn of cmd.
A Pervasive.at_exit function is installed that flushes Fmt.stdout and stdout, closes Unix.stdout and waits upon the cmd spawn termination.

If pager is None this function has no effect.

val page_files : 
  B00_std.Cmd.t option ->
  B00_std.Fpath.t list ->
  (unit, string) Stdlib.result

page_files pager fs uses pager to page the files fs. If pager is:

None, each of the fs files is output on stdout in order separated by a file separator character (U+001C).
Some cmd, cmd is run with fs as arguments. If fs is empty does nothing.

Cli interaction

val don't : ?docs:string -> unit -> bool Cmdliner.Term.t

don't ~docs () is a --no-pager command line option to unconditionally request not use a pager. docs is the manual section where the option is documented.

On This Page

Environment variables
Paging
Cli interaction