Summary

###########################################################################

	File:     showtbl.icn

	Subject:  Procedure to show contents of a table

	Author:   Ralph E. Griswold

	Date:     May 25, 1996

###########################################################################

   This file is in the public domain.

###########################################################################


  showtbl(title, tbl, sort_type, limit, sort_order, posit,
    w1, w2, gutter, f1, f2) displays tbl according to the arguments given.

  The arguments are:

  position	name		meaning			default/alternative

     1		title		heading title		""
     2		tbl		table to be shown
     3		sort_type	type of sorting		"ref"/"val"
     4		limit		lines of table output	essentially infinite
     5		sort_order	increasing/decreasing	"incr"/"decr"
     6		posit		first column		"val"/"ref"
     7		w1		width of 1st column	10
     8		w2		width of 2nd column	10
     9		gutter		width between columns	3
    10		f1		function of 1st column	left
    11		f2		function of 2nd column	right

  showtbl() returns a record with the first element being a count of
  the size of the table and the second element the number of lines
  written.

###########################################################################

  This procedure just grew.  It needs rewriting.
  And it has far too manmy arguments.

###########################################################################

  Deficiencies:  Several features are not yet implemented.  sort_order
                 and posit have no effect.  In the case of sort_type
                 "val", the sorting order is decreasing.

###########################################################################

This file is part of the (main) package.

showtbl(title, tbl, sort_type, limit, sort_order, posit, w1, w2, gutter, f1, f2)