Return to hoc.1 CVS log

Up to [Research Unix] / researchv10no / cmd / hoc

Annotation of researchv10no/cmd/hoc/hoc.1, revision 1.1.1.1

1.1       root        1: .TH HOC 1
                      2: .CT 1 numbers
                      3: .SH NAME
                      4: hoc \(mi interactive floating point language
                      5: .SH SYNOPSIS
                      6: .B hoc
                      7: [
                      8: .I file ...
                      9: ]
                     10: .SH DESCRIPTION
                     11: .I Hoc
                     12: interprets a simple language for floating point arithmetic,
                     13: at about the level of Basic, with C-like syntax and
                     14: functions.
                     15: .PP
                     16: The named
                     17: .IR file s
                     18: are read and interpreted in order.
                     19: If no
                     20: .I file
                     21: is given or if
                     22: .I file
                     23: is
                     24: .L -
                     25: .I hoc
                     26: interprets the standard input.
                     27: .PP
                     28: .I Hoc
                     29: input consists of
                     30: .I expressions
                     31: and
                     32: .IR statements .
                     33: Expressions are evaluated and their results printed.
                     34: Statements, typically assignments and function or procedure
                     35: definitions, produce no output unless they explicitly call
                     36: .IR print .
                     37: .PP
                     38: Variable names have the usual syntax, including 
                     39: .LR _ ;
                     40: the name 
                     41: .L _
                     42: by itself contains the value of the last expression evaluated.
                     43: Certain variables are already initialized:
                     44: .TP
                     45: .B E
                     46: base of natural logs
                     47: .PD0
                     48: .TP
                     49: .B PI
                     50: .TP
                     51: .B PHI
                     52: golden ratio
                     53: .TP
                     54: .B GAMMA 
                     55: Euler's constant
                     56: .TP
                     57: .B DEG 
                     58: 180/PI, degrees per radian
                     59: .TP
                     60: .B PREC
                     61: maximum number of significant digits in output, initially 15;
                     62: .B PREC=0
                     63: gives shortest `exact' values.
                     64: .PD
                     65: .PP
                     66: Expressions are formed with these C-like operators, listed by
                     67: decreasing precedence.
                     68: .TP
                     69: .B ^
                     70: exponentiation
                     71: .TP
                     72: .B ! - ++ --
                     73: .TP
                     74: .B * / %
                     75: .TP
                     76: .B + -
                     77: .TP
                     78: .B > >= < <= == !=
                     79: .TP
                     80: .B &&
                     81: .TP
                     82: .B ||
                     83: .TP
                     84: .B = += -= *= /= %=
                     85: .PP
                     86: Built in functions include
                     87: .BR abs ,
                     88: .BR acos ,
                     89: .B atan
                     90: (one argument),
                     91: .BR cos ,
                     92: .BR cosh ,
                     93: .BR erf ,
                     94: .BR erfc ,
                     95: .BR exp ,
                     96: .BR gamma ,
                     97: .BR int ,
                     98: .BR log ,
                     99: .BR log10 ,
                    100: .BR sin ,
                    101: .BR sinh ,
                    102: .BR sqrt ,
                    103: .BR tan ,
                    104: and
                    105: .BR tanh .
                    106: The function
                    107: .B read(x)
                    108: reads a value into the variable
                    109: .BR x ;
                    110: the statement
                    111: .B print
                    112: prints a list of expressions that may include
                    113: string constants such as
                    114: .B \&\&\&"hello\en".
                    115: .PP
                    116: Control flow statements are
                    117: .BR if - else ,
                    118: .BR while ,
                    119: and
                    120: .BR for ,
                    121: with braces for grouping.
                    122: Newline ends a statement.
                    123: Backslash-newline is equivalent to a space.
                    124: .PP
                    125: Functions and procedures are introduced by the words
                    126: .B func
                    127: and
                    128: .BR proc ;
                    129: .B return
                    130: is used to return with a value from a function.
                    131: Within a function or procedure,
                    132: arguments are referred to as
                    133: .BR $1 ,
                    134: .BR $2 ,
                    135: etc.; all other variables are global.
                    136: .SH EXAMPLES
                    137: .EX
                    138: func gcd() {
                    139:        temp = abs($1) % abs($2)
                    140:        if(temp == 0) return abs($2)
                    141:        return gcd($2, temp)
                    142: }
                    143: for(i=1; i<12; i++) print gcd(i,12)
                    144: .EE
                    145: .SH "SEE ALSO"
                    146: .IR bc (1),
                    147: .IR dc (1)
                    148: .br
                    149: B. W. Kernighan and R. Pike,
                    150: .I
                    151: The Unix Programming Environment,
                    152: Prentice-Hall, 1984
                    153: .SH BUGS
                    154: Error recovery is imperfect within function and procedure definitions.
                    155: .br
                    156: The treatment of newlines is not exactly user-friendly.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.