# debhelper-obsolete-compat

## NAME



           debhelper-obsolete-compat - List of no longer supported compat
           levels
    


## SYNOPSIS



           This document contains the upgrade guidelines from all compat
           levels which are no longer supported.  Accordingly it is mostly
           for historical purposes and to assist people upgrading from a non-
           supported compat level to a supported level.
    
           For upgrades from supported compat levels, please see
           debhelper(7).
    


## UPGRADE LIST FOR COMPAT LEVELS



           The following is the list of now obsolete compat levels and their
           changes.
    
           v7  This is the lowest supported compatibility level.
    
               Changes from v6 are:
    
               -       **dh_install** , will fall back to looking for files in
                       _debian/tmp_ if it doesn't find them in the current
                       directory (or wherever you tell it look using
                       **--sourcedir**). This allows **dh_install** to interoperate
                       with **dh_auto_install** , which installs to _debian/tmp_ ,
                       without needing any special parameters.
    
               -       **dh_clean** will read _debian/clean_ and delete files
                       listed there.
    
               -       **dh_clean** will delete toplevel _*-stamp_ files.
    
               -       **dh_installchangelogs** will guess at what file is the
                       upstream changelog if none is specified.
    
           v6  Changes from v5 are:
    
               -       Commands that generate maintainer script fragments
                       will order the fragments in reverse order for the
                       _prerm_ and _postrm_ scripts.
    
               -       **dh_installwm** will install a slave manpage link for
                       _x-window-manager.1.gz_ , if it sees the man page in
                       _usr/share/man/man1_ in the package build directory.
    
               -       **dh_builddeb** did not previously delete everything
                       matching **DH_ALWAYS_EXCLUDE** , if it was set to a list of
                       things to exclude, such as **CVS:.svn:.git**. Now it does.
    
               -       **dh_installman** allows overwriting existing man pages in
                       the package build directory. In previous compatibility
                       levels it silently refuses to do this.
    
               This mode is deprecated.
    
           v5  Changes from v4 are:
    
               -       Comments are ignored in debhelper config files.
    
               -       **dh_strip --dbg-package** now specifies the name of a
                       package to put debugging symbols in, not the packages
                       to take the symbols from.
    
               -       **dh_installdocs** skips installing empty files.
    
               -       **dh_install** errors out if wildcards expand to nothing.
    
           v4  Changes from v3 are:
    
               -       **dh_makeshlibs -V** will not include the Debian part of
                       the version number in the generated dependency line in
                       the shlibs file.
    
               -       You are encouraged to put the new **${misc:Depends}** into
                       _debian/control_ to supplement the **${shlibs:Depends}**
                       field.
    
               -       **dh_fixperms** will make all files in _bin/_ directories
                       and in _etc/init.d_ executable.
    
               -       **dh_link** will correct existing links to conform with
                       policy.
    
               This mode is deprecated.
    
           v3  This mode works like v2, with the following additions:
    
               -       Debhelper config files support globbing via ***** and **?** ,
                       when appropriate. To turn this off and use those
                       characters raw, just prefix with a backslash.
    
               -       **dh_makeshlibs** makes the _postinst_ and _postrm_ scripts
                       call **ldconfig**.
    
               -       Every file in _etc/_ is automatically flagged as a
                       conffile by **dh_installdeb**.
    
               This mode is deprecated.
    
           v2  In this mode, debhelper will consistently use debian/_package_
               as the package tree directory for every package that is built.
    
               This mode is deprecated.
    
           v1  This is the original debhelper compatibility level, and so it
               is the default one. In this mode, debhelper will use
               _debian/tmp_ as the package tree directory for the first binary
               package listed in the control file, while using debian/_package_
               for all other packages listed in the _control_ file.
    
               This mode is deprecated.
    


* * *