Provided by: dpkg-dev_1.17.5ubuntu5.8_all 
名前
dpkg-source - Debian ソースパッケージ (.dsc) 操作ツール
書式
dpkg-source [option...] command
説明
dpkg-source は、Debian ソースアーカイブの作成、展開を行う。
これらの command では複数のオプションを 1 つに結合することはできず、オプションの値をオプション名から分離
した引数として指定することもできない。
コマンド
-x filename.dsc [output-directory]
ソースパッケージを展開する。Debian ソースコントロールファイル (.dsc) 名として、オプション形式では
ない引数を 1 つ指定する必要がある。それに続きオプション形式ではない引数を指定することで、ソース
パッケージの展開先となるディレクトリを指定することができる。このディレクトリは既存であってはならな
い。ディレクトリが指定されなかった場合、ソースパッケージは、現在のワーキングディレクトリ以下の
source-version というディレクトリに展開される。
dpkg-source は制御ファイルからソースパッケージの設定を行うためのファイル名を取得する。これらは
.dsc ファイルと同じディレクトリに配置されているものとみなされる。
展開されたパッケージのファイルには、ファイルやディレクトリを単に作成したときに設定されるであろうも
のと同様のパーミッションや所有者が設定される。ディレクトリ及び実行ファイルのパーミッションは 0777
に、普通のファイルは 0666 に設定されるが、展開したユーザの umask の影響を受ける。親ディレクトリが
setgid されていた場合、展開されたディレクトリもそれに従い、ファイルやディレクトリには、グループの
所有者情報が引き継がれる。
ソースパッケージが標準以外の形式 (現在のところ "1.0" 以外のすべての形式を意味する) を使用している
場合、形式の名称は debian/source/format に格納され、以降のソースパッケージのビルドでは、デフォルト
で同じ形式が使用される。
-b directory [format-specific-parameters]
ソースパッケージをビルドする。先頭のオプション形式ではない引数は Debian 化されたソースツリー
(debian サブディレクトリとオリジナルのファイルに対する変更物) の格納されたディレクトリ名にな
る。パッケージのビルドに使用されるソースパッケージ形式によって、この他の引数が存在する場合もあるだ
ろう。
dpkg-source は、コマンドライン引数の --format で指定した形式、debian/source/format で指定した形
式、"1.0" の順で形式を確認し、最初に確認できた形式にに基づいてソースパッケージをビルドする。"1.0"
は廃止予定であり、将来的には削除されるため、常に debian/source/format でソースパッケージ形式を指定
するようにすべきである。ソースパッケージ形式についての詳細な解説は、ソースパッケージ形式セクション
を参照のこと。
--print-format directory
dpkg-source -b directory が 呼び出された際に、ソースパッケージのビルドに用いられるソース形式を表示
する。
--before-build directory
ソースパッケージ形式に合致するフックを実行する。このフックはパッケージのビルド開始前に呼び出される
(dpkg-buildpackage は、debian/rules clean 実行前の非常に早い段階でこれを呼び出す)。このコマンドは
冪等であり、複数回呼び出されてもよい。すべてのソース形式がこのフックを実装しているわけではない。実
装される場合は、通常、Debian のパッチが適用されていることを確認するといったビルド前のソースツリー
の準備に用いられる。
--after-build directory
ソースパッケージ形式に合致するフックを実行する。このフックはパッケージのビルド完了後に呼び出される
(dpkg-buildpackage は、これを最後に呼び出す) このコマンドは冪等であり、複数回呼び出されてもよ
い。すべてのソース形式がこのフックを実装しているわけではない。実装される場合は、通
常、--before-build が行った変更を元に戻すために用いられる。
--commit [directory] ...
directory に展開されたソースツリーの変更を記録する。このコマンドはソース形式に応じて追加の引数を取
ることができる。この操作が意味を持たない形式については、エラーとなる。
-?, --help
利用方法を表示して終了する。
--version
バージョン情報を表示して終了する。
オプション
Generic build options
-ccontrol-file
情報の読み取り元となるメインのソース制御ファイルを指定する。デフォルトは debian/control である。相
対パス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。
-lchangelog-file
情報の読み取り元となる changelog ファイルを指定する。デフォルトは debian/changelog である。相対パ
ス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。
-Fchangelog-format
changelog ファイルのフォーマットを指定する。指定可能なフォーマットについての情報
は、dpkg-parsechangelog(1) を参照のこと。
--format=value
ソースパッケージのビルドに指定した形式を使用する。これは debian/source/format で指定された形式に優
先する。
-Vname=value
変数を設定する。出力時の置換に関する詳細は、deb-substvars(5) を参照のこと。
-Tsubstvars-file
substvars-file にある変数を読み込む。デフォルトではいかなるファイルも読み込まれない。このオプショ
ンは複数のファイルから変数を読み取るために複数回指定することができる。
-Dfield=value
出力制御ファイルのフィールドを上書きもしくは追加する。
-Ufield
出力制御ファイルのフィールドを削除する。
-Zcompression, --compression=compression
Specify the compression to use for created files (tarballs and diffs). Note that this option will
not cause existing tarballs to be recompressed, it only affects new files. Supported values are:
gzip, bzip2, lzma and xz. gzip is the default. xz is only supported since dpkg 1.15.5.
-zlevel, --compression-level=level
使用する圧縮レベル。-Z と併せて指定する。これは新規の圧縮時にのみ適用される。指定可能な値は次のと
おり: 1 から 9, best, fast。デフォルトは gzip および bzip2 の場合 9、xz および lzma の場合 6 であ
る。
-i[regex], --diff-ignore[=regex]
You may specify a perl regular expression to match files you want filtered out of the list of
files for the diff. (This list is generated by a find command.) (If the source package is being
built as a version 3 source package using a VCS, this can be used to ignore uncommited changes on
specific files. Using -i.* will ignore all of them.)
The -i option by itself enables this setting with a default regex (preserving any modification to
the default regex done by a previous use of --extend-diff-ignore) that will filter out control
files and directories of the most common revision control systems, backup and swap files and
Libtool build output directories. There can only be one active regex, of multiple -i options only
the last one will take effect.
This is very helpful in cutting out extraneous files that get included in the diff, e.g. if you
maintain your source in a revision control system and want to use a checkout to build a source
package without including the additional files and directories that it will usually contain (e.g.
CVS/, .cvsignore, .svn/). The default regex is already very exhaustive, but if you need to replace
it, please note that by default it can match any part of a path, so if you want to match the begin
of a filename or only full filenames, you will need to provide the necessary anchors (e.g.
'(^|/)', '($|/)') yourself.
--extend-diff-ignore=regex
The perl regular expression specified will extend the default value used by --diff-ignore and its
current value (if set). It does this by concatenating "|regex" to the existing value. This option
is convenient to use in debian/source/options to exclude some auto-generated files from the
automatic patch generation.
-I[file-pattern], --tar-ignore[=file-pattern]
If this option is specified, the pattern will be passed to tar(1)'s --exclude option when it is
called to generate a .orig.tar or .tar file. For example, -ICVS will make tar skip over CVS
directories when generating a .tar.gz file. The option may be repeated multiple times to list
multiple patterns to exclude.
-I by itself adds default --exclude options that will filter out control files and directories of
the most common revision control systems, backup and swap files and Libtool build output
directories.
Note: While they have similar purposes, -i and -I have very different syntax and semantics. -i can only
be specified once and takes a perl compatible regular expression which is matched against the full
relative path of each file. -I can specified multiple times and takes a filename pattern with shell
wildcards. The pattern is applied to the full relative path but also to each part of the path
individually. The exact semantic of tar's --exclude option is somewhat complicated, see
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.
The default regex and patterns for both options can be seen in the output of the --help command.
Generic extract options
--no-copy
展開されたソースパッケージ以外に、オリジナルの tar アーカイブをコピーしない。
--no-check
展開前に、署名やチェックサムの検証を行わない。
--require-valid-signature
展開するユーザの trustedkeys.gpg keyring、ベンダ固有の keyring のいずれか、official Debian keyring
(/usr/share/keyrings/debian-keyring.gpg もしくは/usr/share/keyrings/debian-maintainers.gpg) のいず
れかによって検証可能な OpenPGP の署名が含まれない場合に、ソースパッケージの展開を拒否する。
ソースパッケージ形式
使用しているソース形式が分からない場合は、"3.0 (quilt)" もしくは "3.0 (native)" のいずれかであろ
う。Debian においてこれらの形式を使用するための情報については、https://wiki.debian.org/Projects/DebSrc3.0
を参照のこと。
1.0 形式
この形式のソースパッケージには、.diff.gz と対応する .orig.tar.gz、もしくは.tar.gz のみ (この形態を ネイ
ティブ と称する) が含まれる。
展開
ネイティブパッケージの展開は、単一の tar アーカイブをターゲットディレクトリに単に展開するだけである。非ネ
イティブなパッケージの展開は、先に .orig.tar.gz を展開した上で、.diff.gz ファイルに含まれるパッチを適用す
る。パッチされたファイルのタイムスタンプは、ソースパッケージを展開した時刻に再設定される (これにより、自
動生成されたファイルにパッチする際に、タイムスタンプが逆転してしまうことによる問題の発生を回避する)。diff
により新しいファイルを作成することもできる (debian ディレクトリ自体も、これにより作成される) が、ファイル
を削除することはできない (空ファイルはそのまま残される)。
ビルド
ネイティブパッケージのビルドは、ソースディレクトリに単一の tar アーカイブを作成するだけである。非ネイティ
ブパッケージのビルドは、オリジナルの tar アーカイブを ".orig" ディレクトリに展開し、 directory にあるソー
スパッケージと .orig ディレクトリを比較して .diff.gz ファイルを再生成することにより行われる。
ビルドオプション (-b と併用):
2 番目のオプションでない引数が存在する場合は、オリジナルのソースディレクトリか tar ファイル名を意味す
る。ただし、パッケージが Debian 固有のものであり、Debian 化するための diff が存在しない場合は空文字列とな
る。2 番目の引数が存在する場合、dpkg-source は -sX 引数に応じて、オリジナルのソース tar ファイル
package_upstream-version.orig.tar.gz もしくはオリジナルのソースディレクトリ directory.orig を検索する。
-sa, -sp, -sk, -su, -sr は、既存の tar ファイルやディレクトリを上書きしない。上書きさせたい場合は、代わり
に -sA, -sP, -sK, -sU, -sR を使用すること。
-sk オリジナルのソースが、デフォルトでは package_upstream-version.orig.tar.extension という名前の tar
ファイルであることを指示する。このオリジナルのソースは適切な場所にtar ファイルのまま残され、カレン
トディレクトリに存在していない場合はそこにコピーされる。tar ファイルは diff を生成するため
に、directory.orig に展開される。
-sp -sk と同様だが、最後にディレクトリを削除する。
-su オリジナルのソースが、デフォルトでは package-upstream-version.orig という名前のディレクトリにある
ことを指示する。dpkg-source は、ここから新しいソースアーカイブを作成する。
-sr -su と同様だが、使用後にディレクトリを削除する。
-ss Specifies that the original source is available both as a directory and as a tarfile. dpkg-source
will use the directory to create the diff, but the tarfile to create the .dsc. This option must
be used with care - if the directory and tarfile do not match a bad source archive will be
generated.
-sn オリジナルのソースを参照せず、diff も生成しないことを指示する。2 番目の引数が存在する場合、それは
空文字列である必要がある。これは、アップストリームのソースが存在せず、Debian 化するための差分が存
在しない Debian 固有のパッケージに用いられる。
-sa もしくは -sA
オリジナルのソースアーカイブが tar ファイルもしくはディレクトリであることを指示する。2 番目の引数
が指定されている場合、それは上記のいずれであってもよいし、空文字列でもよい (その場合は、-sn (訳注:
-sp の誤りと思われる) と同等である)。tar ファイルが存在した場合は、diff 生成のために展開され、最後
に削除される (これは -sp と同等である)。ディレクトリが存在した場合は、オリジナルのソースを作成する
ためにアーカイブ化され最後に削除される (これは、-sr と同等である)。いずれも存在しなかった場
合、パッケージは Debian 化の diff を持たず、ソースアーカイブのみが存在すると見なされる (これは、
-sn と同等である)。いずれも存在した場合、dpkg-source はディレクトリの存在を無視して、-sA が指定さ
れていた場合はこれを上書きし (これは -sP と同等である)、-sa が指定されていた場合はエラーを発生させ
る。デフォルトは -sA である。
--abort-on-upstream-changes
生成された diff に Debian サブディレクトリ外にあるファイルへの変更が含まれていた場合、処理を失敗さ
せる。このオプションは debian/source/options で指定できない。debian/source/local-options で指定す
ることは可能である。
展開オプション (-x と併用):
いずれの場合も、既存のオリジナルのソースツリーはすべて削除される。
-sp オリジナルのソースを tar ファイルとして残す (存在する場合)。カレントディレクトリに配置されていない
場合や、存在しているが異なるファイルである場合は、オリジナルのソースがコピーされる (これはデフォル
トの挙動である)。
-su オリジナルのソースツリーを展開する。
-sn オリジナルのソースをカレントディレクトリにコピーさせず、展開もさせない。カレントディレクトリに存在
するオリジナルのソースツリーは削除される。
-sX オプションは相互排他である。複数回指定された場合、最後に指定されたものが使用される。
--skip-debianization
アップストリームのソースのトップに存在する Debian 化の diff を適用しない。
2.0 形式
wig&pen という名称でも知られている。この形式は広範な使用を推奨されておらず、"3.0 (quilt)" が代替してい
る。wig&pen は新世代のソースパッケージ形式の最初の仕様である。
この形式の挙動は、明示的なパッチ一覧を使用しない点を除き、"3.0 (quilt)" 形式と同等である。perl 形式の正規
表現 [\w-]+ にマッチする debian/patches/ に存在するすべてのファイルは、適切なパッチである必要がある。これ
らは展開時に適用される。
新しいソースパッケージをビルドする際にアップストリームのソースに対する変更が発生した場
合、zz_debian-diff-auto という名前のパッチとして保存する。
3.0 (native) 形式
この形式は 1.0 形式で定義されたネイティブパッケージ形式の拡張版である。これはすべての圧縮方式をサポート
し、デフォルトでは、多くの一時ファイル (デフォルト値は --help 出力の -I オプションを参照のこと) やバー
ジョン管理システム固有のファイルやディレクトリを無視する。
3.0 (quilt) 形式
A source package in this format contains at least an original tarball (.orig.tar.ext where ext can be gz,
bz2, lzma and xz) and a debian tarball (.debian.tar.ext). It can also contain additional original
tarballs (.orig-component.tar.ext). component can only contain alphanumeric characters and hyphens
("-").
展開
主たるオリジナルの tar アーカイブが最初に展開され、ついで追加のオリジナル tar アーカイブが、ファイル名の
component からとった名前のサブディレクトリに展開される (既存のディレクトリがあった場合、上書きされ
る)。debian tar アーカイブは、既存の debian ディレクトリの削除後、ソースディレクトリのトップに展開され
る。debian tar アーカイブには、debian サブディレクトリが必要だが、ディレクトリ外にバイナリファイルを含め
ることもできる (--include-binaries) オプションを参照のこと)。
All patches listed in debian/patches/debian.series or debian/patches/series are then applied. If the
former file is used and the latter one doesn't exist (or is a symlink), then the latter is replaced with
a symlink to the former. This is meant to simplify usage of quilt to manage the set of patches. Note
however that while dpkg-source parses correctly series files with explicit options used for patch
application (stored on each line after the patch filename and one or more spaces), it does ignore those
options and always expect patches that can be applied with the -p1 option of patch. It will thus emit a
warning when it encounters such options, and the build is likely to fail.
Contrary to quilt's default behaviour, patches are expected to apply without any fuzz. When that is not
the case, you should refresh such patches with quilt, or dpkg-source will error out while trying to apply
them.
Similarly to quilt's default behaviour, the patches can remove files too.
展開の際にパッチが適用された場合、.pc/applied-patches ファイルが作成される。
ビルド
All original tarballs found in the current directory are extracted in a temporary directory by following
the same logic as for the unpack, the debian directory is copied over in the temporary directory, and all
patches except the automatic patch (debian-changes-version or debian-changes, depending on
--single-debian-patch) are applied. The temporary directory is compared to the source package directory.
When the diff is non-empty, the build fails unless --single-debian-patch or --auto-commit has been used,
in which case the diff is stored in the automatic patch. If the automatic patch is created/deleted, it's
added/removed from the series file and from the quilt metadata.
バイナリファイルに対する変更は diff では表現できないため、メンテナが修正されたバイナリファイルを debian
tar アーカイブに (debian/source/include-binaries に格納することで) 含めておくことを熟考の上決定しない限
り、処理の失敗を引き起こす。debian サブディレクトリ内にバイナリファイルがあった場合
も、debian/source/include-binaries によりホワイトリスト設定されていない限り、ビルドの失敗を引き起こす。
設定を行うことで、debian tar アーカイブを生成する際に、更新された debian ディレクトリと修正されたバイナリ
のリストが使用される。
The automatically generated diff doesn't include changes on VCS specific files as well as many temporary
files (see default value associated to -i option in the --help output). In particular, the .pc directory
used by quilt is ignored during generation of the automatic patch.
dpkg-source --before-build (および -b) は、series ファイルにリストされているすべてのパッチが適用さ
れ、パッケージのビルドが常にすべてのパッチが適用された状態で行われることを担保する。これは、適用されな
かったパッチ (series ファイルにリストされているが、.pc/applied-patches にリストされていないもの) を確認す
ることで行われる。これらのうち、最初のパッチがエラーなく適用可能であれば、残りのすべても適用する。この挙
動を抑止する場合は、--no-preparation オプションを使用すること。
変更の記録
--commit [directory] [patch-name] [patch-file]
Generates a patch corresponding to the local changes that are not managed by the quilt patch
system and integrates it in the patch system under the name patch-name. If the name is missing, it
will be asked interactively. If patch-file is given, it is used as the patch corresponding to the
local changes to integrate. Once integrated, an editor is launched so that you can edit the
meta-information in the patch header.
patch-file の指定は、予め生成されたパッチファイルを用いたビルドに失敗した際に有用であり、そのた
め、指定されたファイルは統合後に削除される。パッチファイルに含まれている変更点は、ツリーに予め適用
されている必要があり、パッチによって修正されるファイルは、その他の記録されていない変更が行われてい
てはならない点にも留意すること。
パッチの生成により、バイナリファイルの変更が必要と認識された場合、それらは自動的に
debian/source/include-binaries に追加されるため、最終的に debian tar アーカイブに追加される
(dpkg-source --include-binaries -b と似た動作となる)。
ビルドオプション
--allow-version-of-quilt-db=version
Allow dpkg-source to build the source package if the version of the quilt metadata is the one
specified, even if dpkg-source doesn't know about it. Effectively this says that the given version
of the quilt metadata is compatible with the version 2 that dpkg-source currently supports. The
version of the quilt metadata is stored in .pc/.version.
--include-removal
削除されたファイルを無視せず、それらを自動生成されたパッチに含める。
--include-timestamp
タイムスタンプを自動生成されたパッチに含める。
--include-binaries
debian tar アーカイブに修正されたバイナリをすべて追加し、併せて debian/source/include-binaries に
も追加する。これらはその後のビルドの際にデフォルトで追加されるため、このオプションは不要である。
--no-preparation
明らかに適用されていないパッチを適用することによるビルドツリーの準備を行わない。
--single-debian-patch
ビルドの際に生成される自動パッチの名前として、debian/patches/debian-changes-version の代わりに
debian/patches/debian-changes を使用する。このオプションは、パッケージがバージョン管理システムで維
持されているために、パッチセットが安定して生成できない場合特に有用であり、アップストリームと現状と
の差分を単一のパッチに格納する。このオプションをdebian/source/local-options に設定した上で、例えば
使用しているバージョン管理システムなどで Debian における変更点を確認するのに最適な方法を説明する
debian/source/local-patch-header ファイルを添付しておく。
--create-empty-orig
主たるオリジナルの tar アーカイブについて、作成できない場合や補助のものが存在する場合であって
も、空のファイルを自動的に生成する。このオプションは、ソースパッケージに複数のアップストリームのソ
フトウェアを単に集めたものであり、"主たる" ソフトウェアが存在しない場合に用いられることを想定して
いる。
--no-unapply-patches, --unapply-patches
By default, dpkg-source will automatically unapply the patches in the --after-build hook if it did
apply them during --before-build. Those options allow you to forcefully disable or enable the
patch unapplication process. Those options are only allowed in debian/source/local-options so that
all generated source packages have the same behavior by default.
--abort-on-upstream-changes
The process fails if an automatic patch has been generated. This option can be used to ensure that
all changes were properly recorded in separate quilt patches prior to the source package build.
This option is not allowed in debian/source/options but can be used in
debian/source/local-options.
--auto-commit
The process doesn't fail if an automatic patch has been generated, instead it's immediately
recorded in the quilt series.
展開オプション
--skip-debianization
アップストリームのソース上に、debian tar アーカイブの上書き展開を行わない。
--skip-patches
展開の最後に、パッチの適用を行わない。
3.0 (custom) 形式
これは特別な形式である。特定のソースパッケージ形式を示すものではなく、任意のファイルを用いてソースパッ
ケージを作成する際に使用する形式である。
ビルドオプション
すべてのオプション形式ではない引数は、生成されたソースパッケージに統合するファイルとみなされる。ファイル
はあらかじめ存在している必要があり、カレントディレクトリに存在していることが望ましい。最低 1 つのファイル
を指定すること。
--target-format=value
Required. Defines the real format of the generated source package. The generated .dsc file will
contain this value in its Format field and not "3.0 (custom)".
3.0 (git) 形式
この形式は実験段階のものである。
この形式のソースパッケージは、パッケージのソースを保持する単一の git bundle である、git リポジトリ .git
から構成される。shallow git clone がリビジョン保持に使用する .gitshallow ファイルも含まれる場合がある。
展開
この git bundle は git リポジトリとしてターゲットディレクトリに複製される。gitshallow ファイルがある場合
は、複製された git リポジトリ内に `.git/shallow` としてインストールされる。
デフォルトで、新しいリポジトリはオリジナルのソースがチェックアウトされたものと同じブランチとなってい
る。(通常は "master" だが、それに限らない。) それ以外のブランチは `remotes/origin` から利用することができ
る。
ビルド
先に進む前に、無視すべきもの以外でコミットされていない変更がないことを担保するためのチェックが行われる。
git リポジトリの bundle を生成する際には git-bundle(1) が使用される。デフォルトで、リポジトリ内のすべての
ブランチとタグが bundle に含められる。
ビルドオプション
--git-ref=ref
Allows specifying a git ref to include in the git bundle. Use disables the default behavior of
including all branches and tags. May be specified multiple times. The ref can be the name of a
branch or tag to include. It may also be any parameter that can be passed to git-rev-list(1). For
example, to include only the master branch, use --git-ref=master. To include all tags and
branches, except for the private branch, use --git-ref=--all --git-ref=^private
--git-depth=number
shallow clone を作成する。作成の際、ヒストリを指定したリビジョン数に切り詰める。
3.0 (bzr) 形式
この形式は実験段階である。これは bzr リポジトリを含む単一の tar アーカイブを生成する。
展開
tar アーカイブを展開した上で、現在のブランチをチェックアウトするために bzr が使用される。
ビルド
先に進む前に、無視すべきもの以外でコミットされていない変更がないことを担保するためのチェックが行われる。
その後、ソースディレクトリ内のバージョン管理システム固有のファイルが一時ディレクトリにコピーされる。一時
ディレクトリが tar アーカイブにされる前に、領域を節約するために、様々なクリーンアップ処理が行われる。
診断メッセージ
no source format specified in debian/source/format
The file debian/source/format should always exist and indicate the desired source format. For backwards
compatibility, format "1.0" is assumed when the file doesn't exist but you should not rely on this: at
some point in the future dpkg-source will be modified to fail when that file doesn't exist.
"1.0" 形式は既に推奨される形式から外れており、新しい形式 ("3.0 (quilt)", "3.0 (native)") のいずれかを使用
すべきであるが、dpkg-source は、これを自動的には行わない。古い形式の使用を継続する場
合、debian/source/format 中で "1.0" を明示すべきである。
the diff modifies the following upstream files
ソース形式として "1.0" を使用する場合、アップストリームのファイルを直接修正することは通常勧められない。こ
れは変更点が隠蔽され、diff.gz ファイル内でドキュメント化されないままとなってしまうためである。変更点につ
いては、 debian ディレクトリ内にパッチとして保存し、ビルド時にこれを適用することが勧められる。複雑化を避
ける意味では、この処理が組み込まれている "3.0 (quilt)" 形式を使用してもよい。
cannot represent change to file
アップストリームのソースに対する変更は、通常パッチファイルに保存されるが、パッチでは、すべての変更を保持
できるわけではない。パッチは平文テキストファイルの内容しか変更できない。これ以外の形式のファイルの内容を
変更しようとすると (例えば普通のファイルをシンボリックリンクやディレクトリに変更するなど) 、このエラー
メッセージが表示される。
newly created empty file file will not be represented in diff
パッチファイルでは空ファイルを作成することができないため、この変更はソースパッケージに保持されない。その
ため警告が表示される。
executable mode perms of file will not be represented in diff
Patch files do not record permissions of files and thus executable permissions are not stored in the
source package. This warning reminds you of that fact.
special mode perms of file will not be represented in diff
パッチファイルにファイルのパーミッション情報は保存されないため、パーミッションの変更はソースパッケージに
保持されない。そのため警告が表示される。
ファイルフォーマット
debian/source/format
このファイルはソースパッケージのビルドの際に使用される形式を記載した 1 行からなる (指定可能な形式は前述の
とおり)。前後に空白を入れてはならない。
debian/source/include-binaries
このファイルには、debian tar アーカイブに含まれるバイナリファイルが (1 行に 1 ファイルずつ) リストされ
る。前後の空白は削除される。"#" で始まる行はコメント行と見なされスキップされる。空行も無視される。
debian/source/options
このファイルには、dpkg-source -b や dpkg-source --print-format が実行される際に自動的に付加されるコマンド
ラインオプションを長いオプション形式でリストしたものが含まれる。このファイルは、--compression や
--compression-level といったオプションを指定するのに適している。
各オプションは別々の行に記載する。空行や "#" から始まる行は無視される。記載の際に、先頭の "--" は省略する
必要がある。また短いオプションは指定できない。"=" の前後に空白を入れることは可能である。また値を囲むため
にクオートを行うこともできる。以下にファイルへの設定例を示す:
# let dpkg-source create a debian.tar.bz2 with maximal compression
compression = "bzip2"
compression-level = 9
# use debian/patches/debian-changes as automatic patch
single-debian-patch
# ignore changes on config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
注記: format オプションをこのファイルで設定することはできない。代わりに debian/source/format を使用するこ
と。
debian/source/local-options
ファイルが生成されたソースパッケージに含まれない点を除き、debian/source/options とまったく同等である。こ
れはメンテナ固有の設定や、ソースパッケージを管理しているバージョン管理システム固有の設定を保持する際に有
用である。
debian/source/local-patch-header and debian/source/patch-header
"2.0" もしくは "3.0 (quilt)" 形式で生成される自動パッチのトップに配置する、フリーフォーマットのテキス
ト。local-patch-header は生成されたソースパッケージに含まれないが、patch-header は含まれる。
debian/patches/series
This file lists all patches that have to be applied (in the given order) on top of the upstream source
package. Leading and trailing spaces are stripped. Lines starting with "#" are comments and are skipped.
Empty lines are ignored. Remaining lines start with a patch filename (relative to the debian/patches/
directory) up to the first space character or the end of line. Optional quilt options can follow up to
the end of line or the first "#" preceded by one or more spaces (which marks the start of a comment up to
the end of line).
バグ
標準の出力フィールドの設定と比較すると、フィールドの上書きが発生する箇所は混乱を引き起こす。
関連項目
dpkg-deb(1), dpkg(1), dselect(1).
翻訳者
高橋 基信 <monyo@monyo.com>. 喜瀬 浩 <kise@fuyuneko.jp>. 関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>. 鍋
谷 栄展 <nabe@debian.or.jp>. 倉澤 望 <nabetaro@debian.or.jp>. 石川 睦 <ishikawa@linux.or.jp>. 鵜飼 文
敏 <ukai@debian.or.jp>. 中野 武雄 <nakano@apm.seikei.ac.jp>.
翻訳校正
Debian JP Documentation ML <debian-doc@debian.or.jp>.
Debian Project 2013-12-05 dpkg-source(1)