home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / misc / MergeRec.lha / MergeRec / MergeRec.doc < prev    next >
Text File  |  1995-12-11  |  4KB  |  113 lines
  1.  
  2.                              MergeRec v1.1
  3.                              ~~~~~~~~~~~~~
  4.                                11-Dec-95
  5.                          by Adriano De Minicis
  6.  
  7.  
  8. INTRODUCTION
  9. ************
  10. MergeRec updates your local copy of the Aminet INDEX file by incorporating
  11. changes from a RECENT file. It is a modified version of MergeRecent program.
  12.  
  13. Now you can also use the e-mailed aminet-weekly RECENT file, without
  14. manually removing the extraneous lines. MergeRec automatically extract the
  15. RECENT file from your e-mail message(s) file. It accepts lines ending with
  16. LF or CR+LF.
  17.  
  18. The 'Age' column of the index file is increased by the differences in weeks
  19. between RECENT and INDEX files.
  20.  
  21. NOTES
  22. -----
  23. If you download RECENT files directly from an Aminet site, be sure to
  24. get them exactly every 7 days, to have a correct update of the INDEX.
  25. Updating after less then 7 days leaves the age column unchanged.
  26. Updating after more than 7 days, you may lost some new-entries (because
  27. the RECENT file contains only the last 7 days uploads).
  28.  
  29. This problem do not arise if you subscribe to aminet-weekly. In this
  30. case it is important that the RECENT file is not modified by the mail
  31. program you (or your provider) have. That is NO justification of lines,
  32. and NO line breaks for lines 80 char long. Otherwise you must manually
  33. restore the original format of the file...
  34.  
  35. The program doesn't work with the regular INDEX (found in pub/aminet),
  36. because it hasn't the age column. Use the file pub/aminet/info/index/INDEX
  37.  
  38.  
  39. USAGE
  40. *****
  41. Usage: MergeRec INDEXFILE/A,RECENTFILE/A,OUTPUT
  42.    
  43. INDEXFILE:  the local copy of an Aminet info/index/INDEX file.
  44.             WARNING: The regular INDEX file (pub/aminet/INDEX) will
  45.             NOT work! Use the file pub/aminet/info/index/INDEX because
  46.             it contains a 'weeks old' column.
  47.  
  48. RECENTFILE: an Aminet RECENT file, either downloaded from an Aminet Site
  49.             or received by e-mail from wuarchive listserver.
  50.    
  51. OUTPUT:     Filename of the new index file. If no filename is given,
  52.             standard output is used.
  53.  
  54. On an A1200 with 020/28MHz 4MB fast (Blizzard1220/4) it tooks about 90 sec
  55. to update the 1.7 MB INDEX (INDEX and OUTPUT on hard disk, RECENT in RAM:)
  56.  
  57.  
  58. SYSTEM REQUIREMENTS
  59. *******************
  60. Kickstart V37 (WorkBench 2.04) or higher.
  61.  
  62.  
  63. SUGGESTIONS
  64. ***********
  65. If you want to search the index without loading it in your editor (to
  66. save RAM), I suggest the use of FlashFind by Frank Würkner. It's VERY
  67. fast (about 10 times faster than "search").
  68. If you add an alias like this: 
  69.  
  70.    alias af "flashfind work:docs/lists/aminetindex "
  71.  
  72. in the shell-startup, you can easily make a search from a shell by typing:
  73.  
  74.    af name
  75.  
  76. The FlashFind program can be found on Aminet (util/cli/FlashFind1.1.lha  11K)
  77. Thanks, Frank!
  78.  
  79.  
  80. AUTHOR
  81. ******
  82. This program is a modified version of the original "MergeRecent"
  83. program (Aminet: text/misc/MergeRecent.lha) written by Alex Tucker.
  84.  
  85. Rewritten (in AmigaE) and modified by Adriano De Minicis (mc4948@mclink.it)
  86. If you want to send me a nice postcard of your hometown, here is my address:
  87.  
  88.   Adriano De Minicis
  89.   Via Latisana, 37
  90.   33054 Lignano Sabbiadoro UD
  91.   Italy
  92.  
  93.  
  94. DISTRIBUTION
  95. ************
  96. MergeRec is FREEWARE. Permission is given to include this program in a
  97. public archive, CD-ROM or disk collections, providing that all parts of
  98. the original distribution are kept intact.
  99.  
  100.  
  101. DISCLAIMER
  102. **********
  103. This software comes with no warranty, either expressed or implied.  
  104. The author is in no way responsible for any damage or loss that may
  105. occur due to direct or indirect usage of this software.  Use this
  106. software entirely at your own risk.
  107.  
  108.  
  109. HISTORY
  110. *******
  111. 1.0  3-Dec-95  Bug-fix and C to E conversion of MergeRecent.
  112. 1.1  5-Dec-95  Added the CR stripping and pre-header skipping.
  113.