NAME

       Lintian::Processable::Patched - access to sources with Debian patches applied

SYNOPSIS

           use Lintian::Processable;
           my $processable = Lintian::Processable::Binary->new;

DESCRIPTION

       Lintian::Processable::Patched provides an interface to collected data about patched sources.

INSTANCE METHODS

       patched
           Returns a index object representing a patched source tree.

       index (FILE)
           The  index  of a source package is not very well defined for non-native source packages.  This method
           gives the index of the "unpacked" package (with 3.0 (quilt), this implies patches have been applied).

           If you want the index of what is listed in the upstream orig tarballs, then there is "orig_index".

           For native packages, the two indices are generally the same as they only have one tarball  and  their
           debian packaging is included in that tarball.

           IMPLEMENTATION  DETAIL/CAVEAT:  Lintian  currently (2.5.11) generates this by running "find(1)" after
           unpacking the source package.  This has three consequences.

           First it means that (original) owner/group data is lost; Lintian inserts "root/root" here.   This  is
           usually  not  a  problem  as  owner/group  information  for  source packages do not really follow any
           standards.

           Secondly, permissions are modified by A) umask and B) laboratory set{g,u}id bits (the  laboratory  on
           lintian.d.o  has  setgid).  This is *not* corrected/altered.  Note Lintian (usually) breaks if any of
           the "user" bits are set in the umask, so that part of the permission bit should be reliable.

           Again, this shouldn't be a problem as permissions in  source  packages  are  usually  not  important.
           Though  if  accuracy  is  needed  here,  "orig_index"  may  used instead (assuming it has the file in
           question).

           Third, hardlinking information is lost and no attempt has been made to restore it.

           Needs-Info requirements for using index: unpacked

       sorted_index
           Returns a sorted array of file names listed in the package.  The names will not have a leading  slash
           (or "./") and can be passed to "unpacked ([FILE])" or "index (FILE)" as is.

           The array will not contain the entry for the "root" of the package.

       index_resolved_path(PATH)
           Resolve PATH (relative to the root of the package) and return the entry denoting the resolved path.

           The resolution is done using resolve_path.

AUTHOR

       Originally written by Felix Lechner <felix.lechner@lease-up.com> for Lintian.

SEE ALSO

       lintian(1)

Lintian v2.62.0ubuntu2.5                           2024-10-16                   Lintian::Processable::Patched(3)