home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / logcut01.zip / LogCuter.Doc < prev    next >
Text File  |  1996-02-07  |  4KB  |  73 lines
  1.                                 LogCutter V1.0
  2.                         By Mark Taylor (c) TryThat SoftWare
  3.  
  4.  
  5. I hate writting docs,so this won't be very long :)
  6. This program is ShareWare,its not crippled in any way,but if after using it for 30 days,
  7. you are required to either Delete it,or Register it,the cost is 5 UK Pounds,10 US Dollars,
  8. or 10 German Marks,My address is at the end of this doc.
  9.  
  10. As its ShareWare I won't be responsable for ill effects it has on your system,so if it deletes
  11. all your files,then don't blame me,I do use the program,and so far thats not happened to me :)
  12.  
  13. So whats it do,well the name of the program should give you a clue :0
  14. Well it Cuts down to size all those LogFiles we generate from the various programs that we
  15. run,at the moment the only EXE in this archive is for OS/2 Warp,I need to read the docs
  16. for EMX a little more on how to create a DOS version,thats if anyone wants a DOS version!
  17. For LogCutter to work you need a CFG file,this MUST be called 'LogCuter.CFG' and be in the
  18. same place as 'LogCuter.EXE',apart from that they can be placed any where you like.
  19. I'll now name each command and give a example,anything in [] is optional.
  20.  
  21. Filenames must be full path names.
  22.  
  23. Command     : Cut FileName [Max Size]
  24. Description : This is the guts of the program,FileName is the file that needs cutting.
  25. Example     : Cut G:\Logs\MaxList.Log 100,Cut G:\Logs\Squish.Log
  26.  
  27. Command     : [Log FileName] [Max Size]
  28. Description : LogCutters own LogFile,Max Size that it can be before cutting down,if you don't
  29.               want a log kept,don't use this Command
  30. Example     : Log G:\Logs\LogCutter.Log 25,Log G:\all_logs\LogCutter.Log
  31.  
  32. Command     : [DefaultSize Max Size]
  33. Description : You can set a Default for your Max Size,LogCutter has a Default of 50KB (50 * 1024)
  34. Example     : DefaultSize 25
  35.  
  36. Command     : [StartFromBlank]
  37. Description : Lots of LogFiles have a Blank line,seperating each run,well with this Command,
  38.               you can make LogCutter search for a Blank line before it cuts to size,makes the
  39.               new file look nicer.
  40. Example     : StartFromBlank
  41.  
  42. Thats all there is to setting LogCutter up,I would advise you to test run it first,before you
  43. put it into your daily CMD file,the only Command you do need to use is 'CUT'.
  44.  
  45. I'll mention a few things that are'nt in LogCutter and why not,the first is if a Log file thats
  46. in the CFG,but has'nt been created yet then LogCutter will say there is a error,the reason being,
  47. I'm only working from the EMX manual and have'nt found the structures I need to check if the file
  48. is there first (Does that make sense?)
  49. The method used for calculating the new log size is this,if the file size is larger than your set
  50. maximum,LogCutter will take two thirds of this size,and then check again,and it does this untill
  51. the new file size is smaller than your set maximum.
  52. Also there is'nt stacks of error checking built in,if you find you're getting loads of errors
  53. let me know and I'll do a quick debug version.
  54. If you have any ideas or find any bugs then just Netmail me.
  55. Well thats about it :)
  56.  
  57. **************************************************************************
  58. * Don't forget its SHAREWARE if you use it after 30 days YOU MUST PAY!!  *
  59. **************************************************************************
  60.  
  61. Here is my Home address,and my network ones :
  62.  
  63. Mark Taylor
  64. 1,Hope Villas,
  65. Upper SpringField RD,
  66. Uplands,Stroud.
  67. GLOS GL5 1TF
  68.  
  69. 2:253/35@fidonet
  70. 81:444/25@os2net
  71. 240:360/317@mercury
  72. 160:3/25@uninet
  73.