; PRTAB
;---------------------------------------------------------------
;! prints any table-format extension file
;# Task Table Plot
;-----------------------------------------------------------------------
;;  Copyright (C) 1995-1996, 1999, 2002, 2004, 2007, 2009
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
PRTAB     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
PRTAB:  Task to print any table-format extension file
INNAME                             Image name (name)
INCLASS                            Image name (class)
INSEQ             0.0    9999.0    Image name (seq. #)
INDISK            0.0       9.0    Disk drive #
INEXT                              Extension type
INVERS           -5.0   46655.0    Extension file version #
BPRINT            0.0              First row number to print
EPRINT            0.0              Last row number to print
XINC              0.0   32767.     Increment between rows
NDIG              0.0      10.0    > 3 => extended precision
DOCRT            -3.0     132.0    If > 0, write to CRT
                                   > 72 => CRT line width
OUTPRINT
                                   Printer disk file to save
DOHMS            -1.0       2.0    If > 0 print times with
                                   hh:mm:ss.s format
NCOUNT            0.0              Print the first NCOUNT values
                                   in a cell plus
BDROP             0.0              values BDROP through
EDROP             0.0              EDROP (if appropriate)
BOX                                List of columns to be printed
                                   0 -> all.
DOFLAG           -1.0       1.0    > 0 => list flagged rows too
----------------------------------------------------------------
PRTAB
Type:  Task
Use:   PRTAB prints on the line printer or terminal the rows of any
       extension file having a tables format.
Adverbs:
  INNAME.....Image name (name).           Standard defaults.
  INCLASS....Image name (class).          Standard defaults.
  INSEQ......Image name (seq. #).         0 => highest.
  INDISK.....Disk drive # of image.       0 => any.
  INEXT......Extension file type          ' ' => 'TA'
  INVERS.....Extension file version #     0 => highest.
  BPRINT.....First row to list.           0 => 1.
  EPRINT.....Last row to list.      < BPRINT => to end.
  XINC.......Increment in row number between listings.
             <= 0 => 1.
  NDIG.......If NDIG <= 3, the formats 1PE10.3 and 1PD13.6 are used
             for single and double precision floats.  To see more
             digits, NDIG > 3 causes 1PE13.6 and 1PD17.10 to be used.
             The added digits may be significant in some tables.
  DOCRT......False (<= 0) use the line printer if OUTPRINT = ' '
                   else write named OUTPRINT file only.
                   When OUTPRINT is not blank, DOCRT=-2 suppresses the
                   page-feed character on page headers and DOCRT=-3
                   suppresses page headers and most other header
                   information.
             True  (> 0) use the terminal interactively.  The task will
                   use the actual terminal width as a display limit
                   unless 72 < DOCRT < width.  In that case, the display
                   limit will be DOCRT characters.
  OUTPRINT...Disk file name in which to save the line printer output.
             ' ' => use scratch and print immediately for interactive
             jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
             (jjj= job #, nnn = user #).  When OUTPRINT is not blank,
             multiple outputs are concatenated, and the file is not
             actually printed.
  DOHMS......If DOHMS is false (<=0), the times in the output will
             be printed in days.  If DOHMS > 0, they will be
             printed in the form hh:mm:ss.s.  This is done for any
             column having units of DAYS and a header which starts with
             TIME.
By default, PRTAB prints all elements in a cell of a table, one element
per line.  The next three adverbs may be used to print elements 1-n1 and
n2-n3 only.
  NCOUNT.....Elements 1 through NCOUNT are printed for each selected
             cell in the table.   0 => 100000.
  BDROP......Additionally, elements BDROP through EDROP are also
             printed.  0 => 1.
  EDROP......Additionally, elements BDROP through EDROP are also
             printed.  < BDROP => 100000.
  BOX........To select the column numbers to be printed including their
             order.  Up to 40 may be selected.  0 => all columns in
             basic order.
  DOFLAG.....> 0 => list flagged rows (with an * in 1st col) as well
                    as unflagged rows
             <= 0 => skip over flagged rows, listing only good ones.
----------------------------------------------------------------
