***********************************************************
*
*  ------     Falcon ToolKit for XiRCON 1.0B4     ------
*                 version 1.51  6/28/1998
*
* written by: David Gravereaux <davygrvy@bigfoot.com> 
*
* Abstract: The DLL contained in this archive ( falcon.dll )
*           adds commands to XiRCON's scripting engine as a
*           loadable extension library.
*
***********************************************************

THIS PACKAGE IS FOR SCRIPT DEVELOPERS ONLY.  IF YOU ARE LOOKING FOR
PRE-BUILT SCRIPTS FOR XIRCON, YOU HAVE DOWNLOADED THE WRONG THING.

This Tcl extension library is freeware.  Do with it, what you want.
Just give me credit, if you make your work public.  Full source code 
is included for those who would like to expand on my work or help-out
with its development (!)  Who knows..  One day, I might stop working 
on this and it would be a shame if the source wasn't available for
those who would be capable of continuing with its development.

This DLL was built using Microsoft Visual C++ v5.0p3 and tested on
Windows NT Workstation 4.0sp3, and of course, XiRCON 1.0B4

You may redistribute falcon.dll freely with your scripts.  There's no
need to pass this whole archive (FalcTK150.zip) with your script package.
It might end up confusing people if you do.


Send me bug reports if you find one!


This extension library contains NINETEEN new Tcl functions for XiRCON:

  1) FALC_shell    : a non-blocking way to start programs/documents.
  2) FALC_fileopen : common dialogs similar, but WAY better, than mIRC's:
                        $file="Select a file:" c:\windows\*.txt
  3) FALC_wmatch   : a wild match function similar to Tcl's 'string match'
  4) FALC_hmatch   : similar to above, but its best use is for hostmask 
                        matching.
  5) FALC_ini      : reads/writes ini files.
  6) FALC_isip     : tests for a valid IP address.
  7) FALC_ip2long  : converts an IP into a network long IP.
  8) FALC_long2ip  : reverse of above.
  9) FALC_port     : resolves the TCP port # from a servicename.
 10) FALC_askbox   : configurable messagebox's that return values.
 11) FALC_listbox  : NEW! displays a dialog with a dropdown combo/listbox and
                        returns the selection.
 12) FALC_dialog   : NEW! creates dynamic dialogboxes.
 13) FALC_yield    : NEW! lets XiRC process pending events.
 14) FALC_winhelp  : opens winhelp.exe to a file, index and options 
                        that you specify.
 15) FALC_dde      : create and maintain DDE conversations.
 16) FALC_ddeserv  : NEW! sets the DDE server options.  Not fully working yet.
                        see commands.txt for an explanation on the DDE server.
 17) FALC_update   : the !REQUIRED! notifier.
 18) FALC_ver      : returns the version number of falcon.
 19) FALC_debug    : displays silly debugging info about falcon.


 See 'Commands.txt' for detailed explanation on the commands.


-- Release notes for v1.51 --

  - fixed-up the examples script.

  - Added the '-s <index>' option to the combo item in FALC_dialog.  This 
    will set the selection of the combobox to the <index> position and 
    tell it to return the selected index rather than the selected text.

-- Release notes for v1.50 --

  - FALC_bcast has been dropped in favor of a full service DDE server.

  - FALC_dde now has a working 'execute' command.  And a DDE server is
    working.  It isn't bug free though.  See FALC_ddeserv in 'Commands.txt'

  - FALC_yield is new.  Use it to unlock XiRC's GUI during long script
    procedures.

  - added a couple new options to FALC_fileopen. -e lets you enter a filename 
    that doesn't exist. -s uses a savefile common dialog.

  - FALC_listbox was added.  Its like 'prompt' but uses a combobox to select 
    from a list.

  - FALC_ini will be rewritten soon.  Sorry guys..  it needs updating.

  - FALC_dialog is new and FANTASTIC.  Try it, you'll like it.

  - I wrote a helpfile for XiRC.  It isn't finished, but here it is. My rtf 
    editor is crap, but one day when i get a better one, I'll finish it.

  - My eggdrop support script is in here too.  Its a great source for 
    examples in programming using the advanced new features added to XiRC 
    by falcon.dll .  BTW, its not done yet.  Its a work-in-progress.



-- Instructions to demo --

  > Place these files into your scripts directory:
       falc_151.tcl
       falcon.dll

  > And place Xircon.hlp and Xircon.cnt in the same directory as
    Xircon.exe if you want to try the winhelp features.

  > Type "/load falc_151.tcl" into anyone of XiRCON's windows. 
    Happy scripting!! :)



-- Legalese

 ** Copyrights:
 **   This software (source code and compiled DLL) contains code made 
 **   available by {David Gravereaux, herin, known as the "author"} 
 **   on an AS IS basis.  Any one receiving the module is considered 
 **   to be licensed under the author's copyrights to use the provided 
 **   source code in any way he or she deems fit, including copying it, 
 **   compiling it, modifying it, and redistributing it, with or without 
 **   modifications. No license under any of the author's patents or 
 **   patent applications is to be implied from this copyright license.
 **
 **   A user of the module should understand that the author can 
 **   provide technical support for the module, but it is not gauranteed
 **   and will not be responsible for any consequences of use of the 
 **   program. Even if your computer turns green and starts eating floopies.
 **
 **   Any notices, including this one, are not to be removed from the
 **   module without the prior written consent of the author. Except for
 **   redistribution of falcon.dll in a pre-built XiRCON script, which 
 **   is allowed.
 **
 **   Some code was taken from other sources. They are:
 **     1) Match.cpp is a verbatim adaptation of eggdrop's match.c 
 **        by Chris Fuller.
 **     2) dde.cpp was based heavily on dde11.c by Ken Corey
 **        and the tk8.1a1 release (c)1996-98 Sun MicroSystems Labs.
 **     3) Although, now, my code doesn't resemble code from the xircsdk,
 **        credit should go to Nate Lewis (xircsdkb.zip). For whom I 
 **        could not have started programming extensions for XiRC.
 **     4) tknt40r3 source code by Gordon Chaffee and Lawrence A. Rowe
 **        of UC Berkeley for the FALC_winhelp and FALC_askbox commands.
 **
 ** Author: David Gravereaux   mailto:davygrvy@bigfoot.com 
 **         (c)1998 Tomahawk Software Group
 **
 ** Note: All mentions of XiRCON are Copyright 
 **       (c) 1996-97 by Mark Hanson - All Rights Reserved.
