scripts/archpath.1

   1 .TH ARCHPATH 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
   2 .SH NAME
   3 archpath \- output arch (tla/Bazaar) archive names, with support for branches
   4 .SH SYNOPSIS
   5 .B archpath
   6 .br
   7 .B archpath
   8 .I branch
   9 .br
  10 .B archpath
  11 .IR branch -- version
  12 .SH DESCRIPTION
  13 .B archpath
  14 is intended to be run in an arch (tla or Bazaar) working copy.
  15 .PP
  16 In its simplest usage,
  17 .B archpath
  18 with no parameters outputs the package name
  19 (archive/category--branch--version) associated with the working copy.
  20 .PP
  21 If a parameter is given, it may either be a branch--version, in which case
  22 .B archpath
  23 will output a corresponding package name in the current archive and
  24 category, or a plain branch name (without \(oq--\(dq), in which case
  25 .B archpath
  26 will output a corresponding package name in the current archive and
  27 category and with the same version as the current working copy.
  28 .PP
  29 This is useful for branching.
  30 For example, if you're using Bazaar and you want to create a branch for a
  31 new feature, you might use a command like this:
  32 .PP
  33 .RS
  34 .nf
  35 .ft CW
  36 baz branch $(archpath) $(archpath new-feature)
  37 .ft R
  38 .fi
  39 .RE
  40 .PP
  41 Or if you want to tag your current code onto a \(oqreleases\(cq branch as
  42 version 1.0, you might use a command like this:
  43 .PP
  44 .RS
  45 .nf
  46 .ft CW
  47 baz branch $(archpath) $(archpath releases--1.0)
  48 .ft R
  49 .fi
  50 .RE
  51 .PP
  52 That's much easier than using \(oqbaz tree-version\(cq to look up the
  53 package name and manually modifying the result.
  54 .SH AUTHOR
  55 .B archpath
  56 was written by
  57 .na
  58 Colin Watson <cjwatson@debian.org>.
  59 .ad
  60 Like
  61 .BR archpath ,
  62 this manual page is released under the GNU General Public License,
  63 version 2 or later.