.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: atversion.3[7.0] Fri Jun 25 17:21:56 1993 andy@cs.tu-berlin.de frozen $
..
.TH atversion 3 "Fri Jun 25 17:21:56 1993" "AtFStk-1.12" "AtFS Toolkit Library"
.SH NAME
atSetVersAlias, atDelVersAlias, atVno, atGen, atRev \- version handling
.SH SYNOPSIS
#include <atfs.h>
.br
#include <atfstk.h>
.sp
.ta 1.2c
int     atSetVersAlias (Af_key *aso; char *aliasName);
.sp
int     atDelVersAlias (Af_key *aso; char *aliasName);
.sp
int     atVno (Af_key *aso);
.sp
void    atGen (int versionNumber)
.sp
void    atRev (int versionNumber)
.sp
.SH DESCRIPTION
\fIatSetVersAlias\fP sets a version number alias (a unique symbolic
name for a version) for \fIaso\fP. The function checks, whether
\fIaliasName\fP is unique within the ASOs history and complains, if
not. It returns TRUE on success and FALSE otherwise. The case that the
version already had the alias name is considered as success.
.LP
\fIatDelVersAlias\fP deletes the given \fIaliasName\fP from the list
of version aliases attached to \fIaso\fP. It returns TRUE on success
and FALSE otherwise. It also returns TRUE, when the alias name did not
exist.
.LP
\fIatVno\fP returns a compact representation of \fIaso\fPs generation
and revision number, packed into a single integer. \fIatGen\fP
extracts the generation number, and \fIatRev\fP the revision number
from a \fIversionNumber\fP in compact representation.
.SH DIAGNOSTICS
On error, the \fIatError\fP variable is set to an appropriate error
code, and \fIatErrMsg\fP holds a diagnostic message.