home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Workbench / Patches / iNFO.lha / Info / Info.doc < prev    next >
Text File  |  1998-04-19  |  7KB  |  197 lines
  1.                   Info V39.12
  2.          ⌐ 1997/98 by Stephan Rupprecht
  3.               All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  This version of Info is copyrighted 1997/98 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged except for addition of new language catalogs.   
  11.  The author is not responsible for any damage caused by the 
  12.  use or misuse of this documentation and/or the program(s) it 
  13.  describes.
  14.  
  15.  
  16. REQUIREMENTS
  17.  Any Amiga« (compatible) computer with AmigaOS« 2.x or higher.
  18.  
  19.  
  20. DESCRIPTION
  21.  Info is a replacement for the original AmigaDOS« 'info' command.
  22.  In opposite to other info commands, this version does not cause 
  23.  any deadlocks. You can select if you  want only information about
  24.  disks or volumes or even selected devices (they are printed in
  25.  alphabetical order). Another advantage is that the columns 'size'
  26.  and 'used' are printed no longer in blocks, but in KBytes, MBytes 
  27.  or even in GBytes, so  you  don't have to know how long a block
  28.  actually is on a specific device. For volumes the creation date
  29.  is printed additionally. Info uses 64bit math-functions, so you 
  30.  won`t get wrong results about the size of a drive, if you have a 
  31.  big hd of 2GBytes or more. Another feature is that info outputs 
  32.  the disktype of each volume:
  33.  
  34.    Output   File system
  35.    --------------------------------------------------------
  36.    OFS      Old File System (DOS\0)
  37.    FFS      Fast File System (DOS\1)
  38.    INT-OFS  Old File System, internal. mode
  39.    INT-FFS  Fast File System, internal. mode
  40.    DC-OFS   Old File System, fast dirs
  41.    DC-FFS   Fast File System, fast dirs
  42.    MSDOS    CrossDos/MSDos disk
  43.    CDFS     CDRom 
  44.    NO DOS   unknown system
  45.  
  46.          If you use any other filesystem, Info will show you the
  47.          4 byte filesystem identifier. Eg.: users of AmiFileSystem
  48.          will get a PFS or AFS as disktype.
  49.          
  50.          
  51. INSTALLATION AND START 
  52.  To install Info simply doubleclick the Install icon in this 
  53.  directory. You can start Info only from shell, since it a DOS 
  54.  command (except for the possibility to start it from Workbench 
  55.  through the menu item 'Execute Command...'). The format is 
  56.  ╗Info  DISKS/S,VOLS=VOLUMES/S,GOODONLY/S,DEVICES/M½. Each parameter 
  57.  is optional.If you don't give any parameter, you'll get full 
  58.  information. If you provide one or more device names (eg. df0:) 
  59.  or pattern strings (eg. dh?:) you will get only information for the 
  60.  device(s) matching the given string(s). If you invoke Info with the 
  61.  keywords VOLUMES or DISKS, you'll only get information from these 
  62.  ones. The keyword VOLS is only an abbreviation for VOLUMES.
  63.  Starting Info with GOODONLY given, will show you only information
  64.  on those drives which have a valid disk inserted.
  65.  
  66.  Some examples for the DEVICES option:
  67.  
  68.  Info df0: dh0: Info only shows information about df0: and dh0:
  69.  Info d#?       Info shows all devices, which names begin with a 'd'
  70.  For more about patterns, take a look at the AmigaDOS manual (ch. 1-11).
  71.  
  72.  If you specify an assign instead of a device name, Info will give
  73.  you information on the assigned device (eg. C: -> DH0:).
  74.  IMPORTANT: LATEBINDING and NONBINDING assigns are not supported!
  75.  
  76.  
  77. CUSTOMIZEABLE DATE-TIME TEMPLATE
  78.  Starting with version 39.6 of Info, you can now specify your own
  79.  date-time template for the creation date of a volume. This is done
  80.  by setting the env variable 'info_datetime'.
  81.  The variable must contain a template describing the desired format for 
  82.  the date and/or the time. This is constructed just like C-language printf()
  83.  statements, except that different formatting codes are used. Just like in C,
  84.  formatting codes start with a % followed by the formatting command.
  85.  The following commands are accepted by this function:
  86.  (Description is taken from the autodocs, (C) Amiga International, Inc.)
  87.  
  88.     %a - abbreviated weekday name
  89.     %A - weekday name
  90.     %b - abbreviated month name
  91.     %B - month name
  92.     %c - same as "%a %b %d %H:%M:%S %Y"
  93.     %C - same as "%a %b %e %T %Z %Y"
  94.     %d - day number with leading 0s
  95.     %D - same as "%m/%d/%y"
  96.     %e - day number with leading spaces
  97.     %h - abbreviated month name
  98.     %H - hour using 24-hour style with leading 0s
  99.     %I - hour using 12-hour style with leading 0s
  100.     %j - julian date
  101.     %m - month number with leading 0s
  102.     %M - the number of minutes with leading 0s
  103.     %p - AM or PM strings
  104.     %q - hour using 24-hour style
  105.     %Q - hour using 12-hour style
  106.     %r - same as "%I:%M:%S %p"
  107.     %R - same as "%H:%M"
  108.     %S - number of seconds with leadings 0s
  109.     %t - insert a tab character
  110.     %T - same as "%H:%M:%S"
  111.     %U - week number, taking Sunday as first day of week
  112.     %w - weekday number
  113.     %W - week number, taking Monday as first day of week
  114.     %x - same as "%m/%d/%y"
  115.     %X - same as "%H:%M:%S"
  116.     %y - year using two digits with leading 0s
  117.     %Y - year using four digits with leading 0s   
  118.     
  119.  Example:
  120.  SetEnv info_datetime "created %x" 
  121.  Info outputs a date formated like this 'created 05/01/97'
  122.  
  123.  SetEnv info_datetime ""
  124.  Info does not print a creation date/time
  125.  
  126.  NOTE: This feature is only available under OS2.1 and higher!
  127.  After you have found your favorite template, you should
  128.  
  129.  SetENV ENVARC:info_datetime "you fav template"
  130.  
  131.  it, so that it does not get lost after a reboot! If you don`t
  132.  specify a template, Info uses the standard DOS template.
  133.  
  134.  
  135. NEW LANGUAGE CATALOGS
  136.  If you translate Info to your native language, please send me the
  137.  catalog translation file (.ct) via eMail, so that I can include it
  138.  into the archive.
  139.  You can find the catalog descriptor file in the subdir Catalogs/ !
  140.  
  141.  
  142. HISTORY
  143.  39.1  first public release
  144.  39.2  added pattern-matching, removed DEVICES/M option for this
  145.        purpose.
  146.        fixed a bug, which causes info to continue its job even
  147.        when a memory allocation failed.
  148.  39.3  devices and volumes are printed in alphabetical order now
  149.  39.4  recompiled with MaxonDEVELOP, some optimiziations
  150.  39.5  Info does no longer shorten the device designation to 5 characters.
  151.        New catalog file (french).
  152.  39.6  customizeable date-time template, new catalogs
  153.  39.7  finally I added the assign support, os3 version
  154.  39.8  re-implemented DEVICES/M option by request of a single user, polish
  155.        catalog
  156.  39.9  supports multiple assigns, now "Info Work:"-like calls are possible,
  157.        new catalogs: serbian,spanish,italian
  158.  39.10 added GOODONLY option
  159.  39.11 changed german catalog by request of a single user, fixed rounding
  160.        error
  161.  39.12 no "division by zero" guru, when disk size equals zero (thanks to
  162.        Matthew Wakeling for the bug report).
  163.  
  164.  
  165. SPECIAL THANKS GO TO
  166.    Gunther Nikl for reporting me that the german catalog file
  167.    was missing the last time (39.1).
  168.    Jussi T Lindgren and
  169.    Dirk Mueller for their suggestions.
  170.  
  171.  Translators:
  172.    Didier Giron (french)
  173.    Kristoffer Larsson (swedisch)
  174.    Kim Roar Utsi (norwegian) 
  175.    Dimitris Panokostas (greek)
  176.    Tomasz Kepa (polish)
  177.    Javier de las Rivas and
  178.    Juan Antonio Burgos Lopez (spanish)
  179.    Daniele Peri (italian)
  180.    Ljubomir Jankovic (serbian)
  181.    
  182.    and to all others, who sent me an eMail and aren't mentioned here!
  183.  
  184.  
  185. AUTHOR
  186.  
  187. Please send bug reports and ideas to:
  188.  
  189.  Stephan Rupprecht
  190.  Apfeldweg 1
  191.  D44359 Dortmund
  192.  Germany
  193.  
  194.  Send emails to
  195.  
  196.  stephan.rupprecht@metronet.de
  197.