<<

NAME

MUD::ExtrasEntry - definition of file to be copied to mud-extras, and possibly auto-installed.

DESCRIPTION

This class encapsulates the information on files which should be copied to mud-extras in the source tree of a package. These files are then available to debian/rules, and other build scripts, to do with as they please.

One typical use is to add new files which should be installed alongside the package, for example icons; launch scripts; desktop files and services.

METHODS

new( FILE, [ METADATA ] )

Create a new instance of a file which should be copied to the source tree. FILE should be an absolute path, and METADATA is an optional hash of data to define destination mode, location etc.

METADATA can contain:

path

Destination path in the target package. Required if the file is to be auto-added to debian/rules:install.

mode

Target file mode. See "mode" for more information. Defaults to auto.

owner

User ID for the target file. Defaults to root.

group

Group for the target file. Defaults to root.

_init

Check that the given file exists and load any additional meta-data. Private method.

source

Return the absolute file which is the source of the file to be copied.

target( [FILE] )

Set or return the path which the file should be installed to on the target system.

If not explicitly called, this will be auto-determined from the information given at construction.

If undef if returned, this file should not be auto-installed, just copied to mud-extras.

mode

Return the mode for the target file. This should be in the format 0644, suitable for passing to install(1).

The default is auto, which means 0644 unless the file starts with the bytes #! - in which case 0755 is used.

owner

Return the user ID for the target file.

group

Return the group ID for the target file.

COPYRIGHT

(c) Andrew Flegg 2007 - 2009. Released under the Artistic Licence: http://www.opensource.org/licenses/artistic-license-2.0.php

SEE ALSO

"extraFiles" in MUD::Package http://mud-builder.garage.maemo.org/

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 187:

You forgot a '=back' before '=head1'

<<