NAME
	aft - [Avenir's] file tracker

SYNOPSIS
	aft			defaults to "aft lu" (list all changed).
	aft c <file>		catchup; mark <file> as tracked.
	aft C			catchup; mark all files as tracked.
	aft lu			list all tracked files that have changed.
	aft l			list all tracked files.
        aft n [<file>]          display new lines in the next tracked file.
        aft r [<file>]          use "tail -r" on the next tracked file.
	aft s <path> [<name>]	select a file for tracking.
	aft u <file>		unselect <file> for tracking.
        aft U			unselect all files.

DESCRIPTION
	The file tracker can be used to keep track of (log) files. You can
	register a file in your list of tracked files. Then, it will keep
	track of whether the file changed since you last read it.

	When you read the file, either the new lines are displayed, or the
	"tail -r" is printed, allowing you to scroll up in the file.
	Recommended use: "aft n"

	A typical "aft l" list looks as follows. The list is sorted based on
	the file name. To refer to a file, you can use the number, the name
	or the full path. An asterisk (*) marks that the file has changed
	since you last tailed it. The greater than (>) sign denotes the log
	you most recently viewed. The rightmost column contains the size of
	the file in bytes. With "aft" or "aft lu" only the files that changed
	(i.e. with an asterisk) are shown.
 
	 1 commune :   /d/Genesis/log/COMMUNE                    154184
	 2 kills   : * /d/Genesis/log/KILLS                       89798
	 3 pkills  : * /d/Genesis/log/PKILLS                      19599
	 4 bugs    >   /d/Genesis/log/bugs                         4395
	 5 praise  :   /d/Genesis/log/praise                      77145
 
ARGUMENTS
	[none]	Without arguments, do "aft lu", list all tracked files that
		have changed since they were last read.

	<path>	Start tracking the path <path>. Tilde notation (~) is
		accepted.

	<name>	An optional private name for a file to track. You can use
		this name to refer to the file later. This name may not be
		longer than eight characters.

	<file>	Index to the file you want to handle. This can be the number
		of the file in the list of files you track, or the private
		name you assigned to a file. It can also be the path of the
		file (including tilde notation).

SEE ALSO
	tail
