QUICKVOY 0.35 ============= QuickVoy is a feature-laden and complex program that offers you many facilities. Whilst it is possible to not bother reading much of this document and just 'wing it' (which, I must admit, is usually my approach); I do strongly suggest you read this ENTIRE document. You'll maybe learn about a few useful things that are not turned on by default. It'll also help you know what QuickVoy can do, and what it is capable of. I have interleaved geeky stuff with the instructions. Doing that does make it a little harder for novice users; but saves a lot in duplicating instructions or cross-referencing stuff. The basic rule is if it gets geeky, whether it be a one-line comment on Wimp_PollIdle or a whole section on Wimp messages; simply skip over it. But, I can't say this enough. Please read this document. It will help. Before we start... ------------------ QuickVoy's Wimp slot is now 128K. Notice (and Quick-Start instructions): -------------------------------------- This is beta software. I want you to be fully aware that this carries certain implications, such as the possibility that it may go belly-up on your system, though it may work perfectly on others. That, obviously, is NOT how the script should go... so if QuickVoy forgets any of its lines then PLEASE send a bug report to support@heyrick.co.uk The use of this software, in particular the configuration of it, assumes that you have some knowledge of the internal workings of !Voyager. If you do not, it is recommended that you copy the "StdConfig" file as "Configure" and don't touch the settings . . . at all. Thus, the Quick-Start instructions: 1. Copy !QuickVoy onto your harddisc somewhere convenient. 2. Ensure !Voyager has been seen by the filer (open the directory that contains it). 3. Hold down Shift and double-click on !QuickVoy to open it. 4. Delete the file named "configure". 5. Copy the file named "stdconfig" as "configure". 6. Double-click on !QuickVoy. From then on, simply follow instructions 2 and 6 to start QuickVoy. You can now ignore the rest of this document if you want; but you'll miss out on some of QuickVoy's many features. EVEN BIGGER NOTICE: ------------------- THIS SOFTWARE IS NOT SUPPORTED BY ARGO INTERACTIVE This is an extension written by Richard Murray and supplied free to Argonet subscribers. If you have any queries or comments about this software, please DO NOT contact Argo. Instead, contact Richard Murray... Email: support@heyrick.co.uk Web : http://www.heyrick.co.uk/voyager/quickvoy/ Repeat again, for the hard of thinking: THIS IS NOT AN ARGO PRODUCT - DO NOT CONTACT ARGO FOR SUPPORT!!! Purpose: -------- On low memory machines (pre-RiscPC), try loading Voyager and FrescoJS and the 128bit SSL module. If you're lucky, you might have enough memory left to open a blank window! The dialler in Voyager is very sexy. It blinks, flashes, and does all sorts of cool things. Unfortunately, it consumes around 400K of memory. Which is almost half a meg. Which isn't really good. You CAN use a task like !RAMplify to swap out the dialler toolbar to free up some memory. But then you loose the functionality of the toolbar. Which, again, isn't really good. So I have created !QuickVoy. When run, it takes on the basic functionality of the Voyager toolbar. And uses a *lot* less memory. The current distribution requires only 128K (or a mimiscule 32K for small version). QuickVoy is physically tied to Voyager. It will not operate with other Internet suites or ISPs. Restrictions: ------------- 1. The toolbar only has one free application icon. In the supplied configuration, this is set to run WebLoad for you. It is disabled in the stdconfig file. If your normal regular toolbar has eighteen colourful icons; sorry. This one won't do that. You can access other VIX modules though. Bottom right, there is a little clicky thing labelled "Run VIX". This opens a menu with your VIX and VIXEN modules listed. Select a VIX to run it. Only the directory "!Voyager.VIX" is searched, and only VIXEN with run actions (ie, the type that can have icons for them) are listed. Some VIXEN are configuration-only (such as my NewsFudge), these are not listed. 2. If you use any VIXEN which plot to the toolbar; they won't work as neither text areas nor LEDs can be added to QuickVoy. An example here is LittleCost (by Christina West). In this case, it is not a problem as QuickVoy provides a counter/coster. But you get the idea. 3. All VIX event autorun information is ignored. If you want something to be run upon an event, then set it up in the configure file. 4. No pretty pictures! 5. No Auto-Connect. Phone bills in this country aren't free, and I deeply distrust automation when billing is involved. 6. No password option. If QuickVoy spots that a Voyager installation has been password protected, it will quit with an explanatory message. NEW FEATURES (from v0.32 to v0.33) ---------------------------------- * Various bug fixes (refer to "Versions" for the gory details!). * Save option on JPEG viewer. Why is it called QuickVoy, does it speed up connections? -------------------------------------------------------- Sorry, there is no Industrial Light And Magic (TM) available here. It is called "Quick" because it didn't take long to get the basics coded, and "Voy" because it is a dialler for Voyager. It is one of my more 'uninspired' titles. On the plus side, it uses less memory. Much less. So maybe it should be called "BabyVoy" or something. Does that baby in Ally McBeal have a name...? Having said that, users have reported a three or four second speed increase in connecting. Don't ask me though, QuickVoy simply calls the required bits of Voyager!!! Configuration: -------------- Configuration has been totally changed. Load QuickVoy, then click on the iconbar menu and open the "Preferences" submenu. Click "QuickVoy". A graphical dodah will open. From the QVConfig iconbar icon, choose "Help" if you need assistance. For those of you with special situations, or who don't trust automatic widgets, here follow the ORIGINAL details for configuring, the hard way... Okay. Breathe twice. Deeply. It isn't as bad as it looks. Well... Um... Look, it isn't. Okay? I promise. If all else fails, and you have a STANDARD as-boxed setup of Voyager, copy the file "StdConfig" as "Configure", and ignore the rest of this section. Configuration is a set of keywords with parameters in curly braces. There is one entity per line. Braces must be on a line on their own. There must be NO blank lines within the braces (use a ';' comment line instead). If there are ANY errors, QuickVoy will try to broadcast a ThrowBack message for each error. You'll need SrcEdit, Zap, or StrongEd in order to receive the messages. This all looks like a monumental pain in the ass, but it is actually quite simple; and if your setup is at all non-standard, I'm sure you'll appreciate the flexibility. To begin with, there are six icon settings. These are, by default, set up to match the Voyager toolbar; with the exception of the rightmost one which is a user definable icon. If you want, you can re-arrange the order and/or change them. If you never use FTP, you could set it up to run an IRC program or whatever. Icon zero is the connect/disconnect icon and its purpose cannot be altered. A definition looks like: --8<-------- ICON 6 { caption "user_1" run some.path.name } --8<-------- Within the braces there are several parameters: caption This is what appears on the clickable icon, and should be given in quotes. This MUST be specified. If it isn't, the icon will be blanked and shaded unselectable. run This is the file/application that will be Run when the icon is clicked on. This should be a sufficient path to uniquely specify the file. altrun This is the file/application that will be Run when the icon is clicked on whilst ALT is held down. This should be a sufficient path to uniquely specify the file. linkrun This specifies a filetype. If that filetype is dropped onto a QuickVoy window (or the iconbar icon), then the application set to run for this icon will be run. An example of this is the default icon one, which will start the web browser upon an HTML file (type &FAF) being dropped onto QuickVoy. This should be a hexadecimal number in the form "&xxx". ** THIS IS NOT CURRENTLY SUPPORTED ** watcher This points to a file to be watched for. If the file exists and is not empty, then the icon will be darkened. This is used to signal that news and/or mail are waiting. This is checked at startup and at disconnect. This should be a sufficient path to uniquely specify the file. nocondis If this keyword is present, the option will be disabled while NOT connected. This should be used for things which expect the stack to be loaded and running when they start (for example: ftp, telnet, timeservices, IRC, etc...). Following this are the GENERAL configuration settings: quitconfirm Either "Yes" or "No". If yes, you will be asked if you are sure you wish to disconnect when you choose to do so. If no, you won't be asked. callcoster Either "Yes" or "No". If yes, the time elapsed will also tell you the average price of your call as it is happening. modeminitto The number of seconds that QuickVoy will wait for an "OK" response from the modem during initialisation. ("to" = "timeout") Best left alone! connectto The number of seconds, from the time the Connect icon is clicked to timeout upon initialisation/authentication. Best left alone! The authentication timeout (between successful modem connection, and logging into your ISP) is fixed at 35 seconds. This should be more than sufficient, even for Pipex... stackloader Path to script file to initialise the stack. Best left alone! stackkiller Path to script file to unload the stack. Best left alone! newsrx Path to News fetcher, used when news RX icon is clicked on. Should be: .Apps.Transports.!NNTPFetch newstx Path to News sender, used when news TX icon is clicked on. Should be: .Apps.Transports.!NNTPSend mailrx Path to Mail fetcher, used when mail RX icon is clicked on. Should be: .Apps.Transports.!CalPOP3 or: .Apps.Transports.!POP3Fetch mailtx Path to Mail sender, used when mail TX icon is clicked on. Should be: .Apps.Transports.!SMTPSend tasknewsrx The taskname of the News fetcher, used to control the news RX icon. tasknewstx The taskname of the News sender, used to control the news TX icon. taskmailrx The taskname of the Mail fetcher, used to control the mail RX icon. taskmailtx The taskname of the Mail sender, used to control the mail TX icon. newsin The file to open from the menu-->open-->incoming-->news. This should be a full path to a file. mailin The file to open from the menu-->open-->incoming-->mail. This should be a full path to a file. newsout The file to open from the menu-->open-->outgoing-->news. This should be a full path to a DIRECTORY (not a file). mailout The file to open from the menu-->open-->outgoing-->mail. This should be a full path to a DIRECTORY (not a file). largecache Either "yes" or "no". This selects the web cache storage area size (largecache = 256K, default = 64K). Refer to the section on the Cache Scanner for further details. splash Either "yes" or "no". This allows you to permanently nuke the splash-screen electric whizzy thing. pollreturn This allows you to set the resolution of the pollidle return. It was originally "100", it is now "200". You can set it as you desire, but note three things: 1. This will affect ALL timer events, and call coster. 2. This may return earlier than the specified number of centi-seconds. 3. Read what "Wimp_PollIdle" does, exactly, in the PRMs or StrongHelp. Then you'll know if you should alter this setting at all... upontimer The number of MINUTES that should elapse between each timed event. Set this to zero to disable. A timed event causes the UPON TIMER script to be run after the specified period has elapsed. It will continue to be run every x minutes during the connection. This could be used to call a news or mail fetcher; or just to run the MbxWatch program. discontimer The number of MINUTES that should elapse before the connection warning opens. After this has opened, you will have one minute to close the window. If you do not close this window (by clicking the obvious icon), the connection will be terminated. Now come the CALLCOST settings: daymin Pence per minute, peak rate, EXCLUDING VAT. Previously, this was called "peakmin". QuickVoy will use either at this time, but you should alter this to "daymin". evemin Pence per minute, evening rate, EXCLUDING VAT. wendmin Pence per minute, weekend rate, EXCLUDING VAT. discount Percentage discount given. mincost Minimum call cost, in pence, EXCLUDING VAT. taxrate The rate of tax to be added. 0% if your VAT registered and can make a claim, 17.5% for the rest of us... timeshuffle The average amount of time that elapses between the call being answered, and the modems successfully connecting. Finally the events: UPON STARTUP UPON CONNECT UPON TIMER UPON DISCONNECT UPON QUIT These are obvious as to their intention. Within the braces, "run" commands (as decribed earlier) are available. Also you can use "boot" commands, if something requires booting but should not be run. By default: The icons are: Connect/disconnect Fresco (alt-click loads JavaScript Fresco) Posty email NewsAgent (alt-click loads NewsAgent without debatching) Telnet FTP WebLoad The settings are: Confirm to quit Iconbar icon and callcoster both active Modem timeouts are init 3, connect 60. DCD is checked roughly every five seconds. Disconnection is by DTR drop. The LEDs run the expected applications, with the exception of the MailRX which will run Calypso. Change this this "!POP3Fetch" if you don't have Cally. The call coster is set to standard BT rates, with a 5% KeyNumbers discount. Upon startup, !NewsAgent is booted. Upon connection, the following are run: Calypso (if you don't have this, change this to run "!POP3Fetch") News fetcher News sender Email sender Voyager auto upgrader QuickVoy self upgrader (not currently implemented, so has no effect) Upon timer, nothing is run. Upon disconnect, nothing is run. The CheckMail program is called from the stack shutdown script so it doesn't need to be specified here. Upon quit: The patch for the auto upgrader is called to check if an upgrade is ready. There is one command that can appear on its own: BOMBOUT Upon this, an error with the given message will be generated and QuickVoy will quit. This is implemented purely for the "Please check..." line; and for QVConfig to give you the option of standard use. It should go without saying that upon checking the Configuration file you should remove the first few lines, so it begins "; SETUP for QuickVoy". But I'll say it here so you are COMPLETELY sure. Okay? A suggestion: If you'd like another VIX icon for your use, you could amalgamate the telnet and ftp operations onto the same icon. Something like: --8<-------- ICON 4 { caption "telnet / ftp" run .Apps.Telnet.!Run altrun .Apps.FTP.!Run nocondis } ICON 5 { caption "your icon" run } --8<-------- You'd click SELECT to run telnet, and ADJUST to run ftp. How to use: ----------- Pretty much like the original Voyager toolbar, yeah? :-) Refer to the "mainwindow" DrawFile for a quick rundown of what does what. Please note: 1. The call coster icon is blank until a connection has commenced. 2. The icon marked "CountDown" will remain blank until you set up the CountDown patch (by Christina West). Please refer to the section entitled "CountDown" for further details. 3. When you click on "Disconnect", you will be asked to confirm your intention to disconnect (unless you have configured otherwise). Clicking MENU over this window will open a menu containing four options: Open -> [submenu] -------------- Phone bill Scan cache -------------- QuickMail User info Simple fetch Tidy hotlist -------------- Ping GetHost -------------- Help The "Open" submenu will open the incoming news and email files, and the outgoing news and email directories. Quickly, easily. If there is not enough memory to load the incoming file, you will be told how big the file is, hence how much memory you require (don't forget to add extra if a text editor needs to be loaded). The "Tidy hotlist" option will remove: * Local pages * Error pages (not found, error, not available, denied) * Search engines (altavista, yahoo, lycos) The tidy options are currently hardcoded into QuickVoy. The "Help" option will open this file. The remaining entries are described in the appropriate sections of this user guide: Phone bill -> Phone bill option Scan cache -> Cache scanner QuickMail -> QuickMail User info -> User Information Simple fetch -> Simple fetcher Ping -> PING and GETHOST GetHost -> PING and GETHOST The Small option ---------------- If you run "!RunSm", it will call the "!RunImgSm" version of the program. This is a highly stripped version of QuickVoy that will get you connected, but without any features. It uses an amazing 32K. You won't get smaller than that on an ARM 2/3 machine without resorting to module tasks written in pure assembler. :-) However, in order to do this, over 22K of code (compressed; 82K source) has been dumped leading to a decrease in functionality. Changes: * No VIX menu or VIX scanning * No call coster or phone bill generator * No cache scanner * No user information, mailbox watcher, or fetcher support * Terser messages * No reporting on errors (missing '{' etc) in script; use QuickVoy if you require checking. * Only 2048 bytes are allocated to the blockdriver code (spec requires 4096 bytes); the largest publically available driver fits, so 2K it is. * None of the extended features (QuickMail, JPEG viewer, etc...) But it still offers you: * Six user-defined icons with actions, alternate actions, and watch files. * Script based events. * Script based configuration. * Quick and easy access to incoming/outgoing news/mail. * Logging * Interfaces with CountDown * The usual supported Voyager messages; and many of the QuickVoy ones. * Quit and resume (!) * Call duration timer That weird orb thing -------------------- Okay, so I was bored one day. Thought I'd code a nifty splash window, rather than the boring "This is the program, here's a little icon" rubbish that you normally get. It is supposed to be one of those sparky glass things - you know, those plasma ball things that you can stick on the table and touch? It won't follow your mouse pointer. Sorry, but the original had better electricity and it *did* try to follow your pointer. But, it was kinda slow so I hacked the extras out. Maybe one day when I'm feeling masochistic I'll recode it in assembler. :-) If you want to not see it upon loading QuickVoy, then simply hold down ALT and CTRL while QuickVoy loads. If you don't want to see it ever again (sob! sob!) then edit the "splash" entry in the configuration file. It *does* induce a speed penalty. Despite the claims by certain people in comp.sys.acorn.advocacy (regarding VM and stuff), there is NO possible way, on a single processor machine, for it to do a whole load more stuff yet not take longer. It was a long and boring debate, forget about it. Anyway, it takes about twice as long with the splash active. The timings for v0.16 release code on my busy A5000 were: With : 8.36 seconds Without : 4.43 seconds I say all this, not to scare you off, but to let you know that it IS taking longer, and that you CAN revert back to the non-fancy-whizzy-thing method if you so choose. But hey, it's cool. :-) Where's the Log window? ----------------------- There isn't one. Look for the "windowlog" file within QuickVoy. This contains everything that is written to the log window, and is closed in between writes so you can access it at any time. The "windowlog" file is not cleared when you next load QuickVoy, so old log entries are available for you to browse through - useful in case of something going wrong. QuickVoy will give you a warning message if the file length exceeds 128K, so you can trim old entries or erase the lot if you prefer. You can access this file by clicking on the "View log" option in the iconbar menu. What's with the quit and resume? -------------------------------- Trying to quit QuickVoy while on-line will cause an warning message to be generated. However, you may quit QuickVoy while on-line if you hold down either ALT key and click the 'Quit' menu option. This is ONLY to be used in emergencies where you'll need every last bit of available memory. QuickVoy doesn't use a lot of memory, and if you quit it you will lose all functionality that it provides. Reloading QuickVoy will pick up on both the current connection and the start time of the connection (so the call timer/coster will be roughly correct). Providing that the correct settings are observed (DCD high and = "1", then QuickVoy will attempt to resume the connection. This may be useful if the Voyager dialler crashes (which isn't very usual, I'll grant you). If you enter at the command line: *Set VTi$LoggedOn 1 when the modem is on-line to Argonet, QuickVoy will resume from just about any dialler. However, this is mainly of interest to geeks as surely nobody in their right mind would connect using one dialler, then change to using another! :-) Resuming from a dialler other than QuickVoy will not provide the timebase value, so the call timer will begin from when QuickVoy resumes the connection. When a connection is resumed, QuickVoy will fire off the applications that are pre-destined to be invoked upon connection. Phone bill option ----------------- This option will create a file which is an itemisation of the calls to Argo laid out in a format similar to the BT telephone bill. For example: Breakdown of call charges - created Mon,01 Nov 1999.16:37:55 ------------------------------------------------------------ Cost before Date Time Destination Duration discount (£) ------ ----- -------------------- -------- ----- 6 Jul 23:27 Local Rate - Argonet 0:03:31 0.059 7 Jul 22:33 Local Rate - Argonet 0:03:58 0.067 8 Jul 14:54 Local Rate - Argonet 0:05:49 0.273 [snip!] 3 Oct 23:26 Local Rate - Argonet 0:01:35 0.041 4 Oct 19:08 Local Rate - Argonet 0:20:15 0.344 6 Oct 18:31 Local Rate - Argonet 0:02:05 0.041 ------ Cost £21.363 Discounts (at 20%) £ 4.272 VAT (at 17.5%) £ 2.990 ====== TOTAL £20.081 ====== The period shown covers a BT charging period. The figure, before discount, quoted on the bill is: Calls to 0845 0885336 before discounts - £26.354 Basically, a fiver's worth is missing. The most likely scenario for this is twofold: 1. The "Business Advantage" scheme offered a 11% discount prior to October, then 15% after. QuickVoy is set to give a 20% discount. (the other 5% is from the "Key Numbers" scheme) 2. Calls which cause the computer to crash will be recorded with no duration. These are, therefore, charged at the flat minimum rate. You may have been on-line during peak rate for three hours, however if it is not logged then there is no way of knowing. The call coster values in the configuration file should be specified without VAT. The values given in the default file, and repeated below, are correct as of 1st November 1999. Peak rate runs from 08:00 to 18:00, and is charged at 3.3 pence/minute (4p/min inc.) Evening rate runs from 18:00 to 08:00, and is charged at 1.2375 p/min (1.5p/min inc.) Weekend rate runs from midnight Friday to midnight Sunday and is charged at 0.825 pence/minute (1p/min inc.) The discounts vary depending on line type, options, etc. It is set to 20% which is a typical discount value. Remember, if Argo is covered by several schemes (such as Business Advantage and Key Numbers), your calls will be subject to an accumulative discount of all the schemes that apply to it. The minimum cost is 4.125 pence (5p inc.). VAT is applied at a flat rate of 17.5% in accordance with UK taxation. Therefore, for BT, the call cost settings will be: CALLCOST { peakmin 3.3 evemin 1.2375 wendmin 0.825 discount 20 mincost 4.125 timeshuffle 12 } (discount and timeshuffle depend upon your choices) Cache scanner ------------- A powerful feature to QuickVoy is a cache scanner, this will search through Fresco's cache and list everything contained within in a window. The window opens containing data such as: [icon] 02.14 http://www.heyrick.co.uk/ricksworld/index.html 5 Kbytes [icon] 02.15 http://www.heyrick.co.uk/assembler/index.html 3498 bytes [icon] 02.16 http://www.altavista.com/cgi-bin/query?pg=q&kŒ 17 Kbytes [icon] 02.17 http://www.argonet.co.uk/beta/downloads/JSinsŒ 487 Kbytes By default, all entries will be coloured black. However some may be coloured blue. In this case, the entry appears in the cache but does exist in real life. Entries in red are error messages, but you should not see any of these. You *MAY* see this "Reached end of list while scanning cache" error message if your cache contains less than four entries. In this case, you can ignore the message. Future versions of QuickVoy may suppress this message in this instance. Entries in dark green have been erased (they will say "deleted"). They still appear in the list as it was deemed quicker to flag them as having been deleted than to purge them entirely. If you wish to purge them yourself, close the cache list window and invoke the cache list again. You can double-click on an entry to open it. On a correctly configured system... HTML files . . opened in . . Fresco, WebsterXL, or Browse Archives . . opened in . . Spark or SparkFS GIFs/JPEGs . . opened in . . FYEO2 or ChangeFSI And so on. The files are opened using the Filer_Run method, so if you double-click on an entry with Shift held then it'll be opened in !Edit (or whatever). Clicking MENU will open a menu giving you three choices: Open Erase > The menu button, when clicked, will cause the cache entry under the pointer to become 'selected'. This has context with "Open" and several of the erase options. "Find" performs the obvious function. :-) You can search for any part of the URL text that is VISIBLE in the cache list window. For long URLs, the end is clipped, thus you cannot search for anything that has been clipped. A useful idea is to search mainly by domain name. "Open" is functionally equivalent to double-clicking on an item. "View" will load HTML files into !Edit, and show JPEG files via QuickVoy. "Erase" is altogether more interesting. The submenu looks like: .-------------------------------------. | Erase | |=====================================| | This file only | | - - - - - - - - - - - - - - - - - - | | All images | | All GIFs | | All JPEGs | | All images neither GIF nor JPEG | | - - - - - - - - - - - - - - - - - - | | All HTML | | All archived files | | All textual/document files | | - - - - - - - - - - - - - - - - - - | | All under 4K | | All over 32K | | - - - - - - - - - - - - - - - - - - | | Search engine (lycos, altavista...) | | All that call CGI scripts | | - - - - - - - - - - - - - - - - - - | | All ftp downloads | | - - - - - - - - - - - - - - - - - - | | All with no domain name | | All from this domain | '-------------------------------------' And what this means is: This file only Obvious! For the lazy - clicking on the parent "Erase >" option will have the effect of deleting the chosen file. All images All image files will be removed. This is both static image and movies. Specifically: * Clear &690 * GIF &695 * BMP &69C * Targa &69D * ARMovie &AE7 * DrawFile &AFF * PNG &B60 * XBitMap &B61 * MPEG &BF8 * JPEG &C85 * AVI &FB2 * Sprite &FF9 All GIFs Any GIF files. All JPEGs Any JPEG files. All images neither GIF nor JPEG As for the "All images" list, except GIFs and JPEGs will not be erased. All HTML All HTML (&FAF) files. All archived files All files that are archives. Specifically: * TAR &C46 * Archive &DDC * GZip &F89 The 'Archive' category is mapped in your MimeMap file to cover .zip, .arc, .spk, .lha, .arj, and .lzh). All textual/document files This deals with the main document types other than plain HTML. Specifically: * TeX &2A7 and &CE5 * LaTeX &2A8 * PDF &ADF * MSWord &AE6 * RTF &C32 * PostScript &FF5 * ASCII &FFF All under 4K All over 32K Obvious. Search engine (lycos, altavista...) String-matched against entries in the file '.Utilities.userdata.searcheng'. Lines beginning ';' are ignored. Other lines are taken as partial URLs to match. Case is converted to lowercase before comparison. All that call CGI scripts String-matched for URLs containing "/cgi". All ftp downloads Anything beginning with "ftp://". All with no domain name Some URLs, such as spam-related systems (invoked by fetching some sort of graphic) and pornographic sites, tend to refer to themselves as a numerical address rather than a textual address. For example: Textual: http://www.heyrick.co.uk/ Numeric: http://193.133.95.172/ The latter address is Woking Library. I presume that Surrey CC decided that, as the libraries were indexed from the Surrey site, it was not worth the expense of registering some URL like www.wokinglibrary.gov.uk (which is a pain in the butt for me, as I'm interested in looking up books and not interested in the other Surrey stuff...). Anyway, enough about that. This option will look for a URL in the form: ://.../ and remove any it finds. All from this domain Will look between the "://" and the next "/" and assume that what it finds is a domain name. Then it will erase any other item that contains this URL. Searching by type is achieved by looking at the file type of the item under examination. Assuming your MimeMap file is correct (as it should be for most (if not all) Argo/ANT/Acorn users), this will work correctly. Searching by string-match uses the internally held URL, which may be truncated. This is not seen as a problem as the current searches use the method and/or parts of the domain name. Deletion is done as a two-stage process. Firstly, the index file is munged, and then the item itself is erased. Depending upon your machine, harddisc, web cache, and filing system; the scanning can be tediously slow or it can be blindlingly fast. An hourglass appears, and the %ge counter will count from 1 upwards. This is NOT the overall percentage - the value shown is the number of scanned cache directories. On a typical system, you should have between ten and fourteen at most. The erase options can also be extremely slow on a slow machine - a large cache (say, 1000 files) asked to erase all images might have to make up to 12,000 checks and/or erase 1,000 files as well as removing 1,000 entries from 14 cache data files. Obviously, this is a worst-possible-case-scenario but it highlights that QuickVoy has a lot to get on with. Don't swear at the Hourglass; the Hourglass is your friend. In more detail: * "cachedmp" is the older index file, created by version 1.xx versions of Fresco - the "official" Argo release. * "/cachedump" is the newer index file, created by version 2.xx versions of Fresco - the ANT suite, JavaScript beta & unofficial Argo release. Fresco, being an ANT product, will stick both cache files into the same directory (principally ".Fresco."). Now it can be said that you shouldn't run two different versions of the same program - but getting Fresco going on a 4Mb machine was the inspiration for QuickVoy. The resultant mess with two cache indexes pointing at god-knows-what is left as a surreal visualisation for the reader. In case of contention (ie, when *both* types of cache file refer to the same files), QuickVoy will now favour whichever is the more recent. The older file will be assumed to be obsolete (thus, you probably should erase it). The cache list, by default, claims an additional 64K for the duration of time that the cache list is open. This is sufficient to list around 1000 entries. If your cache is larger than this, set the "largecache" option in the configuration file to "yes". The cache allocation will now be 256K which is sufficient to index four thousand files. If the cache scanner runs out of memory, you will be given a warning and the cache list will show you what it had room to index. WHY IS THAT FILE I DOWNLOADED NOT IN THE CACHE? There are several reasons why a downloaded file is not present in the cache. The first is that Fresco's cache may be buggy. This happens more than you might want to believe and is due, I think, to a fault in Fresco's cache manager. The way to get around it is to set your cache to an unlimited size. An alternative reason is that Fresco cached, and you had not set the cache to be updated every time it is updated (in which case it'd be updated when Fresco is quit normally); or Fresco crashed and was unable to write out your then-current cache settings. Or your settings told Fresco to junk the cache after Fresco has been quit. But that kinda defeats the usefulness of the cache, so I wouldn't imagine you did that. :-) In "!Voyager.Apps.Web.!Fresco.Config", the cache configuration should be something like: # Size in K for cache (0 = unlimited) cache.size: 0 # Max number of items in the cache cache.items: 1000 # Should the cache be kept across closedowns? cache.keep: Yes # Save the cachedump on every update cache.keep.uptodate: Yes The final possibility is that you performed a "Save to file". Fresco does not seem to cache anything under these circumstances; as the data is written directly to the disc file. Pain in the ass if you tend to create loads of directories called things like "misc1", and now you can't find that important file... User Information ---------------- This provides basic information on... * Argo POP number (most likely 08450885336 unless you're on ISDN/ADSL) * Your name, password, POP3 identification, etc... Your password is decoded, but by default it is displayed as "--------". In order to change this, you must edit the templates. This is a basic security measure to prevent casual snoopers finding out your password. Want to know how? Email me. * Version of Voyager in use * Modem settings * Block driver settings Timer event ----------- By setting the "upontimer" configuration option to a non-zero value, you will cause the timed script to execute every x minutes (which can be as short or as long as you like). A recommended value is 10 minutes. This will cause the script entries in the "UPON TIMER" section of the configuration file to be run. This is useful for firing off news/mail fetchers, or maybe just MbxWatch. Disconnection warning --------------------- By setting the "discontimer" configuration option to a non-zero number of minutes, you will activate the disconnection notification. This, when active, will pop up a little window every x minutes telling you how long you have been online. It will give you 60 seconds to click the "Acknowledge" button - a count-down is provided. If you fail to click the button, then QuickVoy will terminate the connection REGARDLESS of whatever may be happening. This is intended mainly as a useful thing for those who IRC into the early hours and have nodded off on more than one occaision. But, it can also be useful to those with busy desktops and a habit of forgetting that you're still online! Simple fetcher -------------- This allows you to fetch stuff from the web without loading a browser. Only one fetch at a time is allowed. In the web fetch window, you should: 1. Enter a URL in the top icon. This should really be a proper URL in the form "http://www.heyrick.co.uk/index.html", but the fetcher will try to make sense of lesser input (such as "www.heyrick.co.uk/"). Please note that the method (http) is fixed and cannot be altered. The https SSL protocol is not supported. This is because the QuickVoy fetcher talks directly to the Internet system. If ANT documented the interface to their HTTP module, things would be much more flexible! 2. Enter a file NAME (not a path, just the name) that you wish to save the fetched object as. 3. Drag the 'data file' icon to a directory. This will set where the file will be placed. 4. If you want the file to be opened in !Edit after being fetched, ensure the option is ticked. 5. Click on "Fetch". The fetcher isn't really that good at distinguishing server issues, like aliasing, or if a dynamic-IP server isn't present. It'll just whinge and report a really nasty-sounding error. These are all things that will be tidied up in a future release. But, for now, the fetcher exists, and it works. Just fetched D2.JPG and displayed it through QuickVoy. Bad stuff in Biscay...again. D2.JPG is a weather satellite image, the one positioned to give a good view of Europe. I guess it is located in about the same place as the old Astra satellites. It is kept up to date with the latest version. There is an aliasing option available. Basically, you type '`' followed by a keyword. The keyword is used as the filename. The path, unless you have changed it, is "qv_fetch" within the !Scrap directory. The exact location depends upon whether or not you have a network. The command: *Filer_OpenDir entered into a TaskWindow will open the directory for you. To change the aliases, look at "!QuickVoy.Utilities.userdata.wwwalias". The file format should be self explanatory. Here are some of the aliases already set up: `? This 'special' alias will cause the "wwwalias" file to be loaded into !Edit. `qvhome The QuickVoy web area. `qvlatest Downloads the latest binary of QuickVoy. This is an archive that is always given the same name (quickvoy.zip), so you may already have it! [note: downloads are logged, so you need to call the php3 script, rather than downloading it directly...] `argohome www.argonet.co.uk `zfcrogues ZFC (news:argonet.zfc) rogues gallery `d2 Weather satellite image of Europe Look in the "wwwalias" file to see what else is available. Add your own! Clicking ADJUST on the "Fetch" icon will open the currently set downloads directory. This is set by dragging the data file in the fetcher window to your chosen destination. If you do not do this, then a subdirectory within !Scrap will be used instead. MbxWatch -------- Supplied with QuickVoy is a simple mailbox watcher that you may prefer to use in preference to an actual mail fetcher. When invoked (it is designed to be invoked from a scripted event, such as the UPON TIMER, or double-clicked), it will connect to the POP3 server at "email.argonet.co.uk". It will log in as you, then perform the "stat" command to ascertain the statistics of your mailbox. MbxWatch will broadcast this information as a Wimp message... ...which QuickVoy will receive and display. You can, then, fire off a fetcher manually if you so wished (by clicking on the "Fetch" icon); or connect with the telnet program if the results are unexpected. There is a tutorial on accessing your email via telnet available from http://www.heyrick.co.uk/voyager/pop3.html MbxWatch will, by default, connect to your Argonet POP3 server. It can be made to connect to an alternative server. Read the documentation... Before using MbxWatch, please refer to the documentation. MbxWatch is provided in the "Utilities" subdirectory of QuickVoy. NEW! MbxWatch has been rewritten so it is slick, fast, and should work with just about any POP3 server that obeys the RFCs. JPEG viewer ----------- Dragging a JPEG file to QuickVoy will display it for you. In <256 colour modes, the JPEG will be rendered in black and white; in 256 colour modes it will be in colour. Both options use an appropriate form of dithering. Simple dithering is used for 1-16 colour modes, and 256 colour modes use full error diffused dither. The output is ever so slightly worse than !FYEO2 (though whites don't suffer from random specks of pink), though it is considerably faster. In comparison with !ChangeFSI: Monochrome output is dithered slightly worse; about comparable to !ChangeFSI with the "Dithering disabled" option set. Speeds are about equal. Colour output is virtually indistinguishable between the two, with full dithering options selected. QuickVoy's renderer is noticably faster. However, this requires a good quality JPEG. You will notice a LOT of degredation in lower-quality JPEGs; and possibly in higher resolution screen modes (my current maximum is 256 colours...). Additionally, the JPEG needs to be a good 'quality'. Lower quality JPEGs will suffer more because of the ultra-fast rendering techniques. The test pictures used were from the off-line copy of my website. As with many things of this nature, the results are entirely subjective. Email me with your comments and comparisons, particularly if you use a 'deep' screen mode. I'd be interested in knowing how it looks... Clicking MENU over a JPEG will give you the choice of viewing the JPEG at 50% (half size), 100% (real size), or 200% (double size). You also have the option to save the JPEG. What will be saved is what you see on-screen. If you want it monochrome, select a 16 colour mode. :-) Additionally, if the JPEG support modules are NOT loaded and they DO exist in your !System.Modules directory, you will be asked if you wish to load them the first time you try to view a JPEG in QuickVoy. How it works: I'm afraid to say that I have not written some kind of whizzy JPEG decoder. Acorn did it for me. QuickVoy interfaces to the JPEG handler within SpriteExtend, a concept introduced in RISC OS 3.5. Luckily, a patch module is available to give the same functionality to RISC OS 3.1 machines. In order to make the decoder small, quick, and easy to implement - it does not load the JPEG. All rendering operations work directly from the JPEG file, so dragging a menu across the JPEG window will incur an obvious lag. The JPEG system will cache the file (if it feels like it), or read out from the file. Whichever it prefers. This allows me to concentrate on more features for QuickVoy, rather than trying to juggle memory allocations. Oh no! It is saying it won't work without the patches! Panic not. You are using a RISC OS 3.1x machine, yes? This is not a problem. Simply find yourself a CD with the "new !Boot" on it (or a floppy disc, or a download from the Internet). We are going to use the Acorn User CD 8 (the sound utilities one, with the stylised treble clef symbol on the front) as an example. Insert the CD. You will see a directory called "BOOT". In there will be a directory called "NEWBOOT". There will be a "!BOOT" inside that. And in there is "RESOURCES", and "!SYSTEM" within that. For RISC OS 3.1x, we want the "310" directory. Finally we have our "MODULES" directory. This, incidently, is one of the reasons I don't like the new style boot application. Stuff is buried! The path, in case you didn't follow, is: $.BOOT.NEWBOOT.!BOOT.RESOURCES.!SYSTEM.310.MODULES Within that you will find two modules: JPEGMsgs JPEGRender Copy these into your !System.Modules directory. Then run JPEGMsgs first, followed by JPEGRender. This is present in !QuickVoy's !Run file, but it is supplied commented out by default, as the JPEG modules consume around 70K. Where to find the JPEG modules: Acorn User CD 9 (the one with the Linux penguin): Sorry, no go there either. :-( Acorn User CD 8 (the sound one): CDFS::AU_CD8.$.BOOT.NEWBOOT.!BOOT.RESOURCES.!SYSTEM.310.MODULES Acorn User CD 7 (the movie trailers one): It isn't on this one, don't bother looking... Acorn Beta CD While the new boot application is on this CD, the JPEG stuff isn't. You could also try looking on the Acorn FTP site (or a mirror of it). Failing that, try an Acorn-specific ftp site such as hensa or the Acorn Cybervillage. If all else fails, email me. I've tested it with every JPEG on my WWWsite (all the Willow ones, and the Britney ones, especially!) and it looks good in MODEs 8, 12, 13, 28 and 31. I also tried MODE 0, but it wasn't particularly impressive. :-) IMPORTANT: If the JPEG viewer crashes with an abort on instruction fetch or similar, try rmkilling the JPEG support modules and reloading them. It has only happened to me the once, so I was not able to figure out what caused the crash. This is NOT a bug in QuickVoy - it is something with the JPEG modules, and BASIC treats fatal errors as non-recoverable... Progressive JPEGs ----------------- If you have a utility called "jpegtran" somewhere in your Run$Path (ie, in a directory set as a library) then QuickVoy will be able to handle most progressive JPEGs. Again, no magic. It will try to view the JPEG given. Upon an error, if it can locate "jpegtran" then it will call this and then try loading the JPEG a second time. This usually works, as most of the "no can do" errors are due to progressive format. You can obtain the "jpegtran" program, and a useful front-end, from: ftp://ftp.demon.co.uk/pub/archimedes/utils/jtrans.zip To install jpegtran where QuickVoy can find it, open a command window and type: . % and press return. You SHOULD get a directory listing, the top will say something like: Dir. IDEFS::Buffy.$.library Option 00 (Off) CSD IDEFS:"Unset" Lib. IDEFS::Buffy.$.library URD IDEFS:"Unset" If this works, type in: Filer_OpenDir % A directory viewer should open, with a bunch of utilities within, such as "fsck", "IfExists", "Repeat" and the like - though the exact contents will depend very much upon your system. Simply copy the "jpegtran" into the newly opened '%' directory. Back at the command window, enter: jpegtran to ensure it worked. The program should have told you it needs more input, followed by a list of options that you could use. If it all works so far, QuickVoy will now display progressive JPEGs for you. There is no need to reload QuickVoy, simply drop on a JPEG. The only difference you will see is it will take slightly longer to view the JPEG for the first time, as the conversion is being done. Please be aware that the conversion process is quite memory hungry. The more memory you have available, the better. You will be given a (possibly obscure) error message if there is not enough memory available. The exact amount required depends upon the JPEG file to be converted... QuickMail --------- QuickMail is a simple little email editor for those times when you want to send simple little emails; without loading unsimple and unlittle programs such as Posty or Pluto... QuickVoy shares memory with the cache scanner, so you can do one or the other but not both. Sorry, but them's the rules! Upon invoking QuickMail, it will load and index your user aliases. It can handle up to 20 of them, which should be sufficient for most people (then again, Bill Gates allegedly said that about 640K of memory - in the days when coders thought bloat was something you got after eating chinese). The window that appears is pretty obvious. It'll open with your default user alias preselected (the one you used when you created your account with Argonet). Click the little menu icon to the right of the "From" details to open a menu allowing you to change them. Enter who the message is to, plain email address please, no fancy stuff or shortcuts. Enter a subject. If you don't, the default "" will be used. Then, start typing. You have 30K in which to play with. However as each line is allocated 80 bytes, the actual space may be considerably less than 30K. It works out at three hundred and eighty four lines. When you've finished, click the "Send" icon. The message will be placed in the outgoing mail queue. You will need to invoke the mail sender yourself (simply click "Mail TX" in the toolbar window). If you have set up a 'new' signature in !PostyUser, that will be appended to the message. If that user does not have a signature, the default signature ("...!Voyager.User.Signature") will be used. If that one can't be found either (unlikely!), then QuickMail will create its own basic signature. Fear not, it isn't a great big ASCII "Argonet". ;^) The editor will wordwrap. It is a little peculiar when inserting text into an existing line (this is a "known bug"). You can import HTML files (type &FAF) and text files (type &FFF). The importer is slow, but thorough. Files are imported at the current cursor position. There is a cut'n'paste facility. The method of selection is a little unusual in that you don't click-drag. Instead, you select entire lines at once using the ADJUST button. Click a line with ADJUST. This line colours differently, and is your START line. Click another line with ADJUST. All the lines in between will colour. This second line is your END line. Note: If your ending point was before your starting point, the start and end positions are swapped over. You may change the ending position at any time by clicking ADJUST over the new end point. In order to clear the selection, you must click ADJUST on the start line. It is rather difficult to explain. Why don't you try a sample edit session by importing a small text file, and try it out for yourself. I find it is a great way to select things. You can then: COPY by pressing Ctrl and 'C'. This will take a copy of the selected text and insert it at the current cursor position. Note that the cursor cannot be within the selected copy block! DELETE by pressing Ctrl and 'X'. This will erase the selected text and clear the selection. MOVE by pressing Ctrl and 'V'. This is the same as a COPY followed by a DELETE, and is possibly the most useful block facility. Finally, the editor keys provided are: Delete/Backspace Delete the character to the LEFT of the cursor Copy Delete the character to the RIGHT of the cursor Cursor up Go up a line Cursor down Go down a line Cursor left Go left, wrapping onto the next line if necessary Cursor left Go right, wrapping onto the next line if necessary Ctrl + Cursor up Go to the first line Ctrl + Cursor down Go to the last line Ctrl + Cursor left Go to the start of the current line Ctrl + Cursor left Go to the end of the current line Home Go to the top Ctrl + X Delete selected block Ctrl + C Copy selected block to current cursor position Ctrl + V Move selected block to current cursor position These keys might seem familiar. It is all pretty much the same as !Edit. PING and GETHOST ---------------- Just provides a simpler way to launch these command line utilities. Please note that these must be installed in your Run$Path. Usually such software will be in "!Internet.bin", and "!Internet" will have already set this up. If you do not have either program, QuickVoy will give an appropriate warning. In case you were wondering... Ping Bounce a message off a remote station, and time it. This is used to see if a station/host is working. Press Esc to stop trying and report. Example output: PING golden.argonet.co.uk (194.131.104.13): 56 data bytes 64 bytes from 194.131.104.13: icmp_seq=0 ttl=245 time=180.000 ms 64 bytes from 194.131.104.13: icmp_seq=1 ttl=245 time=180.000 ms --- golden.argonet.co.uk ping statistics --- 2 packets transmitted, 2 packets received, 0% packet loss round-trip min/avg/max = 180.000/180.000/180.000 ms (this shows golden.argonet.co.uk is working fine, quite fast too) or... PING www.fbi.gov (32.96.111.130): 56 data bytes --- www.fbi.gov ping statistics --- 6 packets transmitted, 0 packets received, 100% packet loss (this shows the FBI has probably just opened a file on me...) GetHost Given an IP address, or name, try to make sense of it. Example output: Looking up hostname '194.131.104.13' host name: golden.argonet.co.uk host addrtype:2 (Internet) host addr len:4 bytes host addr :194.131.104.13 alias 1:www.argonet.co.uk alias 2:email.argonet.co.uk alias 3:ftp.argonet.co.uk (this shows 194.131.104.13 is golden.argonet.co.uk, and also it is www.argonet.co.uk, email... and finally ftp... (!) ) or: Looking up hostname '62.188.10.171' host name: userec91.uk.uudial.com host addrtype:2 (Internet) host addr len:4 bytes host addr :62.188.10.171 (this is me, for this connection) Supported WIMP messages: ------------------------ This is techie. Skip this if you aren't a VIX developer... Voyager messages: ----------------- &4A43F Voyager_Initialise Only recognises codes 9 through 20 (ie, the applications but none of the preferences). &4A439 Voyager_AddWindowLog Sent to QuickVoy to add something to the log window. There is no log window in QuickVoy, so this information is written to the file "windowlog". &4A438 Voyager_Logon Broadcast by QuickVoy upon connection. &4A437 Voyager_Logoff Broadcast by QuickVoy upon disconnection request. Apps will ack if they wish to keep active, resulting in a prompt. [** NOT QUITE : Message is broadcast (as type 18), but logoff continues regardless **] &4A436 Voyager_LogonStatus Sent to QuickVoy to determine the state. QuickVoy will reply with Voyager_Logon or Voyager_Logoff as applicable. &4A432 Voyager_MailChange 0 - Will set icon 2 to normal colour background. 1 - Will set icon 2 to darker background. 2 - Will set icon 3 to normal colour background. 3 - Will set icon 3 to darker background. 4 - Will set icon 7 red. 5 - Will set icon 8 red. 6 - Will set icon 9 red. 7 - Will set icon 10 red. &4A430 Voyager_StatusMessage The message written to the status icon in the toolbar window. &4A42F Voyager_EndSession Broadcast after full disconnection and reset. &4A42D Voyager_AreYouThere Enquire if Voyager is loaded. QuickVoy will ACK this, and send... &4A42C Voyager_YesIAm Send in response to Voyager_AreYouThere. QuickVoy will set the reply to 28 bytes (rather than twenty), with data%+20 = "RICK" and data%+24 = version number of QuickVoy * 100. If data%+24 has top bit set, then QuickVoy Small is being used. &4A42B Voyager_WhatsTheTime &4A42A Voyager_TimeIs QuickVoy replies with the value of OS_MonotonicTime of the time the two modems connected, plus the specified timeshuffle (see configuration). &4A429 Voyager_Disconnect Broadcast prior to killing the stack. &4A425 Voyager_VIXSetState This message is only implemented insofar as recognising messages from one particular task. See the following section, entitled "CountDown". All other messages or variants of the above are unsupported. QuickVoy messages: ------------------ &51C44 QuickVoy_Message This is a multiple-purpose message allocated to QuickVoy. The base block (&51C40) has been officially allocated for use by my software (originally, to replace the &16F00 doors protocol; BBS stuff). The way this is allocated is a message number is assigned to each application - QuickVoy uses message &51C44 - and the word at data%!20 specifies what the message means. data%+24 is the data. This means, 64 applications can be supported, with 2147483650 possible messages available; which is much more flexible than only 64 messages for one application. The following codes are received by QuickVoy (data%!20): ^^^^^^^^ 1 - QuickVoy_Connect If not connected, connect now. 2 - QuickVoy_Disconnect If connected, disconnect now. 3 - QuickVoy_InvokeTransport Invoke transport - has no effect if not on-line. data%!24 bit 0 = News fetcher 1 = News sender 2 = Mail fetcher 3 = Mail sender 7 = Self upgrader (assumed to be at ...Utilities.!selfupgrd) 4 - QuickVoy_InvokeActivity Invokes a scripted activity data%!24 bit 0 = UPON STARTUP 1 = UPON CONNECT 2 = UPON TIMER 3 = UPON DISCONNECT 4 = UPON QUIT It is only really safe to call the timed events a little early; you can cause nasty things to happen by messing with this. 5 - QuickVoy_RQStatus Request status; replies code 10. 6 - QuickVoy_MbxWatch Broadcast by MbxWatch to indicate the status of the mailbox. Ignored by QuickVoy Small. data%!24 = Number of messages data%!28 = Size of all messages 7 - QuickVoy_Email Broadcast by the email progette in response to a mailto: URL having been chosen (in the browser). Ignored by QuickVoy Small. $(data%+24) = Email address $(data%+128) = Email subject The email subject is currently not decoded by the interface progrette ("...!QuickVoy.Utilities.!mailtourl"), but it is supported by QuickVoy. You could use this Wimp message to add your own email requests. 11 - QuickVoy_FetcherReady Broadcast by fetcher to say that it has loaded and is ready. Ignored by QuickVoy Small. 12 - QuickVoy_FetcherStatus Broadcast by fetcher to report on status. Ignored by QuickVoy Small. data%!24 = 1 Resolving 2 Connecting socket 3 Sending request 4 Waiting for response from server 5 Fetching data data%!28 = Amount fetched, if code = 5 data%!32 = Amount to be fetched or 0 if unknown (if code=5) 14 - QuickVoy_FetcherCompleted Fetch completed. Ignored by QuickVoy Small. 15 - QuickVoy_FetcherError Fetcher error. Ignored by QuickVoy Small. data%!24 = 1 No stack loaded 2 No resolver loaded 3 Unable to resolve domain 4 Unable to open output file 5 Unable to connect socket 6 Unable to fetch object 7 Internal error, quitting 8 Can't do fetch, already fetching something 9 Invalid input 10 Error overrun when fetching headers 11 Error overrun when fetching data 12 Remote system closed connection 14 Unable to open specifier file ("fetchrq") 15 Unable to parse URL in specifier file 16 No write name in specifier file 16 - QuickVoy_FetcherDied Broadcast by fetcher when asked to shut down. Ignored by QuickVoy Small. data%!24 = Handle of task that requested shutdown, or 0 if a TaskManager quit. 17 - QuickVoy_FetcherAlternate Broadcast by fetcher if the actual domain is something other than the specified domain. Not currently supported, and can probably be ignored anyway. $data%+24 = Alternative alias The following codes are broadcast by QuickVoy (data%!20): ^^^^^^^^^ 10 - QuickVoy_Status data%!24 = &796F5651 ("QVoy", for identification) data%!28 = Version number * 100; if bit 31 is set then QuickVoy Small is being used. data%?32 = TRUE if connected, else FALSE. data%?33 = TRUE if dialling, 2 if logging in, else FALSE. $data%+36= Login name (like "UKARG/argxx99"), null terminated. 20 - QuickVoy_RQFetcher Requests the fetcher fetch something. The fetcher will look for the file .Utilities.userdata.fetchrq" which should contain two lines of text: 1 - What to fetch (full URL) 2 - Where to write it to Won't be broadcast by QuickVoy Small. 21 - QuickVoy_RQFetcherStatus Requests a status on the fetcher (replies with code 12). Won't be broadcast by QuickVoy Small. 22 - QuickVoy_RQFetcherDie Requests the fetcher to abort and exit. Won't be broadcast by QuickVoy Small. Other messages: --------------- &0 Quit. Will cause QuickVoy to exit. &2 / &3 DataLoad stuff, for files dragged to QuickVoy. &400C2 TaskManager_TaskInitialise Looking for the PPP loader initialisation. &400C3 TaskManager_TaskCloseDown For PPP loader shutdown, and for controlling the status of the transfer "LEDs". &4AF80 ANT URL request Will intercept simple mailto: URLs, and indirected mailto: URLs. The indirected URLs are expected to have a filename following the URL. This file is then pre-loaded into the message editor. The reason for this is to support: * Clicking "mailto:" links in a browser. * Sending forms with "method=post" in a browser. Using the fetcher ----------------- Don't. QuickVoy will do it for you. If you really must... * Load ".Utilities.!fetcher" (this name is fixed, any newer code will have the same utility name). * It will, upon loading, broadcast &51C44 with the word at +20 being 11. You should wait a few seconds for the fetcher to initialise, before reporting that the fetcher failed to load. * You create the ".Utilities.userdata.fetchrq" file; something like: http://www.heyrick.co.uk/voyager/quickvoy/index.html IDEFS::Willow.$.misc.qvindex/ht * Broadcast code 20. * Wait until you receive code 14, 15, or 16. You will periodically receive code 12 which you can use to update status displays. * If fetch completed okay, send code 22 to kill fetcher. If it didn't, then remove the fetched file as it is likely to be non-existant/incomplete. CountDown --------- Christina West has created a useful module for Voyager which gives an up-to-date count of the email/news waiting to be sent. I wouldn't be without it - so much so that I've added a simple hook to QuickVoy to allow CountDown to be used with it. If you have CountDown, add the following to the UPON STARTUP section of the configure file: run .CIX.CountDown.!Run Please note that QuickVoy expects CountDown to have the VIX identification "LS05". Supported VIX/VIXEN commands: ----------------------------- QuickVoy looks for "!Vixen". If that isn't found, it'll look for "!Info". It ONLY does this for the ".VIX" directory. All other Vixen (ie, in Apps) are ignored. !Vixen: vixen name This is used for the Vix menu. files run This is used when the Vixen is run, to determine what to run. boot This is called immediately prior to Run, just in case the run file assumes it has been booted. configure This is used for the Preferences menu. !Info: name: This is used for the Vix menu. run: This is used when the Vixen is run, to determine what to run. boot: This is called immediately prior to Run, just in case the run file assumes it has been booted. config: This is used for the Preferences menu. For connection/disconnection/quit, amend the QuickVoy configuration file. Dependencies: ------------- Many. At the very least, you need a working version of !Voyager (v2.05 or later) and an account with Argonet. From there, there are various extras, such as beta software or stuff from http://www.heyrick.co.uk/voyager/, Xina's CountDown, the JPEG modules... None of it is strictly necessary; but let's face it, neither is access to the Internet. You won't die without it. But it is fun, dammit, and so are those little add-ons. Don't be a loser, embrace the penguin and the iMac and realise that the point of it all isn't just to reproduce, but to have FUN along the way. Please note that the "StdConfig" file relates to a standard version of !Voyager (v2.05 or later). The supplied "configure" file relates to my system: * It doesn't run the mail fetcher, it runs MbxWatch instead. * The mail fetcher is Calypso. * Alternate-clicking the Browser icon will try to load "!FrescoJS". * The additional icon is set to load WebLoad. * Alternate-clicking the additional icon will try to set up DynDNS. * Alternate-clicking the telnet icon will try to load "!FreeTerm". * MbxWatch is supplied with QuickVoy, in the Utilities subdirectory. * Calypso is a beta test fetcher. * JavaScript Fresco is now available to Argo subscribers, but I have retained my older version of Fresco and renamed the newer one "!FrescoJS" so I can load either as it suits me. * WebLoad is an addition available from Argo for managing your website. * DynDNS is a utility to set a dynamic DNS entry to my machine. Refer to http://www.dyndns.org for more information and software for RISC OS. * FreeTerm is a better version of the telnet supplied with Voyager. Look around ftp.demon.co.uk for the "freenet" site, then look for "t.howat". The latest version is 1.34. The published URL is http://www.angel.ac.uk/ac/2020/ The system variable is created and used by QuickVoy's auto-resume facility to enable the call coster to display the correct information. It is not, yet, supported by Voyager itself. The value of this variable is a string that equates to the value of the monotonic counter, plus the 'shuffle' value added (this accounts for the time between the call being answered, and the connection succeeding; usually about 12-20 secs). Example code: _kernel_swi(OS_ReadMonotonicTime, &r, &r); cost_connecttime = (r.r[0] + (cost_timeshuffle * 100)); _kernel_osclif("%%Set VTi$ConnectTime %d", cost_connecttime); Or: SYS "OS_ReadMonotonicTime" TO cost_connecttime% cost_connecttime% = cost_connecttime% + (cost_timeshuffle * 100) SYS "XOS_CLI", "%Set VTi$ConnectTime "+STR$(cost_connecttime%) This should be done between DCD going high, and the loading of the stack. Utilities: ---------- Each utility in the "Utilities" subdirectory has an "!Help" file which explains what the purpose of the utility is. Read this for more details. You will notice that none of the utilities have icons - this *is* correct. Template hacks: --------------- There is a certain amount of flexibility in the template loader. You can use up to 3200, 5120 bytes in the template definition. Provided all icons are the same physical number and have the same properties (ie: indirected text or optoff,opton et cetera), then you can reorganise the windows to suit your preference. The template file "Tnocdown" is a version modified slightly for those of you who do not use Xina's CountDown module. Rename "Templates", and copy "Tnocdown" as "Templates" in order to use it. The SMALL version has a little free space for template tweaks, but not a lot... Millennium issues ----------------- None. 32 bit OS issues ---------------- The assembler code is NOT 32 bit clean. This can be changed with a minimal amount of grief... The program itself should be okay, as BASIC is BASIC, innit? :-) Known bugs ---------- 1. If you perform a lot of erase operations on the same cache list, the pointers may get messed up. WORDAROUND : Basically, if loads of stuff turns green then it is recommended that you purge the deleted entries by closing the cache list window, and reselecting Scan Cache. 2. Does not respond to a "don't quit yet!" request from the transports - I don't have any documentation on the protocol used. 3. Holding down SHIFT whilst an automated event is taking place will cause lots of !Run type files to be loaded into an editor. This won't be fixed as I find it a useful way to temporarily override the auto events. This isn't so much a "known bug" as it is a "documented behaviour". 4. Word-wrapping on insertion on QuickMail is odd, to say the least. 5. Doing something while trying to connect to the Internet causes the connection to be terminated. Not entirely sure why, at this time. WORKAROUND : Don't do anything (like QuickMail or User Info etc) while QuickVoy is attempting to connect to the Internet. Wait until connection is established. For details of things fixed/added/modified, please refer to the "Versions" file. Suggestions? ------------ QuickVoy will never beat the original Voyager toolbar in terms of visual appeal and pure style. However it may be possible to excel in features. So if you wish the toolbar could do something for you, then please email me with your suggestions. The best and most popular (which, I hope, will be one and the same!) ideas will be looked into. Contacts: --------- The first port of call for anything related to QuickVoy is the QuickVoy web page at: http://www.heyrick.co.uk/voyager/quickvoy/ If you have a problem, query, comment, whatever... then please do not send an email to Argo. QuickVoy is nothing to do with them, so they are unable to assist you. Instead, contact me at: support@heyrick.co.uk Please remember to state the usual: * QuickVoy version * Other software running (if a bug) * Exactly what happened (if a bug). In detail please, saying "it crashed" doesn't help. * Sometimes the Internet plays up. Very rarely, but sometimes. So if you cannot get on with QuickVoy; reset your machine and try !Voyager. If that doesn't work - do something else for a few hours. :-) * If a bug, can you repeat it? Finally, please report ALL bugs (unless covered in the "known bugs" bit) because a bug that might seem obvious to you might only be appearing on your machine. With Acorn hardware, we are lucky in that faults to cheap video cards and dodgy IDE cards are not an issue; but that doesn't mean that there are no variations in the systems. Fresco has been noted to work on one machine, and fail completely on another -- identical specification and loaded with minimal (and identical) software at boot time. Weird, but for real. You can find other goodies for your Voyager setup at: http://www.heyrick.co.uk/voyager/ Finally, if you want to chat in a non-techie manner, email me at: rmurray@heyrick.co.uk Miscellaneous stuff: -------------------- * QuickVoy is not an open source project, and there are no plans to change that, at present. * QuickVoy CAN be used to call another ISP. The patch is available from the QuickVoy website; but note that this is both extremely hacky and against the rules of the use of Voyager. More about this, restrictions, and the limitations (ie, you won't be able to deal with Argo email when logged into another provider) in the patch instructions. * For those who like to know this kind of stuff: "!RunImage" is written in BASIC with some embedded assembler, and links to an assembler 'code' file. Source size is 227750 bytes, or 6957 lines of code. "!autoupgrd" is written in 72 lines of assembler (via BASIC). A 2041 byte source gives us a 356 byte program. "!bashmodem" is obvious - look at the source. :-) "!fetcher" is a 576 line BASIC program that demonstrates pretty much all of the ways to NOT use the sockets. By rubber bands, blutack, and plain old-fashioned luck, it actually works. Wow! The fetcher will, soonish like, be ported to C and done properly. "!mbxwatch"'s 444 lines of code have been largely updated and recoded to make a smooth, slick, and reliable POP3 mailbox interrogator. "!urlmailto" is a simple 42 line program to take a URLOpen_mailto command and translate it into the appropriate Wimp message to begin an edit session in QuickVoy's email sender. "!qvconfig", long awaited, is 2470 lines of code or 85576 bytes... The QuickVoy project is 417 days old (20/11/2000). Statistically, I have coded an average of 25 lines per day. There is approximately 150K of documentation to read! In the future... ---------------- Some may be done in the next version, some is for the future... * QuickVoy will be modified to use either the Voyager stack and PPP driver (in "!Voyager.Stack"), or the Acorn one (in "!System.Modules.Network"). * Integration with Emily, if loaded, for mail sending. * Fetcher to be recoded in C, and working properly. * Provision for self-upgrading, a la VideoList. Care to add more ideas? Email support@heyrick.co.uk and say your ideas! Licence: -------- This software may be freely distributed to any and all Argo subscribers who use the Voyager package - and as it relies heavily on the Voyager configuration system, it is rather non-trivial to use QuickVoy with another internet suite. + The use of QuickVoy with another provider is possible; however as the patch documentation states, it is against the terms ad conditions of the fair use of Voyager components. You use it entirely at your own risk. The patch is provided as a seperate download so you *cannot* install it by accident. For further details and patch-specific licence, refer to the documentation supplied with the patch. This software shall at all times remain the copyright of Richard Murray. This software may only be distributed in its original unaltered form, as available from the previously mentioned URL, with the following exceptions: 1. Magazine discs or CDs - please contact me. 2. Commercial compilation CDs - you must contact me for permission BEFORE including this software on a commercial CD. 3. Commercial software - this software may not be included within the same package as a commercial software product, regardless of whether or not it is identified as a free product UNTIL permission has been obtained. 4. This software may NOT be uploaded to any website for any reason. Use the HT in HTML and link directly to my site. This ensures that the available versions are the latest versions, and that users don't get confused by many copies floating around, which may be out of date. To see what I mean, look for "WinAmp" and see how old some of the ones on the "self-confessed mirror sites" are! My rates are quite reasonable if you ask me nicely. Typically a freebie CD or copy of the software package - whatever it is - is all I ask. But please, do ask, don't assume that because this is free you may do as you wish with it. All copyright notices in the software and in the documentation must remain. You are allowed, under European law, to modify this software in order to correct any small problems you encounter; though you are not allowed to perform such modifications as to enable you to use the software in a way other than that which was intended. I ask that if you do correct a problem, please inform me so I can correct the master copy. This software is supplied as-is, with no guarantees or liability acceptance. It is intended to perform the described functions, and I release it in good faith on the basis of it working correctly, as described in the user guide, on the correct type of computer. However there are too many factors involved to say that it will work faultlessly on every compatible machine on the planet (Fresco type 5s, anyone? ). Thus, I disclaim all liability for damage or loss as a result of the use of this software, even if I have been notified of the possibility of such loss or damage. * A licence to use this software does not cost anything, and may be obtained by anybody who has not had their licence for this software previously terminated for breaking the conditions of the licence. Therefore the concept of transferral of licence is utterly meaningless. + In English, unless I have expressly said that you CANNOT use QuickVoy (and, at time of writing, I can't think of reasons why I would do such a thing), then you can download a copy and enjoy it! This software is a free product, and as such you have no automatic 'right' to end-user support. However, I will endeavor to correct any problems that are reported, to modify the software in light of end-user suggestions or critique, and to maintain this package for as long as it is viable, as and when I have the time to do so. Unfortunately, I have a "real job" which provides me with that much-needed thing known simply as "money". Of course, I don't see much of it. The electricity board, and Argo themselves get some. The tax man gets more that he deserves, and Sainsburys gets a hefty amount of coinage. I won't even start to think about how much BT gets... But, well, let's just say if I didn't have a "real job" I'd be unable to do stuff like this in my free time. Ummm! This software is a free product, however I would not say no to donations or money, or failing that - some old hardware. Maybe you have a BBC micro sideways ROM board that you've not used in a decade? Or an old 486 laptop? Email me! (Shameless, isn't it?) Future releases to this software may become chargable upgrades. It is an unlikely scenario, but I figured I'd better give myself the option. Licence conditions relate to the version of the software supplied. Usually the licence conditions are pretty similar between versions, but this should NEVER be assumed. Always read the licence to see if anything has changed. Conditions which have changed are denoted with a star '*' in the left margin; and new conditions are denoted with a plus '+'. This licence remains in effect until terminated. Termination occurs when: a. You erase all copies of QuickVoy in your possession and cease using it or: b. When you fail to comply with the stated conditions, UNLESS you have a signed letter allowing you extra freedom in the use of this software. Upon termination, you must cease using this software and destroy any copies of the software that you have. The installation and use of this software implies full understanding and acceptance of this licence. If you have any queries about the terms of this licence, or if anything appears to contradict itself, or if it just doesn't seem to make any sense, please email support@heyrick.co.uk for further explanation. Hmmm, did anybody bother to read that stuff?