home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 February / PCWorld_2000-02_cd.bin / live / usr / X11R6 / lib / X11 / cbb / contrib / txn.README < prev    next >
Text File  |  1998-10-07  |  2KB  |  54 lines
  1. #!/usr/bin/perl
  2. To: cbbers@infoplane.com
  3. Subject: shell-based interface to cbb
  4. Date: Mon, 21 Apr 1997 23:30:58 -0500
  5.  
  6. I've finally gotten around to updating the program "txn" to version 0.7 of cbb.
  7.  
  8. The attached program will append records to .cbb files, and do so from the 
  9. command line.
  10.  
  11. For instance: 
  12.  
  13. [25%] txn checking -t '75' 'The Mansion in Dallas' Lunch 75.00 'Gratuitously 
  14. expensive luncheon'
  15.  
  16. Added to /home/cbbrowne/kwiken/checking.cbb
  17. 19970422        75      The Mansion in Dallas   75.00   0       Lunch   
  18. Gratuitously expensive luncheon
  19. [26%] 
  20.  
  21. Limitations:
  22. - It appears that "splits" have been changed somewhat; I haven't checked yet 
  23. to see if they are handled correctly.
  24.  
  25. - Writing to a .cbb file whilst the TCL version is open and using the file in 
  26. question will have obviously questionable results.  If Curt implements his 
  27. file locking idea (which probably ought to put the PID of the main CBB process 
  28. in either /var/lock/LCK..cbb or do individual file locks like 
  29. /var/lock/LCK..checking.cbb), I could have txn look for and/or lock these...
  30.  
  31. - You'll have to modify the paths at the start of the script to locate your 
  32. favorite CBB directory.
  33.  
  34. - This script assumes that if the category is not available that you can look 
  35. at a list of similar category names and pick one.  If you plan to write 
  36. scripts that will create transactions as "batch jobs," then you'll have to 
  37. ensure that the category is correct.  I'm not sure how to best deal with the 
  38. error condition of not having a correct category.  Create "ntxn" 
  39. (non-interactive txn) that reports an error and dies upon receiving a bad 
  40. category, perhaps?  An additional command line switch?  Ideas anyone?
  41.  
  42. - I have no further intentions to maintain the code that allowed 
  43. deletion/reconciliation from the command line.  The cbbsh of 1994 did provide 
  44. this functionality, at the cost of a fairly painful user interface.  It just 
  45. makes too much sense to do transaction editing with a somewhat "GUIed" 
  46. interface to bring most of the remainder of CBBSH up to date.
  47.  
  48. Anyway, here's the new and improved txn:
  49.  
  50. --
  51. Christopher B. Browne, cbbrowne@hex.net, chris_browne@sdt.com
  52. Web: http://www.conline.com/~cbbrowne  SAP Basis Consultant, UNIX Guy
  53. Windows NT - How to make a 100 MIPS Linux workstation perform like an 8 MHz 286
  54.