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

*** 17,34 ****
  .\" fields enclosed by brackets "[]" replaced with your own identifying
  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  .\"
  .\" CDDL HEADER END
  .\"
! .TH interface_check 1ONBLD "25 March 2010"
  .SH NAME
  interface_check \- check shared object interfaces
  .SH SYNOPSIS
  \fBinterface_check [-hIo] [-c vertype_module] [-E errfile] [-e exfile] [-f listfile] [-i intffile] [-w outdir] file | dir, ...\fP
- .LP
  .SH DESCRIPTION
- .IX "OS-Net build tools" "interface_check" "" "\fBinterface_check\fP"
  The
  .I interface_check
  command attempts to check a number of ELF versioning attributes
  for consistency with common build rules and practices.
  In addition, a complete breakdown of the file's version definitions can
--- 17,32 ----
  .\" fields enclosed by brackets "[]" replaced with your own identifying
  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  .\"
  .\" CDDL HEADER END
  .\"
! .TH INTERFACE_CHECK 1ONBLD "Mar 25, 2010"
  .SH NAME
  interface_check \- check shared object interfaces
  .SH SYNOPSIS
  \fBinterface_check [-hIo] [-c vertype_module] [-E errfile] [-e exfile] [-f listfile] [-i intffile] [-w outdir] file | dir, ...\fP
  .SH DESCRIPTION
  The
  .I interface_check
  command attempts to check a number of ELF versioning attributes
  for consistency with common build rules and practices.
  In addition, a complete breakdown of the file's version definitions can
*** 117,127 ****
  auditing a shared objects interfaces from release-to-release.  Any
  addition, deletion or regrouping of versioning information can be
  detected by inspecting this database with
  .I interface_cmp.
  .sp
- .LP
  .SH OPTIONS
  .LP
  The following options are supported:
  .TP 4
  .B \-c vertype_module
--- 115,124 ----
*** 178,188 ****
  Produce one-liner output, with each line of diagnostic output 
  prefixed with the object pathname.
  .TP
  .B -w outdir
  Interpret the paths of all input and output files relative to \fIoutdir\fP.
- .LP
  .SH EXCEPTION FILE FORMAT
  Exceptions to the rules enforced by
  .I interface_check
  are be specified using an exception file. The \fB-e\fP option is used to
  specify an explicit exception file. Otherwise, if used in an activated
--- 175,184 ----
*** 192,202 ****
  $CODEMGR_WS/exception_list/interface_check does not exist,
  .I interface_check
  will use
  .I /opt/onbld/etc/exception_list/interface_check
  as a fallback default exception file.
! .p
  To run
  .I interface_check
  without applying exceptions, specify \fB-e\fP with a value of /dev/null.
  .P
  A '#' character at the beginning of a line, or at any point in
--- 188,198 ----
  $CODEMGR_WS/exception_list/interface_check does not exist,
  .I interface_check
  will use
  .I /opt/onbld/etc/exception_list/interface_check
  as a fallback default exception file.
! .P
  To run
  .I interface_check
  without applying exceptions, specify \fB-e\fP with a value of /dev/null.
  .P
  A '#' character at the beginning of a line, or at any point in
*** 232,277 ****
  The exceptions understood by
  .I interface_check
  are:
  .sp
  .ne 2
- .mk
  .na
  \fBNONSTD_VERNAME\fR
  .ad
  .RS 17n
- .rt
  .sp
  Objects that are allowed to deviate from our standard version names.
  .RE
  
  .sp
  .ne 2
- .mk
  .na
  \fBNOVERDEF\fR
  .ad
  .RS 17n
- .rt
  Objects that are not expected to contain versioning information.
  Note that PLUGIN objects are automatically exempt from this,
  so these directives are generally applied to non-plugin objects
  .RE
  
  .sp
  .ne 2
- .mk
  .na
  \fBPLUGIN\fR
  .ad
  .RS 17n
- .rt
  Sharable objects underneath these parts of the tree are taken to be plugins.
  Plugins are not required to have versioned file names, and are not required
  to be internally versioned.
  .RE
- .LP
  .SH INTERFACE DESCRIPTION FILE FORMAT
  When the \fB-i\fP option is used
  .I interface_check
  produces an \fIInterface Description File\fP that captures a description of
  the interfaces provided by each ELF object processed. 
--- 228,266 ----
*** 288,298 ****
  description of each object starts with an OBJECT directive, and follows the
  form shown below, using /lib/amd64/libadm.so.1 as an example:
  .sp
  .in +4
  .nf
- .CR
  OBJECT  lib/amd64/libadm.so.1
  CLASS   ELFCLASS64
  TYPE    ET_DYN
  ALIAS   lib/64/libadm.so
  ALIAS   lib/64/libadm.so.1
--- 277,286 ----
*** 328,338 ****
  defined in the version, and INHERIT for those that are inherited. Using
  \fB-I\fP for the above example produces the following output:
  .sp
  .in +4
  .nf
- .CR
  OBJECT  lib/amd64/libadm.so.1
  CLASS   ELFCLASS64
  TYPE    ET_DYN
  ALIAS   lib/64/libadm.so
  ALIAS   lib/64/libadm.so.1
--- 316,325 ----
*** 360,370 ****
  .sp
  The \fB-I\fP option is primary used for debugging
  .I interface_check
  and
  .I interface_cmp.
- .LP
  .SH EXAMPLES
  The following example uses
  .I interface_check
  to generate an interface database for a workspace:
  .PP
--- 347,356 ----
*** 387,393 ****
  .BR interface_cmp(1ONBLD),
  .BR ld(1),
  .BR ldd(1),
  .BR elfdump(1),
  .BR pvs(1).
! .LP
! .TZ LLM
--- 373,379 ----
  .BR interface_cmp(1ONBLD),
  .BR ld(1),
  .BR ldd(1),
  .BR elfdump(1),
  .BR pvs(1).
! 
!