# Some files to work with.
$  ls
man.pod           tagit*

# Tag some files.
$  ./tagit tagit Perl Source
tagit: tagit -> Perl, Source
tagit: The file has been added.

$  ./tagit man.pod Perl Pod Source Manual
tagit: man.pod -> Manual, Perl, Pod, Source
tagit: The file has been added.

# Add a tag to an existing file.
$  ./tagit tagit Program
tagit: The file has been updated.

# List the tagged files.
$  ./tagit
man.pod -> Manual, Perl, Pod, Source
tagit -> Perl, Program, Source
--
2 files

# List the files with a certain tag.
$  ./tagit -l Manual
man.pod -> Manual, Perl, Pod, Source
--
1 of 2 files

# List the known tags.
$  ./tagit -t
Manual -> 1
Perl -> 2
Pod -> 1
Program -> 1
Source -> 2
--
5 tags

# Delete a tag.
$  ./tagit -d Manual
man.pod -> Manual, Perl, Pod, Source
--
1 of 2 files

# Add a note to a file.
$ ./tagit -n "The manual for TagIT." man.pod
tagit: Note added.

$ ./tagit
man.pod -> Manual, Perl, Pod, Source
> The manual for TagIT.
tagit -> Perl, Program, Source
--
2 files

# Delete a note.
$ ./tagit -N man.pod
tagit: Note deleted.

$ ./tagit
man.pod -> Manual, Perl, Pod, Source
tagit -> Perl, Program, Source
--
2 files