File: help.doc

package info (click to toggle)
hol-light 20131026-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 26,264 kB
  • ctags: 4,620
  • sloc: ml: 400,325; cpp: 438; java: 279; lisp: 261; makefile: 256; sh: 190; yacc: 108; perl: 78; ansic: 57; sed: 39
file content (73 lines) | stat: -rw-r--r-- 1,723 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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
\DOC help

\TYPE {help : string -> unit}

\SYNOPSIS
Displays help on a given identifier in the system.

\DESCRIBE
A call {help "s"} will attempt to display the help file associated with a
particular identifier {s} in the system. If there is no entry for identifier
{s}, the call responds instead with some possibly helpful suggestions as to
what you might have meant, based on a simple `edit distance' criterion.

The built-in help files are stored in the {Help} subdirectory of HOL Light. 
Users can add additional locations by modifying {help_path}. Normally the help
file for an identifier {name} would be called {name.doc}, but there are a few
exceptions, because some identifiers have characters that cannot be put in
filenames and some platforms like Cygwin have inadequate case sensitivity.

\FAILURE
Never fails.

\EXAMPLE
Here is a successful call:
{
  # help "lhs";;
  -------------------------------------------------------------------

  lhs : term -> term

  SYNOPSIS

  Returns the left-hand side of an equation.

  DESCRIPTION

  lhs `t1 = t2` returns `t1`.

  FAILURE CONDITIONS

  Fails with lhs if the term is not an equation.

  EXAMPLES


    # lhs `2 + 2 = 4`;;
    val it : term = `2 + 2`


  SEE ALSO
  dest_eq, lhand, rand, rhs.

  -------------------------------------------------------------------
  val it : unit = ()
}
\noindent and here is one for a non-existent identifier:
{
  # help "IMP_TAC";;
  -------------------------------------------------------------------
  No help found for "IMP_TAC"; did you mean:

  help "SIMP_TAC";;
  help "MP_TAC";;
  help "IMP_TRANS";;

  ?
  --------------------------------------------------------------------
}

\SEEALSO
help_path, hol_version.

\ENDDOC