paginate

Short:        Does pagination and line numbering on files
Architecture: m68k-amigaos

    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