Provided by: pkg-kde-tools_0.14.2ubuntu5_all bug

NAME

       pkgkde-vcs - a helper tool for Debian pkg-kde VCS repositories.

SYNOPSIS

       pkgkde-vcs [-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.

       pkgkde-cvs should be run from the fully checked out packaging repository of the package it
       is  supposed  to  act upon. Firstly, it attempts to detect a VCS in use for the particular
       packaging in the working  directory.  Please  note,  that  the  detection  might  fail  if
       underlying  VCS  utilities  are not installed. If detection is successful, pkgkde-vcs will
       perform tasks as defined for  the  specified  subcommand  (e.g.  tag).  Different  set  of
       subcommands might be defined for each VCS and each of them might accept a different set of
       SUBCOMMAND OPTIONS (see below). All locally unrecognized subcommand options (or  the  ones
       specified  as  EXTERNAL  TOOL OPTIONS after --) will be passed to the external VCS tool(s)
       which pkgkde-vcs executes to do the job.

       pkgkde-vcs accepts a couple of common options which apply to the helper as  whole  or  are
       common  for  all VCSes it supports. They should be passed before subcommand in order to be
       recognized.

       Even if pkgkde-vcs does extensive sanity  checks  before  doing  anything,  an  underlying
       command  it executes might still fail. Then pkgkde-vcs will terminate immediately possibly
       leaving repository in an inconsistent state. It is up to a user to  recover  from  such  a
       failure.

       At the moment, pkgkde-vcs supports only Git VCS.

OPTIONS

   Common options
       -y     By default, execution of each external command that makes changes to the repository
              has to be explicitly confirmed by user.  However,  if  this  option  is  specified,
              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 fully checked out state.
       The following subcommands for Git repositories are supported at the moment:

       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 subcommand will create an annotated Git  tag  under  "debian/"  namespace.  The
              subcommand itself does not accept any additional options. All EXTERNAL TOOL OPTIONS
              (if specified) and will be passed to git tag invocation. It is recommended to  sign
              tags by specifying -s option.

              The tag created by pkgkde-vcs tag will meet the following requirements:

              ·      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.

              For  example,  a  standard pkgkde-cvs tag will execute the following under the hood
              (assuming version is 1:2.3.4-5 and distribution is experimental):

                     $ git tag debian/2.3.4-5 -m "1:2.3.4-5/experimental"

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>