home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac_os2 / fd53os2.zip / FILEDUDE.DOC < prev    next >
Text File  |  1996-05-25  |  74KB  |  1,961 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               F I L E D U D E / 2
  8.                                   version 5.3
  9.  
  10.  
  11.  
  12.                "The final answer to the RG file management woes."
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                    Copyright (C) 1992-1996 by Edward Stangler
  19.                           An Edhanced Software Product
  20.                               All rights reserved.
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                 Operating Manual
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                              To Contact the Author:
  43.         ________________________________________________________________
  44.  
  45.         Edward Stangler                              Mr. Ed's Corner BBS
  46.         P.O. Box 38553, Suite #247                        1-713-447-6119
  47.         Houston, Texas 77238-8553                              28800 bps
  48.         U.S.A.                                           SGA-Net 30:30/0
  49.         ________________________________________________________________
  50.  
  51.         Internet  mred@neosoft.com                CompuServe  74620,2333
  52.          Fidonet  1:106/1076                          ITCnet  85:842/105
  53.  
  54.                           Edhanced Software Home Page:
  55.                          http://www.neosoft.com/~mred/
  56.  
  57.  
  58.                                 C O N T E N T S
  59.  
  60.  
  61.           ____________________________________________________________
  62.           Introduction                                               1
  63.  
  64.                What Is Filedude?  / 1
  65.                Is Filedude For You?  / 1
  66.                Features  / 2
  67.                Requirements  / 3
  68.  
  69.           ____________________________________________________________
  70.           Simple Usage                                               4
  71.  
  72.                Installation  / 4
  73.                Navigation  / 4
  74.                Running Without Menus  / 5
  75.                Automatic Mode  / 6
  76.                Commandline Parameters  / 6
  77.                Tasks  / 7
  78.                     Importing CD-ROM  / 7
  79.                     Importing FILES.BBS  / 8
  80.                     Fixing Descriptions  / 8
  81.                     Making a Filelist  / 9
  82.  
  83.           ____________________________________________________________
  84.           Advanced Usage                                            10
  85.  
  86.                Menu Options  / 10
  87.                     File  / 10
  88.                          Open  / 10
  89.                          Save  / 10
  90.                          Save As  / 10
  91.                          Basic Configuration  / 10
  92.                          Config File Areas  / 13
  93.                          Create CD-ROM areas  / 13
  94.                          Archive Config  / 15
  95.                          CD-ROM formats  / 15
  96.                          Advanced Settings  / 17
  97.                     Fix  / 20
  98.                          Fix Size  / 20
  99.                          Fix Credits  / 20
  100.                          Fix Upload Date  / 20
  101.                          Fix Duplicates  / 21
  102.                          Delete Dups From Disk  / 21
  103.                          Fix Offline  / 21
  104.                          Delete Offline  / 21
  105.                          Check Versions  / 21
  106.                          Don't Delete Actual Files  / 21
  107.                     Desc  / 22
  108.                          Use FILE_ID.DIZ  / 22
  109.                          Wordwrap FILE_ID.DIZ  / 22
  110.                          Upload Every File In Sight  / 22
  111.                          Use CD-ROM/FILES.BBS list  / 23
  112.                          Don't Remove List  / 23
  113.  
  114.                          Pack EXTENDED.DAT  / 23
  115.                     Filelist  / 23
  116.                          Make Filelist  / 23
  117.                          Compress Filelist  / 23
  118.                          Make Filelist As New  / 24
  119.                          Validated Filelist  / 24
  120.                          Only List New Files  / 24
  121.                     Misc  / 24
  122.                          Process New Areas  / 24
  123.                          Keep a Log File  / 24
  124.                          Update SYSOP.LOG  / 25
  125.                          Convert Archives  / 25
  126.                          Don't Remove Old  / 25
  127.                          Scan For Viruses  / 25
  128.                          No Decompression  / 26
  129.                          Set Hatch Flag  / 26
  130.                          Auto Virus Validate  / 26
  131.                          Don't Validate  / 26
  132.                     Go!  / 26
  133.                     Dos Shell  / 26
  134.                     Quit  / 26
  135.                Template Files  / 26
  136.                Mci Codes  / 27
  137.                Formatting  / 29
  138.                Swapping  / 29
  139.                Multiple Configurations  / 30
  140.  
  141.           ____________________________________________________________
  142.           Miscellaneous                                             30
  143.  
  144.                Contacting the Author  / 30
  145.                Why You Should Register  / 31
  146.                Legal Information  / 32
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.          FileDude/2 5.3  /  Welcome!                                    1
  170.  
  171.  
  172.           INTRODUCTION
  173.  
  174.  
  175.           WHAT IS FILEDUDE?
  176.  
  177.           FileDude is the ultimate file manager for Renegade BBS
  178.           software.  It combines the essential features found in
  179.           smaller utilities into one professional package.  FileDude
  180.           also contains a rich set of features you will find nowhere
  181.           else.  These unique features will save you hundreds of hours
  182.           of work.
  183.  
  184.           Though FileDude offers many options, it does not overwhelm
  185.           you.  FileDude contains an intuitive, pulldown menu system
  186.           for easy access to all options.  It is organized to keep
  187.           things simple.  But if you ever feel like diving into the
  188.           advanced stuff, the menus do not become an obstacle.
  189.  
  190.           FileDude is also convenient.  It offers a fully automated
  191.           mode, perfect for nightly events.  Just configure FileDude
  192.           with the menu system, run it with the /NOMENU option, and
  193.           wallaa!
  194.  
  195.           FileDude is fast and reliable.  It was designed to handle
  196.           the largest file section you can throw at it.  But even if
  197.           your system does not contain 100,000 files, FileDude will
  198.           still provide you with outstanding performance.
  199.  
  200.           Above all else, FileDude helps you tremendously. You cannot
  201.           find another file manager for Renegade BBS software that
  202.           does as much or functions as efficiently as FileDude.
  203.  
  204.           FileDude is the final answer to the RG file management woes.
  205.  
  206.  
  207.  
  208.           IS FILEDUDE FOR YOU?
  209.  
  210.           If you have a file section, FileDude is for you.  You will
  211.           find FileDude extremely helpful if:
  212.  
  213.           =>  You own at least one CD-ROM disc.
  214.  
  215.               FileDude has been designed to handle any and every
  216.               CD-ROM format.  Pick from one of the many preconfigured
  217.               types, or enter your own customized CD-ROM format.
  218.               There's even a one-step process to add every file area on
  219.               your CD-ROM to the BBS!
  220.  
  221.  
  222.  
  223.  
  224.  
  225.          FileDude/2 5.3  /  Is Filedude For You?                        2
  226.  
  227.  
  228.           =>  You receive .TIC files through a network.
  229.  
  230.               FileDude will import a FILES.BBS of any format,
  231.               including ones generated from incoming .TIC files.
  232.               FileDude even handles the strange Renegade-style
  233.               FILES.BBS format!
  234.  
  235.           =>  Descriptions in your file areas are a mess.
  236.  
  237.               It will fix all those bad extended description pointers,
  238.               eliminating mixed up descriptions once and for all.  To
  239.               ensure the descriptions are correct, FileDude can scan
  240.               for FILE_ID.DIZ and DESC.SDI internal descriptions.
  241.               Plus, FileDude can even pack the EXTENDED.DAT.
  242.  
  243.           =>  You've mastered simple file management techniques.
  244.  
  245.               FileDude offers much, much more.  Make a filelist,
  246.               created in the exact style you want.  Convert all your
  247.               archives to the same type.  Scan your existing file base
  248.               for viruses.  Even look for old versions of programs and
  249.               get rid of them.  FileDude will help you do all of these
  250.               things . . . and more!
  251.  
  252.  
  253.  
  254.           FEATURES
  255.  
  256.           CD-ROM importing
  257.  
  258.                 -  Supports all popular formats
  259.                 -  Easily add new CD-ROM formats
  260.                 -  One-step process to create CD-ROM file areas
  261.                 -  Handles wildcard naming of description lists
  262.                    (i.e. DIR1.LST, DIR2.LST, or GAMES.DIR, DOORS.DIR)
  263.                 -  Handles multiline descriptions
  264.  
  265.           FILES.BBS (created from .TICs) importing
  266.  
  267.                 -  Preconfigured with standard FILES.BBS format
  268.                 -  Supports Renegade-style FILES.BBS (padded filenames)
  269.  
  270.           File entry fixing
  271.  
  272.                 -  Fixes offline status, file size, and credits
  273.                 -  Fixes duplicate file entries
  274.                 -  Fixes upload dates
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.          FileDude/2 5.3  /  Features                                    3
  282.  
  283.  
  284.           Description handling
  285.  
  286.                 -  Fully supports FILE_ID.DIZ and DESC.SDI
  287.                 -  Has superb word wrapping
  288.                 -  Packs the EXTENDED.DAT
  289.  
  290.           Filelisting
  291.  
  292.                 -  Creates a filelist in your own style using templates
  293.                 -  Optionally compresses the filelist
  294.                 -  Automatically uploads the filelist to your BBS
  295.                 -  Inserts FILE_ID.DIZ into the archive
  296.  
  297.           Archive conversion
  298.  
  299.                 -  Converts all archives to a specified type
  300.                 -  Preconfigured with support for all major archivers
  301.                 -  Supports nodelist and network file naming
  302.                    (i.e. NODELIST.A32, or 00013333.Z64)
  303.  
  304.           Version checking
  305.  
  306.                 -  Finds old versions of programs and eliminates them
  307.                 -  Optionally creates a list for a tape backup program
  308.                 -  Finds old versions of nodelists and network files
  309.  
  310.           Virus scanning
  311.  
  312.                 -  Interfaces with your favorite virus scanner
  313.                 -  Scans all internal archives
  314.  
  315.  
  316.  
  317.           REQUIREMENTS
  318.  
  319.           FileDude's hardware and software requirements are not much
  320.           more than those of Renegade BBS software:
  321.  
  322.           -  Renegade BBS software dated 04-05-96 or later.
  323.  
  324.              Versions of RG from 12-25-93 to 10-05-94 may work, provided
  325.              that you set the "Maximum number of file description lines"
  326.              in Advanced Settings to five (for RG 04-05-96 or later, it
  327.              should be ten.)
  328.  
  329.           -  IBM OS/2 Operating System version 2.1 or higher.
  330.  
  331.           -  1 meg free hard drive space.  Archive conversion will
  332.              require at least 5 megs free, depending on the size of
  333.              the archives being converted.
  334.  
  335.  
  336.  
  337.          FileDude/2 5.3  /  Requirements                                4
  338.  
  339.  
  340.  
  341.           The following are optional things to improve performance:
  342.  
  343.           -  Mouse.
  344.  
  345.           -  RAM drive, for redirecting swap files.
  346.  
  347.  
  348.  
  349.           SIMPLE USAGE
  350.  
  351.  
  352.           INSTALLATION
  353.  
  354.           Good news--FileDude requires no major installation!
  355.  
  356.           Simply unarchive the FileDude package into its own
  357.           directory.  If you plan on running FileDude from anywhere on
  358.           the hard drive, add this directory to your PATH.
  359.  
  360.           To setup FileDude, invoke the menu system by running:
  361.  
  362.                FILEDUDE
  363.  
  364.           The first time you run FileDude, it will automatically
  365.           create the TEMPLATE subdirectory and move the default
  366.           template files into it.  FileDude will inform you of this
  367.           action by quickly displaying several messages similar to:
  368.  
  369.                Moving FILENAME.EXT => TEMPLATE\FILENAME.EXT
  370.  
  371.           The Basic Configuration menu will soon pop up.  Enter the
  372.           path to your RENEGADE.DAT file in the first field.  Only
  373.           enter the path, not the filename.
  374.  
  375.           You may customize the other options now, or you may wait
  376.           until you are more familiar with the program.  The Basic
  377.           Configuration menu is always available on the File menu off
  378.           the pulldown bar.
  379.  
  380.           When you are finished, hit the "OK" button.
  381.  
  382.  
  383.  
  384.           NAVIGATION
  385.  
  386.           On the pulldown menu bar, the LEFT ARROW and RIGHT ARROW
  387.           keys will allow you to move between menus.  Hit DOWN ARROW
  388.           to pull down a menu.
  389.  
  390.  
  391.  
  392.  
  393.          FileDude/2 5.3  /  Navigation                                  5
  394.  
  395.  
  396.           On a pulled down menu, the UP ARROW and DOWN ARROW keys will
  397.           allow you to move between menu choices.  Pressing <ENTER>
  398.           will select an option.  If the option is a toggle button, a
  399.           checkmark will appear next to the item, informing you that
  400.           the option is turned on.
  401.  
  402.           If the option you chose is not a toggle button, a window
  403.           will pop up.  Several fields for text input will be
  404.           available, perhaps along with a few toggle buttons.  Use
  405.           <TAB> and <SHIFT-TAB> to move between fields.  <ENTER> will
  406.           press the "OK" button, saving all changes and exiting.
  407.           <ESC> will abort any changes you made and exit the window.
  408.  
  409.           If you see a red letter in the name of an item, you may hit
  410.           the <ALT> key and that letter to jump to the item.  In a
  411.           window with an "OK" button, for example, you may hit <ALT-O>
  412.           to press the "OK" button.
  413.  
  414.           Mouse users have a few special things available.  In the
  415.           upper-left corner of each window you will find a "terminate"
  416.           button.  Simply click on this little square, and it will act
  417.           as if you pressed <ESC>, aborting any changes and exiting
  418.           the window.  Also, if a field contains more words than will
  419.           fit on the screen, small arrows will appear on either side
  420.           of the field.  Hold the mouse button down on one of these
  421.           arrows to scroll through the text in the field.
  422.  
  423.           When viewing a scrollable list of items, such as the list of
  424.           file areas or the list of CD-ROM formats, you have
  425.           additional keys available.  <PgUp> will flip to the previous
  426.           page, and <PgDn> will flip to the next page of items.
  427.           <Home> will jump to the first page, and <End> will jump to
  428.           the last page of items.
  429.  
  430.           Radio buttons may be toggled using the SPACEBAR.  To select
  431.           a CD-ROM format, for instance, several radio buttons appear
  432.           on the menu.  Just hit SPACEBAR, and the asterisk (*) will
  433.           move to the current one that is highlighted.
  434.  
  435.  
  436.  
  437.           RUNNING WITHOUT MENUS
  438.  
  439.           FileDude can be run in a fully automatic mode, free of all
  440.           menus and interactive windows.  This automatic mode is ideal
  441.           for nightly events or other times when you want to call
  442.           FileDude from a batch file.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.          FileDude/2 5.3  /  Running Without Menus                       6
  450.  
  451.  
  452.           To use FileDude in automatic mode, run it with the /NOMENU
  453.           commandline parameter:
  454.  
  455.                FILEDUDE /NOMENU
  456.  
  457.           FileDude will load configuration #1 by default.  To load a
  458.           different configuration, add the /CONFIG=# parameter, where
  459.           '#' is the number of the configuration slot.
  460.  
  461.           The following commandline would run FileDude in automatic
  462.           mode, loading configuration #2:
  463.  
  464.                FILEDUDE /NOMENU /CONFIG=2
  465.  
  466.           For more information on having multiple configurations,
  467.           refer to the "Multiple Configurations" section of this
  468.           manual.
  469.  
  470.  
  471.  
  472.           AUTOMATIC MODE
  473.  
  474.           FileDude will take charge in automatic mode, but it will be
  475.           be cautious so as to protect your files.
  476.  
  477.           Some features, such as version checking, normally ask the
  478.           user whenever it wants to delete an actual file from disk.
  479.           When in automatic mode, however, FileDude will be more
  480.           cautious.  Since you will not be there to answer the
  481.           question, FileDude will not take any chances.  Instead of
  482.           deleting a file, it will create a list of files in DEL.LST,
  483.           with their descriptions in DEL.BBS.  Later, you may review
  484.           this list and delete files at your discretion.
  485.  
  486.           You can also achieve the above effect in menu mode by
  487.           toggling "Don't Delete Actual Files" from the Fix menu.
  488.  
  489.           While in automatic mode, FileDude will never ask for you to
  490.           press a key.  Even if an error occurs, FileDude will simply
  491.           exit and log the error in FILEDUDE.LOG.
  492.  
  493.  
  494.  
  495.           COMMANDLINE PARAMETERS
  496.  
  497.           With the exception of the /NOMENU parameter, all parameters
  498.           can be used for both menu and automatic modes.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.          FileDude/2 5.3  /  Commandline Parameters                      7
  506.  
  507.  
  508.           The following commandline parameters are available:
  509.  
  510.              /NOMENU       Runs FileDude in fully automatic mode, with
  511.                            no menu system, for nightly events, etc.
  512.  
  513.              /CONFIG=#     Loads configuration slot '#' on startup
  514.  
  515.              /REGISTER     Brings up a window to enter your
  516.                            registration information
  517.  
  518.  
  519.           TASKS
  520.  
  521.           Importing CD-ROM
  522.           ================
  523.  
  524.           0.  Insert the CD-ROM to import . . .
  525.  
  526.           1.  Create a file area for each directory you want to import
  527.               from the CD-ROM.  You can create the file areas inside
  528.               Renegade, or you can use the "Create CD-ROM Areas" option
  529.               in the File menu of FileDude.
  530.  
  531.           2.  Go to the CD-ROM Formats menu.
  532.  
  533.           3.  Locate your CD-ROM format.  If it is not listed, you can
  534.               easily add your own.
  535.  
  536.           4.  Go to the Config File Areas menu.
  537.  
  538.           5.  Tag the file areas you wish to import.
  539.  
  540.           6.  For each area you tag, you will need to pick its CD-ROM
  541.               format.
  542.  
  543.               When a file area name is highlighted, choose a CD-ROM
  544.               format from the gray box on the right side of the menu.
  545.  
  546.           7.  Each area you tag also has a CD-ROM description list
  547.               filename associated with it.
  548.  
  549.               Near the bottom of the menu you will find a field marked
  550.               "Description list".  Enter the filename of the
  551.               description list here.
  552.  
  553.               If the description list file is not located in the
  554.               directory to be uploaded, enter the full path.
  555.  
  556.               Wildcards are supported.  A filename of DIR*.LST will
  557.               pick up DIR1.LST or DIR2.LST, whichever is in that
  558.               directory.
  559.  
  560.  
  561.          FileDude/2 5.3  /  Importing CD-ROM                            8
  562.  
  563.  
  564.  
  565.           8.  Hit "OK" when you are done.
  566.  
  567.           9.  Toggle "Use CD-ROM/FILES.BBS List" to ON in the
  568.               Desc menu.
  569.  
  570.           10. Hit "Go!" to process.
  571.  
  572.  
  573.           Importing FILES.BBS
  574.           ===================
  575.  
  576.           0.  You should already have a program which builds FILES.BBS
  577.               lists from incoming .TIC files.
  578.  
  579.           1.  If you have not created a file area for each FILES.BBS
  580.               list, do that now.  Make sure the DOWNLOAD PATH is the
  581.               directory containing the files to be uploaded.
  582.  
  583.           2.  Go to the Config File Areas menu.
  584.  
  585.           3.  Tag the file areas you wish to import.
  586.  
  587.           4.  Hit "OK" when you are done.
  588.  
  589.           5.  Toggle "Use CD-ROM/FILES.BBS List" to ON in the
  590.               Desc menu.
  591.  
  592.           6.  Hit "Go!" to process.
  593.  
  594.  
  595.           Fixing Descriptions
  596.           ===================
  597.  
  598.           0.  FileDude will automatically fix things such as bad
  599.               extended description pointers.
  600.  
  601.           1.  Toggle "Use CD-ROM/FILES.BBS List" to ON in the
  602.               Desc menu.
  603.  
  604.           2.  Toggle "Use FILE_ID.DIZ" to ON in the Desc menu.
  605.  
  606.               If you wish to rescan files previously scanned for DIZ
  607.               and SDI descriptions, delete the FILEDIZ.DAT file in
  608.               your FileDude directory.
  609.  
  610.           3.  Hit "Go!" to process.
  611.  
  612.  
  613.           Making a Filelist
  614.           =================
  615.  
  616.  
  617.          FileDude/2 5.3  /  Making a Filelist                           9
  618.  
  619.  
  620.  
  621.           0.  FileDude comes preconfigured with default template
  622.               files.  They are located in the TEMPLATE subdirectory.
  623.  
  624.               When first starting out with FileDude, you will probably
  625.               want to use these default templates.  Later, you may
  626.               want edit them to reflect your own style.
  627.  
  628.           1.  Go to the Basic Configuration menu in the File menu.
  629.  
  630.           2.  Enter the full path and filename of the filelist to
  631.               create in the appropriate field.
  632.  
  633.               If you want FileDude to automatically upload the
  634.               filelist to your BBS, enter a path which will put it in
  635.               one of your file areas.
  636.  
  637.           3.  There is a field marked "Archive format".  If you plan
  638.               on having FileDude compress the filelist, be sure that
  639.               the archive format listed here is the one you want.
  640.  
  641.           4.  If this filelist will contain only new files uploaded
  642.               in the past 'x' number of days, enter this number in
  643.               the field labeled "Number of days..."
  644.  
  645.           5.  Hit "OK" when you are done.
  646.  
  647.           6.  Toggle "Make Filelist" to ON in the Filelist menu.
  648.  
  649.           7.  If you want FileDude to compress the filelist, toggle
  650.               "Compress Filelist" to ON in the Filelist menu.
  651.  
  652.               FileDude will automatically insert a FILE_ID.DIZ
  653.               description, based on the FILE_ID.ASC template.
  654.  
  655.           8.  If you want the filelist to appear on everyone's newscan
  656.               after every run, toggle the "Mark Filelist As New" to ON
  657.               in the Filelist menu.
  658.  
  659.           9.  If you do not want resume or unvalidated files to appear
  660.               on the filelist, toggle "Validated Filelist" to ON in
  661.               the Filelist menu.
  662.  
  663.           10. If this filelist will only contain new files uploaded in
  664.               the past 'x' number of days, toggle "Only List New Files"
  665.               to ON in the Filelist menu.
  666.  
  667.           11. Hit "Go!" to process.
  668.  
  669.  
  670.  
  671.  
  672.  
  673.          FileDude/2 5.3  /  Making a Filelist                          10
  674.  
  675.  
  676.           ADVANCED USAGE
  677.  
  678.  
  679.           MENU OPTIONS
  680.  
  681.           FILE
  682.  
  683.         ≡ │ File │ Fix   Desc   Filelist   Misc   Go!   DOS Shell  Quit
  684.         ──│      └──────────────────┐──────────────────────────────────
  685.           │  Open...                │
  686.           │  Save                   │
  687.           │  Save as...             │
  688.           │                         │
  689.           │  Basic Configuration    │
  690.           │  Config File Areas      │
  691.           │  Create CD-ROM Areas    │
  692.           │                         │
  693.           │  Archive Config         │
  694.           │  CD-ROM Formats         │
  695.           │                         │
  696.           │  Advanced Settings      │
  697.           └─────────────────────────┘
  698.  
  699.  
  700.           Open        Opens another configuration and loads it into
  701.                       memory. You are presented with a menu of
  702.                       existing configurations.
  703.  
  704.           Save        Saves the current configuration in its old slot.
  705.  
  706.           Save As     Saves the current configuration in a new slot.
  707.                       You are prompted for the new configuration name.
  708.  
  709.  
  710.           Basic Configuration
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.          FileDude/2 5.3  /  Basic Configuration                        11
  730.  
  731.  
  732.           ╔═════════════════ Basic Configuration ════════════════════╗
  733.           ║                                                          ║
  734.           ║ Path (not filename) of RENEGADE.DAT:   C:\RENEGADE\      ║
  735.           ║                                                          ║
  736.           ║ Temporary swap files path:   C:\FILEDUDE\                ║
  737.           ║ Template file directory:     C:\FILEDUDE\TEMPLATE        ║
  738.           ║                                                          ║
  739.           ║ Archive format to convert TO if conversion toggled: ZIP  ║
  740.           ║ Number of days to include in "new files" filelists:   0  ║
  741.           ║                                                          ║
  742.           ║ Filelist filename:  FILELIST.ASC                         ║
  743.           ║                                                          ║
  744.           ║ Virus scanner commandline (errorlevel 0=no virus):       ║
  745.           ║  SCAN %I /ALL /SUB /NOMEM                                ║
  746.           ║                                                          ║
  747.           ║ Default description for uploads:                         ║
  748.           ║  No description.  Uploaded by FileDude.                  ║
  749.           ║                                                          ║
  750.           ╚══════════════════════════════════════════════════════════╝
  751.  
  752.  
  753.              Path (not filename) of RENEGADE.DAT
  754.  
  755.                     This is the path to your main Renegade directory.
  756.                     This directory should contain the RENEGADE.DAT
  757.                     file.  The DATA subdirectory is where FileDude
  758.                     will look for your .DIR and EXTENDED.DAT files.
  759.  
  760.              Temporary swap files path
  761.  
  762.                     This is the path where FileDude will store its
  763.                     temporary swap files.  These swap files are not
  764.                     the DOS shell swap files, but rather much bigger
  765.                     ones which contain runtime data.
  766.  
  767.                     You may want to change this path to a RAM drive to
  768.                     speed up performance.  Make sure the RAM drive is
  769.                     at lease 256K in size.  If you have a larger
  770.                     system (over 4,000 files), make sure your RAM
  771.                     drive is at least one megabyte in size.
  772.  
  773.              Template file directory
  774.  
  775.                     This is the directory where the template files are
  776.                     located.  The template files will be used to
  777.                     construct a filelist if the "Make Filelist" toggle
  778.                     is on.  Each configuration may have its own set of
  779.                     template files in its own template directory.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.          FileDude/2 5.3  /  Basic Configuration                        12
  786.  
  787.  
  788.              Archive format to convert TO if conversion toggled
  789.  
  790.                     This is the desired format that FileDude will
  791.                     convert all archives to.  When FileDude compresses
  792.                     a filelist, it will also use this format.
  793.  
  794.                     Make sure that this format is defined in the
  795.                     Archive Config menu.
  796.  
  797.              Number of days to include in "new files" filelists
  798.  
  799.                     This is the number which specifies the maximum
  800.                     age -- in days -- of the files to include in the
  801.                     filelist.  Note that "Only List New Files" must be
  802.                     toggled ON in the Filelist menu in order to make
  803.                     use of this field.
  804.  
  805.              Filelist filename
  806.  
  807.                     This is the path and filename to the filelist
  808.                     FileDude creates.
  809.  
  810.                     If you want FileDude to automatically upload this
  811.                     filelist to your BBS, type in a path that puts it
  812.                     in one of your file areas.
  813.  
  814.              Virus scanner commandline (errorlevel 0=no virus)
  815.  
  816.                     This is the commandline for FileDude running an
  817.                     external virus scanner.  Enter the complete path,
  818.                     filename, and parameters to the virus scanner
  819.                     program.
  820.  
  821.                     The virus scanner you use must return the
  822.                     following errorlevels:
  823.  
  824.                     Errorlevel                Why
  825.                     ==========   ================================
  826.                         0        No virus.  Everything's cool.
  827.                     ----------   --------------------------------
  828.                         1        Virus!  Virus!
  829.                     ----------   --------------------------------
  830.                         2        Error during virus scanning;  no
  831.                     or greater   idea if there is a virus or not.
  832.                     ----------   --------------------------------
  833.  
  834.              Default description for uploads
  835.  
  836.                     This is the default description for uploads.
  837.  
  838.  
  839.  
  840.  
  841.          FileDude/2 5.3  /  Basic Configuration                        13
  842.  
  843.  
  844.                     FileDude will use this description if a
  845.                     description cannot be found in a FILE_ID.DIZ, in a
  846.                     DESC.SDI, or on a CD-ROM/FILES.BBS list.
  847.  
  848.           Config File Areas
  849.  
  850.                     Here you select which file areas to process.  This
  851.                     menu also contains CD-ROM/FILES.BBS setup
  852.                     information for each file area.
  853.  
  854.           Create CD-ROM Areas
  855.  
  856.         ╔════════════════════ Create CD-ROM Areas ══════════════════════╗
  857.         ║                                                               ║
  858.         ║ Drive:  E:          [X]  Only areas with FILES.BBS-type list  ║
  859.         ║                     [X]  Recurse to find areas inside subdirs ║
  860.         ║                                                               ║
  861.         ║ Archive Type (1..max, 0=none):  1                             ║
  862.         ║ Comment Type (1..3, 0=none):    0                             ║
  863.         ║                                                               ║
  864.         ║ Prefix for .DIR filenames:                                    ║
  865.         ║ Prefix for area descriptions:  [CD-ROM]                       ║
  866.         ║                                                               ║
  867.         ║ Path to DIR0/DIRINFO.ROM (optional):                          ║
  868.         ║                                                               ║
  869.         ║ Access String:     Download ACS:       Upload ACS:            ║
  870.         ║  s5                 s5                  s250                  ║
  871.         ║                                                               ║
  872.         ║ Upload Path (Blank=download path):                            ║
  873.         ║                                                               ║
  874.         ╚═══════════════════════════════════════════════════════════════╝
  875.  
  876.  
  877.              Drive
  878.  
  879.                     This is the drive letter, plus colon (:), of
  880.                     your CD-ROM.
  881.  
  882.              [ ] Recurse to find areas inside subdirs
  883.  
  884.                     This option tells FileDude to look inside
  885.                     subdirectories to see if there are any nested
  886.                     subdirectories which may be file areas.  For
  887.                     example, with this option on, it would find
  888.                     /WINDOWS/TEXT/ after finding an area /WINDOWS/.
  889.  
  890.                     This option considerably slows down FileDude. Since
  891.                     many CD-ROMs do not have nested subdirectories as
  892.                     file areas, turning this option off may be a viable
  893.                     way to speed up the search when finding file areas.
  894.  
  895.  
  896.  
  897.          FileDude/2 5.3  /  Create CD-ROM areas                        14
  898.  
  899.  
  900.              [ ] Only areas with FILES.BBS-type list
  901.  
  902.                     Toggle this option if you want FileDude to only
  903.                     create file areas for directories which contain
  904.                     FILES.BBS-type lists.
  905.  
  906.              Archive Type (1..max, 0=none)
  907.  
  908.                     This field specifies which archive type in RG to use
  909.                     for the file areas created.  This field corresponds
  910.                     exactly with the Archive Type field in the RG file
  911.                     area editor.
  912.  
  913.              Comment Type (1..3, 0=none)
  914.  
  915.                     This field specifies which comment type in RG to use
  916.                     for the file areas created.  This field corresponds
  917.                     exactly with the Comment Type field in the RG file
  918.                     area editor.
  919.  
  920.              Prefix for .DIR filenames:
  921.  
  922.                     The text in this field will be placed before the
  923.                     .DIR filename determined for any given file area.
  924.                     If the text is specified as "PR", then every file
  925.                     area will have a .DIR filename of the form PRxxxxxx,
  926.                     where 'xxxxxx' is a string determined by FileDude.
  927.  
  928.              Prefix for area descriptions
  929.  
  930.                     The text in this field will be placed before the
  931.                     description of each file area created.
  932.  
  933.              Path to DIR0/DIRINFO.ROM (optional)
  934.  
  935.                     If your CD-ROM contains a table of directories, in
  936.                     either DIRxx or DIRINFO.ROM format, place the
  937.                     filename of the table in this field.
  938.  
  939.                     A table of directories in DIRxx format should look
  940.                     like:
  941.  
  942.                         File Area Name         DIR1
  943.                         Another File Area      DIR2
  944.                         The Final File Area    DIR3
  945.  
  946.              Access String
  947.  
  948.                     This is the access string (ACS) which determines
  949.                     who can see these file areas.
  950.  
  951.  
  952.  
  953.          FileDude/2 5.3  /  Create CD-ROM areas                        15
  954.  
  955.  
  956.              Download ACS
  957.  
  958.                     This is the access string (ACS) which determines
  959.                     who can download files from these file areas.
  960.  
  961.              Upload ACS
  962.  
  963.                     This is the access string (ACS) which determines
  964.                     who can upload files to these file areas.
  965.  
  966.              Upload Path (Blank=download path)
  967.  
  968.                     This is the path to the directory which will hold
  969.                     user uploads to these file areas.
  970.  
  971.                     Please note that specifying a directory here will
  972.                     considerably increase FileDude's scanning time on
  973.                     the CD-ROM file areas, since it will check both
  974.                     the download (CD-ROM) path and the upload (hard
  975.                     drive) path.
  976.  
  977.           Archive Config
  978.  
  979.                     This menu contains setup information for
  980.                     archivers.
  981.  
  982.                     FileDude comes preconfigured for use with all
  983.                     major archivers.
  984.  
  985.           CD-ROM Formats
  986.  
  987.                     Here is where you set up your CD-ROM formats.
  988.  
  989.                     When adding your own format, be sure to have a
  990.                     printout of a sample filelist on your CD-ROM.  You
  991.                     will need to know the basic structure of an entry.
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.          FileDude/2 5.3  /  CD-ROM formats                             16
  1010.  
  1011.  
  1012.                     For example:
  1013.  
  1014.                     ╔════════════════════════════════════════════════╗
  1015.                     ║  Name of format:                               ║
  1016.                     ║   Standard Tick (FILES.BBS)                    ║
  1017.                     ║                                                ║
  1018.                     ║  Default filename of description list:         ║
  1019.                     ║   FILES.BBS                                    ║
  1020.                     ║                                                ║
  1021.                     ║  Description starts on nth word:               ║
  1022.                     ║   2                                            ║
  1023.                     ║                                                ║
  1024.                     ║  Description starts on nth letter of word:     ║
  1025.                     ║   1                                            ║
  1026.                     ║                                                ║
  1027.                     ║  String preceeding extended description lines: ║
  1028.                     ║   |                                            ║
  1029.                     ╚════════════════════════════════════════════════╝
  1030.  
  1031.                     The above format configuration would be for a list
  1032.                     file with entries that look like this:
  1033.  
  1034.                      WHATDONE.ZIP  These are pseudo-docs.
  1035.                                    | Many years in the making, it
  1036.                                    | makes a great paperweight when
  1037.                                    | printed.
  1038.  
  1039.                     If the entry looked like this:
  1040.  
  1041.                      WHATDONE.ZIP  01-01-99  These are pseudo-docs.
  1042.                        $Many years in the making, this
  1043.                        $file is really cool.
  1044.  
  1045.                     Then the format configuration could be:
  1046.  
  1047.                     ╔════════════════════════════════════════════════╗
  1048.                     ║  Name of format:                               ║
  1049.                     ║   The Strange CD-ROM Format                    ║
  1050.                     ║                                                ║
  1051.                     ║  Default filename of description list:         ║
  1052.                     ║   DIR*.LST                                     ║
  1053.                     ║                                                ║
  1054.                     ║  Description starts on nth word:               ║
  1055.                     ║   3                                            ║
  1056.                     ║                                                ║
  1057.                     ║  Description starts on nth letter of word:     ║
  1058.                     ║   1                                            ║
  1059.                     ║                                                ║
  1060.                     ║  String preceeding extended description lines: ║
  1061.                     ║   $                                            ║
  1062.                     ╚════════════════════════════════════════════════╝
  1063.  
  1064.  
  1065.          FileDude/2 5.3  /  CD-ROM formats                             17
  1066.  
  1067.  
  1068.  
  1069.                     The format configuration contains the default
  1070.                     filename for the description list.  This is the
  1071.                     filename that appears on the bottom of the the
  1072.                     Config File Areas menu.  Notice that wildcards can
  1073.                     be used.
  1074.  
  1075.                     The format configuration also contains the "nth"
  1076.                     word and "nth" letter the description starts on.
  1077.                     FileDude considers a space character to be what
  1078.                     separates two words.  The "n" in "nth" starts with
  1079.                     the number 1 and is a positive integer only.
  1080.  
  1081.                     Finally, the configuration has a place for what
  1082.                     string preceeds an extended description line.  If
  1083.                     your list has no distinctive string of characters
  1084.                     preceeding an extended description line, set this
  1085.                     string to a single space character.  Normally,
  1086.                     this field is set to a single pipe character (|)
  1087.                     followed by a space character.
  1088.  
  1089.  
  1090.           Advanced Settings
  1091.  
  1092.           ╔════════════════════ Advanced Settings ═══════════════════╗
  1093.           ║                                                          ║
  1094.           ║   Path and filename of command interpreter:              ║
  1095.           ║    C:\OS2\CMD.EXE                                        ║
  1096.           ║                                                          ║
  1097.           ║   Wordwrap length for first line of description:    50   ║
  1098.           ║   Wordwrap length for extended description lines:   50   ║
  1099.           ║   Maximum number of file description lines:         10   ║
  1100.           ║                                                          ║
  1101.           ║   Uploader Name:  Sysop                                  ║
  1102.           ║                                                          ║
  1103.           ║   -Below options do not take effect until you restart-   ║
  1104.           ║                                                          ║
  1105.           ║   FileDude backdrop color (back * 16 + front):     113   ║
  1106.           ║   FileDude backdrop message (no color codes):            ║
  1107.           ║    ░                                                     ║
  1108.           ║                                                          ║
  1109.           ║    [ ]  Start FileDude in 43/50 line text mode           ║
  1110.           ║    [ ]  FileDude will be run inside a window             ║
  1111.           ║                                                          ║
  1112.           ╚══════════════════════════════════════════════════════════╝
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.          FileDude/2 5.3  /  Advanced Settings                          18
  1122.  
  1123.  
  1124.              Path and filename of command interpreter
  1125.  
  1126.                     This is the path and filename to your command
  1127.                     interpreter.  For OS/2 systems, this is CMD.EXE.
  1128.                     Other interpreters, such as 4-DOS, can be entered
  1129.                     here.
  1130.  
  1131.              Wordwrap length for first line of description
  1132.  
  1133.                     This is the maximum length of the first line of a
  1134.                     description before FileDude wraps it.  The default
  1135.                     is 50, the maximum characters visible during a
  1136.                     [L]ist command in the file areas in RG.
  1137.  
  1138.                     Renegade allows 60 characters max on the first
  1139.                     line of a description.  Keep in mind that the
  1140.                     official maximum width of a FILE_ID.DIZ is 45
  1141.                     characters.
  1142.  
  1143.              Wordwrap length for extended description lines
  1144.  
  1145.                     This is the maximum length of the any line after the
  1146.                     first line of a description.  The default is 50, the
  1147.                     maximum characters visible during a [L]ist command
  1148.                     in the file areas in RG.
  1149.  
  1150.                     Renegade allows 50 characters max on each of the
  1151.                     extended description lines.  Keep in mind that the
  1152.                     official maximum width of a FILE_ID.DIZ is 45
  1153.                     characters.
  1154.  
  1155.              Maximum number of file description lines
  1156.  
  1157.                     The is the total number of lines in a file
  1158.                     description.  In RG 04-05-96 and later, this number
  1159.                     should be set to ten (unless a new version increases
  1160.                     this number.)  In versions prior to 04-05, this
  1161.                     number should be set to five.  Note that this number
  1162.                     is found by taking the maximum number of extended
  1163.                     description lines in EXTENDED.DAT (nine in RG 04-05)
  1164.                     plus one.
  1165.  
  1166.              FileDude backdrop color (back * 16 + front)
  1167.  
  1168.                     This is the color of the backdrop FileDude uses on
  1169.                     the menu interface.
  1170.  
  1171.                     To create the color number, take your background
  1172.                     color, multiply it by 16, and add your foreground
  1173.                     color.
  1174.  
  1175.  
  1176.  
  1177.          FileDude/2 5.3  /  Advanced Settings                          19
  1178.  
  1179.  
  1180.                     The following are valid color numbers (before you
  1181.                     do the multiply thing):
  1182.  
  1183.                         0 - Black               8  - Dark Gray
  1184.                         1 - Blue                9  - Light Blue
  1185.                         2 - Green               10 - Light Green
  1186.                         3 - Cyan (Kinda Blue)   11 - Light Cyan
  1187.                         4 - Red                 12 - Light Red
  1188.                         5 - Magenta (Purple)    13 - Light Magenta
  1189.                         6 - Brown               14 - Yellow
  1190.                         7 - Light Gray          15 - White
  1191.  
  1192.              FileDude backdrop message (no color codes)
  1193.  
  1194.                     This is the message or string of characters that
  1195.                     FileDude will tile as its menu backdrop. There
  1196.                     should be no color codes in this string.
  1197.  
  1198.              [ ]  Start FileDude in 43/50 line text mode
  1199.  
  1200.                     This toggle is for telling FileDude to
  1201.                     automatically start in 43/50 line EGA/VGA mode.
  1202.  
  1203.                     When FileDude exits, it will switch back to the
  1204.                     original mode that was active before FileDude was
  1205.                     loaded.
  1206.  
  1207.              [ ]  FileDude will be run inside a window
  1208.  
  1209.                     This toggle tells FileDude that it will be run
  1210.                     in a half-screen (or less) window.  FileDude will
  1211.                     then do extra cursor positioning to try to keep
  1212.                     the point of focus in the visible part of the
  1213.                     window at all times.
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.          FileDude/2 5.3  /  Advanced Settings                          20
  1234.  
  1235.  
  1236.           FIX
  1237.  
  1238.         ≡   File │ Fix │ Desc   Filelist   Misc   Go!   DOS Shell  Quit
  1239.         ─────────│     └──────────────────────────────┐────────────────
  1240.                  │  ( )  Fix Size                     │
  1241.                  │  ( )  Fix Credits                  │
  1242.                  │  ( )  Fix Upload Date              │
  1243.                  │                                    │
  1244.                  │  ( )  Fix Duplicates               │
  1245.                  │  ( )  Delete Dups From Disk        │
  1246.                  │                                    │
  1247.                  │  ( )  Fix Offline                  │
  1248.                  │  ( )  Delete Offline               │
  1249.                  │                                    │
  1250.                  │  ( )  Check Versions               │
  1251.                  │  ( )  Don't Delete Actual Files    │
  1252.                  └────────────────────────────────────┘
  1253.  
  1254.           Fix Size                 Fixes file sizes, to the nearest
  1255.                                    byte.
  1256.  
  1257.           Fix Credits              Fixes the numbers of credits a file
  1258.                                    is worth.  The size (kilobytes) per
  1259.                                    one credit is automatically read
  1260.                                    from your Renegade configuration
  1261.                                    (RENEGADE.DAT).
  1262.  
  1263.                                    If you have "File Credit System"
  1264.                                    turned ON in Renegade and a file
  1265.                                    calculates to be worth 0 credits,
  1266.                                    FileDude will make it worth 1
  1267.                                    credit.  Nothing is free!
  1268.  
  1269.           Fix Upload Date          If a file's date is more recent
  1270.                                    than the .DIR entry's upload date,
  1271.                                    it will be stamped with "today's"
  1272.                                    date.  If you receive an update of
  1273.                                    a file through a network, for
  1274.                                    example, this option will cause it
  1275.                                    to reappear on everyone's newscan.
  1276.  
  1277.                                    Also, this option fixes entries
  1278.                                    who's dates are beyond the current
  1279.                                    date.  For example, file entries
  1280.                                    dated 01/01/99 will be set to the
  1281.                                    current date if FileDude is run
  1282.                                    prior to 1999.
  1283.  
  1284.           Fix Duplicates           Deletes duplicate filenames from
  1285.                                    the .DIRs and asks you whether to
  1286.                                    delete the actual file from disk.
  1287.  
  1288.  
  1289.          FileDude/2 5.3  /  Fix Duplicates                             21
  1290.  
  1291.  
  1292.  
  1293.           Delete Dups From Disk    Duplicate files will be
  1294.                                    automatically deleted from the hard
  1295.                                    drive, regardless of the "Don't
  1296.                                    Delete Actual Files" toggle.
  1297.  
  1298.           Fix Offline              Checks to see whether a file really
  1299.                                    exists on the hard drive or not.
  1300.                                    It adjust the entry's "Request"
  1301.                                    flag accordingly.
  1302.  
  1303.           Delete Offline           Deletes a file entry if the file
  1304.                                    does not exist.
  1305.  
  1306.                                    If both the "Fix Offline" and
  1307.                                    "Delete Offline" toggles are ON,
  1308.                                    the "Delete Offline" toggle takes
  1309.                                    precedence.
  1310.  
  1311.           Check Versions           Finds old versions of programs and
  1312.                                    eliminates them.  If you have
  1313.                                    PROG20.XXX, for example, it will
  1314.                                    delete PROG10.XXX.
  1315.  
  1316.                                    Whenever an old file is found,
  1317.                                    FileDude will ask you whether to
  1318.                                    delete it.
  1319.  
  1320.           Don't Delete Actual Files
  1321.                                    Instead of deleting files, FileDude
  1322.                                    will create a list called DEL.LST,
  1323.                                    with their descriptions in DEL.BBS.
  1324.  
  1325.                                    With this option toggled on,
  1326.                                    FileDude will not ask you whether
  1327.                                    to delete a file.
  1328.  
  1329.                                    The only times FileDude deletes
  1330.                                    files is when "Check Versions" or
  1331.                                    "Fix Duplicates" is toggled on.
  1332.  
  1333.                                    You can review the DEL.LST at a
  1334.                                    later time.  Perhaps have your
  1335.                                    favorite tape backup program use
  1336.                                    this list to put old versions in
  1337.                                    offline storage.  Or, you can show
  1338.                                    no mercy and delete the files
  1339.                                    immediately.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.          FileDude/2 5.3  /  Don't Delete Actual Files                  22
  1346.  
  1347.  
  1348.           DESC
  1349.  
  1350.         ≡   File   Fix │ Desc │ Filelist   Misc   Go!   DOS Shell  Quit
  1351.         ───────────────│      └──────────────────────────────┐─────────
  1352.                        │  ( )  Use FILE_ID.DIZ               │
  1353.                        │  ( )  Wordwrap FILE_ID.DIZ          │
  1354.                        │  ( )  Upload Every File in Sight    │
  1355.                        │                                     │
  1356.                        │  ( )  Use CD-ROM/FILES.BBS List     │
  1357.                        │  ( )  Don't Remove List             │
  1358.                        │                                     │
  1359.                        │  ( )  Pack EXTENDED.DAT             │
  1360.                        └─────────────────────────────────────┘
  1361.  
  1362.           Use FILE_ID.DIZ          Searches archives for FILE_ID.DIZ
  1363.                                    and DESC.SDI description files.
  1364.  
  1365.                                    If you wish to rescan files which
  1366.                                    FileDude has previously scanned for
  1367.                                    DIZ and SDI descriptions, delete
  1368.                                    the FILEDIZ.DAT file from the
  1369.                                    FileDude directory.
  1370.  
  1371.                                    FileDude supports the official
  1372.                                    FILE_ID.DIZ standard of 45
  1373.                                    characters per line, 10 lines max.
  1374.                                    Renegade, however, only support a
  1375.                                    total of 5 lines in its file entry
  1376.                                    structures.
  1377.  
  1378.                                    So, when your descriptions get cut
  1379.                                    off, it's not FileDude's fault;
  1380.                                    it's Renegade's doing.
  1381.  
  1382.           Wordwrap FILE_ID.DIZ     Word wraps imported
  1383.                                    FILE_ID.DIZ descriptions.
  1384.  
  1385.           Upload Every File in Sight
  1386.                                    Uploads every file not already
  1387.                                    listed on a .DIR.  Even if no
  1388.                                    description is found, FileDude
  1389.                                    still uploads the file.
  1390.  
  1391.                                    If a file does not have a
  1392.                                    description, the default
  1393.                                    description -- set in the Basic
  1394.                                    Configuration menu -- is used.
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.          FileDude/2 5.3  /  Upload Every File In Sight                 23
  1402.  
  1403.  
  1404.           Use CD-ROM/FILES.BBS list
  1405.                                    Finds CD-ROM/FILES.BBS list files
  1406.                                    and uses them for descriptions.
  1407.                                    The list file is deleted after use
  1408.                                    unless it is located on a CD-ROM.
  1409.  
  1410.                                    FileDude automatically recognizes
  1411.                                    padded filenames inside
  1412.                                    CD-ROM/FILES.BBS list files, such
  1413.                                    as those produced by Renegade.
  1414.  
  1415.           Don't Remove List        Prevents FileDude from deleting
  1416.                                    CD-ROM/FILES.BBS list files after
  1417.                                    using them.
  1418.  
  1419.                                    FileDude never attempts to delete a
  1420.                                    CD-ROM/FILES.BBS list file from a
  1421.                                    CD-ROM, regardless of this setting.
  1422.  
  1423.           Pack EXTENDED.DAT        Packs the EXTENDED.DAT file.
  1424.  
  1425.                                    All file areas must be selected to
  1426.                                    use this option.  Also, the "Use
  1427.                                    FILE_ID.DIZ" and "Use
  1428.                                    CD-ROM/FILES.BBS List" options must
  1429.                                    be toggled on.
  1430.  
  1431.  
  1432.           FILELIST
  1433.  
  1434.         ≡   File   Fix   Desc │ Filelist │ Misc   Go!   DOS Shell  Quit
  1435.         ──────────────────────│          └───────────────────┐─────────
  1436.                               │  ( )  Make Filelist          │
  1437.                               │  ( )  Compress Filelist      │
  1438.                               │                              │
  1439.                               │  ( )  Mark Filelist As New   │
  1440.                               │  ( )  Validated Filelist     │
  1441.                               │                              │
  1442.                               │  ( )  Only List New Files    │
  1443.                               └──────────────────────────────┘
  1444.  
  1445.           Make Filelist            Makes a list of files using the
  1446.                                    templates found in the TEMPLATES
  1447.                                    subdirectory.
  1448.  
  1449.           Compress Filelist        Compresses the filelist made and
  1450.                                    inserts a FILE_ID.DIZ based on the
  1451.                                    FILE_ID.ASC template file.
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.          FileDude/2 5.3  /  Compress Filelist                          24
  1458.  
  1459.  
  1460.                                    The compression format is
  1461.                                    determined by the one you specified
  1462.                                    in the Basic Configuration menu.
  1463.  
  1464.           Make Filelist As New     The filelist will show up on
  1465.                                    everyone's newscan each time a new
  1466.                                    filelist is compiled.
  1467.  
  1468.           Validated Filelist       Prevents resume and unvalidated
  1469.                                    files from showing up on the
  1470.                                    filelist.
  1471.  
  1472.           Only List New Files      The filelist will contain only
  1473.                                    new files uploaded in the past 'x'
  1474.                                    number of days, where 'x' is
  1475.                                    defined in the "Basic
  1476.                                    Configuration" menu.
  1477.  
  1478.  
  1479.           MISC
  1480.  
  1481.         ≡   File   Fix   Desc   Filelist │ Misc │ Go!   DOS Shell  Quit
  1482.         ─────────────────────────────────│      └───────────────────┐──
  1483.                                          │ ( )  Process New Areas   │
  1484.                                          │                          │
  1485.                                          │ ( )  Keep a Log File     │
  1486.                                          │ ( )  Update SYSOP.LOG    │
  1487.                                          │                          │
  1488.                                          │ ( )  Convert Archives    │
  1489.                                          │ ( )  Don't Remove Old    │
  1490.                                          │                          │
  1491.                                          │ ( )  Scan for Viruses    │
  1492.                                          │ ( )  No Decompression    │
  1493.                                          │                          │
  1494.                                          │ ( )  Set Hatch Flag      │
  1495.                                          │ ( )  Auto Virus Validate │
  1496.                                          │                          │
  1497.                                          │ ( )  Don't Validate      │
  1498.                                          └──────────────────────────┘
  1499.  
  1500.           Process New Areas        Instructs FileDude to
  1501.                                    automatically place a check mark
  1502.                                    next to any new areas it
  1503.                                    encounters.  This in effect allows
  1504.                                    FileDude to process areas you added
  1505.                                    inside RG -- but forgot to mark for
  1506.                                    processing inside FileDude.
  1507.  
  1508.           Keep a Log File          Logs important screen information
  1509.                                    to FILEDUDE.LOG.
  1510.  
  1511.  
  1512.  
  1513.          FileDude/2 5.3  /  Keep a Log File                            25
  1514.  
  1515.  
  1516.           Update SYSOP.LOG         Logs end-of-process statistics at
  1517.                                    the end of Renegade's SYSOP.LOG.
  1518.                                    Information such as how many files
  1519.                                    were processed, how many
  1520.                                    conversions took place, etc., will
  1521.                                    be included.
  1522.  
  1523.           Convert Archives         Converts all archives to the format
  1524.                                    specified in the Basic
  1525.                                    Configuration menu.
  1526.  
  1527.                                    FileDude automatically handles
  1528.                                    nodelist and network file naming.
  1529.                                    NODELIST.Z32, for example, would be
  1530.                                    handled like a ZIP file.
  1531.  
  1532.                                    What about NODELIST.A32, though?
  1533.                                    Is it ARJ or ARC?  FileDude will go
  1534.                                    down the list in the Archive Config
  1535.                                    menu.  It will try all archivers
  1536.                                    whose 3-letter extension begins
  1537.                                    with 'A'.  Once FileDude finds one
  1538.                                    that works, it will proceed to the
  1539.                                    next step in the conversion
  1540.                                    process.
  1541.  
  1542.           Don't Remove Old         Prevents FileDude from deleting the
  1543.                                    original archives after the
  1544.                                    conversion process.
  1545.  
  1546.                                    The original archives will have the
  1547.                                    extension .BAK.
  1548.  
  1549.           Scan for Viruses         Scans archives for viruses, using
  1550.                                    the commandline set in the Basic
  1551.                                    Configuration menu.
  1552.  
  1553.                                    FileDude automatically scans
  1554.                                    archives within archives.
  1555.  
  1556.                                    To prevent rescanning files,
  1557.                                    FileDude maintains a VIRSCAN.DAT
  1558.                                    file.  If a file is changed in the
  1559.                                    slightest way, however, FileDude
  1560.                                    will rescan it.
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.          FileDude/2 5.3  /  Scan For Viruses                           26
  1570.  
  1571.  
  1572.           No Decompression         FileDude will skip the
  1573.                                    decompression step of the virus
  1574.                                    scan.  This is useful if you have
  1575.                                    another utility which already
  1576.                                    unpacks the archive in question,
  1577.                                    before FileDude processes it.
  1578.  
  1579.           Set Hatch Flag           Files uploaded from a FILES.BBS
  1580.                                    will have their hatch flags set.
  1581.  
  1582.           Auto Virus Validate      Automatically virus validate
  1583.                                    files which have the hatch flag set
  1584.                                    to on.  This in effect tricks
  1585.                                    FileDude into thinking it already
  1586.                                    virus scanned incoming archives.
  1587.  
  1588.                                    This option is useful if you have
  1589.                                    another utility, such as a .TIC ->
  1590.                                    FILES.BBS converter, that already
  1591.                                    virus scans the incoming archives.
  1592.  
  1593.           Don't Validate           Marks ALL files uploaded as not
  1594.                                    validated.
  1595.  
  1596.  
  1597.  
  1598.           Other Options on the Pulldown Bar
  1599.           ---------------------------------
  1600.  
  1601.           Go!                      Instructs FileDude to begin
  1602.                                    processing.
  1603.  
  1604.           DOS Shell                Shells to the command interpreter.
  1605.  
  1606.           Quit                     Exits FileDude.
  1607.  
  1608.  
  1609.  
  1610.           TEMPLATE FILES
  1611.  
  1612.           The template files FileDude uses to contruct the filelist
  1613.           are:
  1614.  
  1615.           HEADER.ASC      At the beginning of the filelist.
  1616.           PREBODY.ASC     Before a file area.
  1617.  
  1618.           ERROR.ASC       Shows up if FileDude cannot process a
  1619.                           certain file area (i.e. when there is no
  1620.                           SHARE permission.)
  1621.  
  1622.  
  1623.  
  1624.  
  1625.          FileDude/2 5.3  /  Template Files                             27
  1626.  
  1627.  
  1628.           BODY.ASC        Each entry in the file area.
  1629.           EXTBODYx.ASC    For entry with 'x' number of extended
  1630.                           description lines, where 'x' ranges 1 to 9.
  1631.           BODYINFO.ASC    Extra information for a file entry, such as
  1632.                           the number of credits, downloads, etc.
  1633.  
  1634.           POSTBODY.ASC    After a file area.
  1635.           FOOTER.ASC      At the end of the filelist.
  1636.  
  1637.           FILE_ID.ASC     If FileDude compresses your filelist, it
  1638.                           will insert a FILE_ID.DIZ in the archive
  1639.                           using this file as a template.
  1640.  
  1641.  
  1642.           MCI CODES
  1643.  
  1644.           The below MCI codes are valid in only certain template
  1645.           files.
  1646.  
  1647.           MCI   SIZE  TEMPLATE      DESCRIPTION
  1648.           ---   ----  ------------  ----------------------------------
  1649.           %DA   8     HEADER.ASC    date of the filelist in format:
  1650.                       FOOTER.ASC    xx/xx/xx
  1651.                       FILE_ID.ASC
  1652.  
  1653.           %BN   40    HEADER.ASC    BBS name
  1654.                       FOOTER.ASC
  1655.                       FILE_ID.ASC
  1656.  
  1657.           %BP   12    HEADER.ASC    BBS phone number in format:
  1658.                       FOOTER.ASC    xxx-xxx-xxx
  1659.                       FILE_ID.ASC
  1660.  
  1661.           %SN   30    HEADER.ASC    Sysop's name
  1662.                       FOOTER.ASC
  1663.                       FILE_ID.ASC
  1664.  
  1665.           %FB   40    <any>         Full name of the current file area
  1666.  
  1667.           %F1   13    FOOTER.ASC    Total bytes in all areas shown
  1668.                       FILE_ID.ASC
  1669.           %F1K  13    FOOTER.ASC    Total kilobytes in all areas shown
  1670.                       FILE_ID.ASC
  1671.  
  1672.           %F2   13    FOOTER.ASC    Total files in all areas shown
  1673.                       FILE_ID.ASC
  1674.  
  1675.           %F3   6     FOOTER.ASC    Total directories shown
  1676.                       FILE_ID.ASC
  1677.  
  1678.  
  1679.  
  1680.  
  1681.          FileDude/2 5.3  /  Mci Codes                                  28
  1682.  
  1683.  
  1684.           %F4   13    POSTBODY.ASC  Total bytes in current file area
  1685.           %F4K  13    POSTBODY.ASC  Total kilobytes in current file
  1686.                                     area
  1687.  
  1688.           %F5   6     POSTBODY.ASC  Total files processed in the
  1689.                                     current file area
  1690.  
  1691.           %F6   12    BODY.ASC      Name of current file
  1692.  
  1693.           %F7   7     BODY.ASC      Size of current file ("k" on end)
  1694.  
  1695.           %F8   60    BODY.ASC      Main (line 1) description of
  1696.                                     current file
  1697.  
  1698.           %FEx  50    EXTBODYx.ASC  For entry with 'x' number of
  1699.                                     extended description lines, where
  1700.                                     'x' ranges 1 to 9.
  1701.  
  1702.           %FC   6     BODYINFO.ASC  Number of credits required for
  1703.                                     file
  1704.  
  1705.           %FD   8     BODYINFO.ASC  Date of file entry
  1706.                       BODY.ASC
  1707.                       EXTBODYx.ASC
  1708.  
  1709.           %F9   6     BODYINFO.ASC  Number of downloads of a file
  1710.  
  1711.  
  1712.           In addition FileDude can choose between a single and plural
  1713.           form of a word.  The syntax is:
  1714.  
  1715.           %[singular/plural]
  1716.  
  1717.           The following would choose between "directory" and
  1718.           "directories", depending on the value of %F3 (number of
  1719.           directories processed):
  1720.  
  1721.           %F3 %[directory/directories]
  1722.  
  1723.           The value on which the decision is based must be a numeral
  1724.           value, such as 1 or 42, not "one" or "forty-two".
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.          FileDude/2 5.3  /  Mci Codes                                  29
  1738.  
  1739.  
  1740.           FORMATTING
  1741.  
  1742.           After an MCI code, the following formatting options are
  1743.           available:
  1744.  
  1745.           #x -- Sets the width to 'x'.  If the MCI string is not long
  1746.                 enough to fill the width, it is padded with spaces to
  1747.                 'x' length.  'x' can be any integer between -32,767 to
  1748.                 32,767, inclusive.
  1749.  
  1750.                 A positive width is for RIGHT JUSTIFICATION.
  1751.                 A negative width is for LEFT JUSTIFICATION.
  1752.  
  1753.           :x -- Set the precision to 'x'.  If the MCI string is longer
  1754.                 than the precision, the string is truncated to 'x'
  1755.                 length.  'x' can be any positive integer up to 32,767.
  1756.  
  1757.  
  1758.           Here are some examples (with tab marks every 5 spaces to
  1759.           help):
  1760.  
  1761.           ORIGINAL STRING    MCI CODING          OUTPUT
  1762.           ---------------    ----------------    ----|----|----|----|
  1763.           10/29/94           Today is %DA#10!    Today is   10/29/94!
  1764.           Mr. Ed's Corner    BBS: %BN#10:5       BBS:      Mr. E
  1765.           12:04:06           Time: %TI#-7:5am    Time: 12:04  am
  1766.  
  1767.  
  1768.  
  1769.           SWAPPING
  1770.  
  1771.           Because FileDude must remember a lot of information while
  1772.           running, it must use disk storage as memory storage for some
  1773.           functions.
  1774.  
  1775.           For smaller systems, this "memory" information is quite small.
  1776.           For large systems, however, FileDude cannot possibly fit this
  1777.           information into base memory RAM.
  1778.  
  1779.           This memory issue can be overcome using OS/2's 32-bit flat
  1780.           memory model.  However, FileDude still uses the 16-bit API to
  1781.           allocate memory, so swap files are necessary.
  1782.           
  1783.           By default, FileDude will put these data swap files in the
  1784.           same directory as FILEDUDE.EXE.  You can redirect the data
  1785.           swap files, however, by setting a path in the Basic
  1786.           Configuration menu.
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.          FileDude/2 5.3  /  Swapping                                   30
  1794.  
  1795.  
  1796.           This new location for data swap files can be a RAM drive or
  1797.           another hard drive (or a floppy, if you're adventurous.)
  1798.           There must be at least 256K free space in this new location.
  1799.           For larger systems (with more than 4,000 files), you will need
  1800.           at least one megabyte of free space.
  1801.  
  1802.  
  1803.  
  1804.           MULTIPLE CONFIGURATIONS
  1805.  
  1806.           FileDude has the ability to store multiple configurations.
  1807.  
  1808.           Whenever you choose "Save As..." from the File menu, you are
  1809.           saving the current configuration in a new slot.  You can
  1810.           then reload this configuration at a later time by using the
  1811.           "Open..." option from the File menu.
  1812.  
  1813.           If you're running FileDude in automatic mode -- without
  1814.           menus -- you can specify which configuration FileDude should
  1815.           start up with.  Simply add /CONFIG=# to the commandline.
  1816.           The '#' is the number of the slot of the configuration.
  1817.  
  1818.           When you choose "Open..." from the File menu, the first
  1819.           configuration you see on the list is slot #1.  The second
  1820.           configuration is slot #2, etc.
  1821.  
  1822.           Multiple configurations allow you to run several different
  1823.           processes from a single copy of FileDude.
  1824.  
  1825.  
  1826.  
  1827.           MISCELLANEOUS
  1828.  
  1829.  
  1830.           CONTACTING THE AUTHOR
  1831.  
  1832.           The author, Edward Stangler, can be reached at his BBS:
  1833.  
  1834.           Mr. Ed's Corner
  1835.           1-713-447-6119
  1836.           28800 bps
  1837.           24 hours
  1838.  
  1839.           You can also reach the author at the following addresses:
  1840.  
  1841.           Edward Stangler                       CompuServe  74620,2333
  1842.           P.O. Box 38553, Suite #247               Fidonet  1:106/1076
  1843.           Houston, Texas 77238-8553                 ITCnet  85:842/105
  1844.           U.S.A.                                   SGA-Net  30:30/0
  1845.  
  1846.  
  1847.  
  1848.  
  1849.          FileDude/2 5.3  /  Contacting the Author                      31
  1850.  
  1851.  
  1852.           Internet e-mail:   mred@neosoft.com
  1853.  
  1854.           Edhanced Software Home Page:   http://www.neosoft.com/~mred/
  1855.  
  1856.  
  1857.           WHY YOU SHOULD REGISTER
  1858.  
  1859.           o  The "UNREGISTERED" announcement screen is removed.
  1860.           o  The following features are available:
  1861.  
  1862.              o Ability to change "Uploader" and "Default Description"
  1863.              o Archive conversion and virus scanning
  1864.              o Version checking
  1865.              o Packing of EXTENDED.DAT
  1866.  
  1867.           o  You will be supporting the shareware concept.
  1868.  
  1869.           FileDude 5.3 has taken many months and hundreds of hours of
  1870.           programming to develop this far.  If you find FileDude
  1871.           useful, please register.  See REGISTER.FRM for the details.
  1872.  
  1873.           Thank you for trying FileDude!
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.          FileDude/2 5.3  /  Why You Should Register                    32
  1906.  
  1907.  
  1908.           LEGAL INFORMATION
  1909.  
  1910.           This software and documentation are protected under U.S. and
  1911.           international copyright laws and treaties.
  1912.  
  1913.           You are free to make copies of the shareware version of this
  1914.           software and documentation.  However, all materials relating
  1915.           to this license statement, software, documentation, order
  1916.           information, copyright and trademark statement must remain
  1917.           intact as supplied in the original shareware package.  You
  1918.           may not distribute, rent, sublicense, integrate or lease the
  1919.           software or the documentation.  You may not alter, modify,
  1920.           or adapt the software or documentation, including but not
  1921.           limited to translating, decompiling, reverse assembling, or
  1922.           creating derivative works.
  1923.  
  1924.           The author disclaims all warranties, either express or
  1925.           implied, including but not limited to implied warranties of
  1926.           merchantability and fitness for a particular purpose, with
  1927.           respect to the software and any accompanying written
  1928.           materials.  In no event shall the author be liable for any
  1929.           damages whatsoever (including, without limitation, damages
  1930.           for loss of business profits, business interruption, loss of
  1931.           business information, or other pecuniary loss) arising out
  1932.           of the use and/or misuse of this product, even if the author
  1933.           has been advised of the possibility of such damages.
  1934.           Because some states do not allow the exclusion or limitation
  1935.           of liability for consequential or incidental damages, the
  1936.           above limitations may not apply to you.
  1937.  
  1938.           All brand and product names referenced in this document are
  1939.           trademarks, registered trademarks, or copyrighted works of
  1940.           their respective holders.
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.