Annotation of researchv9/X11/src/X.V11R1/clients/xcalc/xcalc.man, revision 1.1

1.1     ! root        1: .TH XCALC 1 "16 March 1987" "X Version 10"
        !             2: .SH NAME
        !             3: xcalc \- X based scientific calculator
        !             4: .SH SYNOPSIS
        !             5: .B xcalc
        !             6: [host:display]  [-bw <pixels>] [-stip] [-rv] [-rpn] [-analog] [=geometry]
        !             7: .SH DESCRIPTION
        !             8: .I Xcalc
        !             9: is a program that brings up a scientific calculator desk accessory.  The 
        !            10: calculator mode should remind you more than a little bit of the TI-30 or 
        !            11: HP-10C.
        !            12: .SH OPTIONS
        !            13: .PP
        !            14: .TP 14
        !            15: .B \-bw
        !            16: The border width in pixels
        !            17: .PP
        !            18: .TP 14
        !            19: .B \-stip
        !            20: Sets the 'stipple' option.  See 'defaults'.
        !            21: .PP
        !            22: .TP 14
        !            23: .B \-rv
        !            24: Reverse video (on monochrom displays).
        !            25: .PP
        !            26: .TP 14
        !            27: .B \-rpn
        !            28: Specifies Reverse Polish Notation mode, in which the calculator behaves like 
        !            29: an HP-10 calculator.  Without this flag, it will behave like a TI-30 
        !            30: calculator.
        !            31: .PP
        !            32: .TP 14
        !            33: .B \-analog
        !            34: For backwards compatability.  Try it.
        !            35: .PP
        !            36: .TP 14
        !            37: .B \=geometry
        !            38: The width and height shouldn't be set by the user, as the default size is also
        !            39: the minimum size, and anything larger than that won't be 'right'.  You can, 
        !            40: however feel free to set the position.
        !            41: .PP
        !            42: .TP 14
        !            43: .B \fIhost\fP:\fIdisplay\fP
        !            44: Normally,
        !            45: .I xcalc
        !            46: gets  the host and display number to use from the environment variable
        !            47: ``DISPLAY''.  One can, however specify them explicitly.
        !            48: The
        !            49: .I host
        !            50: specifies which machine to create the
        !            51: .I xcalc
        !            52: window on, and
        !            53: the
        !            54: .I display
        !            55: argument specifies the display number.
        !            56: .SH OPERATION
        !            57: .PP
        !            58: .I Mouse Operation:
        !            59: The left button is the only one (really) used to operate the calculator.
        !            60: Pressing the AC key with the right button terminates the calculator.
        !            61: .PP
        !            62: .I Key Usage (Normal mode):
        !            63: The number keys, the +/- key, and the +, -, *, /, and = keys all do exactly 
        !            64: what you would expect them to.  It should be noted that the operators obey
        !            65: the standard rules of precedence.  Thus, entering "3+4*5=" results in "23",
        !            66: not "35".  The parentheses can be used to override this.  For example, 
        !            67: "(1+2+3)*(4+5+6)=" results in "6*15=90".  The non-obvious keys are detailed
        !            68: below.
        !            69: .PP
        !            70: .B 1/x
        !            71: replaces the number in the display with its reciprocal.
        !            72: .PP
        !            73: .B x^2
        !            74: squares the number in the display.
        !            75: .PP
        !            76: .B SQRT
        !            77: takes the square root of the number in the display.
        !            78: .PP
        !            79: .B CE/C
        !            80: when pressed once, clears the number in the display without clearing the state
        !            81: of the machine.  Allows you to re-enter a number if you screw it up.  
        !            82: Pressing it twice clears the state, also.
        !            83: .PP
        !            84: .B AC
        !            85: clears everything, the display, the state, the memory, everything.  Pressing
        !            86: it with the right button 'turns off' the calculator, in that it exits the
        !            87: program.  Somewhat more equivalent to throwing the calculator in the trash,
        !            88: if we were to pursue the analogy.
        !            89: .PP
        !            90: .B INV
        !            91: inverts the meaning of the function keys.  See the individual function keys
        !            92: for details.
        !            93: .PP
        !            94: .B sin
        !            95: computes the sine of the number in the display, as interpreted by the current
        !            96: DRG mode (see DRG, below).  If inverted, computes the arcsine.
        !            97: .PP
        !            98: .B cos
        !            99: computes the cosine, or arccosine when inverted.
        !           100: .PP
        !           101: .B tan
        !           102: computes the tangent, or arctangent when inverted.
        !           103: .PP
        !           104: .B DRG
        !           105: changes the DRG mode, as indicated by 'DEG', 'RAD', or 'GRAD' at the bottom of
        !           106: the display.  When in 'DEG' mode, numbers in the display are taken as being
        !           107: degrees.  In 'RAD' mode, numbers are in radians, and in 'GRAD' mode, numbers
        !           108: are in gradians.  When inverted, the DRG key has the nifty feature of 
        !           109: converting degrees to radians to gradians and vice-versa.  Example:  put the 
        !           110: calculator into 'DEG' mode, and type "45 INV DRG".  The display should now
        !           111: show something along the lines of ".785398", which is 45 degrees converted to
        !           112: radians.
        !           113: .PP
        !           114: .B e
        !           115: the constant 'e'.  (2.7182818...)
        !           116: .PP
        !           117: .B EE
        !           118: used for entering exponential numbers.  For example, to enter "-2.3E-4" you'd
        !           119: type "2 . 3 +/- EE 4 +/-"
        !           120: .PP
        !           121: .B log
        !           122: calculates the log (base 10) of the number in the display.  When inverted,
        !           123: raises "10.0" to the number in the display.  For example, typing "3 INV log"
        !           124: should result in "1000".
        !           125: .PP
        !           126: .B ln
        !           127: calcuates the log (base e) of the number in the display.  When inverted, 
        !           128: raises "e" to the number in the display.  For example, typing "e ln" should
        !           129: result in "1"
        !           130: .PP
        !           131: .B y^x
        !           132: raises the number on the left to the power of the number on the right.  For 
        !           133: example "2 y^x 3 =" results in "8", which is 2^3.  For a further example,
        !           134: "(1+2+3) y^x (1+2) =" equals "6 y^x 3" which equals "216".
        !           135: .PP
        !           136: .B PI
        !           137: the constant 'pi'.  (3.1415927....)
        !           138: .PP
        !           139: .B x!
        !           140: computes the factorial of the number in the display.  The number in the display
        !           141: must be an integer in the range 0-500, though, depending on your math library,
        !           142: it might overflow long before that.
        !           143: .PP
        !           144: .B STO
        !           145: copies the number in the display to the memory location.
        !           146: .PP
        !           147: .B RCL
        !           148: copies the number from the memory location to the display.
        !           149: .PP
        !           150: .B SUM
        !           151: adds the number in the display to the number in the memory location.
        !           152: .PP
        !           153: .B EXC
        !           154: swaps the number in the display with the number in the memory location.
        !           155: .PP
        !           156: .I Key Usage (RPN mode):
        !           157: The number keys, CHS (change sign), +, -, *, /, and ENTR keys all do exactly 
        !           158: what you would expect them to.  Many of the remaining keys are the same as in
        !           159: normal mode.  The differences are detailed below.
        !           160: .PP
        !           161: .B <-
        !           162: is a backspace key that can be used while typing a number.  It will erase
        !           163: digits from the display.
        !           164: .PP
        !           165: .B ON
        !           166: clears everything, the display, the state, the memory, everything.  Pressing
        !           167: it with the right button 'turns off' the calculator, in that it exits the
        !           168: program.  Somewhat more equivalent to throwing the calculator in the trash,
        !           169: if we were to pursue the analogy.
        !           170: .PP
        !           171: .B INV
        !           172: inverts the meaning of the function keys.  This would be the  "f" key
        !           173: on an HP calculator, but xcalc does not have the resolution to display
        !           174: multiple legends on each key.  See the individual function keys
        !           175: for details.
        !           176: .PP
        !           177: .B 10^x
        !           178: raises "10.0" to the number in the top of the stack.  When inverted, calculates
        !           179: the log (base 10) of the number in the display.
        !           180: .PP
        !           181: .B e^x
        !           182: raises "e" to the number in the top of the stack.  When inverted, calcuates the
        !           183: log (base e) of the number in the display.  
        !           184: .PP
        !           185: .B STO
        !           186: copies the number in the top of the stack to a memory location.  There are 10
        !           187: memory locations.  The desired memory is specified by following this
        !           188: key with pressing a digit key.
        !           189: .PP
        !           190: .B RCL
        !           191: pushes the number from the specified memory location onto the stack.
        !           192: .PP
        !           193: .B SUM
        !           194: adds the number on top of the stack to the number in the specified
        !           195: memory location.
        !           196: .PP
        !           197: .B x:y
        !           198: exchanges the numbers in the top two stack positions.
        !           199: .PP
        !           200: .B R v
        !           201: rolls the stack downward.  When inverted, rolls the stack upward.
        !           202: .PP
        !           203: .I blank
        !           204: these keys were used for programming functions on the HP11-C.  Their
        !           205: functionality has not been duplicated here.
        !           206: .PP
        !           207: .SH KEYBOARD EQUIVALENTS
        !           208: If you have the mouse in the xcalc window, you can use the keyboard to speed
        !           209: entry, as almost all of the calculator keys have a keyboard equivalent.  The
        !           210: number keys, the operator keys, and the parentheses all have the obvious
        !           211: equivalent.  The less-obvious equivalents are as follows:
        !           212: .PP
        !           213: .EX
        !           214: n:  +/-            !:  x!
        !           215: p:  PI             e:  EE
        !           216: l:  ln             ^:  y^x
        !           217: i:  INV            s:  sin
        !           218: c:  cos            t:  tan
        !           219: d:  DRG      BS, DEL:  CE/C ("<-" in RPN mode)
        !           220: CR: ENTR           
        !           221: 
        !           222: .SH COLOR USAGE
        !           223: .I Xcalc
        !           224: uses a lot of colors, given the opportunity.  In the default case, it will 
        !           225: just use two colors (Foreground and Background) for everything.  This works out
        !           226: nicely.  However, if you're a color fanatic you can specify the colors used 
        !           227: for the number keys, the operator (+-*/=) keys, the function keys, the display,
        !           228: and the icon.
        !           229: .SH X DEFAULTS
        !           230: .PP
        !           231: .TP 8
        !           232: .B BorderWidth
        !           233: width of border.  Default is '2'.
        !           234: .PP
        !           235: .TP 8
        !           236: .B ReverseVideo
        !           237: reverses colors on monochrome displays
        !           238: .PP
        !           239: .TP 8
        !           240: .B Stipple
        !           241: makes the calculator background a 50% stipple.  Default is 'on' on 
        !           242: monochrome displays, 'off' on color displays.  
        !           243: .PP
        !           244: .TP 8
        !           245: .B Mode
        !           246: sets the default mode.  Values are "rpn", "analog".
        !           247: .PP
        !           248: .TP 8
        !           249: .B Foreground
        !           250: the default color used for borders and text.
        !           251: .PP
        !           252: .TP 8
        !           253: .B Background
        !           254: the default color used for the background.
        !           255: .B NKeyFore, NKeyBack
        !           256: the colors used for the number keys.
        !           257: .PP
        !           258: .TP 8
        !           259: .B OKeyFore, OKeyBack
        !           260: the colors used for the operator keys.
        !           261: .PP
        !           262: .TP 8
        !           263: .B FKeyFore, FKeyBack
        !           264: the colors used for the function keys.
        !           265: .B DispFore, DispBack
        !           266: the colors used for the display.
        !           267: .B IconFore, IconBack
        !           268: the colors used for the icon.
        !           269: .SH SAMPLE .XDEFAULTS ENTRY
        !           270: If you're running on a monochrome display, you shouldn't need any .Xdefaults
        !           271: entries for xcalc.  On a color display, you might want to try the
        !           272: following in normal mode:
        !           273: 
        !           274: .EX
        !           275: xcalc.Foreground:               Black
        !           276: xcalc.Background:               LightSteelBlue
        !           277: xcalc.NKeyFore:                 Black
        !           278: xcalc.NKeyBack:                 White
        !           279: xcalc.OKeyFore:                 Aquamarine
        !           280: xcalc.OKeyBack:                 DarkSlateGray
        !           281: xcalc.FKeyFore:                 White
        !           282: xcalc.FKeyBack:                 #900
        !           283: xcalc.DispFore:                 Yellow
        !           284: xcalc.DispBack:                 #777
        !           285: xcalc.IconFore:                 Red
        !           286: xcalc.IconBack:                 White
        !           287: 
        !           288: <well, *I* like them.>
        !           289: .SH BUGS
        !           290: Well, it would be really nice if you could (usefully) rescale the calculator,
        !           291: and the redraw of the keys is sort of slow.  Nothing fatal though, I think.
        !           292: 
        !           293: The analog mode stuff isn't really working yet under X11.
        !           294: .SH AUTHOR
        !           295: John Bradley, University of Pennsylvania
        !           296: 
        !           297: ([email protected])
        !           298: 
        !           299: RPN and analog modes added by Mark Rosenstein, MIT Project Athena
        !           300: 
        !           301: <[email protected]>

unix.superglobalmegacorp.com

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