NAME

    Dist::Zilla::Plugin::ArchiveTar - Create dist archives using
    Archive::Tar

VERSION

    version 0.03

SYNOPSIS

    In your dist.ini

     [ArchiveTar]

DESCRIPTION

    This Dist::Zilla plugin overrides the build in archive builder and uses
    Archive::Tar only. Although Dist::Zilla does frequently use
    Archive::Tar itself, it is different from the built in version in the
    following ways:

    Predictable

      The built in behavior will sometimes use Archive::Tar or
      Archive::Tar::Wrapper. The problem with Archive::Tar::Wrapper is that
      it depends on the system implementation of tar, which in some cases
      can produce archives that are not readable by older implementations
      of tar. In particular GNU tar which is typically the default on Linux
      systems includes unnecessary features that break tar on HP-UX. (You
      should probably be getting off HP-UX if you are still using it in
      2021 as I write this).

    Sorted by name

      The contents of the archive are sorted by name instead of being
      sorted by filename length. While sorting by length makes for a pretty
      display when they are unpacked, I find it harder to find stuff when
      the content is listed.

    Additional formats

      This plugin supports the use of compression formats supported by
      Archive::Tar.

PROPERTIES

 format

     [ArchiveTar]
     format = tar.gz

    Sets the output format. The default, most common and easiest to unpack
    for cpan clients is tar.gz. You should consider carefully before not
    using the default. Supported formats:

    tar

    tar.gz

    tar.bz2

    tar.xz

SEE ALSO

    Archive::Libarchive

    Dist::Zilla

    Dist::Zilla::Plugin::Libarchive

    Dist::Zilla::Role::ArchiveBuilder

AUTHOR

    Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

    This software is copyright (c) 2021 by Graham Ollis.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.