=head1 Name

sqitch-tag - Create or list tag objects

=head1 Synopsis

  sqitch [options] tag
  sqitch [options] tag name
  sqitch [options] tag name change
  sqitch [options] tag [-n MESSAGE] name

=head1 Description

Tag a change or list the existing tags. Tagging a change is useful for
preparing for a release. Tags are also required in order to rework a change.

To specify a change, use a change specification as documented in
L<sqitchchanges>. If called with a tag name but no change, the most recent
change will be tagged. If called with no name specified, a list of the current
tags will be output.

=head1 Options

=over

=item C<-n>

=item C<--note>

A brief note describing the tag. The note will be attached to the tag as a
comment. Multiple invocations will be concatenated together as separate
paragraphs.

For you Git folks out there, C<-m> also works.

=back

=head1 Configuration Variables

None currently.

=head1 Sqitch

Part of the L<sqitch> suite.
