jedstate(1) · carta

NAME

jedstate - an add-on for the text-editor jed

SYNOPSIS

Usually you won't have to invoke jedstate manually. For sample crontab entries to maintain your database see the Examples section.

DESCRIPTION

This manual page documents briefly the jedstate command. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

jedstate is some sort of an extended mind for John E. Davis' splendid text editor jed. Using jedstate and jed's startup and exit hooks as a glue jed "remembers" the position of the cursor for all visited files and will automagically jump to that position whenever the file is revisited. The database is purgeable based on a time-since-last-view criterion.

OPTIONS

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-xN --example=[N]: print sample startup/exit hooks (1|2)

-h --help: Show summary of options.

-pAGE --purge=AGE

Purge database entries older than AGE

Where AGE is age-since-last-view in seconds unless appended with `Y' (years), `W' (weeks), `D' (days), `H' (hours) or `M' (minutes), e.g., "2w" (2 weeks) or "19d" (19 days).
Be careful not to overflow an int. If AGE is negative no purging will take place. If age is zero the database will be cleared (this is useful when installing jedstate for the first time)!
To purge only non-existant files set AGE=0x7FFFFFFF or some other large number.

-q --quiet: Suppress normal output

-Q --really-quiet: Suppress even error messages

-V --version: Show version of program.

EXAMPLES

Sample crontab entries for database maintenance:

# Keep four weeks' worth of data
02 00 * * * /usr/bin/jedstate --purge=4w

# Keep four weeks' worth of data and shut your mouth
02 00 * * * /usr/bin/jedstate --purge=4w -q

# Purge only non-existant files
02 00 * * * /usr/bin/jedstate --purge=0x7fffffff

# Reset database every Monday
02 00 * * 1 /usr/bin/jedstate --purge=0

# Don't do anything
02 00 * * * /usr/bin/jedstate --purge=-1

AUTHOR

Klaus Alexander Seistrup <[email protected]>