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/bringovercheck.1onbld
          +++ new/usr/src/tools/scripts/bringovercheck.1onbld

   1    1  .\" CDDL HEADER START
   2    2  .\"
   3    3  .\" The contents of this file are subject to the terms of the
   4    4  .\" Common Development and Distribution License (the "License").
   5    5  .\" You may not use this file except in compliance with the License.
   6    6  .\"
   7    7  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   8    8  .\" or http://www.opensolaris.org/os/licensing.
   9    9  .\" See the License for the specific language governing permissions
  10   10  .\" and limitations under the License.
  11   11  .\"
  12   12  .\" When distributing Covered Code, include this CDDL HEADER in each

  13   13  .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  14   14  .\" If applicable, add the following below this CDDL HEADER, with the
  15   15  .\" fields enclosed by brackets "[]" replaced with your own identifying
  16   16  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  17   17  .\"
  18   18  .\" CDDL HEADER END
  19   19  .\"
  20   20  .\" Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
  21   21  .\" Use is subject to license terms.
  22   22  .\"
  23      -.TH bringovercheck 1ONBLD "7 April 2006"
       23 +.TH BRINGOVERCHECK 1ONBLD "Apr 7, 2006"
  24   24  .SH NAME
  25   25  .I bringovercheck
  26   26  \- Repair misordered workspace timestamps
  27   27  .SH SYNOPSIS
  28   28  .B bringovercheck
  29   29  workspace
  30   30  .SH DESCRIPTION
  31   31  Some versions of
  32   32  .I bringover(1ONBLD)
  33   33  fail to

  34   34  .I msync(2)
  35   35  writeable mappings; this results in indeterminate modification times
  36   36  when the workspace exists on certain filesystems.  When this results
  37   37  in SCCS s. files being newer than their respective checked-out source
  38   38  files, build carnage may result (see
  39   39  .I sccscheck(1ONBLD)
  40   40  for one mitigating step being taken).
  41   41  
  42   42  If a workspace has been damaged by this bug, you can run
  43   43  bringovercheck to detect and correct cases where a source file is
  44   44  older than its corresponding SCCS s. file.
  45   45  
  46   46  If no out-of-date files are found, bringovercheck will produce no
  47   47  output; otherwise, it will produce a human-readable transcript
  48   48  which includes filenames, last modification dates, and the output of
  49   49  the sccs commands it uses to attempt to fix the problem.
  50   50  
  51   51  Note that because the problem may involve deferred filesystem writes,
  52   52  this script may not be fully effective if run immediately after a
  53   53  bringover.
  54   54  
  55   55  

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX