Return to hoc.1 CVS log

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

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

1.1       root        1: .TH HOC 1
                      2: .SH NAME
                      3: hoc \- interactive floating point language
                      4: .SH SYNOPSIS
                      5: .B hoc
                      6: [ file ... ]
                      7: .SH DESCRIPTION
                      8: .I Hoc
                      9: interprets a simple language for floating point arithmetic,
                     10: at about the level of BASIC, with C-like syntax and
                     11: functions and procedures with arguments and recursion.
                     12: .PP
                     13: The named
                     14: .IR file s
                     15: are read and interpreted in order.
                     16: If no
                     17: .I file
                     18: is given or if
                     19: .I file
                     20: is `\-'
                     21: .I hoc
                     22: interprets the standard input.
                     23: .PP
                     24: .I Hoc
                     25: input consists of
                     26: .I expressions
                     27: and
                     28: .IR statements .
                     29: Expressions are evaluated and their results printed.
                     30: Statements, typically assignments and function or procedure
                     31: definitions, produce no output unless they explicitly call
                     32: .IR print .
                     33: .PP
                     34: Variable names are the usual syntax, including `_'; the name `_'
                     35: by itself contains the value of the last expression evaluated.
                     36: The variables E, PI, PHI, GAMMA and DEG are predefined;
                     37: the last is 59.25..., degrees per radian.
                     38: .PP
                     39: Expressions are formed with these operators:
                     40: .nf
                     41: .ta .5i 1.5i
                     42:        ^       exponentiation
                     43:        ! \- ++ \-\-    unary logical and arithmetic negation, ...
                     44:        * / %   the obvious
                     45:        + \-    ditto
                     46:        > >= < <= == !=
                     47:        &&
                     48:        \(or\(or
                     49:        = += \-= \(**= /= %=
                     50: .fi
                     51: Built in functions include 
                     52: .IR abs ,
                     53: .I atan
                     54: (one argument),
                     55: .IR cos ,
                     56: .IR exp ,
                     57: .IR int ,
                     58: .IR log ,
                     59: .IR log10 ,
                     60: .IR sin ,
                     61: and
                     62: .IR sqrt .
                     63: The function
                     64: .I read(x)
                     65: reads a value into the variable 
                     66: .IR x ;
                     67: the statement
                     68: .I print
                     69: prints a list of expressions that may include
                     70: string constants such as
                     71: .IR \&\&\&"hello\en" .
                     72: .PP
                     73: Control flow includes
                     74: .IR if-else ,
                     75: .IR while ,
                     76: and
                     77: .IR for ,
                     78: with braces for grouping.
                     79: End of line marks end of statement, as does a semicolon.
                     80: Comments begin with # and continue to end of line.
                     81: .PP
                     82: Functions and procedures are introduced by the words
                     83: .I func
                     84: and
                     85: .IR proc ;
                     86: .I return
                     87: is used to return, with a value from a function.
                     88: Within a function or procedure,
                     89: arguments are referred to as
                     90: .IR $1 ,
                     91: .IR $2 ,
                     92: etc.; all other variables are global.
                     93: .SH "SEE ALSO"
                     94: .I
                     95: The Unix Programming Environment
                     96: by Brian Kernighan and Rob Pike.
                     97: .br
                     98: .IR bas (1),
                     99: .IR bc (1)
                    100: and
                    101: .IR dc (1).
                    102: .SH BUGS
                    103: Error recovery is imperfect within function and procedure definitions.
                    104: .br
                    105: 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.