view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    Returns true on success. Returns "undef" on error, or if the path of the
    file clashes with an existing file in the Section.

    This could happen if you try to add a file with the same name, of if
    your path contains a directory that is already in the Section as a file.
    For example, the two files could not exist in the same Section.

      first/second
      first/second/third

    Creation of the directory first/second would be blocked by the existing
    file first/second ( or vica versa ). This issue is caught for you now,
    rather than wait until we are halfway through writing the files to disk
    to find out.

  new_file $path, $generator [, @arguments ]
    Creates a new file, using the arguments provided, and immediately adds
    it to the current section. See the "new" method for
    Archive::Builder::File below for more details on the arguments.

    Returns true if the file is created and added successfuly. Returns

lib/Archive/Builder.pm  view on Meta::CPAN

Returns true on success. Returns C<undef> on error, or if the path
of the file clashes with an existing file in the Section.

This could happen if you try to add a file with the same name, of if your
path contains a directory that is already in the Section as a file. For
example, the two files could not exist in the same Section.

  first/second
  first/second/third

Creation of the directory first/second would be blocked by the existing
file first/second ( or vica versa ). This issue is caught for you now,
rather than wait until we are halfway through writing the files to disk
to find out.

=head2 new_file $path, $generator [, @arguments ]

Creates a new file, using the arguments provided, and immediately adds it
to the current section. See the C<new> method for Archive::Builder::File
below for more details on the arguments.