.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLCATALOGS 1"
.TH DH_INSTALLCATALOGS 1 2025-03-29 13.24.2 Debhelper
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_installcatalogs \- install and register SGML Catalogs
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_installcatalogs\fR [\fIdebhelper\ options\fR] [\fB\-n\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_installcatalogs\fR is a debhelper program that installs and
registers SGML catalogs. It complies with the Debian XML/SGML policy.
.PP
Catalogs will be registered in a supercatalog, in
\&\fI/etc/sgml/package.cat\fR.
.PP
This command automatically adds maintainer script snippets for
registering and unregistering the catalogs and supercatalogs (unless
\&\fB\-n\fR is used). These snippets are inserted into the maintainer
scripts and the \fBtriggers\fR file by \fBdh_installdeb\fR; see
\&\fBdh_installdeb\fR\|(1) for an explanation of Debhelper maintainer script
snippets.
.PP
A dependency on \fBsgml-base\fR will be added to \fB${misc:Depends}\fR, so be
sure your package uses that variable in \fIdebian/control\fR.
.SH FILES
.IX Header "FILES"
.IP debian/\fIpackage\fR.sgmlcatalogs 4
.IX Item "debian/package.sgmlcatalogs"
Lists the catalogs to be installed per package. Each line in that file
should be of the form \f(CW\*(C`\fR\f(CIsource\fR\f(CW \fR\f(CIdest\fR\f(CW\*(C'\fR, where \fIsource\fR indicates where the
catalog resides in the source tree, and \fIdest\fR indicates the destination
location for the catalog under the package build area. \fIdest\fR should
start with \fI/usr/share/sgml/\fR.
.Sp
Supports substitution variables in compat 13 and later as
documented in \fBdebhelper\fR\|(7).
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Do not modify \fIpostinst\fR/\fIpostrm\fR/\fIprerm\fR scripts nor add an
activation trigger.
.SH NOTES
.IX Header "NOTES"
Note that this command is not idempotent. \fBdh_prep\fR\|(1) should be
called between invocations of this command. Otherwise, it may cause
multiple instances of the same text to be added to maintainer scripts.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
\&\fI/usr/share/doc/sgml\-base\-doc/\fR
.SH AUTHOR
.IX Header "AUTHOR"
Adam Di Carlo <aph@debian.org>