3 gonvert is a conversion utility that allows conversion between many units
4 like CGS, Ancient, Imperial with many categories like length, mass, numbers,
5 etc. All units converted values shown at once as you type. Easy to add/change
6 your own units. Written in Python,pygtk,libgade.
11 The goal when making gonvert was to have the most complete and easy to use
12 unit conversion utility. It is still growing as I find new units.
22 See INSTALL for installation notes
27 - Start the program by typing "gonvert".
28 - Select the category of units that you want to convert.
29 - Select the unit that want to enter a value for.
31 - The top two rows on the right side are temporary locations that scroll
32 through each unit you select. You can use this area to convert
33 between one unit and another without scrolling through the entire list
39 - You can sort Units and Value columns by clicking on the column name.
40 - You can print (to STDOUT) out all the units by selecting Tools>Write_Units
41 - You can find units by typing the name of the desired unit at the bottom
42 input field then pressing the Find butonn or hitting enter.
43 The number of units found that match the desired string is displayed
44 in the label at the bottom right. F6 key also acts as the Find button.
45 - previously selected categories and units are saved to ~/.gonvert/ directory
51 The usual disclaimer, I am not responsible for any damages this program may
52 cause. Use at your own risk. See COPYING for license.
55 Making additions and changes:
56 =============================
57 If you make corrections or additions to the program, please e-mail me so that I
58 can incorporate them into the source (with credit to your name of course).
59 Please keep in mind that this project is GPL (see COPYING file) so do not use
60 copyrighted material in your changes/additions to the unit descriptions that you
63 Make sure that all standard calculations using the m() function have floating
64 point arguments. In other words use at least one number in the formula with a
65 decimal point to force floating point numbers:
66 (m,5/2) #this is bad (the result will be 2, not 2.5)
67 (m,5.0/2) #this forces float (good, the result will be 2.5)
70 Without knowing Python:
71 You can alter the code without knowing much about Python just be reviewing the
72 method that the units definitions were written. Be careful to include the same
73 number of starting and ending brackets, also be careful of the commas.
75 If you want to use mathematical functions like pi etc you can see what other
76 functions there are as follows:
81 ['__builtins__', '__doc__', '__name__', 'acos', 'asin', 'atan', 'atan2', 'ceil',
82 'cos', 'cosh', 'e', 'exp', 'fabs', 'floor', 'fmod', 'frexp', 'hypot', 'ldexp',
83 'log', 'log10', 'modf', 'pi', 'pow', 'sin', 'sinh', 'sqrt', 'tan', 'tanh']
86 A good book for learning Python is the O'Reilly "Learning Python" book by
87 Mark Lutz and David Ascher.
96 Location of installed gonvert software is put into directories suggested by
97 then manpage hier (man hier).
100 gonvert program (this is the source)
103 gonvert documentation files.
106 Files associated with gonvert like the glade file and the pixmaps.
109 gonvert Man page (when one is written)
112 user configuration files associated with gonvert.