Index of /cbx/

CHECKBOOK --------- Version 1.1 9/24/2020 http://www.centaur.pw <jon@centel.cc> ABOUT ----- Checkbook (CBX) is a command line utility for managing a virtual checkbook stored as a file in the user's directory. TABLE OF CONTENTS ----------------- 1. Compiling & Installation 2. Checkbook File 3. Command Line Parameters 4. Examples 1. COMPILING & INSTALLATION --------------------------- To build the 'cbx' binary: $ make To move the 'cbx' binary to /usr/bin and copy the manual page file 'cbx.7.gz' to /usr/share/man/man7: $ make install To remove the object files generated by make: $ make clean To delete the installed binary and manual: $ make uninstall 2. CHECKBOOK FILE ----------------- The file 'Checkbook' in a user's home directory is always the only file accessed by CBX, with the exception of a hidden temporary file created by CBX for certain operations. If the file does not exist, it can be created using the '-n' option on the command line. User is prompted for overwrite if the file already exists in the user's home directory. To have multiple Checkbook files, it is only necessary to rename (or move) the old one and create a new one. The first seven lines follow a specific format. CBX will malfunction if the header has been improperly modified. Appending lines to the 'Checkbook' file will not interfere with CBX operations. 3. COMMAND LINE PARAMETERS -------------------------- Syntax: cbx -h Display help text cbx -n Create a new checkbook file ('Checkbook' in user's home directory) cbx -b Display account balance cbx -v Display checkbook file Transaction numbers are listed automatically with '-v'. These numbers are not stored in the file. cbx -w <num> <date> <desc> <amount> - Add a withdrawal (payment) transaction cbx -d <num> <date> <desc> <amount> - Add a deposit transaction <num> - check number (or any other short notation, e.g. 'DC', 'DEP') <date> - date of transaction (e.g. 9-5) <desc> - transaction description (up to 15 characters) (enclose in single-quotes ('') if using space characters in <desc>) <amount> - dollar amount (without dollar sign); may be a decimal or an integer <num> and <date> may take a different format than shown here if desired. Both should limited to 5 characters. Exactly four parameters are required for options '-w' and '-d'. 4. EXAMPLES ----------- $ cbx -b Output: Balance for jon: $5030.95 $ cbx -v Output: CHECKBOOK1.1 / jon Balance: $4879.43 Num Date Description +/- Balance ------------------------------------------------------------------------------- 1: - 9-5 Candy -$2.38 $5027.62 2: - 9-6 Gas -$25.68 $5001.94 3: - 9-9 Electricity -$122.51 $4879.43 $ cbx -w 2562 9-10 Rent 650.00 Output: Transaction complete. New balance: $4229.43 $ cbx -w 2563 9-10 'Car Payment' 310.55 Output: Transaction complete. New balance: $3918.88 $ cbx -d DEP 9-16 Payday 897.03 Output: Transaction complete. New balance: $4815.91 Assuming the above three examples have been entered: $ cbx -v Output: CHECKBOOK1.1 / jon Balance: $4815.91 Num Date Description +/- Balance ------------------------------------------------------------------------------- 1: - 9-5 Candy -$2.38 $5027.62 2: - 9-6 Gas -$25.68 $5001.94 3: - 9-9 Electricity -$122.51 $4879.43 4: 2562 9-10 Rent -$650.00 $4229.43 5: 2563 9-10 Car Payment -$310.55 $3918.88 6: DEP 9-16 Payday +$897.03 $4815.91