Index of /cbx/

      Name                                                                             Last modified         Size  Description
   
up Parent Directory 27-Sep-2020 02:47 - unknown CHECKSUM.MD5 27-Sep-2020 02:47 4k unknown Makefile 27-Sep-2020 02:47 4k [CMP] cbx-1.1.tar.gz 27-Sep-2020 02:47 8k [CMP] cbx.7.gz 27-Sep-2020 02:47 4k [TXT] checkbook.c 27-Sep-2020 02:47 8k [TXT] checkbook.h 27-Sep-2020 02:47 4k [TXT] main.c 27-Sep-2020 02:47 4k

CHECKBOOK
---------

Version 1.1
9/24/2020
http://www.centaur.pw


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     - Add a withdrawal (payment) transaction
cbx -d     - Add a deposit transaction

	    - check number (or any other short notation, e.g. 'DC', 'DEP')
	   - date of transaction (e.g. 9-5)
	   - transaction description (up to 15 characters)
	           (enclose in single-quotes ('') if using space characters in )
	 - dollar amount (without dollar sign); may be a decimal or an integer

	 and  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
Proudly Served by LiteSpeed Web Server at centel.cc Port 443