.\" -*- 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 "dpt-checkout 1"
.TH dpt-checkout 1 2024-03-04 "pkg-perl-tools 0.78" "Debian Perl packaging Tools"
.\" 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
dpt\-checkout \- work on a pkg\-perl package
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdpt checkout\fR \fIpackage-name\fR [\fIpackage-name\fR ...]
.PP
\&\fBdpt co\fR \fIpackage-name\fR [\fIpackage-name\fR ...]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdpt checkout\fR checks out a working copy for the packaging of a given package.
.PP
If you use \fBdpt\-shell\-lib\fR\|(1), \fBdpt checkout\fR even puts you in the
directory of working copy if you checked out only one source package.
.PP
If the package directory exists, the clone is updated by calling
\&\fBgbp\-pull\fR\|(1). If it doesn't exist, it is cloned off pkg-perl git
repositories via \fBgbp\-clone\fR\|(1).
.PP
If there is an upstream repository information in \fIdebian/upstream/metadata\fR,
\&\fBdpt\-upstream\-repo\fR\|(1) is invoked to add it as a Git remote.
.PP
\&\fBdpt co\fR is an alias for \fBdpt checkout\fR.
.SH CONFIGURATION
.IX Header "CONFIGURATION"
\&\fBdpt checkout\fR uses the \f(CW\*(C`DPT_PACKAGES\*(C'\fR environment variable. If
\&\f(CW\*(C`DPT_PACKAGES\*(C'\fR is not defined, the current working directory is used.
.PP
See \fBdpt\-config\fR\|(5) for details.
.SH "COPYRIGHT & LICENSE"
.IX Header "COPYRIGHT & LICENSE"
.IP "Copyright 2013\-2019 gregor herrmann gregoa@debian.org" 4
.IX Item "Copyright 2013-2019 gregor herrmann gregoa@debian.org"
.PD 0
.IP "Copyright 2013, 2014 Damyan Ivanov dmn@debian.org" 4
.IX Item "Copyright 2013, 2014 Damyan Ivanov dmn@debian.org"
.IP "Copyright 2013 Axel Beckert abe@debian.org" 4
.IX Item "Copyright 2013 Axel Beckert abe@debian.org"
.PD
.PP
This program is free software, licensed under the same term as perl.