Install instructions
_______________________

Copy bt-GASel.zip in mystic root directory and unzip. Scripts files will be decompressed
in scripts directory, and text files will be decompressed in text directory.

The program must be compiled with either MIDE or MPLC from command line.

To replace default Join Group menu and Select Area menu from menu "file", edit each
function and replace the executed code (with TAB) from system function FA, FG, MA or
MG by GX (MPL exec) and in the second field, data, type one of the following :

To replace the normal File Group Join menu :

  bt-GASel GASel-fg.cfg

To replace the normal File Area menu :

  bt-GASel GASel-fa.cfg

To replace the normal Message Group Join menu :

  bt-GASel GASel-mg.cfg

To replace the normal Message Area menu :

  bt-GASel GASel-ma.cfg

In each of these cfg files (already decompressed in your script directy), you will find
all required parameters to customize the behaviour independently from other cfg files.

The available parameters are :

  Zone_Type         	Determines which Group/Area is managed
  			        	Possible values are 1 for File Group,
  			            		        	2 for File Area,
  			                      			3 for Message Group
  			                      			4 for Message Area

  Top_Left_X			Position of first column available to display the list of elements
  Top_Left_Y			Position of first row available to display the list of elements
  Bottom_Right_X    	Position of last column available to display the list of elements
  Bottom_Right_Y    	Position of last row available to display the list of elements

  						It's the window area in which the lightbar menu will be displayed

  Display_File			Name of file to display as a background
  Help_File				Name of help file o display when CTRL-Z is pressed

  Pos_Search_X			Where to print the current search string
  Pos_Search_Y

  Search_Color_Prefix	The MCI code to insert before displaying the search string

  Bar_HighLight_Prefix  The MCI code to insert before displaying the active element
  Bar_HighLight_Suffix  The MCI code to insert after displaying the active element

  Bar_Dimmed_Prefix     The MCI code to insert before displaying an inactive element

Each parameters is optionnal and will work with default value if not provided.

I tried to make the code as clear as possible, with doc where it is needed, hopefully.

This has only been tester with Mystic BBS v1.12 A31 so I can't say if it's running with
earlier versions.

The original work by xqtr (at least, I didn't see the code from g00r00) has a nifty bug
regarding the way it stores ID for groups and areas (bases). Their code is storing the
sequential number of the list during the list construction. But it breaks the menu when
you reordered groups and or bases, when you deleted some, then added new groups/areas.

Because the ID are not consistent anymore and system functions (like FA, FG, MA and MG)
don't take the sequential ID (as displayed in Mystic config itself) but the internal
UniqueID (for groups) or internal Index (for Areas/Bases). As for now, you can't get
those ID without loading system files (groups_f.dat, groups_g.dat, mbases.dat and
fbases.dat). The structure doc is available so I could read in them.

My version does open those system files (the one needed based on the Zone_Type param)
and I build an internal list of available Groups/Areas. And I retrieve the UniqueID or
Index for them to store in an array, arZones. Those numbers will be given to system
calls to FG, FA, MG or MA when the user make his decision by pressing Enter.

I hope you will enjoy this software. Don't hesitate to get back to me with comment,
bugs, requests, or whatever, I'll be very glad to hear from you (even if it's
not working on your system !). You can reach me here :

fabian@lucchi.me
on bttr.it-awareness.ch:2323 (write to Fabian or sysop)
through Netmail (Fabian @ 21:2/106 on fsxNet)