NAME
	Paginate - Paginates a file or numbers the lines in a file

    SYNOPSIS
	Paginate <infile >outfile -F/K -f0/K -f1/K -ff/K -H/K -h0/K -h1/K
	-hf/K -N/K -t/K/N -b/K/N -l/K/N -r/K/N -p/K/N -T/S

	    -F	    Default Format String for Footers
	    -f0     Format String for Even Paged Footers
	    -f1     Format String for Odd Paged Footers
	    -ff     Format String for Footer on First Page
	    -H	    Default Format String for Headers
	    -h0     Format String for Even Paged Headers
	    -h1     Format String for Odd Paged Headers
	    -hf     Format String for Header on First Page
	    -N	    Printf Style Format String for Line Numbering
	    -t	    Top Line for Each Page
	    -b	    Bottom Line for Each Page
	    -l	    Left Margin for Headers and Footers
	    -r	    Relative Right Margin for Headers and Footers
	    -p	    Number of First Page
	    -T	    Title Page

    COPYRIGHT
	Paginate Copyright (C) 1993 Fergus Duniho

    DESCRIPTION
	This program divides a text file into pages of equal length, and it
	optionally marks each page with a header, a footer, or both. The
	headers and footers may contain the page number in various formats,
	as well as the time and date in various formats. They may also
	include any other text you want to put in them.

	You may choose different headers and footers for odd and even
	pages, as well as for the first page. You may also choose to have
	no header or footer on the first page, on odd pages, or on even
	pages. And you may choose to have the same footer or header on all
	pages.

	You may also choose to make the first page a title page. A title
	page has no headers and footers on it. Also, "Paginate" does not
	begin page numbering with a title page. And as far as the headers
	and footers for the first page are concerned, "Paginate" does not
	regard the title page as the first page. It considers it as the
	page prior to the first page.

    HISTORY
	I first needed a pagination program when I began writing my essays
	with dme instead of with my word processor. I preferred dme because
	it was faster and much more customizable, but it didn't have all
	the nice features that my word processor had, including pagination.

	My first pagination program was an ARexx script called
	Paginate.dme. This would put some lines at the beginning of a page,
	and it would center the line number at the bottom of the page. It
	would let me control such parameters as first page number and
	number of lines per page.

	When I began writing XDMD, the soon to be released successor of
	DMD, I decided that I wanted something better. I downloaded Pager
	to see if it would suit my needs, and it didn't. So I wrote this
	program, which is much more powerful than both Paginate.dme and
	Pager. In my opinion, it completely replaces both.

	Fergus Duniho

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  587    1711  34.3% -lh5- 5d30 Apr 27  1993 Paginate/NumToStr.c
[generic]                 8077   13972  57.8% -lh5- 4909 Apr 27  1993 Paginate/Paginate
[generic]                 2798    8950  31.3% -lh5- 6642 Apr 27  1993 Paginate/Paginate.c
[generic]                 8091   22744  35.6% -lh5- e906 Apr 27  1993 Paginate/Paginate.man
[generic]                  357    1076  33.2% -lh5- 7b1c Apr 25  1993 zzBBSList.TXT
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         5 files   19910   48453  41.1%            Apr 28  1993