home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 2 / amigaformatcd02.iso / comms / netsoftware / tcphelp.lha / amitcphelper1.14 / Docsv1.14 < prev    next >
Encoding:
Text File  |  1995-07-20  |  15.3 KB  |  412 lines
  1.  
  2.                                        ####..............  .....   ............
  3.     #########                         ###.############# ..#####. .############..
  4.     #########                         ###.#  -######## .#######. .#  -##########.
  5.     #########                         ###.# -######## .##  -###. .# -############.
  6.    ###########                         ##.#-######## .## ####### .#-#############.
  7.    ###########                           .########## .# -####### .######...#######.
  8.    ###########    #####  ##### ####   ####....##### .##-#####... .######.  .######.
  9.   #############   ##################  #####  .##### .#######.    .######.  .#-####.
  10.   ###### ######   ################### #####  .##### .######.     .######...## ####.
  11.   ###### ######   ################### #####  .##### .######.     .#########- -###.
  12.  ####### #######  #####  #####  ##### #####  .##### .######.     .########- #####.
  13.  ######   ######  #####  #####  ##### #####  .##### .######.     .##############.
  14.  ######   ######  #####  #####  ##### #####  .##### .#######.    .############..
  15. ################# #####  #####  ##### #####  .##### .########... .######......
  16. ################# #####  #####  ##### #####  .###### .########## .######.
  17. ################# #####  #####  ##### #####  .###### .########## .######.
  18. ################# #####  #####  ##### #####  .######. .########. .######.
  19. ######     ###### #####  #####  ##### #####  .######.  .#######. .######.
  20. ######     ###### #####  #####  ##### #####  .######.   ..#####. .######.
  21.                                                ......      ......  ......
  22.  
  23.  
  24.  
  25.                                         #    #       #
  26.                                         #    #       #
  27.                                         #    #  ###  # # ##   ###  # ##
  28.                                         ###### #   # # ##  # #   # ##
  29.                                #####    #    # ##### # #   # ##### #       #####
  30.                                         #    # #     # #   # #     #
  31.                                         #    # #   # # ##  # #   # #
  32.                                         #    #  ###  # # ##   ###  #
  33.                                                        #
  34.                                                        #
  35.                          - Version 1.14 20.VII.95 -
  36.                                By Ben Vost
  37.  
  38.  
  39.  
  40. This is just a little gizmo to work with the Demon AmiTCP
  41. installation. It possibly won't cope with any other AmiTCP setup but
  42. you can try. To start with it needs a script called "startnet" in
  43. Amitcp:bin/. You can set the tooltypes to reflect the programs you
  44. want to use for linking, ftp, mail, news, etc.
  45.    
  46. It was written using a mixture of CanDo 2.0 and 3.0 and requires the
  47. supplied cando.library (in libs:).
  48.  
  49. Unfortunately, any errors in location or setup just result in the
  50. program not running at all, with no explanation for what went wrong.
  51. Make sure that you have Rexxc in your path, or copy the "RX" program
  52. from Rexxc into C:.
  53.  
  54.  
  55. Requirements
  56. ------------
  57.  
  58. As far as I know it should run on any Amiga with an AmiTCP
  59. installation (and possibly a Demon account :)). I have tested on an
  60. Amiga 3000 and 3000T running WB3.1 and also an A4000/040 running
  61. WB3.0. I don't think that there is a reason why it shouldn't run on
  62. an earlier operating system, but you do need ARexx. To use the
  63. GetNews button you must have the script "NNTPTransfer" in AmiTCP:bin.
  64. The provided nntptransfer script has a couple of alterations to the
  65. one provided by DIS, namely paths for all the commands and an
  66. automatic retry if News is busy (thanks Tez (Tez@tezboyes.demon.co.uk)).
  67.  
  68.  
  69. Installation
  70. ------------
  71.  
  72. This part's really tricky so pay attention.
  73.  
  74. Copy AmiTCPHelper anywhere you like. :)
  75.  
  76. (Seriously, do check that the tooltypes agree with your set up and
  77. that the supplied nntptransfer script is in AmiTCP:bin. You might
  78. also want to put AmiTCPHelper in your Downloads: directory as I don't
  79. seem to be able to set a default directory for FTPing at the moment.
  80. You can always "Leave Out" the icon for AmiTCPHelper if you are
  81. worried about starting it.)
  82.  
  83.  
  84. Buttons
  85. -------
  86.  
  87. The buttons do what they say they do. If you have entered NONE for
  88. some of the tooltypes then the relevant button will be disabled in
  89. AmiTCPHelper.
  90.  
  91. The Mail button changed in version 1.07 to account for multiple
  92. mailboxes. The problem with the unfriendly mailboxes has been sorted
  93. out in version 1.11 (thanks to Ben Scott) and now the mailbox names
  94. are presented in the requester's button as they should be.
  95.  
  96.  
  97. Ping, Finger, Clock & Telnet
  98. ----------------------------
  99.  
  100. Just type in the name of whomever you want to ping or finger and hit
  101. return. Clock works the same way and will save the resulting time.
  102. AmiTCPHelper will pop up a window with the relevant details. I have
  103. finally added Telnet to AmiTCPHelper, it's not that it was difficult
  104. to do, it's just that I never use it, so I didn't put it in. But then
  105. again, I hardly ever use Gopher, but I put that in, so there you go
  106. :þ
  107.  
  108. Telnet works the same way that all the other field-based tools in
  109. AmiTCPHelper do, just type in where you want to go. You can include
  110. the port name as well.
  111.  
  112.  
  113. Newsgroups
  114. ----------
  115.  
  116. This window will list any newsgroup configs you have. You can
  117. double-click on an entry to make it the current "NewsGroups" file.
  118. Newsgroup files should be named "newsgroups.what_you_like" and put in
  119. where newsroups normally go, your Amitcp:usr/lib directory. This is
  120. where AmiTCPHelper will look for them. You might want to make a
  121. newsgroups.std list containing your standard config so that you can
  122. have a variety of newsgroup setup but still be able to return to your
  123. normal newsgroups when you need to.
  124.  
  125.  
  126. Tooltypes and their meanings:
  127. -----------------------------
  128.  
  129. If you enter NONE for the tooltypes for FTP, Mail, Gopher, WWW, IRC or
  130. HList, then AmiTCPHelper will disable the appropriate button. (HList
  131. doesn't have a button but it won't be looked for when a web browser
  132. is loaded.)
  133.  
  134. WindowX        Gives the final x position of the AmiTCP helper on
  135.         the screen.
  136.  
  137. WindowY        Gives the final y position of the AmiTCP helper on
  138.         the screen.
  139.  
  140. DONOTWAIT    Standard commodity stuff if you want AmiTCPHelper in
  141.         your WBStartup drawer.
  142.  
  143. FTP        Put the path and name of your favourite FTP tool here.
  144.         Possibilities would include "AmiTCP:bin/mftp" or
  145.         "Comms:AmiTCP/ftp", etc. (No quotes are needed). I
  146.         have tested it with both of these and ncftp.
  147.  
  148. Mail        As for FTP. It has been tested with Elm. It doesn't
  149.         work with Mail since v1.07, but I forgot to change
  150.         the docs to reflect this, so sue me :)
  151.  
  152. WWW        As for FTP. Well, it's been tested with AMosaic, but
  153.         if there is a secret Netscape clone for the Amiga
  154.         that I could test it with, will someone PLEASE let me
  155.         know? :)
  156.  
  157. Gopher        As for FTP. Tested with Graham's AmigaGuide-based
  158.         Gopher.
  159.  
  160. AmiTCPhome    This is the home directory for AmiTCP. Make sure you
  161.         include    trailing "/" or ":", ie. "Data:AmiTCP/".
  162.  
  163. Editor        This is the editor you will run when editing your
  164.         config in the menus. Put the complete path and name
  165.         of the program. To be able to edit the files it says
  166.         it can they have to be in the AmiTCP:db and
  167.         AmiTCP:usr/lib directories. Tested with TurboText and
  168.         one of my users says it also works with GoldEd.
  169.  
  170. Link        This is your *ARexx* link script. AmiTCPHelper
  171.         automatically looks for this script in your
  172.         AmiTCPHome bin directory. Tested with "Link" and
  173.         phil's (phil@curve.demon.co.uk) "PLink".
  174.  
  175. LinkOpts    The options for linking up. You should at least give
  176.         "up" as an option, but you can also put "up news" or
  177.         any other commands that your link script supports.
  178.  
  179. HList        As for FTP. This is the Hotlist program for Mosaic.
  180.         There is only one as far as I know and it becomes
  181.         slightly obsolete now that AMosaic 2 (1.4ß) is
  182.         available although I still prefer it to the built-in
  183.         hotlist.
  184.  
  185. Ping        As for FTP. This is your Ping command.
  186.  
  187. Finger        As for FTP. This is the command you should use for
  188.         finger (oo-err).
  189.  
  190. Clock        As for FTP. This is the clock command you are going
  191.         to use. So far I have only tested it with Syncro.
  192.  
  193. IRC        As for FTP. Enter the name of your IRC client.
  194.         Remember to include the path. Tested with Grapevine.
  195.  
  196. Telnet        Your telnet application. It works with Telnet_VGOODER
  197.         from Demon and should work with most if not all of
  198.         the others.
  199.  
  200. Startnet    This tooltype determines whether you want the
  201.         startnet script executed by AmiTCPHelper or in your
  202.         user-startup. Enter yes for yes and no for no (quel
  203.         surprise!).
  204.  
  205. WinSize        WinSize sets the size for the output window that
  206.         AmiTCPHelper produces. It should consist of four
  207.         numbers separated by /. For instance:- 0/0/400/200.
  208.         This will open the window in the top left hand corner
  209.         of the screen which will be 400 pixels wide and 200
  210.         pixels high.
  211.      
  212.      
  213. Menus:
  214. ------
  215.  
  216. Project Menu
  217.  
  218. About        This shows you what version of AmiTCPHelper you are
  219.         running and my name and email address. If you
  220.         register this is where your personalisation will
  221.         appear.
  222.  
  223. About CanDo    This gives some information about CanDo v3.
  224.  
  225. Quit        Surprisingly enough, this actually quits out of
  226.         AmiTCPHelper.
  227.  
  228.  
  229.  
  230. Edit Menu
  231.  
  232. Aliases        Hmm, God knows what this does...
  233.  
  234. Config        This lets you edit your AmiTCP:usr/lib/config file.
  235.         I'm not really sure if this is any use at all...
  236.  
  237. DialScript    Lets you edit that dialscript...
  238.  
  239.  
  240. NewsGroups    Surprise, surpise, surprise... This lets you edit your
  241.         newsgroups. Remember kiddies, the number after the
  242.         newsgroup is how many days to keep news for before it
  243.         gets trimmed.
  244.  
  245. NewsStamp    Lets you edit the newsstamp so you aren't on the
  246.         blower downloading all night... :)
  247.  
  248. Startnet    Lets you edit the startnet script. Changes made will
  249.         obviously not work until you re-run the startnet
  250.         script.
  251.  
  252. .signature    Duh, not sure really...
  253.  
  254.  
  255. To Do List:
  256. -----------
  257.  
  258. Sort out the default directory for downloading.
  259.  
  260. Amigaguide documentation. (Like it really needs it! :) )
  261.  
  262. Add a newsgroups editor that grabs the new newsgroups list from
  263. nntptransfer, and also lets you browse an "active" list. Done! It's a
  264. separate program called GroupEditor, downloadable from an Aminet site
  265. near you (comm/tcp).
  266.  
  267. Not sure of anything else, really. Any suggestions?
  268.  
  269. How many people would object if I switched back to eight colour buttons,
  270. à la MUI? I don't really want to put in a four colour page and an
  271. eight colour page as this will double up the size of the executable
  272. and mean extra work for me if anything needs changing.
  273.  
  274.  
  275. Legal Stuff:
  276. ------------
  277.  
  278.  
  279. Disclaimer
  280. ==========
  281.  
  282.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  283. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  284. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
  285. WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  286. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  287. A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
  288. PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  289. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
  290. CORRECTION.
  291.  
  292.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  293. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  294. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  295. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  296. DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
  297. (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  298. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE
  299. OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
  300. HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  301. DAMAGES.
  302.  
  303.  
  304. AmiTCPHelper is not Public Domain and is © Ben Vost 1995. If you
  305. register with me for £10, I will ensure that you receive all
  306. upgrades, until further notice, via EMail automatically. I can also
  307. configure AmiTCPHelper to your tastes, changing the Ping, Finger,
  308. Telnet and Clock default addresses, things like that. I can also
  309. reinstate the much nicer eight-colour buttons. If you do not have an
  310. EMail facility, I'm not sure what I will do (and why are you using my
  311. program?!), but contact me at the following address:
  312.  
  313. EMail:    Ben@subway.demon.co.uk
  314.  
  315. SMail:  Ben Vost
  316.     124 Bank Street
  317.     Macclesfield
  318.     Cheshire SK11 7AR
  319.  
  320. Tel:     01625 730741
  321.  
  322. History
  323. -------
  324.  
  325. v1.14    There was no version 1.13 but only because I don't like to
  326.     tempt fate :) v1.14 sees the addition of the Mailqueue clone
  327.     to the AmiTCPHelper window. At the moment this checks
  328.     uuspool: every five seconds to see if there is new mail or if
  329.     mail has been sent. It creates a text file in T: called
  330.     SpoolList, so if you find your DOpus constantly rereading T:
  331.     that is the reason. 
  332.     Changed the About menu item back to the standard one, the one
  333.     in v1.12 was only for registered users.
  334.     Rewrote some of the documentation to stop it seeming so
  335.     dated.
  336.     Changed the way the mailboxes were checked and now the
  337.     requester will change dynamically if mailboxes are deleted.
  338.     In previous versions you had to restart AmiTCPHelper to see
  339.     any changes. The names in the requester are also now in
  340.     alphabetical order.
  341.     Internal simplification. I got rid of a couple of tooltypes
  342.     that didn't do anything along with their mentions in the
  343.     scripts.
  344.     
  345. v1.12    Yet another rejig of the buttons as the Prefs and Read News
  346.     buttons have been removed. Not sure if I like the new layout
  347.     so it might get changed yet again...
  348.     I've added a DOSNotify event to check to see if a new mailbox
  349.     has been added when mail is received. Previously, the only
  350.     time AmiTCPHelper checked for the names of the mailboxes was
  351.     at startup.
  352.     One internal change with regard to how registered owners are
  353.     dealt with...
  354.     Dumped the Prefs page as being beyond my capabilities and
  355.     also a bit pointless.
  356.  
  357. v1.11    Changed the nasty mailbox requester to something a bit more
  358.     standard.
  359.     Removed the Newsgroups backup option at startup.
  360.     Added a tooltype to allow AmiTCPHelper's output window to be
  361.     sized and positioned where desired.
  362.     
  363. v1.10    Added Telnet support (for completeness sake).
  364.     Added a new eight-colour (and four-colour) icon that freely
  365.     plagiarises the Xen style :)
  366.     More internal wrangling going on for the prefs page which
  367.     should be complete soon (maybe v1.12).
  368.     Added Startnet tooltype.
  369.  
  370. v1.09    Added startnet script editing in the Edit menu.
  371.     Added IRC and Prefs buttons to the interface which has been
  372.     jiggled to fit the new buttons in without requiring more
  373.     space. The Prefs button doesn't work at the mo, but will
  374.     eventually let you edit TCP-related ENV variables and the
  375.     co-ordinates and size of the windows that AmiTCPHelper opens
  376.     amongst other things.
  377.  
  378. v1.08    The Get News button now works! Hurrah!
  379.  
  380. v1.07    Changes made to the way Mail is dealt implemented in this
  381.     version.
  382.  
  383. v1.06    General tidying up.
  384.     Internal changes to the way mail is dealt with.
  385.  
  386.  
  387. v1.051    Changed the buttons to four colour ones for the Amiga
  388.     Computing Cover disk.
  389.  
  390. v1.05    Made Mail detach when run from AmiTCPHelper.
  391.     Added the Clock function.
  392.     Took out the sound samples, they were taking up far too much
  393.     space. If anyone wants them back, I can put them in just for
  394.     you.
  395.     Changed the About message and added the CanDo about.
  396.     Fiddled about with Get News, it's still not quite ready, but
  397.     hopefully the next release should see that button enabled.
  398.     (No promises... :) )
  399.  
  400. v1.04    Added support for multiple newsgroups.
  401.  
  402. v1.03    Changed the shape of the window to make it easier to use Ping
  403.     and Finger.
  404.     Miscellaneous internal tidying up.
  405.  
  406. v1.02    Added support for Ping and Finger.
  407.  
  408. v1.01     Added support for user definable link command and options.
  409.     Added better support for AMHotlist.
  410.     Added Info menu item.
  411.  
  412. v1.0     First public release