table of contents
other versions
- wheezy 0.15.3
- wheezy-backports 0.15.15~bpo70+1
- jessie 0.15.15
- jessie-backports 0.15.21~bpo8+1
- testing 0.15.24
- unstable 0.15.24
PKGKDE-VCS(1) | Debian KDE packaging VCS helper | PKGKDE-VCS(1) |
NAME¶
pkgkde-vcs - a helper tool for Debian pkg-kde VCS repositories.SYNOPSIS¶
pkgkde-vcs [ -vy] subcommand [ SUBCOMMAND OPTIONS ] [ -- EXTERNAL TOOL OPTIONS ] pkgkde-git [ -vy] subcommand [ SUBCOMMAND OPTIONS ] [ -- EXTERNAL TOOL OPTIONS ]DESCRIPTION¶
pkgkde-vcs is a helper tool which aims to simplify a couple of routine tasks associated with packaging management in version control system (VCS) repositories. pkgkde-vcs transparently supports VCSes used by Debian Qt/KDE maintainer groups wrapping various VCS related command sequences into a convenient CLI interface. Please note that this helper enforces the best practises and packaging conventions adopted by Debian Qt/KDE maintainer groups and therefore it should not be considered as a general purpose packaging helper.OPTIONS¶
Common options¶
- -y
- By default, execution of the first external command that makes changes to the repository has to be explicitly confirmed by user. However, if this option is specified, the first command will be run without confirmation.
- -n
- Do not run any external commands that make changes to the repository. Useful with -v to see what commands with what options would be run.
- -v
- Be more verbose (e.g. show external commands as they are executed).
- -- EXTERNAL TOOL OPTIONS
- Pass additional EXTERNAL TOOL OPTIONS to the
external commands pkgkde-vcs executes to accomplish the task. See
documentations of the specific subcommand for more details.
SUPPORTED VERSION CONTROL SYSTEMS AND SUBCOMMANDS¶
Git¶
In order to use pkgkde-vcs with Git, git(1) must be available in PATH. Bare Git repositories are not supported and Git repository should be in the fully checked out state (except clone). The following subcommands for Git repositories are supported at the moment:- clone
- Clone the specified pkg-kde git repository. This subcommand
should be specified by forcing VCS to git, i.e. by running
pkgkde-git command rather than pkgkde-vcs.
$ pkgkde-git clone kde-sc/kde4libs
$ pkgkde-git clone kde-req/akonadi
$ pkgkde-git clone pkg-kde-tools
- tag
- Tag current packaging state (HEAD) as upload to Debian
archive. Repository working tree must be clean before executing this
subcommand. Current package version and target distribution are
automatically determined from debian/changelog. Distribution must
be a valid Debian suite in order to avoid tagging of unfinished (aka
UNRELEASED) revisions.
- •
- The tag will named as "debian/<version>" where <version> is a full debian package version without epoch. All occurrences of the ~ character in <version> will be replaced with the - character because Git does not support ~ character in tag names.
- •
- The tag will be assigned the message with content like <version>/<distribution>" where <version> is a full debian version of the package (without any modifications including epoch) and <distribution> is the distribution this package is uploaded.
$ git tag debian/2.3.4-5 -m
"1:2.3.4-5/experimental"
- update-config
- Do some common configuration on the checked out packaging repository. At the moment, the subcommand performs the following:
- •
- Set up master branch and debian tags for pushing. -f option may be specified to force update of the pushing configuration even if some pushing configuration already exists.
- •
- Set repository user name and email address to the values of the DEBFULLNAME and DEBEMAIL environment variables respectively. -f option may be specified to override the values even if the repository has some specified already.
LICENSE¶
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.AUTHORS¶
Modestas Vainius <modax@debian.org>2012-05-27 | 0.15 |