xref: /illumos-gate/usr/src/tools/findunref/README.exception_lists (revision cdf0c1d55d9b3b6beaf994835440dfb01aef5cf0)
1*cdf0c1d5Smjnelson#
2*cdf0c1d5Smjnelson# CDDL HEADER START
3*cdf0c1d5Smjnelson#
4*cdf0c1d5Smjnelson# The contents of this file are subject to the terms of the
5*cdf0c1d5Smjnelson# Common Development and Distribution License (the "License").
6*cdf0c1d5Smjnelson# You may not use this file except in compliance with the License.
7*cdf0c1d5Smjnelson#
8*cdf0c1d5Smjnelson# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*cdf0c1d5Smjnelson# or http://www.opensolaris.org/os/licensing.
10*cdf0c1d5Smjnelson# See the License for the specific language governing permissions
11*cdf0c1d5Smjnelson# and limitations under the License.
12*cdf0c1d5Smjnelson#
13*cdf0c1d5Smjnelson# When distributing Covered Code, include this CDDL HEADER in each
14*cdf0c1d5Smjnelson# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*cdf0c1d5Smjnelson# If applicable, add the following below this CDDL HEADER, with the
16*cdf0c1d5Smjnelson# fields enclosed by brackets "[]" replaced with your own identifying
17*cdf0c1d5Smjnelson# information: Portions Copyright [yyyy] [name of copyright owner]
18*cdf0c1d5Smjnelson#
19*cdf0c1d5Smjnelson# CDDL HEADER END
20*cdf0c1d5Smjnelson#
21*cdf0c1d5Smjnelson
22*cdf0c1d5Smjnelson#
23*cdf0c1d5Smjnelson# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
24*cdf0c1d5Smjnelson# Use is subject to license terms.
25*cdf0c1d5Smjnelson#
26*cdf0c1d5Smjnelson# ident	"%Z%%M%	%I%	%E% SMI"
27*cdf0c1d5Smjnelson#
28*cdf0c1d5Smjnelson
29*cdf0c1d5SmjnelsonException lists for the findunref tool
30*cdf0c1d5Smjnelson
31*cdf0c1d5SmjnelsonFiles in these lists are by definition intentionally never used during a
32*cdf0c1d5Smjnelsonstandard nightly build.
33*cdf0c1d5Smjnelson
34*cdf0c1d5SmjnelsonMost files in this category should be matched by the existing filename globs, so
35*cdf0c1d5Smjnelsonif you find yourself adding exceptions, please check with your advocate and/or
36*cdf0c1d5Smjnelsonthe gatekeepers to be sure you're doing the right thing.
37*cdf0c1d5Smjnelson
38*cdf0c1d5SmjnelsonThe actual exception_list file used during a nightly build is generated during
39*cdf0c1d5Smjnelsonthe build (see usr/src/tools/findunref/Makefile for details), based on various
40*cdf0c1d5Smjnelsoninput files as follows:
41*cdf0c1d5Smjnelson
42*cdf0c1d5Smjnelson	Filename globs, applicable regardless of location in the source tree,
43*cdf0c1d5Smjnelson	and regardless of SCM:
44*cdf0c1d5Smjnelson
45*cdf0c1d5Smjnelson		exception_list.common
46*cdf0c1d5Smjnelson
47*cdf0c1d5Smjnelson	Filename globs and specific files to ignore, based on the SCM in use:
48*cdf0c1d5Smjnelson
49*cdf0c1d5Smjnelson		exception_list.teamware
50*cdf0c1d5Smjnelson		exception_list.mercurial
51*cdf0c1d5Smjnelson
52*cdf0c1d5Smjnelson	Specific files to ignore, divided by location in the source tree:
53*cdf0c1d5Smjnelson
54*cdf0c1d5Smjnelson		exception_list.open
55*cdf0c1d5Smjnelson		exception_list.closed
56