@database "XDCC-Get v3.42 - The Best AmIRC XDCC GUI"
@$VER: XdccGet.AMIRX 3.42 (23.5.98) Button XDCC Requestor AmigaGuide Docs
@author lanky "sykoe@sub.net.au  http://www.sub.net.au/~sykoe/"
@WORDWRAP
@INDEX Index
@node Main "XDCC-Get v3.42"
@font helvetica.font 15
@TOC Contents

                    @{b}AmIRC XDCC GUI  -  XDCC-Get v3.42@{ub}


                                           @{b}Written by:@{ub}
                     IRC:  @{fg highlight}lanky@{fg text}   Email:  @{fg highlight}sykoe@sub.net.au@{fg text}
                       Web:  @{fg highlight}http://www.sub.net.au/~sykoe/@{fg text}


                                        @{"Main Contents" link Contents}

@endnode
@node Contents "XDCC-Get v3.42 - Contents"
@next Introduction
@help HelpPage
@font helvetica.font 15

   @{b}Contents:@{ub}

  A fast, well laid out, fully featured GUI for XDCC requesting.

  Great for grabbing packs.  For example.. Kuang¹¹ offers.

  The best XDCC-Get script and utilises functions in Kuang Eleven © v3.x or higher!

  Way better then other XDCC-Get type script that is limited in comparison!


   @{" Introduction " link Introduction}  Sent a CTCP XDCC List sent to @{fg highlight}-@{fg text}  Introduction to the philosophy

   @{" Requirements " link Requirements}  @{fg highlight}-@{fg text}  What you need for this program to work

   @{" Thanks " link Thanks}  @{fg highlight}-@{fg text}  People who help make XDCC-Get what it is today

   @{" Installation & Usage " link Usage}  @{fg highlight}-@{fg text}  Installation & Usage on your system (Options Have Changed!)

   @{" Menu Over-View " link Menus}  @{fg highlight}-@{fg text}  The Full Menu Over-View (Not Completed Yet)

   @{" XDCC-Get FAQ " link FAQ}  @{fg highlight}-@{fg text}  XDCC-Get Frequently Asked Questions

   @{" History " link History}  @{fg highlight}-@{fg text}  The past problems and triumphs

   @{" Future " link ToDo}  @{fg highlight}-@{fg text}  Ideas and improvements to come for XDCC-Get(?)

   @{" Contact " link Contact}  @{fg highlight}-@{fg text}  How and where to contact the author

   @{" Legalities " link Legal}  @{fg highlight}-@{fg text}  Protecting the innocent from the money making lawyers

   @{" Index " link Index}  @{fg highlight}-@{fg text}  Index of this Amigaguide (For pre v39 users)


@{fg highlight}*@{fg text}  This whole project is in memory of the recently departed Seona.  I'll miss you always.
@endnode
@node Introduction "XDCC-Get v3.42 - Introduction"
@next Requirements
@prev Contents
@help HelpPage
@font XEN.font 11

@{b}Introduction:@{ub}

Welcome to XDCC-Get.  This is just for AmIRC users who use XDCC Bots.  If you ever have requested files off XDCC Bots on IRC, you know that they can be a pain.  A lot of typing that is repeatative.  Some people set Buttons and some people set F-Keys in AmIRC.  There have been average attempts at scripts also, but alas nothing to make it a definately perfect solution.


The Answer?
I saw Bossman^'s XdccGetFile (v2.1) AmIRC script and instantly thought, it is good but lacks a million things that people do need.  Mostly it was cumbersome to use due to not full and proper keyboard support.  Also it didn't support /Msg XDCC support for Un*x type XDCC Bots and lacked multiple pack requesting.

After being frustrated enough, I worked and fixed it for my own needs.  Nearing what was v3.00beta I asked Bossman^ if I could release it publically.  He agreed and the rest is @{" history " link History}.

This program is specifically made to work in conjunction with AmIRC.  I found myself having too many buttons in AmIRC thus the original GUI by @{" Bossman^ " link History} I saw was a great idea.  I also found that on occasions that some XDCC Bots only supported /Msg XDCC commands instead of the usual /CTCP XDCC commands.  Thus extending the GUI was needed.

The program was made to make it easier to get XDCC Packs.  More current versions has made this program even more powerful for people that want to go directly to certain parts inside the program (See @{" Usage " link Usage}).


XDCC-Get was made to support the following:

@{fg highlight}-@{fg text}  An easy to use GUI to request XDCC packs from.

@{fg highlight}-@{fg text}  Has temporary DCC AutoGet for Kuang 11 v3.x or higher users.

@{fg highlight}-@{fg text}  CTCP & Msg XDCC requests.

@{fg highlight}-@{fg text}  Multiple CTCP/Msg XDCC requesting.

@{fg highlight}-@{fg text}  Protection so only numeric packs will be requested.

@{fg highlight}-@{fg text}  Anti-Flooding protection on Multi-requesting.

@{fg highlight}-@{fg text}  Open a Query window to view the XDCC list in. (Optional)

@{fg highlight}-@{fg text}  Start in any part of the program in CTCP or Msg format. (Even Listing)

@{fg highlight}-@{fg text}  Clean output. (CTCP and Msg output are Clean)

@{fg highlight}-@{fg text}  FULL mouse/keyboard support for every pack number.

@{fg highlight}-@{fg text}  Optimised code.

@{fg highlight}-@{fg text}  Jump to the author's Web Page.


NOTE: Some of the Options Changed, So read the @{" Usage " link Usage} information.


     ._____
  ___| _  /_/\_ _ /\__  /\__
  \_ _  _/____ \_/ __/__ __/
  /  |___\|  |  |  |  |  |  |
 /___|GET v3.42_l_____l_____|
@endnode
@node Requirements "XDCC-Get v3.42 - Requirements"
@next Thanks
@prev Introduction
@help HelpPage
@font XEN.font 11

@{b}Requirements:@{ub}


What you need for this program to operate fully:

@{fg highlight}-@{fg text}  AmIRC IRC Client  (Available on AmiNET or ftp.vapor.com or alternatively http://www.vapor.com)

@{fg highlight}-@{fg text}  RexxReqTools.library in Libs: (In This Pack, for the full pack goto AmiNET:utils/libs/ReqToolsUsr.lha)

@{fg highlight}-@{fg text}  RexxSupport.library & RexxDosSupport.library in Libs: (From your Workbench disks)

@{fg highlight}-@{fg text}  RexxMast Running  (Needed for any ARexx script to work, and available from your Workbench disks)

@endnode
@node Thanks "XDCC-Get v3.42 - Thanks"
@next Usage
@prev Requirements
@help HelpPage
@font XEN.font 11

@{b}Thanks goes to:@{ub}

@{fg highlight}*@{fg text}  Bossman^ for the great idea he started.

@{fg highlight}*@{fg text}  KingGuppy for help on some program imporovements and ARexx command help.

@{fg highlight}*@{fg text}  Ariel (ARexx Messiah) for help on Kuang v3+ Temporary AutoGet and general ARexx command teachings.

@{fg highlight}*@{fg text}  Term!nator, eNTHRONE^,etc for his cool ASCII logo(File_ID.DiZ & see above),
    Beta testing sessions, Improvement ideas & support

@{fg highlight}*@{fg text}  Cyber2th for Beta testing and locating the Query Window Bug.  (How did I miss that?!)

@{fg highlight}*@{fg text}  Dragster^ for being a great Beta tester & Multiple Pack Selection Idea)

@{fg highlight}*@{fg text}  HeavyWeight for wording for Pack requests to the local user

@{fg highlight}*@{fg text}  Zarovich for separate List Query Window with easy viewing Option..

@{fg highlight}*@{fg text}  Anton Rolls for his help on some ARexx.

@{fg highlight}*@{fg text}  This whole project is in memory of the recently departed Seona.  I'll miss you always.
@endnode
@node Usage "XDCC-Get v3.42 - Usage"
@prev Requirements
@next Menus
@help HelpPage
@font XEN.font 11

@{b}Inbstallation & Usage:@{ub}

For Usage upon your system just copy the file XdccGet.amirx to your AmIRC/Rexx drawer and RexxReqTools.library to your Libs: Drawer.

Once you have done that, Start up AmIRC and then type the following:

/Alias XDCCGet /Rx XdccGet.amirx %p
Then Save your Settings under the Settings menu.

If you wish to have have a button for XDCC-Get, then go to your Settings/Setup menu and add an Action button with a label of XDCCGet and a Operation of /XDCCGet %u


Some Options have changed since 3.25 public release.  So Please read below.

Usage: /XDCCGet <Nick> [Option] , [C/M]

<Nick> is the person you wish to request XDCC Packs from and is always required.

[Option] can be a pack # you wish to request or:
 LIST       -  XDCC List
 INPUT      -  Pack input window
 MANUAL     -  Manual pack input window  (Changed since 3.25 Public)
 LISTINPUT  -  XDCC List and also brings up the pack input window
 LISTMANUAL -  XDCC List and also brings up the manual pack input window. (Changed Since 3.25 Public)

, [C/M] where C is CTCP requests/GUI and M is Msg requests/GUI.  (Always prefix C or M with a , )


XDCC-Get has a few extra options that allow the user to directly go to a certain part of XDCC-Get, they are:

@{b}/XDCCGet <Nick> <Pack> , [C/M]@{ub}       @{fg highlight}-@{fg text}  Request CTCP XDCC Pack # (No Need to type #) on person <Nick>

@{b}/XDCCGet <Nick> @{" List " link L}, [C/M]@{ub}         @{fg highlight}-@{fg text}  Do a CTCP XDCC List on the person <Nick>

@{b}/XDCCGet <Nick> @{" Input " link P}, [C/M]@{ub}        @{fg highlight}-@{fg text}  Open a CTCP Pack Input Window on the person <Nick>

@{b}/XDCCGet <Nick> @{" ListInput " link LP}, [C/M]@{ub}    @{fg highlight}-@{fg text}  Do a CTCP XDCC List and open a CTCP Pack Input Window on the person <Nick>

@{b}/XDCCGet <Nick> @{" Manual " link Man}, [C/M]@{ub}        @{fg highlight}-@{fg text}  Open a CTCP Multi Pack Input Window on the person <Nick>

@{b}/XDCCGet <Nick> @{" ListManual " link LMan}, [C/M]@{ub}    @{fg highlight}-@{fg text}  Do a CTCP XDCC List and open a CTCP Multi Pack Input Window on the person <Nick>

@{b}/XDCCGet <nick> [OPTION] , [C/M]@{ub}     @{fg highlight}-@{fg text}  Where [C/M] is C = CTCP and M = Msg requesting

For buttons use, replace <nick> with %u


If you wish the program to open up a Separate Query for the list offered to be viewed in, then you have to edit the ARexx script and change  @{fg highlight}QUERY="NO"@{fg text}  to  @{fg highlight}QUERY="YES"@{fg text}


@endnode
@node ToDo "XDCC-Get v3.42 - To Do"
@prev History
@next Contact
@help HelpPage
@font XEN.font 11

@{b}To Do:@{ub}

Don't Expect this to be perfetly optimised nor perfect..  I am still learning everyday.

@{fg highlight}-@{fg text}  An API application.  I require the API headers/information to do such a thing. (I Don't See A Reason For An API In This Case)

@{fg highlight}-@{fg text}  A MUI(Rexx) application.  The MUIRexx's author logic circuits are messed up!

@{fg highlight}-@{fg text}  Move this AmiagGuide documentation to HTML format. (Suggested by Bossman^)

@{fg highlight}-@{fg text}  A Shutdown of Miami automatically once all selected files have been downloaded. (Dragster^)

@{fg highlight}-@{fg text}  More Kuang11 v3.0 connectivity for extra "special" options. (Dragster's and alike)

@{fg highlight}-@{fg text}  Any ideas you suggest.

Any more ideas please @{" Contact " link Contact} myself.



@endnode
@node Menus "XDCC-Get v3.42 - Full Menu Over-View - CTCP Menu"
@prev Usage
@next FAQ
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - CTCP Menu:@{ub}

This section is a Oview of the GUI, explaining how it works what each buttomns does, with links where each button is.

I hope this solves some people's problems and fears with this program.


+--------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - CTCP Menu                                 |@|
+--------------------------------------------------------------------+-+
| Choose your CTCP XDCC Request from XDCC                              |
|                                                                      |
| O - Requests a list and opens the Pack GUI                           |
| L - Requests a list and Quits                                        |
| P - Goes to pack input menu                                          |
| M - Go to XDCC-Get Msg menu                                          |
| A - Brings up the Author's information                               |
+----------------------------------------------------------------------+
| @{" List & Open Pack GUI " link LP} @{" List & Quit " link L} @{" Pack " link P} @{" Msg " link M} @{" About " link A} @{" Quit " link Q} |
+----------------------------------------------------------------------+

@{" List & Open Pack GUI " link LP}  -  Gets a CTCP XDCC List of all the packs on offer from the person the GUI is activated on.

@{" List & Quit " link L}           -  Does a CTCP XDCC List from the person the GUI is activated on and then Quits the GUI

@{" Pack " link P}                  -  Goto to the Pack Input Menu to select which pack(files) to download from the person the GUI is activated on.

@{" Msg " link M}                   -  Goes to Msg format for XDCC requesting (Used by some Unix XDCC Bots and some Mac ones)

@{" About " link A}                 -  Takes you to the About Menu.
                            Gives general infoormation about the Program/Author.
                            With buttons to open up YAM to email the Author or
                             open up his Web Page on IBrowse, AWeb or Voyager.

@{" Quit " link Q}                  -  Quits the XDCC-Get GUI and program totally.
@endnode
@node M "XDCC-Get v3.42 - Full Menu Over-View - Msg Menu"
@prev Menus
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - Msg Menu:@{ub}

This section is a Oview of the GUI, explaining how it works what each buttomns does, with links where each button is.

I hope this solves some people's problems and fears with this program.


+---------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - Msg Menu                                   |@|
+---------------------------------------------------------------------+-+
| Choose your Msg XDCC Request from XDCC                                |
|                                                                       |
| O - Requests a list and opens the Pack GUI                            |
| L - Requests a list and Quits                                         |
| P - Goes to pack input menu                                           |
| M - Go to XDCC-Get Msg menu                                           |
| A - Brings up the Author's information                                |
+-----------------------------------------------------------------------+
| @{" List & Open Pack GUI " link LP} @{" List & Quit " link L} @{" Pack " link P} @{" CTCP " link Menus} @{" About " link A} @{" Quit " link Q} |
+-----------------------------------------------------------------------+

@{" List & Open Pack GUI " link LP}  -  Gets a Msg XDCC List of all the packs on offer from the person the GUI is activated on.

@{" List & Quit " link L}           -  Does a Msg XDCC List from the person the GUI is activated on and then Quits the GUI

@{" Pack " link P}                  -  Goto to the Pack Input Menu to select which pack(files) to download from the person the GUI is activated on.

@{" CTCP " link Menus}                  -  Goes to CTCP format for XDCC requesting (Used by most XDCC Bots)

@{" About " link A}                 -  Takes you to the About Menu.
                            Gives general information about the Program/Author.
                            With buttons to open up YAM to email the Author or
                             open up his Web Page on IBrowse, AWeb or Voyager.

@{" Quit " link Q}                  -  Quits the XDCC-Get GUI and program totally.
@endnode
@node LP "XDCC-Get v3.42 - Full Menu Over-View - List & Open Pack GUI"
@prev Menus
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - List & Open Pack GUI:@{ub}

This will get a XDCC List off the person you set XDCC-Get to work on.

If it responds nothing this may be due to your lag or the other persons lag.

If ya have waited for some time and you get no responce, try to ping the person (/ping <nick>)  if that takes a lot of time to get back or doesnt ever, the person has crashed or one of you two is lagged badly.

If the Ping replies, then try XDCC-Get with the other format,  Example: Try Msg Format or CTCP Format..  the different one to what you tried previously.
(  Msg or CTCP Menu of XDCC-Get  )
(  /XDCCGet <nick> List ,m    or    /XDCCGet <nick> List ,c  )

*Note:  Lag/Lagged means the time to send a message to someone is long and slow, similar to jet la, as you feel tired/larthargic.


@{b}After it sends out the List to the person, it will open this GUI:@{ub}

Please note the numbers below can be any variable group of 10 ascending numbers..

+--------------------------------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - Pack Input Request Menu                                           |@|
+--------------------------------------------------------------------------------------------+-+
|                       Pick the XDCC pack number to request from XDCC                         |
|                       M for Manual to input more easily multiple packs                       |
|                       N or Return will choose Next                                           |
+----------------------------------------------------------------------------------------------+
|@{" 11 " link P} @{" 12 " link P} @{" 13 " link P} @{" 13 " link P} @{" 14 " link P} @{" 15 " link P} @{" 16 " link P} @{" 17 " link P} @{" 18 " link P} @{" 19 " link P} @{" 20 " link P} @{" Next " link P} @{" Manual " link Man} @{" Prev " link P} @{" Quit " link Q}|
+----------------------------------------------------------------------------------------------+

@{" 11 " link P} to @{" 20 " link P}                  -  Request the pack number from the person the GUI is activated on.

@{" Next " link P}                         -  Moves the menus buttons to the Next 10 packs.

@{" Manual " link Man}                       -  Takes you to the Manual Input Menu (Enter [Multiple] Packs via the keyboard

@{" Prev " link P} (Appears when over 10)  -  Moves the menus buttons to the Previous 10 Packs (If Available).

@{" Quit " link Q}                         -  Quits the XDCC-Get GUI and program totally.
@endnode
@node P "XDCC-Get v3.42 - Full Menu Over-View - Pack Input Menu"
@prev Menus
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - Pack Input Menu:@{ub}


Please note the numbers below can be any variable group of 10 ascending numbers..

+--------------------------------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - Pack Input Request Menu                                           |@|
+--------------------------------------------------------------------------------------------+-+
|                        Pick the XDCC pack number to request from XDCC                        |
|                        M for Manual to input easily multiple packs                           |
|                        N or Return will choose Next                                          |
+----------------------------------------------------------------------------------------------+
|@{" 11 " link P} @{" 12 " link P} @{" 13 " link P} @{" 13 " link P} @{" 14 " link P} @{" 15 " link P} @{" 16 " link P} @{" 17 " link P} @{" 18 " link P} @{" 19 " link P} @{" 20 " link P} @{" Next " link P} @{" Manual " link Man} @{" Prev " link P} @{" Quit " link Q}|
+----------------------------------------------------------------------------------------------+

@{" 11 " link P} to @{" 20 " link P}                  -  Request the pack number from the person the GUI is activated on.

@{" Next " link P}                         -  Moves the menus buttons to the Next 10 packs.

@{" Manual " link Man}                       -  Takes you to the Manual Input Menu (Enter [Multiple] Packs via the keyboard

@{" Prev " link P} (Appears when over 10)  -  Moves the menus buttons to the Previous 10 Packs (If Available).

@{" Quit " link Q}                         -  Quits the XDCC-Get GUI and program totally.
@endnode
@node LMan "XDCC-Get v3.42 - Full Menu Over-View - List & Manual Input Menu"
@prev P
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - List & Manual Input Menu:@{ub}


This will first get a XDCC List off the person you set XDCC-Get to work on then open the GUI below.

If it responds nothing this may be due to your lag or the other persons lag.

If ya have waited for some time and you get no responce, try to ping the person (/ping <nick>)  if that takes a lot of time to get back or doesnt ever, the person has crashed or one of you two is lagged badly.

If the Ping replies, then try XDCC-Get with the other format,  Example: Try Msg Format or CTCP Format..  the different one to what you tried previously.
(  Msg or CTCP Menu of XDCC-Get  )
(  /XDCCGet <nick> ListManual ,m    or    /XDCCGet <nick> ListManual ,c  )

*Note:  Lag/Lagged means the time to send a message to someone is long and slow, similar to jet la, as you feel tired/larthargic.


@{b}After it sends out the List to the person, it will open this GUI:@{ub}

+-----------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - Manual Input Pack Request Menu               |@|
+-----------------------------------------------------------------------+-+
| Enter numeric XDCC pack #'s to request from XDCC                        |
| You can put a space or . , - / + * \ between each.  Example: 5,8,12,18  |
+-------------------------------------------------------------------------+
| +---------------------------------------------------------------------+ |
| | @{" String Here " link Man}                                                      | |
| +---------------------------------------------------------------------+ |
+-------------------------------------------------------------------------+
| @{" Ok " link P}                                                            @{" Quit " link Q} |
+-------------------------------------------------------------------------+

@{" String Here " link LMan}  -  Packs to request from the person the GUI is activated on.

@{" Ok " link P}           -  Request the pack numbers entered or Quit of the string area is empty.

@{" Quit " link Q}         -  Quit XDCC-Get.

@endnode
@node Man "XDCC-Get v3.42 - Full Menu Over-View - Manual Input Menu"
@prev P
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - Manual Input Menu:@{ub}

+-----------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - Manual Input Pack Request Menu               |@|
+-----------------------------------------------------------------------+-+
| Enter numeric XDCC pack #'s to request from XDCC                        |
| You can put a space or . , - / + * \ between each.  Example: 5,8,12,18  |
+-------------------------------------------------------------------------+
| +---------------------------------------------------------------------+ |
| | @{" String Here " link Man}                                                      | |
| +---------------------------------------------------------------------+ |
+-------------------------------------------------------------------------+
| @{" Ok " link P}                                                            @{" Quit " link Q} |
+-------------------------------------------------------------------------+

@{" String Here " link Man}  -  Packs to request from the person the GUI is activated on.

@{" Ok " link P}           -  Request the pack numbers entered or Quit of the string area is empty.

@{" Quit " link Q}         -  Quit XDCC-Get.

@endnode
@node L "XDCC-Get v3.42 - Full Menu Over-View - List"
@prev Menus
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - List:@{ub}

This will get a XDCC List off the person you set XDCC-Get to work on.

If it responds nothing this may be due to your lag or the other persons lag.

If ya have waited for some time and you get no responce, try to ping the person (/ping <nick>)  if that takes a lot of time to get back or doesnt ever, the person has crashed or one of you two is lagged badly.

If the Ping replies, then try XDCC-Get with the other format,  Example: Try Msg Format or CTCP Format..  the different one to what you tried previously.
(  Msg or CTCP Menu of XDCC-Get  )
(  /XDCCGet <nick> List ,m    or    /XDCCGet <nick> List ,c  )

*Note:  Lag/Lagged means the time to send a message to someone is long and slow, similar to jet la, as you feel tired/larthargic.
@endnode
@node A "XDCC-Get v3.42 - Full Menu Over-View - About"
@prev Menus
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - About:@{ub}

+------------------------------------------------------------------------------+-+
|XDCC-Get v3.42 by lanky - About Menu                                          |@|
+------------------------------------------------------------------------------+-+
| XDCC-Get v3.42.  For any comments / ideas / suggestions contact me:            |
| IRC: lanky  -  EMail: sykoe@sub.net.au  -  Web: http://www.sub.net.au/~sykoe/  |
+--------------------------------------------------------------------------------+
| @{" Ok " link Menus}  @{" Yam EMail " link A}  @{" IBrowse " link A}  @{" Voyager " link A}  @{" AWeb " link A}                             |
+--------------------------------------------------------------------------------+

@{" Ok " link Menus}         -  Takes you back the Main XDCC-Get Menu

@{" Yam EMail " link A}         -  Open's Up YAM 1.3.x or 2.0.x and prepares a messaage to type to the Author.

@{" IBrowse " link A}         -  Opens up the Author's Web Home Page on IBrowse.

@{" Voyager " link A}         -  Opens up the Author's Web Home Page on Voyager.

@{" AWeb " link A}         -  Opens up the Author's Web Home Page on AWeb.
@endnode
@node Q "XDCC-Get v3.42 - Full Menu Over-View - Quit"
@prev
@help HelpPage
@font XEN.font 9

@{b}Full Menus Over-View - Quit:@{ub}

The @{b}Quit@{ub} button will Leave XDCC-Get totally.  Putting you as you were before you ran XDCC-Get.


@endnode
@node FAQ "XDCC-Get v3.42 - FAQ"
@prev Menus
@next History
@help HelpPage
@font XEN.font 11

@{b}Frequently Asked Questions:@{ub}


@{fg highlight}Q)@{fg text}  What is XDCC-Get?

@{fg highlight}A)@{fg text}  A GUI to easily and quickly do XDCC requesting.


@{fg highlight}Q)@{fg text}  What is XDCC requesting?

@{fg highlight}A)@{fg text}  An easy automated way to grab files off people in an IRC channel.


@{fg highlight}Q)@{fg text}  Why can't people get files from me with XDCC-Get?

@{fg highlight}A)@{fg text}  Because this is to get packs easily (leech).  There are numerous tools on various formats to XDCC Offer (Give out files).


@{fg highlight}Q)@{fg text}  What program would I use to set up a XDCC to offer from?

@{fg highlight}A)@{fg text}  For AmIRC, Kuang 11 is the best I have seen.  The easiest is the XDCC API built into AmIRC v2.0+.  For Unix BitchX is very good.


@{fg highlight}Q)@{fg text}  I have installed XDCC-Get but when I try to run it, it doesn't work?

@{fg highlight}A)@{fg text}  Make sure rexxreqtools.library is in Libs: and XdccGet.amirx is in your AmIRC/Rexx drawer.  If you are using the Alias /XDCCGet then re-enter it using /Alias XDCCGet /Rx XdccGet.amirx %p   Then save your AmIRC prefs.


@{fg highlight}Q)@{fg text}  XDCC-Get GUI is nice, but why isn't it MUI?

@{fg highlight}A)@{fg text}  Because XdccGetFile originally was written to use RexxReqTools and still is as my main priority was to firstly get it to a level that I wanted.  Its slow enough as is and I have optimised the code.  With MUI it would be even slower.  I will look into MUI though and do a trial version to see the speed.


@{fg highlight}Q)@{fg text}  When I order a few packs through the Multi Input Window it sends the requests out slowly, Why?

@{fg highlight}A)@{fg text}  I made XDCC-Get so you will not flood the person you are requesting packs from.


@{fg highlight}Q)@{fg text}  Why doesn't XDCC-Get open a window that the list appears in and you click on the pack name to get it?

@{fg highlight}A)@{fg text}  XDCC-Get is AREXX, to do that it would be very slow.  Making it API (Which I am considering) would make it better.  XDCC listings are also not uniform unfortunately which causes heaches on making such an option.


@{fg highlight}Q)@{fg text}  Why doesn't XDCC-Get work on Windows(TM)?

@{fg highlight}A)@{fg text}  It would require a 2000 Intel Parrallel CPU system that could warm up the dark side of pluto to 500,000 degrees celcius just to get it work like on an A500.


@{fg highlight}Q)@{fg text}  When I use XDCC-Get for multiple manual inputs requests, I put in 1 5 8 and it comes back with an error that quits the program, why?

@{fg highlight}A)@{fg text}  You are supposed to separate the packs with a , only (Example: 1,5,8).  Also make sure the script is still called XdccGet.amirx as renaming it will cause troubles.


@{fg highlight}Q)@{fg text}  Can I donate a small sum of money to author for his effort?

@{fg highlight}A)@{fg text}  Yes, contact me via EMail to organise the best way if you wish to do so.


@{fg highlight}Q)@{fg text}  I have an idea for it I wish to see, would you add it?

@{fg highlight}A)@{fg text}  I have added nearly all additions requested off me that are possible.  @{" Contact me " link Contact} ASAP and I will definately try to implement it at least.


@{fg highlight}Q)@{fg text}  Where do I get new versions of XDCC-Get?

@{fg highlight}A)@{fg text}  At this stage Aminet or @{" me " link Contact} directly on my XDCC.  Also now available at:  http://www.sub.net.au/~sykoe/


@{fg highlight}Q)@{fg text}  I think I found a bug in XDCC-Get, should I notify the Author?

@{fg highlight}A)@{fg text}  Please do @{" Contact me " link Contact}.  I enjoy feedback and hopefully one day I wish to remove all the bugs out of this program.


@{fg highlight}Q)@{fg text}  I think I know a better way of doing some of the coding in XDCC-Get.

@{fg highlight}A)@{fg text}  Please @{" Contact me " link Contact} to let me know how.


@{fg highlight}Q)@{fg text}  Can I use some of the code in XDCC-get in my own ARexx scripts?

@{fg highlight}A)@{fg text}  Yes, I learnt and built this up by looking and learning at other's code (and also the good ol' Workbench 3.1 Arexx Manual).


@endnode
@node History "XDCC-Get v3.42 - History"
@prev FAQ
@next ToDo
@help HelpPage
@font XEN.font 11

@{b}History:@{ub}

@{u}For v2.1 and previous:@{uu}
XdccGetFile.amirx 2.1  -  (C) 1997 by Bossman^

IRC: Bossman^   Email: bosman@erols.com   Web:www.erols.com/bosman
More of Bossman^'s AmIRC scripts can be found on his Homepage.
I thank Bossman^ for letting me expand XDCC-Get further.


@{fg highlight}XDCC-Get v3.0 onwards history:@{fg text}

Public Release
    v3.42 Added: Fixed a check for quick pack requesting.
    (23.05.98)   Removed unnecessary BOLD closures (Speed up text output).
                 Re-worded/Changed Bold styles to match Kuang 11.

Public Release
    v3.41 Added: Fixed a missed bit of optimisation in my code.
     (18.4.98)   Added check for rexxsupport.library & rexxdossupport.library
                  (Including a fix for rexxreqtools.library check)
                 Added Thanks area to list properly all the people who have
                  helped me in my work on XDCC-Get.

Public Release
    v3.40 Added: Fixed Which Screen Opening On Bug. (Dragster^)
     (07.4.98)    (Was from v3.37, Beta Testers.. Where were you?)

Public Release
    v3.39 Added: Changed all menu titles.
     (06.4.98)   Changed all menu display format.
                 Fixed a stupid oversight, Usage Info is now faster.
                 Fixed the AmigaGuide Contents page button.

    v3.38 Added: Added Full Menu Over-View Documentation. (What A Job!)
     (05.4.98)   General Overhawl on the AmigaGuide.
                 Optimised the code further.
                 Removed Kuang 11 v3.0+ Not Installed Warning.
                 Fixed information above the buttons on some Menus.

    v3.37 Added: Fixed QUERY window bug.  How the hell did I miss that bug?!
     (02.4.98)    and also removed more redundant code (Thanks Cyber2th)
                 More adaptable in handling Query window Yes/No options.
                 Cleaned up the internal Prefs look.

    v3.36 Added: Temporary DCC AutoGet for Kuang 11 v3.x onward users.
     (31.3.98)   Shows also the Version when ran without any arguements.
                 1(One) line of Code, to speed up its operation.

Public Release
    v3.35 Added: Optimised some code.
     (25.3.98)   Default XDCC type is CTCP is wrong value entered in [C/M].
                 Cleaned up display/local output.
                 Cleaned up internal help.
                 Changed MULTI & LISTMULTI to
                  MANUAL & LISTMANUAL respectively to make it more logical.
                 Fixed Input window menu so it does not look so bad under
                  640x480 with XEN/11.

    v3.30 Added: The Multiple Input Window allows:
     (21.3.98)    ","  " "  "."  "-"  "+"  "*"  "/" "\"
                  to separate pack numbers now.
                  (Thanks to KingGuppy/Anton for the Help/Ideas)

    v3.25 Added: Added Full mouse operation even on packs over pack 10
     (21.3.98)   while still keeping FULL keyboard support in the program!
                  (Thanks to Anton for the Ideas/Help)

Public Release
    v3.23 Added: /XDCCGet <nick> [OPTION] , [C/M] (C = CTCP / M = Msg)
     (20.3.98)   Now Allows Instant Msg actions.
                 Now allows starting any part of the GUI in Msg mode.
                 Made code less redundant due to Msg option.
                 Added jump buttons to my WebPage via IBrowse/Voyager/AWeb.
                 Fixed a nasty workaround I had to re-open the multi request
                  window if you typed a non numeric entry.

    v3.22 Added: Cleaned up text strings.
     (15.2.98)   Made rexxreqtools.library checking 100%
                 Made help text appear properly.
                 Making a German translation (Translators HD Went B00M!)
                  (I don't know a word of German!)

Public Release
    v3.21 Added: Made flood protection more bullet proof.
     (24.1.98)    (Now 1 request per 5 seconds)

Public Release:
    v3.20 Added: Renamed Input Window with Multi Input Window.
     (20.1.98)   Added Multi & ListMulti Options.
                 Anti-Flooding Code on the Multi Pack Requesting Window.
                 Numeric Numbers Only Accepted on Multi Pack Requesting.
                 Greater Optimisation of Code (Less Lines Makes It Faster).

    v3.19 Added: Added Multi Manual Pack Requesting Window.
     (19.1.98)    This was needed to work around a limit in RexxReqTools
                  so that the "," would be accepted.

Public Release:
    v3.18 Added: Looped Pack Requesting on the Manual Input Window.
     (18.1.98)    (Required a bit of tinkering with the code)

    v3.17 Added: Internal Option to Open a Separate Query Window to view
     (18.1.98)    XDCC Lists in.  Like that they won't clutter your
                  Channel Window. (Thanks Zarovich for the idea)

Public Release:
    v3.16 Added: Fixed /XDCCGet <Nick> ListInput.
     (13.1.98)   Fixed Info on Alias setup in .amirx and .readme file.
                  (If Alias didn't work, Set-up with info from Usage)
                 Fixed *ALL* Internal Version Numbers
                 Added protection so only numeric packs will be ordered
                  with  /XDCCGet <Nick> <Pack>

Public Release:
    v3.15 Added: Instant CTCP XDCC List.
     (12.1.98)     /Rx XdccGet.amirc <nick> LIST
                  Or use an Alias to make it a lot shorter..
                   /XdccGet <Nick> LIST

                 Instant CTCP XDCC List & Pack get.
                   /Rx XdccGet.amirc <nick> LISTINPUT
                  Or use an Alias to make it a lot shorter..
                   /XdccGet <Nick> LISTINPUT

    v3.12 Added: Instant CTCP XDCC Pack get and Instant Input Window
     (11.1.98)     /Rx XdccGet.amirc <nick> <pack>
                  Or use an Alias to make it a lot shorter..
                   /XdccGet <Nick> <Pack>
                 Where Pack can be a number or INPUT to go straight to the
                 Input Window.


    v3.10 Added: Multi-pack request support. (Thanks Dragster^ for the idea)
     (10.1.98)   Changed Cancel's to Quit's for better looks, and function.
                 (Q at any time wll Quit XDCC-Get)
                 Improved presenation of the Input Window.
                 Added Yam EMail to Author Button. (Under About)

Public Release:
    v3.05 Added: Optimised the redundant Text.
      (9.1.98)   Changed local pack request text. (Thanks HeavyWeight)

    v3.02 Added: Fix the pack selection. Somehow I missed Pack 14!
      (8.1.98)   Optimised the code even more (However slight that was)
                 NonClean Output Support Dropped.

Public Release:
    v3.01 Added: /Msg Xdcc Support for Other Xdcc platforms.
      (7.1.98)   Cleaned Up Code.
                 More And Better Key ShortCuts.
     [ First     Warning Of No Nick Given Now Works.
       Public     (Warning doesn't work as a button due to AmIRC)
      Release ]  Clean Output (Hidden /CTCP & /Msg) Version.
                 Better Presented Generally.


@endnode
@node Contact "XDCC-Get v3.42 - Contact"
@prev History
@next Legal
@help HelpPage
@font XEN.font 11

@{b}Contact:@{ub}


To contact myself for improvements, ideas or a chat..  You can contact myself in the following ways:


                                  @{b}Internet Email:@{ub}
                                 sykoe@sub.net.au



                                  @{b}Internet Chat:@{ub}
         IRC channel: #AmigaZone on sydney.oz.org  Port: 6667  Nick: lanky



                                    @{b}HomePage:@{ub}
                          http://www.sub.net.au/~sykoe/



                        @{b}Shoikan Grove BBS (My Own BBS! 8):@{ub}
                                 +61-3-9317-3857
                             (Melbourne, Australia)




@endnode
@node Legal "XDCC-Get v3.42 - Legalities"
@prev Contents
@help HelpPage
@font XEN.font 11

@{b}Legalities:@{ub}

The author of this program is not in any way liable for any injury, sickness, loss of income or personal problems caused by the contents of this archive and its use including data loss/mental problems/or too much sex because this program attracts hot sexy sentual women. ;)


@endnode
@node Index "XDCCC-Get v3.42 - Index"
@prev Contents
@help HelpPage
@font helvetica.font 15

@{u}@{b}Index:@{ub}@{uu}

   @{" AmigaGuide Manufacture " link Manufacture}  @{fg highlight}-@{fg text}  How this AmigaGuide file was made

   @{" Introduction " link Introduction}  @{fg highlight}-@{fg text}  Introduction to the program

   @{" Requirements " link Requirements}  @{fg highlight}-@{fg text}  Requirements to run the program

   @{" Installation & Usage " link Usage}  @{fg highlight}-@{fg text}  Installation & Usage With AmIRC

   @{" FAQ " link FAQ}  @{fg highlight}-@{fg text}  Frequently Asked Questions about XDCC-Get

   @{" History " link History}  @{fg highlight}-@{fg text} History of the program to date

   @{" Ideas " link ToDo}  @{fg highlight}-@{fg text}  Ideas and improvements to come for XDCC-Get

   @{" Contact " link Contact}  @{fg highlight}-@{fg text}  How and where to contact all the authors

   @{" Legalities " link Legal}  @{fg highlight}-@{fg text}  Protecting the innocent from the money making lawyers



@endnode
@node Manufacture "XDCC-Get v3.42 - AmigaGuide Manufacture"
@prev Index
@help HelpPage
@font XEN.font 11

@{b}Manufacture of this AmigaGuide document:@{ub}

This document was made in a plain ASCII editor with no extra utils.  All done by hand.
For any improvements on this AmigaGuide @{" please notify myself " link Contact}.

I used in this AmigaGuide:

@{fg highlight}-@{fg text} Wordwrap, (Makes typing wrap around if you resize the reader screen size and even if you have different screen resolutions)

@{fg highlight}-@{fg text} @{u}Underline@{uu},

@{fg highlight}-@{fg text} @{b}Bold@{ub},

@{fg highlight}-@{fg text} @{fg highlight}Foreground @{fg fill}text@{fg highlight} alteration@{fg text}, (I didn't do @{bg fill}background@{bg background} text alteration because it looks generally cruddy)

@{fg highlight}-@{fg text} Index Support, (For v39+[OS 3+]) users and Pre v39 [OS 2] users also! :)

@{fg highlight}-@{fg text} Browsing fully supported and controlled, (Next and Prev keywords)

@{fg highlight}-@{fg text} Use of different fonts,

@{fg highlight}-@{fg text} Basic setup for @{" Help Screens " link HelpPage},

@{fg highlight}-@{fg text} and "Version" works on this AmigaGuide!  ($VER: )

@endnode
@node HelpPage "XDCC-Get v3.42 - Help Pages"
@prev Contents


                       @{b}@{u}Help Pages !@{ub}@{uu}

If you are unable to find yourself navigating through this manual in AmigaGuide format, then I suggest you take a look at your Amiga manual.

If you require further information for use of this program, you can contact the author in various ways by clicking..  @{" HERE " link Contact}!


@endnode
