====== Manual modes ======

===== Manually added captures =====


Use ''-S'' (''%%--%%stamp'') to force capturing at a certain time stamp. The usual [[vcs:docs:time_syntax|time syntax]] can be used.

When a fixed number of captures is used (''[[vcs:docs:cli_options#numcaps|-n]]''), manually set captures are added to that number, so e.g. ''$ vcs -n 3 -S 1m'' will output four captures.


===== Highlights =====

Highlights are a special type of manual captures. They're put in a separate section of the contact sheet (see [[vcs:docs:sections]]), shown before the standard contact sheet and with a highlighted background.

Use ''-l'' (''%%--%%highlight'') followed by a [[vcs:docs:time_syntax|time stamp string]] to add a highlight. There's no limit of highlights.

Note that unless a single highlight is used they won't be centered so it's usually preferable to match the number of columns (or a multiple).

===== Manual-only mode =====

In manual-only mode no captures will be taken by default, only those specified manually will be used.

Manual-only mode is enabled with ''-m'' (''%%--%%manual''). At least a manual capture is required to enable this mode.

Highlights (which are always manual) and extended captures aren't affected by this mode.