# dh_installchangelogs

## NAME



           dh_installchangelogs - install changelogs into package build
           directories
    


## SYNOPSIS



           **dh_installchangelogs**[_debhelper options_] [**-k**] [**-X** _item_] [**--no-trim**]
           [_upstream_]
    


## DESCRIPTION



           **dh_installchangelogs** is a debhelper program that is responsible
           for installing changelogs into package build directories.
    
           An upstream _changelog_ file may be specified as an option. If none
           is specified, **dh_installchangelogs** may look for files with names
           that seem likely to be changelogs as described in the next
           paragraphs.
    
           In non-native packages, **dh_installchangelogs** will first look for
           changelog files installed by the upstream build system into
           _usr/share/doc/package_ (of the package build directory) and rename
           the most likely candidate (if any) to
           _usr/share/doc/package/changelog_.  Note that **dh_installchangelogs**
           does _not_ look into any source directory (such as _debian/tmp_).
           Otherwise, **dh_installchangelogs**(at compatibility level 7 or any
           later) will look for changelog files in the source directory (e.g.
           the root or the _docs_ subdirectory).  It will look for _changelog_ ,
           _changes_ and _history_ optionally with common extensions (such as
           _.txt_ , _.md_ , _.rst_ , _.org_ , etc.)
    
           If a changelog file is specified and is an _html_ file (determined
           by file extension), it will be installed as
           _usr/share/doc/package/changelog.html_ instead. If the html
           changelog is converted to plain text, that variant can be
           specified as a second parameter. When no plain text variant is
           specified, a short _usr/share/doc/package/changelog_ is generated,
           pointing readers at the html changelog file.
    
           The **debchange** -style Debian changelogs are trimmed to include only
           entries more recent than the release date of _oldstable_.  No
           trimming will be performed if the **--no-trim** option is passed or if
           the **DEB_BUILD_OPTIONS** environment variable contains **notrimdch**.
    


## FILES



           _debian/changelog_
           _debian/NEWS_
           debian/_package_.changelog
           debian/_package_.NEWS
               Automatically installed into usr/share/doc/_package_ / in the
               package build directory.
    
               Use the package specific name if _package_ needs a different
               _NEWS_ or _changelog_ file.
    
               The _changelog_ file is installed with a name of changelog for
               native packages, and _changelog.Debian_ for non-native packages.
               The _NEWS_ file is always installed with a name of _NEWS.Debian_.
    


## OPTIONS



           **-k** , **--keep**
               Keep the original name of the upstream changelog. This will be
               accomplished by installing the upstream changelog as
               _changelog_ , and making a symlink from that to the original name
               of the _changelog_ file. This can be useful if the upstream
               changelog has an unusual name, or if other documentation in
               the package refers to the _changelog_ file.
    
           **-X** _item_ , **--exclude=**_item_
               Exclude upstream _changelog_ files that contain _item_ anywhere in
               their filename from being installed.
    
               Note that directory name of the changelog is also part of the
               match.
    
           **--no-trim**
               Install the full changelog, not its trimmed version that
               includes only recent entries.
    
           _upstream_
               Install this file as the upstream changelog.
    


* * *