home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt63.zip / downsort.faq < prev    next >
Text File  |  1996-12-27  |  7KB  |  131 lines
  1.  
  2.     A couple of Frequently Asked Questions about Downsort by Rob Hamerling
  3.     ──────────────────────────────────────────────────────────────────────
  4.  
  5.     These questions are about and the answers hopefully explain or prevent
  6.     unexpected behaviour of Downsort. It may help you to understand how to
  7.     organise your FILES.BBS and specify the parameters in Downsort.Cfg for
  8.     optimal results.
  9.  
  10.     ──────────────────────────────────────────────────────────────────────
  11.  
  12.  
  13. Q1. The setup of Downsort is too complicated for first time users, the
  14.     sample Downsort.Cfg contains too much text, cannot it be made simpler?
  15.  
  16. A1. Sysops are always in a hurry and read Downsort.Cfg sometimes only after
  17.     hours of experiments. Every good manual is a comprimise between being
  18.     clear and complete. Therefore I made a complete manual (Downsort.Doc)
  19.     and summarised the most important instructions in a sample Downsort.Cfg,
  20.     following the style of MAX.CTL and many other programs.
  21.     Why does one expect a versatile program to be simple to setup?
  22.  
  23.  
  24. Q2. What is the minumum parameter specification for Downsort.Cfg?
  25.  
  26. A2. Without ANY commandline parameter and configuration file Downsort will
  27.     probably generate an Allfiles.Lst for you (since version 6.3)! This will
  28.     work if you run Downsort from the directory in which the Maximus file
  29.     FAREA.DAT is located, or the MAXIMUS environment variable points to the
  30.     directory of Maximus' main control files, among which the file
  31.     FAREA.DAT. See also chapter "Quick Start" in Downsort.Doc.
  32.     If you want more or want it differently, you need to tell Downsort via a
  33.     configuration file such as the sample file Downsort.Cfg.
  34.  
  35.  
  36. Q3. Why does Downsort not support privilege and key/locks or ACS?
  37.  
  38. A3. Maximus 3.0 uses an Access Control String (ACS) as a suffisticated
  39.     method to control which class of users may access which resources.
  40.     Downsort is only concerned with downloadable files, which is just a tiny
  41.     subset of the scope of Maximus. Filelists are generally not provided
  42.     in all variations of your user classes. And since most sysops use
  43.     access-rights to download areas much simpler than Maximus allows, I
  44.     considered it not worth the trouble to copy or mimic the rather
  45.     complicated method of ACS.
  46.     With Downsort's support of AreaGroups you may obtain an approximate
  47.     result, but agreed, this is not automatic.
  48.  
  49.  
  50. Q4. I have my FILES.BBS formatted like this:
  51.  
  52.     Filename.Ext Short file description,
  53.                  +----------------------------------------------+
  54.                  | but this is only the first line of a longer  |
  55.                  | and neatly(?) formatted description.         |
  56.                  +----------------------------------------------+
  57.  
  58.     How do I tell Downsort to maintain this carefully formatted description?
  59.  
  60. A4. According to Maximus' docs the whole file-description must be on the
  61.     line with the filespec and may not exceed 1024 characters (Maximus 3.0).
  62.     Maximus does not know about 'continuation lines', and handles these
  63.     as comments. So in fact this is an improper question!
  64.  
  65.     However Downsort has a slightly more practical approach: it tries to
  66.     recognise continuation lines and will handle these as integral part of
  67.     the file description. For this purpose Downsort collects the description
  68.     including (supposed) continuation lines in a single string of up to 2 KB.
  69.     Advantages:
  70.     1. FILES.BBS can be sorted without loosing the 'comment'-lines, which
  71.        are in fact continuation lines of the description. Where should these
  72.        lines be put otherwise after sorting?
  73.     2. Saves memory for the leading blanks: maybe not so important for
  74.        OS/2, but the more for DOS.
  75.     3. Faster sorts: less lines to be sorted.
  76.     4. Allows dynamic formatting of the description based on the available
  77.        width, which is different for different lists.
  78.        With IPFFileList this is down by VIEW, and with HTML-formatted lists
  79.        by the browser, depending on the used font.
  80.     Disadvantage: the original format of the description is lost.
  81.  
  82.     Of course I have thought about different approaches, but so far I could
  83.     not find a method without loosing the listed advantages.
  84.  
  85.  
  86. Q5. Can Downsort import FILE-ID.DIZ?
  87.  
  88. A5. Yes it can! (since version 6.3)
  89.     There are some prerequisites and other matters you should be aware of:
  90.     - With the keyword DIZimport (see the sample Downsort.Cfg) you can
  91.       specify: 'Yes' to import only missing descriptions, or 'Force' to
  92.       replace existing descriptions, or a numeric value when the current
  93.       description is shorter than this number of bytes.
  94.       Finally you can choose for 'No' import, which is the default.
  95.     - Downsort follows the rules as in the answer of question 4: The whole
  96.       description will be in single string of up to 2 KB, and the text will
  97.       be unwrapped (newlines and consecutive blanks removed).
  98.     - A configuration file Compress.Cfg is used to obtain the extract
  99.       command specification for a particular archive type. This can be the
  100.       same file as you use for Maximus or Squish. A copy of one of those is
  101.       provided with Downsort.
  102.  
  103.  
  104. Q6. How careful handles Downsort my Files.Bbs?
  105.  
  106. A6. Since Files.Bbs is a valuable resource, Downsort is designed to allow
  107.     you to recover from a wrong choice, or even malfunctioning of Downsort.
  108.     These are the options and possible pitfalls:
  109.     - You can create new Files.Bbs files in another directory than where the
  110.       originals are. This is the most safe way of doing it, since the
  111.       originals will be read only. But your users will not see the results
  112.       unless you copy this output over the original Files.Bbs!
  113.     - When you choose to let Downsort update your Files.Bbs files then the
  114.       original will be copied to Files.Bak for every area. But of course
  115.       this allows recovery only after a single update by Downsort!
  116.     - When an error is detected during write of a new Files.Bbs file in
  117.       update mode, the original is restored immediately!
  118.     - All text that Downsort recognises as file description or continuation
  119.       lines of it are preserved with a maximum of 2 KB. Other text in
  120.       Files.Bbs is handled as comment. If you choose to sort the contents of
  121.       Files.Bbs, then the comments are lost.
  122.  
  123.     ** Always check results and recover before running Downsort again **
  124.  
  125.  
  126.     ────────────────────────────────────────────────────────────────────
  127.  
  128.     Hopefully these answers explain some 'unexpected' or 'unwelcome'
  129.     behaviour. If still unclear, please ask!
  130.  
  131.