Short:        A "RequestFile" like program for 1.x+
Author:       lombi@iprimus.com.au (Lorence Lombardo)
Uploader:     lombi iprimus com au (Lorence Lombardo)
Type:         util/batch
Version:      1.7
Requires:     reqtools.library
Architecture: m68k-amigaos


f-req  v1.7  (C) 2006-2008  Lorence Lombardo.


What the @#$% is f-req ?

f-req is an "OS3.x RequestFile" like program for 1.x, 2.x, 3.x+.
It might even work fine on MOS and OS4.

Those of you who are familiar with "OS3.x RequestFile" will be familiar
with f-req's usage.


 f-req's usage is as follows:-

 TITLE, FILE, DRAWER, DRAWERSONLY, PATTERN, MULTISELECT, PUBSCREEN, UNIX

 SCRIPT, VOLUMESONLY, NOASSIGNS, NODISKS, CHOICE, STRING, LONG, LONGRANGE

 MODEID, HIDE, NAME, HEX, 0X, INFO, MOUSE, TOPLEFT 


TITLE title_text
   This allows you to enter the text string that will appear in the title
   bar of the window.

FILE filename
   The "filename" will be the selected default file.

DRAWER dir
   The first directory listing will be the specified "dir", and this path
   will appear in the drawer gadget of the file requestor.

DRAWERSONLY
   Will not show any filenames, only the directory names.

PATTERN pat
   This keyword causes only the files which match that pattern you specify
   to show up. The user can, however, enter any file he desires by simply
   entering the filename or by changing the pattern.

MULTISELECT
   Lets the user select multiple files. These files will be outputed to the 
   console device, seperated by spaces, when the 'OK' button is selected.

PUBSCREEN screenname
   Lets you choose which screen you want the requestor to show up on.
   This option and will be ignored under "OS1.x".

UNIX
   This keyword causes the output paths to be Unix style. In some scripts
   it will be necessary to obtain Amiga paths first and then convert to
   Unix. In this case see the archive "a2u.lha" from the aminet.  
   
SCRIPT script_name
   Due to limitations in "OS1.x's" environment variables, this option should
   be of special interest to "OS1.x" users. This keyword causes the selected
   file(s) to be a part of a temporary script which will execute a specified
   ".key" script and pass the file name(s) to that script.

   eg. f-req >t:temp_script SCRIPT script_name 
       "t:temp_script" will look like this:-
       execute "script_name" "selected_file"

   This option has been intended to be used in a pathed environment.

VOLUMESONLY
   This keyword causes only Disk and Assign names to be shown.

   NOASSIGNS
      This keyword causes Assign names not to be shown.

   NODISKS
      This keyword causes Disk names not to be shown.

CHOICE body_text [button1|button2|etc...]
   This keyword causes f-req to behave like "OS3.x RequestChoice".
   If this is not the last keyword then a button name should be supplied.

STRING body_text [default_string]
   This keyword is similar to the "CHOICE" keyword, except that it will be
   a string requestor instead. If an empty string (="") is supplied to the
   "body_text" then the requestor will not have a message part. If this is
   not the last keyword then a default string should be supplied, use an
   empty string for no default string.

LONG body_text [default_value]
   This keyword is similar to the "STRING" keyword, except only a value can
   be entered. If this is not the last keyword then a default value should
   be supplied, use an empty string for no default value.

LONGRANGE body_text minimum maximum [default_value]
   This keyword is like the "LONG" keyword, but imposes limits on the
   minimum and maximum number entered. If this is not the last keyword then
   a default value should be supplied, use an empty string for no default
   value.

MODEID
   This keyword causes f-req to open a screen mode requestor. The default
   output ID will be in decimal format. 
   This option is not available to "OS1.x" users.

   HIDE
      This keyword causes non standard screen modes to be hidden.

   NAME
      This keyword causes the output to use the screen mode name instead
      of its ID.

   HEX
      This keyword causes the output ID to be in hexadecimal format.

   0X
      This keyword causes the output ID to be in "C" style hexadecimal
      format.

   INFO
      This keyword causes all known information about the screen mode to be
      the output.

MOUSE
   This keyword causes the requestors location to be at the location of the
   mouse pointer.

TOPLEFT
   This keyword causes the requestors location to be at the top left of the
   screen.

   
f-req will return an empty string (="") upon cancelation, except for when
the MODEID keyword is used then the word "quit" will be returned.

For all requestors having a "body_text" a "*N" can be used to obtain a
new line.

When writing scripts to work on "OS1.x" also it is recommended that you
provide all optional parameters.


See the archive "LHA_HD_Install.lha" on the aminet for an example of a
script using f-req.

See the archive "ReqToolsUsr.lha" on the aminet for more information about
the "reqtools.library".


Distribution:

Please distribute f-req with this documentation or alternatively give
reference to the "f-req.lha" archive from the aminet within your own
documentation.



Feeling bored ?  :)
Why not check out this URL ?

http://home.iprimus.com.au/lombi/1/homepage.htm