[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

14. Miscellaneous Scripting Support

14.1 parse-package-name  parse a package name
14.2 valid-package-name  test a package name for validity

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

14.1 parse-package-name

parse a package name

usage: tla parse-package-name [options] name

 
  -h, --help             Display a help message and exit.
  -H                     Display a verbose help message and exit.
  -V, --version          Display a release identifier string
                         and exit.
  -A, --archive          Override `my-default-archive'
  -a, --arch             print the archive name
  --non-arch             print the non-archive part of the name
  -c, --category         print the category name
  -b, --branch           print the branch name
  -p, --package          print the package name
  -v, --vsn              print the version id
  --package-version      print the category--branch--version
  -l, --lvl              print the patch level
  --patch-level          synonym for --lvl

Options -b, -B, -p, -v, and -l cancel each other.

For -b, -v, and -l, just the id string is printed without "--".

For -p, the output is "<basename>--<branch>".


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

14.2 valid-package-name

test a package name for validity

usage: tla valid-package-name [options] name

 
  -h, --help         Display a help message and exit.
  -H                 Display a verbose help message and exit.
  -V, --version      Display a release identifier string
                     and exit.
  -e, --errname      specify program name for errors
  --archive          require and explicit archive
  --no-archive       prohibit and explicit archive
  -c, --category     require a category
  -p, --package      require category, permit branch
  -v, --vsn          require a version number
  -l, --patch-level  require a patch level
  --lvl              synonym for --patch-level
  -t, --tolerant     tolerate more specific names

Exit with status 0 if PACKAGE is a valid package name, status 1 otherwise.

By default, require a basename or basename plus branch label.

Options -v and -l cancel -b and vice versa.

Option -l implies -v.

If an error name is specified (-e or --errname), then invalid names cause an error message on stdout. Otherwise, the exit status is the only output.

By default, validation is strict. For example, -b checks for a valid basename and does not permit a branch label or version number.

With -t, more specific names are permitted. For example, -b will permit a branch name, version number, and patch level.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by wilk on May, 11 2004 using texi2html