home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / pip20.lha / pip.doc next >
Encoding:
Text File  |  1992-08-20  |  5.2 KB  |  157 lines
  1.  
  2.                         Pip 2.0
  3. Written By Asher Feldman
  4.  
  5. What's Been Changed Since 1.0? (and why is this version 2.0?)
  6. --------------------------------------------------------------
  7.  
  8. I decided to make the big step to 2.0, as this is a complete re-write of
  9. 1.0, and not a single thing has been left alone. 2.0 now supports 
  10. commands of  unlimited length, and there is no longer the '-s' option, 
  11. it's now standard. 1.0 had a major timing bug, which would cause it to bomb 
  12. about 30% of the time. At first I planed just to fix it, but I ended up
  13. starting over from scratch. All bugs have been fixed (that I know of :-),
  14. and 2.0 runs perfectly under 1.3 and 2.04, on a 68000 to a 68040. 1.0 
  15. would sometimes crash under an 030.
  16.  
  17. So What Is It???
  18. ----------------
  19.  
  20. Pip allows you to easily pipe commands through each other, just as in Unix. 
  21. For example, you could type a program in hexidemal (with the type opt h 
  22. function) and have the output appear in more, or your favorite text reader. 
  23. The Amiga comes with a pipe facility, the pipe: device. But, to make use of 
  24. it, the user is required to enter multiple command lines, which is time 
  25. consuming. Pip is a "user friendly" pipe utility, that does all the hard work
  26. automaticly for you, making the process quick and easy, as it is in Unix. 
  27.  
  28. Note!
  29. -----
  30.  
  31. Pip requires the pipe: device be mounted. It is automaticly mounted in the
  32. default startup-sequence, so if you haven't changed that, don't worry.
  33.  
  34. Because of the nature of the pipe: Pip will NOT work with programs that 
  35. attempt to load file non-sequentially. This is not a bug with Pip, its 
  36. part of the Amiga OS. 
  37.  
  38. Usage 
  39. -----
  40.  
  41. Pip is relativly easy to use. The usage is
  42.  
  43.     Pip [command1] | [command2]
  44.  
  45. [command1] can be as long as you want, as can [command2] (1.0 limited you to 
  46. 5 words.) Note the '|' character is used to seperate the two commands. It is the 
  47. character above the '\' on your keyboard. Also, please note the spaces.
  48.     
  49.    [command1] is the program to be run
  50.    [command2] is the program [command1] will be piped to.
  51.  
  52. For example, if I wanted to read Pip in hexidemal, but have the output appear 
  53. in less, where I can move arround in two directions, and search for strings I 
  54. would enter :
  55.  
  56.    Pip type opt h pip | less
  57.  
  58. The output of type is then piped into less, instead of appearing in your
  59. shell.
  60.  
  61. Maybe I want to read Pip in hex mode, and then read Pip.doc. This would
  62. be done using:
  63.  
  64.     Pip type opt h pip | less pip.doc
  65.  
  66. This will give you pip.doc FIRST, and then Pip in hexademal in less.
  67.  
  68. If I wanted to see the entire contents of DH0: in less, where you can search 
  69. for files, or just browse, etc.. You would enter:
  70.  
  71.     Pip ls -lR dh0: | less
  72.  
  73. If you wanted the output to be able to appear in a file editor you could enter
  74. the following (Ed shall be used for this example, as it's standard)
  75.  
  76.     Pip -s ls -lR dh0: | ed
  77.  
  78. Note, that the -s option is required when <command2> expects the output in the
  79. form as a file (i.e. ram:file). If you are having trouble getting a program to
  80. recieve output, you should try using the -s option.
  81.  
  82. Ls is an excelent 2.0 only directory lister. With different programs, the
  83. context will be diferent. 
  84.  
  85. Pip works well with egrep, a clone of the unix grep command from the 
  86. GNU project. It's available on Portal. If I wanted to information on a 
  87. task called test, I could do the following :
  88.  
  89.     Pip ps | egrep test
  90.  
  91. The ps command is part of a pd package called JM, which is 2.0 only. 
  92. It lists all currently running tasks (not just the ones run from a CLI, 
  93. like the AmigaDos status command) and gives you some information on them,
  94. such as the task number, and cpu usage.
  95.  
  96.  
  97.                                  *     *     *
  98.  
  99.  
  100. Limitations/Bugs
  101. ----------------
  102.  
  103. All the limitations from 1.0 have been removed, and all known bugs have
  104. been fixed. If you have any trouble, please contact me at one of the 
  105. adresses below.
  106.  
  107. How To Contact Me
  108. -----------------
  109. Send bug reports/comments, etc.. to:
  110.  
  111. PORTAL: Wizard0
  112. INTERNET: asher@netcom.netcom.com
  113.           Wizard0@cup.portal.com
  114.  
  115. US Snail:
  116.  
  117.    Asher Feldman
  118.    4791 Calle de Tosca             Phone:  (408) 266-7917
  119.    San Jose, CA 95118
  120.  
  121. This program is shareware, and is (C)1992 by Asher Feldman. 
  122. If you find it useful, and would like to help out a poor high
  123. school student (as well as a die-hard Amiga user!) then I would greatly
  124. appreciate it if you sent a small amount of money, or maybe a nice euro
  125. demo to the address above.  I would be even MORE grateful if you sent me a
  126. 1.2GIG hard drive or a v.32bis modem! :-)
  127.  
  128. And Now For The Legal Claptrap
  129. -------------------------------
  130. If this program causes your computer to blow up, or your hard drive to
  131. implode, or anything else that isn't too nice, then it's your fault, not
  132. mine.  This program is not "guaranteed" to do anything. (although if it
  133. doesn't, please send me (E)mail!)
  134.  
  135. This program may be freely distributed on bbs', networks such as Portal,
  136. and by PD disk librarys, as long as they don't charge too much (more than 
  137. $5US) or try to copyright the material they distribute.
  138.  
  139.  
  140. And remember:
  141.  
  142.  
  143.  
  144.  ONLY  _   C_o m m o d o_r_e   _
  145.       /\\  l\\   /l ll //  \  /\\
  146.      /  \\ l \\ /ll ll(< __  /  \\    MAKES IT POSSIBLE!!!!
  147.     /--- \\l  \X ll ll \\_ll/--- \\
  148.    /______________________________\\
  149.  
  150.  
  151.                                                  A.F.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.