header

The title of the header to be added. (default: "VERSION")

format

The string to use when generating the version string.

Default: version %v

The following variables are available:

• v - the version
• V - the version, suffixed by "-TRIAL" if a trial release
• d - the CLDR format for DateTime
• n - a newline
• t - a tab
• s - a space
• r - the name of the dist, present only if you use Dist::Zilla to generate the POD!
• m - the name of the module, present only if PPI parsed the document and it contained a package declaration!
• T - special: at the beginning of the line, followed by any amount of whitespace, indicates that the line should only be included in trial releases; otherwise, results in a fatal error

If multiple strings are supplied as an array ref, a line of POD is produced for each string. Each line will be separated by a newline. This is useful for splitting longer text across multiple lines in a "weaver.ini" file, for example:

  ; weaver.ini
  [Version]
  format = version %v
  format =
  format = This module's version numbers follow the conventions described at
  format = L<semver.org|http://semver.org/>.
  format = %T
  format = %T This is a trial release!

is_verbatim

A boolean value specifying whether the version paragraph should be verbatim or not.

Default: false

time_zone

The timezone to use when using DateTime for the format.

Default: local

build_content

  my @pod_elements = $section->build_content(\%input);

This method is passed the same "\%input" that goes to the "weave_section" method, and should return a list of pod elements to insert.

In almost all cases, this method is used internally, but could be usefully overridden in a subclass.