Print this page
6205 onbld manuals should be declared as 1onbld
Reviewed by: Dan McDonald <danmcd@omniti.com>
Reviewed by: Josef Sipek <jeffpc@josefsipek.net>
*** 17,27 ****
.\"
.\" CDDL HEADER END
.\"
.\" Copyright 2009 Sun Microsystems, Inc. All rights reserved.
.\" Use is subject to license terms.
! .TH findunref 1 "Oct 30, 2012"
.I findunref
\- find unused files in a source tree
.SH SYNOPSIS
findunref [\fB-s\fP \fIsubtree\fP] [\fB-t\fP \fItstampfile\fP]
[\fB-S\fP \fBhg\fP|\fBtw\fP|\fBgit\fP] \fIsrcroot\fP \fIexceptfile\fP
--- 17,27 ----
.\"
.\" CDDL HEADER END
.\"
.\" Copyright 2009 Sun Microsystems, Inc. All rights reserved.
.\" Use is subject to license terms.
! .TH findunref 1ONBLD "Oct 30, 2012"
.I findunref
\- find unused files in a source tree
.SH SYNOPSIS
findunref [\fB-s\fP \fIsubtree\fP] [\fB-t\fP \fItstampfile\fP]
[\fB-S\fP \fBhg\fP|\fBtw\fP|\fBgit\fP] \fIsrcroot\fP \fIexceptfile\fP
*** 30,41 ****
.IX "OS-Net build tools" "findunref" "" "\fBfindunref\fP"
.LP
The findunref utility lists the files in a source tree which have not been
accessed more recently than a particular timestamp file. Although
findunref may be used on its own, it is usually invoked by
! \fBnightly\fP(1) to find files that are never referenced during a given
! build (see \fB-f\fP in \fBnightly\fP(1)).
.LP
The root of the source tree to examine is specified by \fIsrcroot\fP. To
simplify comparing findunref output from different source trees, findunref
outputs all filenames relative to \fIsrcroot\fP.
.LP
--- 30,41 ----
.IX "OS-Net build tools" "findunref" "" "\fBfindunref\fP"
.LP
The findunref utility lists the files in a source tree which have not been
accessed more recently than a particular timestamp file. Although
findunref may be used on its own, it is usually invoked by
! \fBnightly\fP(1ONBLD) to find files that are never referenced during a given
! build (see \fB-f\fP in \fBnightly\fP(1ONBLD)).
.LP
The root of the source tree to examine is specified by \fIsrcroot\fP. To
simplify comparing findunref output from different source trees, findunref
outputs all filenames relative to \fIsrcroot\fP.
.LP
*** 69,87 ****
Consider files older than \fItstampfile\fP to be unreferenced.
By default, \fIsrcroot\fB/.build.tstamp\fR is used.
.TP 10
.B -S \fBhg\fP|\fBtw\fP|\fBgit\fP
Only check files that are managed by the specified SCM. To simplify
! interaction with \fBwhich_scm\fP(1), the SCM names "mercurial" and
"teamware" may also be specified for "hg" and "tw", respectively.
By default, all files are checked.
.SH SEE ALSO
.LP
\fBgit\fP(1),
\fBhg\fP(1),
! \fBnightly\fP(1),
! \fBwhich_scm\fP(1)
.SH NOTES
Since many files are only used when building for a particular ISA (e.g.,
Makefiles that are specific to x86 or SPARC), builds must be done on all
applicable ISAs and the results merged. For instance, if nightly builds
(with \fB-f\fP) are done on both SPARC and x86, \fBusr/src\fP will be
--- 69,87 ----
Consider files older than \fItstampfile\fP to be unreferenced.
By default, \fIsrcroot\fB/.build.tstamp\fR is used.
.TP 10
.B -S \fBhg\fP|\fBtw\fP|\fBgit\fP
Only check files that are managed by the specified SCM. To simplify
! interaction with \fBwhich_scm\fP(1ONBLD), the SCM names "mercurial" and
"teamware" may also be specified for "hg" and "tw", respectively.
By default, all files are checked.
.SH SEE ALSO
.LP
\fBgit\fP(1),
\fBhg\fP(1),
! \fBnightly\fP(1ONBLD),
! \fBwhich_scm\fP(1ONBLD)
.SH NOTES
Since many files are only used when building for a particular ISA (e.g.,
Makefiles that are specific to x86 or SPARC), builds must be done on all
applicable ISAs and the results merged. For instance, if nightly builds
(with \fB-f\fP) are done on both SPARC and x86, \fBusr/src\fP will be