.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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_USRLOCAL 1"
.TH DH_USRLOCAL 1 2024-03-27 13.15.3 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 名前
.IX Header "名前"
dh_usrlocal \- usr/local ディレクトリをメンテナスクリプトへ移行する
.SH 書式
.IX Header "書式"
\&\fBdh_usrlocal\fR [\fIdebhelper\ オプション\fR] [\fB\-n\fR]
.SH 説明
.IX Header "説明"
\&\fBdh_usrlocal\fR コマンドはインストールの際に \fI/usr/local\fR 以下にサブディレクトリを作成するパッケージをビルドする時に使える debhelper プログラムです。
.PP
このコマンドは、パッケージビルドディレクトリにある \fIusr/local\fR 以下のサブディレクトリを走査・削除し、Debian policy の内容に沿った形でインストール時に作成されたディレクトリを作成、及びパッケージ削除時に削除を実施するため、(\fB\-n\fR が使われてない限り) メンテナスクリプトのスニペットで置換します。これらのスニペットは \fBdh_installdeb\fR により、メンテナスクリプトへ挿入されます。debhelper のメンテナスクリプトのスニペットに関する説明については、\fBdh_installdeb\fR\|(1) を参照して下さい。
.PP
When the \fIDEB_RULES_REQUIRES_ROOT\fR environment variable is not (effectively)  \fIbinary-targets\fR, the directories in \fI/usr/local\fR will be handled as if they were owned by root:root (see below).
.PP
When the \fIDEB_RULES_REQUIRES_ROOT\fR environment variable has an effective value of \fIbinary-targets\fR, the owners, groups and permissions will be preserved with the sole exception where the directory is owned by root:root.
.PP
If a directory is owned by root:root, then ownership will be determined at install time.  The ownership and permission bits will either be root:root mode 0755 or root:staff mode 02775.  The actual choice depends on whether the system has \fI/etc/staff\-group\-for\-usr\-local\fR (as documented in the Debian Policy Manual §9.1.2 since version 4.1.4)
.SH オプション
.IX Header "オプション"
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
\&\fIpostinst\fR/\fIprerm\fR を変更しません。
.SH 付記
.IX Header "付記"
このコマンドは複数回実行しても安全なコマンドではありません。このコマンドを複数回呼び出す際には必ず間に \fBdh_prep\fR\|(1) を挿入してください。さもないと、メンテナスクリプト中に同じ内容のコードを繰り返し挿入してしまいます。
.SH 確認すべき事
.IX Header "確認すべき事"
Debian ポリシー バージョン 2.2
.SH 参照
.IX Header "参照"
\&\fBdebhelper\fR\|(7)
.PP
このプログラムは debhelper の一部です。
.SH 作者
.IX Header "作者"
Andrew Stribblehill <ads@debian.org>