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