Merge branch 'master' of https://git.code.sf.net/p/cdesktopenv/code
[oweals/cde.git] / cde / programs / dtcalc / dtcalc.man
1 .\" $XConsortium: dtcalc.man /main/2 1995/07/17 10:50:28 drk $
2 .TH DTCALC 1X "" "" "" ""
3 .ds ]W CDE 1.0 (2/94)
4 .na
5 .SH NAME
6 \fBdtcalc \(em The Common Desktop Environment Calculator.\fP
7 .sp 1
8 .SH SYNOPSIS
9 \fBdtcalc\fP
10 [-a accuracy] [-m mode] [-b numeric_base] [-notation display_notation]
11 [-trig trigonometric_type] [-session session_file] [-no_menu_bar]
12 .sp 1
13 .SH DESCRIPTION
14 The \fIDtcalc\fP program is a calculator for use within the Common 
15 Desktop Environment.  It provides an easy to use interface designed to
16 give access to common arithmetic and financial calculations.
17 .P
18 The calculator is designed to operate in much the same way as many 
19 hand-held calculators.  It provides three modes of operation: scientific,
20 financial, and logical.  The default operation is scientific, but with
21 the easy to use GUI changing to the modes of operation are easy.  When
22 the operation mode is changed, a number of the keys change for the new
23 operations.  
24 .P
25 .P
26 .P
27 .sp 1
28 .SH OPTIONS
29 \fIDtcalc\fP defines a number of command-line options which allow the user
30 to configure how the calculator displays itself.  Command-line options have a
31 higher precedence then resources.  By using command-line options
32 a user can override anything specified in a resource file. 
33 .IP "\fB-a \fP\fI<accuracy>\fP"
34 .br
35 This is the initial number of digits displayed after the numeric point.
36 This value must be in the range 0 to 9.  The default value is 2.
37 .IP "\fB-m \fP\fI<mode>\fP"
38 .br
39 This determines which mode the calculator will display itself in.  
40 There are three modes of operation: scientific, financial, or logical.
41 Some of the calculator keys change when it changes between different
42 modes.
43 .IP "\fB-b \fP\fI<numeric_base>\fP"
44 .br
45 This determines which numeric base the calculator will use when it does
46 calculations. There are four bases the calculator supports: binary (base 2), 
47 octal (base 8), decimal (base 10), or hexidecimal (base 16).  The default
48 is decimal.
49 .IP "\fB-notation \fP\fI<display_notation>\fP"
50 .br
51 This determines how the answers are to be display on the calculator.
52 There are three ways of displaying answers on the calculator: scientific,
53 engineering, and fixed.  The default is fixed. 
54 .IP "\fB-trig \fP\fI<trigonometric_type>\fP"
55 .br
56 This determines how answers are presented when the calculator is in 
57 scientific mode. There are three trigonometric ways to present the answers:
58 degrees, radians, or gradients.  The default is degrees.
59 .IP "\fB-no_menu_bar\fP"
60 .br
61 This option makes the calculator come up with no menubar.
62 .IP "\fB-session \fP\fI<session_file>\fP"
63 .br
64 This option takes the name of a session file as an additional parameter.
65 \fIDtcalc\fP is run with the specified session file name.  This session 
66 file is a file that was previously saved by \fIdtcalc\fP during a session
67 shutdown.
68 .sp 1
69 .SH RESOURCES
70 .P
71 The Calculator supports a number of resources which make it much more 
72 configurable. Following is the list of supported resources and their default 
73 values. 
74 .sp 2
75 .TS
76 center;
77 CB sss
78 lB lB lB lB
79 l l l l .
80 Client Resource Set
81 Name    Class   Type    Default
82 _
83 postMenuBar     PostMenuBar     Boolean True
84 accuracy        accuracy        int     2
85 base    Base    string  decimal
86 display Display string  fixed
87 mode    Mode    string  scientific
88 trigType        TrigType        string  degrees
89 .TE
90 .ps
91 .sp 1
92 .IP "\fBDtcalc*postMenuBar:\fP"
93 Specifies wheither the menu bar should appear or not.
94 .IP "\fBDtcalc*accuracy:\fP"
95 Specifies wheither the menu bar should appear or not.
96 .IP "\fBDtcalc*base:\fP"
97 This resource allows the user to change the default for the numeric base
98 the calculator uses when it does its calculations.  The default is "decimal" 
99 which is base 10.  Possible values are:
100 .br
101 .sp 1
102 \fBbinary (or bin):\fP do calculations in base 2.
103 .br
104 .sp 1
105 \fBoctal (or oct):\fP do calculations in base 8.
106 .br
107 .sp 1
108 \fBdecimal (or dec):\fP do calculations in base 10.
109 .br
110 .sp 1
111 \fBhexidecimal (or hex):\fP do calculations in base 16.
112 .IP "\fBDtcalc*display:\fP"
113 This resource allows the user to change the default for the way answers are
114 display on the calculator.  The default is "fixed".  Possible values are:
115 .br
116 .sp 1
117 \fBfixed (or fix):\fP display in fixed mode.
118 .br
119 .sp 1
120 \fBscientific (or sci):\fP display in scientific mode.
121 .br
122 .sp 1
123 \fBengineering (or eng):\fP display in engineering mode.
124 .br
125 .sp 1
126 \fBhexidecimal:\fP do calculations in base 16.
127 .sp 2
128 .SH FEATURES
129 .P
130 .IP "\fBMemory Register\fP"
131 .IP "\fBFinancial Register\fP"
132 .IP "\fBASCII Converter\fP"
133 .IP "\fBFunctions\fP"
134 .IP "\fBConstants\fP"
135 .IP "\fBHelp\fP"
136 .IP "\fBPopup Menu Support\fP"
137 .SH COPYRIGHT
138 (c) Copyright 1994 Hewlett-Packard Company
139 .IP
140 (c) Copyright 1994 International Business Machines Corp.
141 .IP
142 (c) Copyright 1994 Sun Microsystems, Inc.
143 .sp 1
144 .SH ORIGIN
145 Hewlett-Packard Company, WTD-CV.