home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / tools / system / info / info.doc < prev    next >
Text File  |  1997-06-07  |  6KB  |  178 lines
  1.                  Info V39.6
  2.          © 1997 by Stephan Rupprecht
  3.              All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  This version of Info is copyrighted 1997 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,DEVICES«. Each parameter is optional. 
  57.  If you don't give any parameter, you'll get full information. If 
  58.  you provide a device name (eg. df0:) or a pattern string (eg. dh?:) 
  59.  you will get only information for the device(s) matching the given 
  60.  string. If you invoke Info with the keywords VOLUMES or DISKS, 
  61.  you'll only get information from these ones. The keyword VOLS is 
  62.  only an abbreviation for VOLUMES.
  63.  
  64.  Some examples for the DEVICES option:
  65.  
  66.  Info (df0:|dh0:) Info only shows information about df0: and dh0:
  67.  Info d#?         Info shows all devices, which names begin with a 'd'
  68.  For more about patterns, take a look at the AmigaDOS manual (ch. 1-11).
  69.  
  70. CUSTOMIZEABLE DATE-TIME TEMPLATE
  71.  Starting with version 39.6 of Info, you can now specify your own
  72.  date-time template for the creation date of a volume. This is done
  73.  by setting the env variable 'info_datetime'.
  74.  The variable must contain a template describing the desired format for 
  75.  the date and/or the time. This is constructed just like C-language printf()
  76.  statements, except that different formatting codes are used. Just like in C,
  77.  formatting codes start with a % followed by the formatting command.
  78.  The following commands are accepted by this function:
  79.  (Description is taken from the autodocs, (C) Amiga International)
  80.  
  81.     %a - abbreviated weekday name
  82.     %A - weekday name
  83.     %b - abbreviated month name
  84.     %B - month name
  85.     %c - same as "%a %b %d %H:%M:%S %Y"
  86.     %C - same as "%a %b %e %T %Z %Y"
  87.     %d - day number with leading 0s
  88.     %D - same as "%m/%d/%y"
  89.     %e - day number with leading spaces
  90.     %h - abbreviated month name
  91.     %H - hour using 24-hour style with leading 0s
  92.     %I - hour using 12-hour style with leading 0s
  93.     %j - julian date
  94.     %m - month number with leading 0s
  95.     %M - the number of minutes with leading 0s
  96.     %p - AM or PM strings
  97.     %q - hour using 24-hour style
  98.     %Q - hour using 12-hour style
  99.     %r - same as "%I:%M:%S %p"
  100.     %R - same as "%H:%M"
  101.     %S - number of seconds with leadings 0s
  102.     %t - insert a tab character
  103.     %T - same as "%H:%M:%S"
  104.     %U - week number, taking Sunday as first day of week
  105.     %w - weekday number
  106.     %W - week number, taking Monday as first day of week
  107.     %x - same as "%m/%d/%y"
  108.     %X - same as "%H:%M:%S"
  109.     %y - year using two digits with leading 0s
  110.     %Y - year using four digits with leading 0s   
  111.     
  112.  Example:
  113.  SetEnv info_datetime "created %x" 
  114.  Info outputs a date formated like this 'created 05/01/97'
  115.  
  116.  SetEnv info_datetime ""
  117.  Info does not print a creation date/time
  118.  
  119.  NOTE: This feature is only available under OS2.1 and higher!
  120.  After you have found your favorite template, you should
  121.  
  122.  SetENV ENVARC:info_datetime "you fav template"
  123.  
  124.  it, so that it does not get lost after a reboot! If you don`t
  125.  specify a template, Info uses the standard DOS template.
  126.  
  127.  
  128. NEW LANGUAGE CATALOGS
  129.  If you translate Info to your native language, please send me the
  130.  catalog translation file (.ct) via eMail, so that I can include it
  131.  into the archive.
  132.  You can find the catalog descriptor file in the subdir Catalogs/ !
  133.  
  134.  
  135. HISTORY
  136.  39.1 first public release
  137.  39.2 added pattern-matching, removed DEVICES/M option for this
  138.       purpose.
  139.       fixed a bug, which causes info to continue its job even
  140.       when a memory allocation failed.
  141.  39.3 devices and volumes are printed in alphabetical order now
  142.  39.4 recompiled with MaxonDEVELOP, some optimiziations
  143.  39.5 Info does no longer shorten the device designation to 5 characters.
  144.       New catalog file (french).
  145.  39.6 customizeable date-time template, new catalogs
  146.  
  147.  
  148. SPECIAL THANKS GO TO
  149.    Gunther Nikl for reporting me that the german catalog file
  150.    was missing the last time (39.1).
  151.    Jussi T Lindgren for his suggestions.
  152.    Didier Giron for the french translation.
  153.    Dirk Mueller for his suggestions.
  154.    Kristoffer Larsson (swedisch cat.)
  155.    Kim Roar Utsi (norwegian cat.) 
  156.    Dimitris Panokostas (greek cat.)
  157.    
  158.    and to all others, who send me an eMail and aren't mentioned here!
  159.  
  160.  
  161. TODO
  162.  Assign support
  163.  
  164.  
  165. AUTHOR
  166.  
  167. Please send bug reports and ideas to:
  168.  
  169.  Stephan Rupprecht
  170.  Apfeldweg 1
  171.  D44359 Dortmund
  172.  Germany
  173.  
  174.  Send emails to (it`s my brothers address!)
  175.  
  176.  Rupprecht_Verwertung@T-Online.de
  177.  
  178.