home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / basic / sortsubs.zip / SORTSUBS.DOC < prev    next >
Text File  |  1993-07-11  |  3KB  |  52 lines

  1. SortSubs
  2. (C) Copyright 1993 by Tim Gerchmez
  3. All Rights Reserved.
  4. Freeware - Distribute Freely
  5. ----------------------------------
  6.  
  7.         SortSubs is a handy utility for Spectra's PowerBASIC (all versions)
  8. and Borland's Turbo BASIC that sorts your program's SUBs and FUNCTIONs in
  9. alphabetical order, optionally letting you place dividers between each
  10. SUB or FUNCTION for readability.  SortSubs is written for PowerBASIC 3.0,
  11. but should be compilable under all versions of PowerBASIC.
  12.  
  13.         To use SortSubs, just enter SORTSUBS at the command line.  You
  14. will be asked for the path to the directory containing the BASIC source
  15. code file you wish to sort.  To use the current directory, press ENTER alone
  16. at this prompt.  A directory of .BAS files (if any) in the selected directory
  17. will be presented, and you'll be prompted for a filename.  Enter the name
  18. of the program you wish to sort.  You'll also be asked if you wish to place
  19. dividers between SUBs/FUNCTIONs to increase program readability (answer Y
  20. for Yes or N for No).  SortSubs will then read through your program,
  21. organizing each SUB and FUNCTION in alphabetical order, and placing all
  22. non SUB/FUNCTION (main program) text toward the top of the program.  If you
  23. selected Yes for dividers, a dividing line ('-----) will be placed between
  24. each SUB and FUNCTION in the program.  SortSubs will rename the original
  25. program to PROGRAMNAME.BAK, and rewrite the "new" sorted file to the 
  26. original filename selected.
  27.  
  28.         I wrote SortSubs for my own use because I was finding that my
  29. programs were becoming a jumble of SUBs and FUNCTIONs in no particular 
  30. order, and it was getting very difficult to find a given routine.  
  31. QuickBASIC automatically sorts routines in alphabetical order, but this 
  32. feature is missing from PowerBASIC.  SortSubs will make your programs
  33. much more readable, and make it a lot easier to find a particular routine
  34. by paging through the program text.
  35.  
  36.         I'm releasing SortSubs as freeware, free for noncommercial use.
  37. Commercial (business) use of SortSubs requires a licensing fee (write to
  38. the address below for details).  If you find any bugs in SortSubs, PLEASE
  39. write me at the address below so I can fix them - I'd hate to be blamed
  40. for trashing anyone's programs <grin>.  Of course, I can take no liability
  41. for damages arising from the use of SortSubs - you use it entirely at
  42. your own risk.
  43.  
  44. Tim Gerchmez
  45. 12648 S.E. 81st Pl.
  46. Renton, WA  98056-9121
  47.  
  48. Distributors: Distribute freely, no restrictions.
  49.  
  50. QuickBASIC and PowerBASIC are trademarks of Microsoft
  51. Corp. and Spectra Publishing, respectively.
  52.