home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / forut062.zip / ForUtil-0.62 / man / doc / list_commons.txt < prev    next >
Text File  |  1996-08-28  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. LIST_COMMONS(1)       ForUtil Fortran Tools       LIST_COMMONS(1)
  5.  
  6.  
  7. NAME
  8.        list_commons - list the contents of a f77 common database.
  9.  
  10.  
  11. SYNOPSIS
  12.        list_commons [-shv] -ddatabase -fincfile -ooutfile
  13.  
  14.  
  15. DESCRIPTION
  16.        list_commons can be used to manually check the contents of
  17.        a  common  database. It outputs every common it finds in a
  18.        given database.  list_commons examines a  database  gener-
  19.        ated with scan_commons(1).
  20.  
  21.  
  22. OPTIONS
  23.        -h, --help
  24.               Shows a short description of every option.
  25.  
  26.  
  27.        -s     If  you  use  this flag, list_commons will sort the
  28.               contents of the database per  file  that  has  been
  29.               stored  in  the  database.   If  this option is not
  30.               given,  list_commons  will  just  list  the  entire
  31.               (unsorted)  contents  of  the  database. Using this
  32.               option can take a while since the  entire  database
  33.               has to be scanned entirely before the output can be
  34.               sorted. The MS-DOS version might run out of  memory
  35.               if you have a large database.
  36.  
  37.  
  38.        -v     Show database version information. This information
  39.               consists of the name of the user that  has  created
  40.               this  database,  the  machine and system name where
  41.               this database was created on, the date of the  last
  42.               update   of  this  database,  and  the  directories
  43.               stored.
  44.  
  45.  
  46.        --version
  47.               Shows the version number of get_common.
  48.  
  49.  
  50.        -ddatabase
  51.               Name of the database to list.  If  no  database  is
  52.               given, the value of COMMON_DATABASE is checked.
  53.  
  54.  
  55.        -fincfile
  56.               This  is  the  same as the -s option, with the main
  57.               difference being that only the commons for  incfile
  58.               will be shown.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Linux                      August 1996                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LIST_COMMONS(1)       ForUtil Fortran Tools       LIST_COMMONS(1)
  71.  
  72.  
  73.        -ooutfile
  74.               Using  this option will cause list_commons to store
  75.               its output in the  file  outfile.   If  not  given,
  76.               list_commons will write it's output to stdout.
  77.  
  78.  
  79. COMPATIBILITY
  80.        list_commons  has run under HP-UX 9 and 10, SGI IRIX 5.2 &
  81.        5.3, DEC OSF1, SunOs 4.1 and 4.3, Cray Unicos, IBM AIX 3.2
  82.        &  4.1,  Linux and MSDOS 6.2.  list_commons also runs in a
  83.        dos box under Windows 3.1, 3.11 and Win95.
  84.  
  85.  
  86. ENVIRONMENT
  87.        COMMON_DATABASE
  88.               Points to the location of a common  database.  This
  89.               environment variable is only used if no database is
  90.               given on the command line.
  91.  
  92.  
  93. DISTRIBUTION POLICY
  94.        All utilities in  this  fortran  utility  suite  are  dis-
  95.        tributed under the GNU Public License.
  96.  
  97.  
  98. BUGS
  99.        If  a  bug occurs, it will most likely be generated by the
  100.        MS-DOS versions of these tools. This will be mainly due to
  101.        the 640kb memory limit MS-DOS has.
  102.  
  103.        If  you  think you have found a bug, you can send email to
  104.        the author, describing what the bug is, how you  generated
  105.        it  and if you can reproduce it. Also specify the platform
  106.        where this bug occured.
  107.  
  108.  
  109. AUTHOR
  110.        Koen D'Hondt
  111.        ripley@xs4all.nl
  112.        (C)Copyright 1995-1996 by Ripley Software Development
  113.  
  114.  
  115. SEE ALSO
  116.        scan_commons(1),   get_common(1),   fflow(1),   ffscan(1),
  117.        ftags(1)
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. Linux                      August 1996                          2
  131.  
  132.  
  133.