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