usr/src/man/man4/compver.4

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH COMPVER 4 "Oct 4, 1996"
   7 .SH NAME
   8 compver \- compatible versions file
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 \fBcompver\fR is an \fBASCII\fR file used to specify previous versions of the
  13 associated package which are upward compatible. It is created by a package
  14 developer.
  15 .sp
  16 .LP
  17 Each line of the file specifies a previous version of the associated package
  18 with which the current version is backward compatible.
  19 .sp
  20 .LP
  21 Since some packages may require installation of a specific version of another
  22 software package, compatibility information is extremely crucial. Consider, for
  23 example, a package called "A" which requires version "1.0" of application "B"
  24 as a prerequisite for installation. If the customer installing "A" has a newer
  25 version of "B" (version 1.3), the \fBcompver\fR file for "B" must indicate that
  26 "1.3" is compatible with version "1.0" in order for the customer to install
  27 package "A".
  28 .SH EXAMPLES
  29 .LP
  30 \fBExample 1 \fRSample \fBcompver\fR file.
  31 .sp
  32 .LP
  33 A sample \fBcompver\fR file is shown below:
  34
  35 .sp
  36 .in +2
  37 .nf
  38 \fBVersion 1.3
  39 Version 1.0\fR
  40 .fi
  41 .in -2
  42 .sp
  43
  44 .SH SEE ALSO
  45 .sp
  46 .LP
  47 \fBpkginfo\fR(4)
  48 .sp
  49 .LP
  50 \fIApplication Packaging Developer\&'s Guide\fR
  51 .SH NOTES
  52 .sp
  53 .LP
  54 The comparison of the version string disregards white space and tabs. It is
  55 performed on a word-by-word basis. Thus, "Version 1.3" and "Version 1.3" would
  56 be considered the same.
  57 .sp
  58 .LP
  59 The entries in the \fBcompver\fR file must match the values assigned to the
  60 \fBVERSION\fR parameter in the \fBpkginfo\fR(4) files.