6282 ONBLD man pages not pbchk clean
Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com>
Reviewed by: Josef Sipek <jeffpc@josefsipek.net>

          --- old/usr/src/tools/scripts/checkpaths.1onbld
          +++ new/usr/src/tools/scripts/checkpaths.1onbld

   1    1  .\" Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
   2    2  .\" Use is subject to license terms.
   3    3  .\"
   4    4  .\" CDDL HEADER START
   5    5  .\"
   6    6  .\" The contents of this file are subject to the terms of the
   7    7  .\" Common Development and Distribution License, Version 1.0 only
   8    8  .\" (the "License").  You may not use this file except in compliance
   9    9  .\" with the License.
  10   10  .\"
  11   11  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  12   12  .\" or http://www.opensolaris.org/os/licensing.
  13   13  .\" See the License for the specific language governing permissions

  14   14  .\" and limitations under the License.
  15   15  .\"
  16   16  .\" When distributing Covered Code, include this CDDL HEADER in each
  17   17  .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  18   18  .\" If applicable, add the following below this CDDL HEADER, with the
  19   19  .\" fields enclosed by brackets "[]" replaced with your own identifying
  20   20  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  21   21  .\"
  22   22  .\" CDDL HEADER END
  23   23  .\"
  24      -.TH checkpaths 1ONBLD "25 September 2003"
       24 +.TH CHECKPATHS 1ONBLD "Sep 25, 2003"
  25   25  .SH NAME
  26   26  .I checkpaths
  27   27  \- check file path containing files
  28   28  .SH SYNOPSIS
  29   29  \fBcheckpaths [-b] [root_paths...]\fP
  30      -.LP
  31   30  .SH DESCRIPTION
  32      -.IX "OS-Net build tools" "checkpaths" "" "\fBcheckpaths\fP"
  33   31  .LP
  34   32  .I checkpaths
  35   33  inspects the contents of various files within an OS-Net workspace to
  36   34  ensure that the file paths listed in those files are valid.  This
  37   35  provides an integrity check of the workspace to catch cases where a
  38   36  file was removed or renamed without updating the corresponding
  39   37  \fIinc.flg\fP, \fIcry_files\fP, or \fIexception_list\fP entry.
  40   38  .LP
  41   39  .I checkpaths
  42   40  is typically called from \fBnightly(1ONBLD)\fP.  It may be invoked
  43   41  interactively within a workspace, and requires that at least
  44   42  \fI$CODEMGR_WS\fP is set to a valid workspace.  It is not necessary
  45   43  that a full build has been performed in the workspace to be tested,
  46   44  but if full build(s) are not available under the
  47   45  \fI$CODEMGR_WS/proto/\fP directory, then the corresponding exclusion
  48   46  lists are not verified.
  49      -.LP
  50   47  .SH OPTIONS
  51   48  .LP
  52   49  The following options are supported:
  53   50  .TP 4
  54   51  .B \-b
  55   52  Disable processing of files that list derived (built) objects.  This
  56   53  should be set if the \fI$CODEMGR_WS/proto/\fP directory exists, but
  57   54  the contents are known to be bad.  \fBnightly(1ONBLD)\fP will typically set
  58   55  this flag if the build fails.
  59      -.LP
  60   56  .TP 4
  61   57  .B root_paths...
  62   58  By default, checkpaths validates all of the proto areas for known
  63   59  architectures that exist in the \fI$CODEMGR_WS/proto/\fP directory.
  64   60  To specify other root directories, list them as arguments on the
  65   61  command line.  It is an error if any of the root paths specified does
  66   62  not end with a known architecture.
  67      -.LP
  68   63  .SH ENVIRONMENT VARIABLES
  69   64  .LP
  70   65  .B CODEMGR_WS
  71   66  .RS 4
  72   67  The root of your TeamWare workspace, which is the directory
  73   68  containing \fICodemgr_wsdata\fP.
  74   69  .RE
  75   70  .LP
  76   71  .B SRC
  77   72  .RS 4
  78   73  The location of your ON source tree.  Defaults to
  79   74  \fI$CODEMGR_WS/usr/src/\fP if not specified.
  80   75  .RE
  81      -.LP
  82   76  .SH SEE ALSO
  83   77  .B nightly(1ONBLD).
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX