The ASL Library
***************

   The asl.library has been improved in V44 to address a number of
localization, efficiency and GUI layout issues as well as fixing bugs.
For developers, there are also some new API extensions.

New Functions
=============

VOID ActivateAslRequest(APTR requester)
     Activate a modal requester from a different task context.

VOID AbortAslRequest(APTR requester)
     Attempt to tell the modal ASL requester provided to shut down and
     perform as if the user had clicked on the requester's window close
     gadget.

New Tags
========

ASLFR_InitialShowVolumes (BOOL)
     When opening the file requester, read the list of active volumes,
     do not read the contents of the specified drawer.

ASLFR_SetSortBy (ULONG)
ASLFR_GetSortBy (ULONG *)
     Criteria for sorting the file list. This must be one of:

        * ASLFRSORTBY_Name - sort by name (default)

        * ASLFRSORTBY_Date - sort by date

        * ASLFRSORTBY_Size - sort by size

     If ASLFR_GetSortBy is passed to AslRequest(), the file requester
     will store its current sort criteria in the ULONG pointed to by
     the tag before leaving.

ASLFR_SetSortDrawers (ULONG)
ASLFR_GetSortDrawers (ULONG *)
     Determines where drawers are placed in the sorted list; this must
     be one of:

        * ASLFRSORTDRAWERS_First - drawers appear before all other
          files (default)

        * ASLFRSORTDRAWERS_Mix - drawers are sorted along with the the
          other files

        * ASLFRSORTDRAWERS_Last - drawers appear after all other files

     If ASLFR_GetSortDrawers is passed to AslRequest(), the file
     requester will store its current sort drawer list placement in the
     ULONG pointed to by this tag.

ASLFR_SetSortOrder (ULONG)
ASLFR_GetSortOrder (ULONG *)
     Selects the order in which the list is sorted; this must be one of:

        * ASLFRSORTORDER_Ascend - smallest/oldest files first,
          largest/newest files last (default)

        * ASLFRSORTORDER_Descend - largest/newest files first,
          smallest/oldest files last

     If ASLFR_GetSortOrder is passed to AslRequest(), the file
     requester will store its current sort order in the ULONG pointed
     to by this tag.

ASLFR_PopToFront (BOOL)
ASLFO_PopToFront (BOOL)
ASLSM_PopToFront (BOOL)
     When set to TRUE, this tells ASL to bring the screen to the front
     the requester has opened on. (Default is TRUE).