diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:36:25 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:36:25 +0000 |
commit | 6077d258b500b20e1e705f5cda567400240c7804 (patch) | |
tree | a5d41c050bd69f91476994b0d30c0a8f1e7957b5 /scripts/dscextract.1 | |
parent | Initial commit. (diff) | |
download | devscripts-upstream.tar.xz devscripts-upstream.zip |
Adding upstream version 2.21.3+deb11u1.upstream/2.21.3+deb11u1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'scripts/dscextract.1')
-rw-r--r-- | scripts/dscextract.1 | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/scripts/dscextract.1 b/scripts/dscextract.1 new file mode 100644 index 0000000..d455c43 --- /dev/null +++ b/scripts/dscextract.1 @@ -0,0 +1,33 @@ +.TH DSCEXTRACT 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*- +.SH NAME +dscextract \- extract a single file from a Debian source package +.SH SYNOPSIS +\fBdscextract\fR [\fIoptions\fR] \fIdscfile\fR \fIfile\fR +.SH DESCRIPTION +\fBdscextract\fR reads a single file from a Debian source package. The idea is +to only look into \fI.diff.gz\fR files (source format 1.0) or \fI.debian.tar.gz/bz2\fR +files (source format 3.0) where possible, hence avoiding to unpack large +tarballs. It is most useful for files in the \fIdebian/\fR subdirectory. + +\fIfile\fP is relative to the first level directory contained in the package, +i.e. with the first component stripped. +.SH OPTIONS +.TP +.B \fB\-f +"Fast" mode. For source format 1.0, avoid to fall back scanning the \fI.orig.tar.gz\fR +file if \fIfile\fR was not found in the \fI.diff.gz\fR. (For 3.0 packages, it is +assumed that \fIdebian/*\fR are exactly the contents of \fIdebian.tar.gz/bz2\fR.) +.SH "EXIT STATUS" +.TP +0 +\fIfile\fR was extracted. +.TP +1 +\fIfile\fR was not found in the source package. +.TP +2 +An error occurred, like \fIdscfile\fR was not found. +.SH EXAMPLE +dscextract dds_2.1.1+ddd105-2.dsc debian/watch || test $? = 1 +.SH AUTHOR +\fBdscextract\fR was written by Christoph Berg <myon@debian.org>. |