home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / SMK-TURBO-SORT.lha / docs / TurboSort.Doc
Encoding:
Text File  |  1996-01-06  |  6.6 KB  |  221 lines
  1.          .-----------------------------------------------------------.
  2.          |               /\                      /\       _/\_._/\_  |
  3.          |    _/\_______/  \  _/\_  _/\___ _/\__/  \___/\_|   |   |\ |
  4.          |  _/  _______/    \/    \/  __  \|   / __/  __  \_  |   || |
  5.          |  \______  \/     \/     \_ \/   \_     \   \____/__  __|| |
  6.          |  /     /   \_     \______/__     /__    \____     /  |\\| |
  7.          | /________  _/___  _/\____\_l_  _/\__\_  _\__\_  _/_  ||   |
  8.          | \________\/\____\/\\/        \/\\/    \/\_\   \/\__\/\|   |
  9.          |           \/     \/           \/       \/      \/   \/    |
  10.          `-------------------------------------------------------IfN-'
  11.  
  12.  
  13.                                  PRESENTS
  14.  
  15.  
  16.  
  17.              - -  -  -  --------------------.
  18.                                             |
  19.                                             |
  20. _:---:__                :---:               |
  21. \_    _/_____.___.______|__ |___________.   |
  22.  |   |   _   |   |   _    / __  \   _   |   |
  23.  |   |   \   |   |   \___/   /   \  |   |   `-------------------------.
  24.  |____    \______|____\ |________/______/                             |
  25.      |_____/[wHW]                                        _:---:__     |
  26. -  -  - -  -------------------+   ________________.______\_    _/__   |
  27.                               |   \_   ____   _   |   _    /  |   /   |
  28.                               |   / \___  \_  |   |   \___/   |   \   |
  29.                               | _/    _____/______|____\  |____    \_ |
  30.                               | \_____\                       |_____/ |
  31.                               `---------------------------------------'
  32.  
  33.  
  34.  
  35.                                       A
  36.  
  37.                           sOULtAKEr/sMK pRODUCTiON.
  38.  
  39.  
  40.  
  41. OVERViEW:
  42. ~~~~~~~~~
  43.  
  44.  1 - iNTRODUCTiON.................................SUM INFO ABOUT THE PROGRAM
  45.  2 - REQUiREMENTS..............................................WHAT YOU NEED
  46.  3 - iNSTALLATiON.................................................U KNOW IT!
  47.  4 - USAGE...........,.........................................HOW TO USE iT
  48.  5 - TECHNICAL iNFO...........................iF YOU WANNA KNOW HOW iT WORKS
  49.  6 - HOW TO REACH ME.......................FOR BUG REPORTS, SUGGESTiONS, ETC
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56. 1 - iNTRODUCTiON:
  57. ~~~~~~~~~~~~~~~~~
  58.  
  59. This is a very FAST sorting program. And may be very interesting for AREXX
  60. programmers. It is also very usefull in CLI. It shows how many lines are
  61. sorted and how many are in total etc. So you can see how long it will take.
  62.  
  63.  
  64.  
  65.  
  66. 2 - REQUiREMENTS:
  67. ~~~~~~~~~~~~~~~~~
  68.  
  69. To use this program you need:
  70.  
  71. AmigaDos 2.x+ (Maybe also on 1.3 ?? i haven't tested that!)
  72. The Standard libraries (Located in ROM)
  73.  
  74.  
  75.  
  76. 3 - iNSTALLATiON:
  77. ~~~~~~~~~~~~~~~~~
  78.  
  79. You have the following files:
  80.  
  81.  C/TurboSort                          - Mainprogram
  82.  C/TurboSort.info                     - Workbench icon (8 colors)
  83.  Docs/TurboSort.Doc                   - Documentation (this file)
  84.  Install.script                       - Installation script (Amigados)
  85.  
  86.  
  87. Novice users: type: Execute install.script
  88. ---------------------------------------------------[]
  89. Intermediate users: Execute install.script
  90. ---------------------------------------------------[]
  91. Expert users: Copy them to wherever you want (adviced: C: )
  92.               
  93.  
  94.  
  95.  
  96. 4 - USAGE:
  97. ~~~~~~~~~~
  98.  
  99.  
  100. This is the argument line:
  101.  
  102. LOADFILE/A,SAVEFILE/A,QUIET/S:
  103.  
  104.  
  105. - LOADFILE : Put here the filename to load and sort.
  106. - SAVEFILE : Put here the filename to save the sorted lines.
  107. - QUIET    : If you write this arg then there will be NO output at all (For
  108.              arexx/script coders.) This means ±2 times more speed!
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Example:
  115.  
  116. -----------------------------------------------[CUT HERE]
  117.  
  118. 7.Harddisk:E/Sources/System/TurboSort> turbosort dh0:list dh0:list.alpha
  119. TurboSort V1.0 Written by sOULtAKEr/sMOKEY.                                  
  120.                                                                              
  121. Please Wait While Loading: dh0:list.....Done                
  122. Please Wait While Sorting and Saving to: dh0:list.alpha.....
  123. 168 lines sorted and saved out of 168...Finished..                           
  124.                                                                              
  125. 7.Harddisk:E/Sources/System/TurboSort>
  126.  
  127. -----------------------------------------------[CUT HERE]
  128.  
  129. *NOTE*--START THiS UTiLS FROM THE CLi..!!!!--*NOTE*
  130.  
  131.  
  132.  
  133.  
  134. OR maybe in a arexx program:
  135.  
  136.  
  137. -----------------------------------------------[CUT HERE]
  138.  
  139. /* We will now sort a file */
  140.  
  141. Address Command ('c:turbosort dh0:list dh0:list.alpha QUIET')
  142.  
  143. /* And now we will copy the file blablablbaabab */
  144.  
  145. -----------------------------------------------[CUT HERE]
  146.  
  147.  
  148.  
  149.  
  150. 5 - TECHNiCAL iNFO
  151. ~~~~~~~~~~~~~~~~~~
  152.  
  153.  
  154. This program is written in E.
  155. Here are some statistics done on a plain a1200/020 2mb ram.
  156. It loads,sorts,saves 100 lines on a:
  157.  
  158. Harddisk: ±2 seconds (With Console output)
  159. Harddisk: less than 0.4 seconds (Without Console Output (QUIET))
  160.  
  161. DiskDrive: ±4 seconds (With Console Output)
  162. DiskDrive: ±3 seconds (Without Console Output (QUIET))
  163.  
  164. As you can see, the console output slows down the process a lot. Thats
  165. why i added the quiet option. But it is very usefull for arexx coders.
  166. Because they don't need the output.
  167.  
  168. This program uses asynchronous i/o routines for maximum speed.
  169. The sorting routine is called radix and is very fast, unlike quicksort or
  170. merge sort which use O(n * log n) methods this one uses a true O(n) method.
  171. Radixsort uses 256 buckets at each level to put the strings in.
  172.  
  173. (NOTE: For highest sorting speed, copy the file first to ram, or place
  174. the savefile in RAM: !)
  175.  
  176.  
  177.  
  178.  
  179. 6 - HOW TO REACH ME
  180. ~~~~~~~~~~~~~~~~~~~
  181.  
  182. You can reach me on ONE EIGHT SEVEN, numbers: +31-ELITE-KNOW!
  183.                                               +31-ELITE-KNOW!
  184.                                               +31-PRI-VA-TE!
  185.  
  186.  
  187. FAST GREETINGS GOTO:
  188.  
  189. RICK             - Are you ever going to get back?
  190. WHIRLWIND        - Resets suck don't they? :)
  191. APOLLO/RYL       - How about recoding attaatta?
  192. SVEN THE CREATOR - Yo dude! E rulez!
  193. TIB              - Where's that demo?
  194. JUNK             - This might be usefull!
  195. PITER            - Nice chats!
  196. MR.G             - How's da mod?
  197. ZIUTEK           - Autotrading rulez!
  198. FLOPPY ROBBY     - Does that MFC already work?
  199. CLOTUG           - Where are da uploads?
  200. [MEGA^FORTRESS]  - C Rulez!?
  201. RADAVI           - Nice meeting ya!
  202. ORLINGO          - yOU kNOW tHE sTILO!
  203.  
  204.  
  205. and all the other dudes i fucking sorry forgot: i'M sORRY!!
  206.  
  207.  
  208.  
  209.  
  210. SMoKeY BOARDS
  211. ~~~~~~~~~~~~~
  212. wONDERLANd  -  WHQ   +31-(0)70-317-6466
  213. PANDARVE    -  DHQ   +31-(0)57-08-4756
  214. COLD SLAM   -  DiST  +31-(0)57-507-1510
  215. SPAC!D      -  DiST  +31-(0)251-316-304
  216. DREAMLANDZ  -  DiST  +31-(0)79-342-7639
  217.  
  218.  
  219.  
  220. [<This was written by sOULtAKEr!>-------------------------------------------]
  221.