home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 4 / AACD04.ISO / AACD / Online / Upd8 / Upd8.readme < prev    next >
Text File  |  1999-11-17  |  12KB  |  278 lines
  1. Short:    Reports updated webpages. v.1.2
  2. Author:   carl.licke@swipnet.se (Carl Licke)
  3. Uploader: carl.licke@swipnet.se (Carl Licke)
  4. Version:  1.2
  5. Type:     comm/www
  6. Replaces: comm/www/upd8*
  7. Requires: tritonrexx.library, rxsocket.library
  8.  
  9.  
  10.  
  11. Upd8 v.1.2 (visitware) by Carl Licke / Turbid design
  12.  
  13. This release should fix the 'openurl.library' problem, but to use
  14. this (optional) library you also need to install 'rmh.library'.
  15.  
  16. History with latest changes can be found at the bottom of this text.
  17.  
  18. I found the new, similar software called GuardAmy on Aminet which
  19. seems to be, ehum, pretty good! As a result I got rid of my lazyness
  20. and uploaded this new version of Upd8 which have been around half
  21. ready for some time, instead of wasting it. I think Upd8 still has
  22. some good points so I will continue my support if someone likes it
  23. as an alternative, so please tell me if this is the case with you!
  24.  
  25.  
  26.  
  27. introduction
  28. ------------
  29. Are you always browsing the web to check if your favourite webpages
  30. are updated? Then this software is for you! It checks all the pages
  31. on your configured list, and reports all updated pages it finds!
  32.  
  33. Additionally it has a nice interface with progressbar etc. and it can
  34. show the webpages using your favourite browser or using the internal
  35. (primitive) HTML viewer!
  36.  
  37. This software is visitware!
  38. If you use it, you have to visit my website and have a look around:
  39. http://home.swipnet.se/turbid/
  40.  
  41. Electronic mail is always appreciated:
  42. carl.licke@swipnet.se
  43.  
  44. Use this software at your own risk! ARexx source included!
  45.  
  46.  
  47.  
  48. installation
  49. ------------
  50. 1 Copy the icon and program wherever you want them.
  51.   Upd8 saves it's prefs and listfiles in the directory where it's
  52.   stored so an own directory is preferable.
  53.  
  54. 2 Make sure you have 'tritonrexx.library' and 'rxsocket.library'
  55.   in your 'Libs:' directory! If you don't have them you will have
  56.   to install them yourself, they can be found on Aminet.
  57.  
  58.   And don't forget to install the 'triton.library' which comes
  59.   with the 'tritonrexx.library' package!
  60.  
  61.   Optionally install 'openurl.library' together with 'rmh.library'
  62.   for better browser support, and the full Triton package for better
  63.   GUI support (save window positions etc.)!
  64.  
  65.   Find links to the latest versions of these libraries here:
  66.   http://home.swipnet.se/turbid/software_amiga.html
  67.  
  68. (You must also have your 'SYS:System/RexxMast' started, which many
  69. Amigas already have.)
  70.  
  71.  
  72.  
  73. usage
  74. -----
  75. * some great uses for this program:
  76. - All those newspages that never change.
  77. - All your favourite pages that you otherwise MUST check every day.
  78. - To detect new Aminet uploads!
  79. - Detect updates of binary files! Aminet can be reached through HTTP.
  80. - Got any more special uses?
  81.  
  82. The basic operation might be pretty self explanatory, byt here is
  83. a documentation of all gadgets and stuff.
  84.  
  85. * main window gadgets:
  86. - locations:
  87.   The list of locations to keep track of. To the left of each entry
  88.   is the methods of verifying written in parenthesis. Doubleclicking on
  89.   an entry will mark it, so will pressing the space key.
  90.   The marked entries have '>' written before them.
  91.   You can move the selector with the arrow keys.
  92. - updated locations:
  93.   A list which displays the updated locations found. Doubleclicking on
  94.   an entry will show information about it.
  95.   You can move the selector with the number pad keys.
  96. - verify       : Check if the selected location is updated.
  97. - new          : Add a new location to your list.
  98. - delete       : Remove the selected location from your list.
  99. - edit         : Change some data of the selected location.
  100. - data         : Show some data of the selected location.
  101. - browse:
  102.   Upd8 searches for any started browser it recognizes.
  103.   If it doesn't find any active browser, it starts the one you configured.
  104.   After that the selected location is loaded into your browser.
  105.   This procedure is done, better, by 'openurl.library' if installed.
  106. - show:
  107.   View the selected location with the internal viewer. This function
  108.   is here mainly to see if Upd8 gets the right page. But it can also
  109.   be used for normal viewing. It shows the separate viewing URL if
  110.   available, so you will have to cut and paste to test the normal URL.
  111.   Links and images are displayed like {link text} and [image description].
  112. - (textfield)  : A status and message field.
  113. - (progressbar): Fills as the locations are verified.
  114. - forget       : Remove this entry from the updated locations list.
  115. - verify all   : Verify all your locations for updates.
  116. - verify marked:
  117.   Verify your marked locations for updates.
  118.   For this and verify all, a window will list all failures at once,
  119.   if 'continue on error' is selected in prefs (default).
  120.   This window can be open simultaneously with the main window.
  121.   On verify all/marked the locations which fails will be marked
  122.   and the ones which succeed will be unmarked.
  123.   This will help you to retry.
  124. - import BookCon:
  125.   Choose a BookCon text file to import locations from.
  126.   BookCon is a free program available on AmiNet which converts
  127.   bookmark files between different formats. Upd8 can import the
  128.   format called plain text.
  129. - prefs        : Open the preferences window.
  130. - quit         : Quit program. Also saves the list if changed.
  131.  
  132. * prefs window gadgets:
  133. - verify all at start: Verify all location when starting Upd8.
  134. - continue on error:
  135.   Do not interrupt the checking of multiple entries on error,
  136.   instead report all failures when done.
  137. - notify when ready:
  138.   Notify with requester when multiple locations have been verified.
  139. - mark imported      : Mark the locations which are imported.
  140. - browser path       : Path of the browser to start if needed.
  141. - viewer textwidth   : Width of the text in the show window.
  142. - transfer timeout   : Timeout for data transfers.
  143. - size threshold:
  144.   If a location is verified by size, the change of size has to
  145.   be greater than this value to be reported as updated.
  146.  
  147. * verification methods:
  148. - (date): The best method which uses the date sent by the server
  149.           to see if the location is updated.
  150. - (size): If the server does not send any date, Upd8 compares the
  151.           new size of the location to the last size.
  152.           This can also be done quick if the server tells the new
  153.           size to Upd8. If this is not the case, Upd8 has to
  154.           download the whole location to see how long it is.
  155.           The last case is often much slower.
  156.           Needless to say, the methods based on size data is less
  157.           reliable as the updated page could have the same size.
  158. - (fsze): If the server tells a false date, like GeoCities which
  159.           always sends the current date, this method can be turned
  160.           on when adding or editing a location. The force size
  161.           method always verifies the size even if date is available.
  162.           If you choose this in 'edit', the first verification
  163.           directly after this will never detect an update.
  164.           So you might want to verify directly after the change.
  165. - (????): This location has not been verified and the method to be
  166.           used is unknown. The first time this location is verified,
  167.           it will not show up as updated, because it has no previous
  168.           data to compare with.
  169.  
  170.  
  171.  
  172. problems and solutions
  173. ----------------------
  174. * Unable to browse URLs which have the character '=' in them.
  175.   This is probably because of some parsing or something somewhere.
  176.   To cure this, put doublequotes on %u everywhere in OpenURL config
  177.   ("%u"). This helps all software using 'upenurl.library'.
  178.  
  179. * If the program won't start, make sure you have all the required
  180.   libraries (see 'installation').
  181.  
  182. * If you still have problems you can turn on the debug output. Just
  183.   change the tooltype named 'console' from 'NIL:' to 'CON:'.
  184.   If the output is interesting, please report it!
  185.  
  186. * It is possible that Upd8 reports false updates even in date mode.
  187.   This happens when the webmaster uploads without any changes made.
  188.  
  189. * When adding a webpage which uses frames, be sure to use the URL
  190.   of the particular frame you wish to keep track of. The URL for
  191.   separate frames can often be found in the menu frame, if one is
  192.   available. To verify if you got the right URL, type it in your
  193.   browser or view it with the show function of Upd8.
  194.   If only the right page with no frames comes up, it should be right.
  195.   You can set the 'separate viewing URL' to the main page with frames
  196.   though.
  197.  
  198. * If your URL works with your browser but not with Upd8:
  199. - Upd8 only supports HTTP, so your URL must start with 'http://'.
  200.   Upd8 automatically adds 'http://' if you do not enter it yourself, but
  201.   this is useless if you entered for example a FTP only server.
  202. - Feel free to e-mail non working URLs to me!
  203.  
  204. * Please report found problems and/or solutions!
  205.  
  206.  
  207.  
  208. future
  209. ------
  210. * Multiple connections. (I who thought I wouldn't need to do this,
  211.   but the competition forced it :-))
  212. * Abort button for 'verify all' and 'verify'.
  213. * Fill in the fields for a new location automatically from the
  214.   page which is currently opened in your browser.
  215.   Well, wonder where I got that idea :-)
  216. * Possibility to disable a location, the '----' method or something...
  217. * Maybe not list double updates of one page?
  218. * Maybe use checksum for size verified pages (and date verified?).
  219. * More individual settings for every location.
  220. * Possibility to sort locations automatically or with up/down buttons.
  221. * Option to get name from the title of the real page (HTML).
  222. * Porting to C, E or some other nice language.
  223. * Maybe an ARexx port (not in the same sense as above!) if someone
  224.   finds this useful.
  225. * Support for authorization and other technical network features.
  226.   Only on request, or if I'm very nice some day!
  227. * Smarter progress indication for 'verify marked'.
  228. * Please suggest and give comments!
  229.  
  230.  
  231.  
  232. bugs/limitations
  233. ----------------
  234. * There were problems reported with the main window not being updated
  235.   and continuos CPU load when activating it, if I understood correctly.
  236.   Please report if you encounter these problems, because I don't!
  237. * Please report found bugs and/or solutions!
  238.  
  239.  
  240.  
  241. thanks to
  242. ---------
  243. Alfonso Ranieri for 'rxsocket.library'!
  244. Jürgen Kohrmeyer for 'tritonrexx.library'!
  245. Troels Walsted Hansen for 'openurl.library'!
  246.  
  247. And in no particular order to Jan-willem van Eys, Jerome Chesnot,
  248. Petra Struck, Matti Tiainen, Bo Arnholm, Stuart Tomlinson, Ron Jensen,
  249. Rolf Kleiber, Michael Jaccoud, Stephen, Radek Machacek, and Robert Kihl
  250. (and some other people whos names I lost together with my e-mails) who
  251. mailed me with suggestions, code, help and encouragement!
  252. BTW, excuse me for my lazyness ;-)
  253.  
  254.  
  255.  
  256. history
  257. -------
  258. 1.2  : Fixed problem with 'openurl.library'.
  259.        'rmh.library' is now needed to enjoy 'openurl.library'.
  260.  
  261. 1.1  : You can now select multiple locations to verify at once.
  262.        OpenURL.library supported.
  263.        Continue on error option with smart retry!
  264.        Separate viewing URL for framed sites etc..
  265.        You can now enter URLs longer than 64 characters (512 :-)).
  266.        The '=' in URL problem solved (see 'problems and solutions').
  267.        You can force Upd8 to use the size method on a location.
  268.        Importing of BookCon plain text files is possible.
  269.        Full keyboard control everywhere.
  270.        Some improvements to HTTP code (no cached pages etc.).
  271.        Some other improvements and GUI changes.
  272.  
  273. 1.0ß2: Major improvement. New GUI, new features, better HTTP code.
  274.        Note that the format of the listfile has changed.
  275.  
  276. 0.7  : Rather crappy code, but the basics are working.
  277.        ARexx (or other) source viewable in all following versions.
  278.