QuickURL 3.1 Automates FTP/HTTP/GOPHER/EMAIL/TELNET Document Transfer
1/20/98

QuickURL is a program which expands on the concept of bidirectional
file transfer (FTP) to include a full range of URL protocols, including
file:///, ftp://, gopher://, http://, telnet://, and mailto: as well as
the custom URL protocols dde:, log:, msg:, pick:, view:, and variable:.
Transfers may be carried out by simple mouse-pointing or via scripting.
Commands include CD, DEL, DIR, DISCONNECT, EDIT, EXECUTE, GET, HEAD, LAUNCH,
MKDIR, POST, PUT, RENAME, SENDKEYS, SHELL, and VIEW.

Program flow commands include BEEP, DO/LOOP, FOREACH/NEXT, GOTO/LABEL,
IF/ELSEIF/ELSE/ENDIF, MSGBOX, PAUSE, SET/UNSET, and WAIT.

Transfer options include ASCII, BINARY, HTML (add <HTML><PRE></PRE></HTML>),
COMPARE, REPLACE, UPDATE, and LOWER CASE (file names changed to lower case).

Files may be filtered by line, reformated by column fields,
transferred between two remote machines, replaced, updated, and appended,
and viewed as HTML in your browser. Remote/Local directories are displayable,
and remote files can be edited, deleted, and renamed remotely. Transfer to
WEB sites is facilitated by mapping to equivalent FTP sites. Many examples
and usage tips are included.
    
Publisher/Author: Integrated Graphics, 312 Nevada St., Northfield, MN. 55057
Replaces: QuickFTP
Registration Price: $50
Basic Platform: Windows 3.1, Windows 95
Product Category: FTP/Telnet/Gopher/Web client
Product Distribution Category: Shareware, freely re-distributable
Keywords: INTERNET, QUICK, FTP, AUTOMATE, FILTER, REFORMAT, SCHEDULE 

New in 3.1:

'1/18/98  3.1  command line can be quickurl statement!
'              This allows running something such as this from DOS in Windows95:
'
'              quickurl get test.txt from http://www.stolaf.edu/people/hansonr
'
'1/20/98  3.1  complete input filter logic--and, or, not
'1/20/98  3.1  input filter [''] matches blank lines
'1/20/98  3.1  input filter not [''] matches nonblank lines
'1/20/98  3.1  input filter [''@20] matches lines shorter than 20 characters
'1/20/98  3.1  PUT with wildcard no longer gives error if 0-byte file or FTP non-plain file





See online Examples and Tips for further details:

[Examples]

Using Set--QuickURL Update by FTP
DO/LOOP, gopher://, Filters, and IF--MSP Weather Update
Using dde:--PUT to Excel
Using input: with mailto:--Send Comments to Author
Using pick: with IF and FOREACH
Using pick: and filters--RFCs by Keyword
Using pick: and filters--RFCs by number
Using dde: and FOREACH--Creating a Windows Group
Sophisticated Filtering--CSO Phone Book Lookup
Filter Formats--Text to Msg Tests
Advanced IF and default GET/PUT--Interactive Update
Using the Compare OPTION--Comparing two files
_Samples

[Tips]

Using IF
Using SET
Commands (Program Flow)
Turning Variables OFF
Command Line Options
Using SENDKEYS
Commands (File Transfer)
Using mailto:
_Getting Started
Using SENDKEYS--Special Keys
Using DDE
Using DDE To Run QuickURL
Starting QuickURL with Drag/Drop
Using dde: With GET/PUT
Using FOREACH/NEXT
Using pick:
Using Variables
Creating and Editing Tips
Using DO/LOOP
Filter Basics
Filter Examples
Filter Formats
__NEW
Using telnet:
Using ftp: with GET/PUT
Using EXECUTE
Using ftp: The FTP URL
So What's a URL?
FTP/FTP?
FTP Options
Protocols--Source
Protocols--Destination
Filter Formats--Column Matching
Filter Formats--Evaluations
Variable Expressions
Filter Formats--Character Substitution
Using GOTO
Using url:--generic protocols
Copying and Moving List Commands
Using IF--Advanced Transfer
Using IF--Advanced MSGBOX
Using ...... To Continue Lines

New in 3.0:

This is a MAJOR upgrade all will want to have.

Most significantly, the Quick up/download operation has been
greatly expanded to include HTTP and GOPHER sites as well as
FTP. Basically, the idea was to expand the concept of FTP to
WEB and GOPHER sites--all are heirarchical. It works. For example,
HTML files are used as "indexes" to Web sites, and also contain
links to other sites. QuickURL uses the links in HTML files as a
basis for building a path/file directory listing just like on an
FTP site. Also added was an interface to Netscape that allows you to
view remote documents using Netscape, making QuickURL a 'front end' for
Netscape. In a addition, you can DIRECTLY edit a WEB page on a
server remotely.

Imagine WS_FTP expanded to WS_HTTP or WS_GOPHER.
That's what we have now in QuickURL.



New in 2.3:

The following MAY change the characteristics of your
current lists:
-----------------------------------------------------

Output filter field type -n.m abandoned in favor of (n.m)
  (space-trimmed) and n.0 (quote-trimmed)
Output filter default for 'from':'to' on 'to' is 
  'first' not 'last'

The following WILL NOT change the characteristics of
your current lists
----------------------------------------------------

INTERFACE CHANGES
-----------------

Direct RECENT.INI editing automatically updates Quick menu 
  'Check...' button for filter opens up a whole new form
  allowing filter checking/testing.

CTRL-ENTER during modification same as OK

Quick Up/Downloads now include path in menu name
Menu Item 'Uploads' renamed 'Quick Uploads'
Menu Item 'Downloads' renamed 'Quick Downloads'
msgbox for Quick Upload/Download reconfigured

Quick Connect 'Rename' button now 'Ren'
Quick Connect 'Delete' button now 'Del'
New Quick Connect 'Clr' button delselects all on list
Clicking on path in Quick Connect allows creation of
  new directory on a remote FTP server

Quick variable evaluation. Point to a variable
  in a SET statement and it will appear on the 
  Variable menu.


PROGRAMMING CHANGES
-------------------

Output filter field type -1.999 translated to (+)

COMPLETE FILTER OVERHAUL--MANY NEW CAPABILITIES
filter formats expanded:
              (-n) last n characters
              (-3:-2) 3rd from last to 2nd to last
              (3:4) 3rd-4th characters (same as 3.2)
              (4:3) all EXCEPT 3rd and 4th characters
              (-2:-3) all EXCEPT 3rd from last and 2nd from last
              ('x':'y') match of 'x' to match of 'y'
              note that in ('x':'y') x MUST be found
                to the left of y or the record is skipped.
              (-'xyz') all EXCEPT xyz
              (find)=(replace)
              2.1|'t'='h'  piping of output filter fields

BUG FIXES IN 2.3
----------------

fixed switch of '\n' to '/n' in format options of GET/PUT FILE:///
fix for insertion of examples at end
GOTO %variable% wasn't doing substitution
fix for lines exactly 1001 bytes long
fix for some evaluations dropping first character



NEW IN 2.2
----------

Quick variable evaluation. Point to a variable
and it will appear on the Variable menu.

Use %'test'% and %"test"% to specify lower or upper
case of variable %test% See tip (search for UPPER) 

myIP special variable always the IP number of this computer

BUG FIXES in 2.2
----------------

QUICKURL.TIP and QUICKURL.INI missing tips on 
  first installation if [x] is used to close instead 
  of File-Exit.

Command line variables %%whatever%%=value were not being read

First line deletion resulted in improper UNdelete
fixed occasional datasocket open failure under Windows95


NEW IN 2.1
----------

F1 for help in comboboxes and text
added separator in pick form.
%whatever% ok in loop and wait
   also click on wait box==> 10 seconds
if commandline file missing, uses app.path second
added MKDIR function (FTP and FILE)

BUG FIXES in 2.1
----------------

fix for set #n=#n+1
fix for do/loop time
fixed goto/loop problem introduced in 2.1b.
fix for HTTP servers mixing upper/lower case


NEW IN 2.0
----------
The number of changes and fixes between 1.0 and 2.0
is staggering. The highlights are pointed out here.


The following MAY change the characteristics of your
current lists:
-----------------------------------------------------

Variables having '?' as the first character are
  automatically unset, and the "?" is removed. Thus, any
  such variable will be prompted from the user every time
  the '?' is present.

DOS environment variables must begin with '_' followed by the
  standard dos name, such as TEMP or PATH

Lines ending in three consecutive periods are assumed
  to be continuing on to the next line. Messages such as

    MSGBOX ok: And now...

  will cause the next line to become part of your message.



The following WILL NOT change the characteristics of
your current lists
----------------------------------------------------

INTERFACE CHANGES
-----------------

Direct List Editing.

List is scrollable horizontally and vertically.

'New' button now inserts commands BEFORE pointer, not AFTER.
'Skip' button added.
'=?=' button on directory lists allows comparison of files.

Error trapping/error status indicated in bottom right-hand
  corner of screen. This is a clickable toggle ON/OFF.

Line numbers cleaned up; indicated in bottom right-hand
  corner of scrolling region. Click there for quick navigation.

Buttons rearranged.

Variable listing in menu is gone. Click on 'Set' to see them.
(This due to memory problems on some machines.)


PROGRAMMING CHANGES
-------------------

url: protocol allows full URL designation, as, for example:
 
  GET file:/// ......FROM url:http://www.stolaf.edu/index.html
  
  This is helpful when using variables, where the variable
  is expected to be a FULL url:

  GET file:/// ......FROM url:%What do you want to get?%

transfer protocols which require an object, such as
  file:///, ftp://, gopher:, http://, and mailto:
  when left blank, default to variables 
  %?file source%, %?file destination%,
  %?ftp source%, %?gopher source%, etc...
  i.e. they will be asked EVERY time.

Default for GET when no ......FROM is given is as follows:

     GET whatever

  means

     GET %Default|TempFile% ......FROM whatever

Default for PUT when no ......TO is given is as follows:

     PUT whatever

  means

     PUT %Default|TempFile% ......TO whatever

  Thus, the following is handy:

     GET c:\temp\t
     GET text:"new last line" ......OPTIONS aPpend
     PUT c:\temp\t1 ......OPTIONS [-5]
     PUT c:\temp\t2 ......OPTIONS [+5]

  But be careful! %Default|TempFile% clears only when
     a) processing restarts from Line 1.
     b) a new list is loaded.

Compare OPTION allows comparison without update or replace

Commands can be evaluated in IF statements with predictable results:

     IF `GET c:\temp\t ...
     ...from ftp://ftp.stolaf.edu/pub/origami/WIN/iconmovr.exe` and !updated!

  where possible outcomes are:

     !ok! (1, success, no update)
     !updated! (2, file updated or replaced)
     !error! (4, unsuccessful)

Full support of AND, OR, and NOT in IF statements. In the case of AND,
   if the left-hand side is false, then right-hand side is NOT EVALUATED

Full support of parentheses in IF statements. () are evaluated first, from
   left to right, before any other processing.


OPTIONS may be specified as whole words:

  Ascii, Binary, Replace, Update, apPend, Compare, Lower, and uNchanged

  (Case is not important here)

msg: protocol allows for caption; defaults to line number.

pick: protocol [sorted] will sort:

   get pick:[sorted] ......from whatever

Default protocol for GET and PUT is file:///, not ftp://
This means you can do the following:

    GET c:/temp/t ......from d:/temp/source

BUG FIXES:
----------

Tabbing allowed tabs to invisible buttons with unpredictable results
if Enter was pressed.

Menus and buttons were not disabled during processing.

Filters containing ']' in quotes were being misinterpreted.

HISTORY OF CHANGES:


'5/29/97  2.0a input: fixed to allow prompt in txtURL
          2.0a FTPconnecttimeout used for all modes now
          2.0a new tip Obtaining User Input

'6/2/97   2.0d QuickTelnet allows SHIFT-INS paste and Backspace.          
'6/8/97   2.0e DIR command was transferring but not doing any file saving.
'6/13/97  2.0e (also) remove FTP RENAME was doing a remote copy, not rename. 
'6/17/97  2.0f bug in loadcommandfile caused erroneous "file not found" due to 
'              strange behavior of Windows temp file. 
'6/30/97  2.0g FOREACH file:/// with wildcard was inoperative 
'              (starting with version 2.0e; fixed in 2.0g)
'              also now can take binary files over http
'8/28/96  2.1  F1 for help in comboboxes and text
'8/31/97  2.1  %whatever% ok in loop and wait
'              also click on wait box==> 10 seconds
'              fix for set #n=#n+1
'9/3/97   2.1b commandline file missing, uses app.path second
'9/3/97   2.1b fix for do/loop time
'10/10/97 2.1c added separator in pick form.
'10/20/97 2.1d fixed goto/loop problem introduced in 2.1b.
'10/24/97 2.1e added MKDIR function (FTP and FILE)
'10/29/97 2.1f fix for HTTP servers mixing upper/lower case

'11/5/97 2.2 fixed missing tips on first installation
'11/5/97 2.2 fixed not reading variables from commandline under Windows95
'11/5/97 2.2 fixed undelete of first line in script
'11/5/97 2.2 fixed occasional datasocket open failure under Windows95

'11/11/97 2.3 fixed switch of '\n' to '/n' in format options of GET/PUT FILE:///
'11/11/97 2.3 FILTERS DEMYSIFIED!!! New Filter 'Check...' button
'11/11/97 2.3 fix for insertion of examples at end
'11/11/97 2.3 CTRL-ENTER during modification same as OK
'11/12/97 2.3 fixed GOTO %variable% wasn't doing substitution
'11/15/97 2.3 COMPLETE FILTER OVERHAUL--MANY NEW CAPABILITIES
'11/11/97 2.3 filter formats expanded:
'                (-n) last n characters
'                (-3:-2) 3rd from last to 2nd to last
'                (3:4) 3rd-4th characters (same as 3.2)
'                (4:3) all EXCEPT 3rd and 4th characters
'                (-2:-3) all EXCEPT 3rd from last and 2nd from last
'                ('x':'y') match of 'x' to match of 'y'
'                note that in ('x':'y') x MUST be found
'                to the left of y or the record is skipped.
'                (-'xyz') all EXCEPT xyz
'                (find)=(replace)
'11/19/97 2.3 overdue fix for lines exactly 1001 bytes long
'11/24/97 2.3 fix for some evaluations dropping first character
'11/26/97 2.3 quick up/downloads now include path
'12/14/97 3.0 "......" no longer necessary in ......FROM, ......TO, or ......OPTIONS
'12/14/97 3.0 "OPTIONS" may be "OPTION
'12/15/97 3.0 Disconnect moved to Connect... Submenu
'12/15/97 3.0 view: protocol added as destination
'12/15/97 3.0 DIR * expanded to HTTP and GOPHER
'12/19/97 3.0 DIR OPTION X (eXtended listing) added
'12/7/97  3.0 EDIT expanded to gopher (read-only)
'12/7/97  3.0 EDIT expanded to http (read/write)
'12/9/97  3.0 VIEW method added
'12/12/97 3.0 QUICK download expanded to HTTP   'WOW!!
'12/14/97 3.0 QUICK download expanded to GOPHER 'WOW!!
'12/19/97 3.0 QUICK VIEW button added
'12/19/97 3.0 QUICK cache added--remote directories are cached and
               redisplayed VERY quickly
'12/20/97 3.0 HTML transfer option added--ensures
             at least <HTML><PRE> tags are present, and
             on appending, appends PRIOR to </HTML> tag
'12/16/97 3.0 bug fix: upon OK from detail..., left-hand list was not resetting properly
'12/31/97 3.0 modification: transfers from http add <BASE now ONLY when option HTML is set
'1/2/98   3.0 check for missing APIGUIDE.DLL
'1/2/98   3.0 Quick Connects subdivided
'1/2/98   3.0 Quick Upload expanded to HTTP !WOWWWW!
'1/2/98   3.0 Quick panels widen for full view
'1/2/98   3.0 VIEW method added
'1/2/98   3.0 HTTP can now be a DESTINATION!!!
'1/2/98   3.0  with FTP site equivalence in WEB_FTP.INI
'1/2/98   3.0 URL histories added to RECENT.INI
'1/6/98   3.0a bug fix: URL move to other computer now OK
'1/6/98   3.0a bug fix: setting variable to '' (two single quotes) now makes it blank, not undefined
'1/6/98   3.0a bug fix: #recordsin/out were not updating
'1/6/98   3.0a moved Edit menu to main menu
'1/6/98   3.0a QuickUp/Download menus merged
'1/6/98   3.0a modification: -n.m where n<m, such as -1.999 now (n.m) i.e. fully trimmed
'1/7/98   3.0a ahem. critical 3.0 filter malfunction fixed
'1/7/98   3.0a ahem. critical 3.0 foreach malfunction fixed
'1/7/98   3.0a VIEW extended to FTP


involves: QuickURL.EXE, QuickURL.TIP

changes that may affect your scripts:

transfers from http add <BASE> tag now ONLY when 
 option HTML is set
New in QuickURL:

'4/16/98  3.1f fix for connect/history files
'5/18/98  3.1g fix for compare lOng filenames
'5/20/98  3.1h fix for start-at-line and isabort on startup
'5/28/98  3.1i fix for execute: error causes isabort=true
'6/8/98   3.1j fix iroot to be root!
'6/8/98   3.1j extend special vars menu to include foreach variables
'6/8/98   3.1j fix for appending truncating last \n (filter_do)
'7/28/98  3.1k fix for foreach value and also ELSEIF default
'9/1/98   3.1l fix for foreach in IF broken by 3.1k!

Effects Quickurl.EXE