head	1.10;
access;
symbols
	RELENG_8_4:1.10.0.2
	RELENG_9_1_0_RELEASE:1.9.2.1.4.2
	RELENG_9_1:1.9.2.1.0.4
	RELENG_9_1_BP:1.9.2.1
	RELENG_8_3_0_RELEASE:1.8.10.1.8.1
	RELENG_8_3:1.8.10.1.0.8
	RELENG_8_3_BP:1.8.10.1
	RELENG_9_0_0_RELEASE:1.9.2.1.2.1
	RELENG_9_0:1.9.2.1.0.2
	RELENG_9_0_BP:1.9.2.1
	RELENG_9:1.9.0.2
	RELENG_9_BP:1.9
	RELENG_7_4_0_RELEASE:1.8.14.1
	RELENG_8_2_0_RELEASE:1.8.10.1.6.1
	RELENG_7_4:1.8.0.14
	RELENG_7_4_BP:1.8
	RELENG_8_2:1.8.10.1.0.6
	RELENG_8_2_BP:1.8.10.1
	RELENG_8_1_0_RELEASE:1.8.10.1.4.1
	RELENG_8_1:1.8.10.1.0.4
	RELENG_8_1_BP:1.8.10.1
	RELENG_7_3_0_RELEASE:1.8.12.1
	RELENG_7_3:1.8.0.12
	RELENG_7_3_BP:1.8
	RELENG_8_0_0_RELEASE:1.8.10.1.2.1
	RELENG_8_0:1.8.10.1.0.2
	RELENG_8_0_BP:1.8.10.1
	RELENG_8:1.8.0.10
	RELENG_8_BP:1.8
	RELENG_7_2_0_RELEASE:1.8.8.1
	RELENG_7_2:1.8.0.8
	RELENG_7_2_BP:1.8
	RELENG_7_1_0_RELEASE:1.8.6.1
	RELENG_6_4_0_RELEASE:1.7.26.1
	RELENG_7_1:1.8.0.6
	RELENG_7_1_BP:1.8
	RELENG_6_4:1.7.0.26
	RELENG_6_4_BP:1.7
	RELENG_7_0_0_RELEASE:1.8
	RELENG_6_3_0_RELEASE:1.7
	RELENG_7_0:1.8.0.4
	RELENG_7_0_BP:1.8
	RELENG_6_3:1.7.0.24
	RELENG_6_3_BP:1.7
	RELENG_7:1.8.0.2
	RELENG_7_BP:1.8
	RELENG_6_2_0_RELEASE:1.7
	RELENG_6_2:1.7.0.22
	RELENG_6_2_BP:1.7
	RELENG_5_5_0_RELEASE:1.7
	RELENG_5_5:1.7.0.20
	RELENG_5_5_BP:1.7
	RELENG_6_1_0_RELEASE:1.7
	RELENG_6_1:1.7.0.18
	RELENG_6_1_BP:1.7
	RELENG_6_0_0_RELEASE:1.7
	RELENG_6_0:1.7.0.16
	RELENG_6_0_BP:1.7
	RELENG_6:1.7.0.14
	RELENG_6_BP:1.7
	RELENG_5_4_0_RELEASE:1.7
	RELENG_5_4:1.7.0.12
	RELENG_5_4_BP:1.7
	RELENG_4_11_0_RELEASE:1.4.2.2
	RELENG_4_11:1.4.2.2.0.10
	RELENG_4_11_BP:1.4.2.2
	RELENG_5_3_0_RELEASE:1.7
	RELENG_5_3:1.7.0.10
	RELENG_5_3_BP:1.7
	RELENG_5:1.7.0.8
	RELENG_5_BP:1.7
	RELENG_4_10_0_RELEASE:1.4.2.2
	RELENG_4_10:1.4.2.2.0.8
	RELENG_4_10_BP:1.4.2.2
	RELENG_5_2_1_RELEASE:1.7
	RELENG_5_2_0_RELEASE:1.7
	RELENG_5_2:1.7.0.6
	RELENG_5_2_BP:1.7
	RELENG_4_9_0_RELEASE:1.4.2.2
	RELENG_4_9:1.4.2.2.0.6
	RELENG_4_9_BP:1.4.2.2
	RELENG_5_1_0_RELEASE:1.7
	RELENG_5_1:1.7.0.4
	RELENG_5_1_BP:1.7
	RELENG_4_8_0_RELEASE:1.4.2.2
	RELENG_4_8:1.4.2.2.0.4
	RELENG_4_8_BP:1.4.2.2
	RELENG_5_0_0_RELEASE:1.7
	RELENG_5_0:1.7.0.2
	RELENG_5_0_BP:1.7
	RELENG_4_7_0_RELEASE:1.4.2.2
	RELENG_4_7:1.4.2.2.0.2
	RELENG_4_7_BP:1.4.2.2
	RELENG_4_6_2_RELEASE:1.4.2.1
	RELENG_4_6_1_RELEASE:1.4.2.1
	RELENG_4_6_0_RELEASE:1.4.2.1
	RELENG_4_6:1.4.2.1.0.8
	RELENG_4_6_BP:1.4.2.1
	RELENG_4_5_0_RELEASE:1.4.2.1
	RELENG_4_5:1.4.2.1.0.6
	RELENG_4_5_BP:1.4.2.1
	RELENG_4_4_0_RELEASE:1.4.2.1
	RELENG_4_4:1.4.2.1.0.4
	RELENG_4_4_BP:1.4.2.1
	RELENG_4_3_0_RELEASE:1.4.2.1
	RELENG_4_3:1.4.2.1.0.2
	RELENG_4_3_BP:1.4.2.1
	RELENG_4_2_0_RELEASE:1.4
	RELENG_4_1_1_RELEASE:1.4
	PRE_SMPNG:1.4
	RELENG_4_1_0_RELEASE:1.4
	RELENG_4_0_0_RELEASE:1.4
	RELENG_4:1.4.0.2
	RELENG_4_BP:1.4;
locks; strict;
comment	@# @;


1.10
date	2012.11.17.01.49.03;	author svnexp;	state Exp;
branches
	1.10.2.1;
next	1.9;

1.9
date	2011.01.19.20.16.47;	author uqs;	state Exp;
branches
	1.9.2.1;
next	1.8;

1.8
date	2007.10.03.05.44.27;	author ru;	state Exp;
branches
	1.8.2.1
	1.8.6.1
	1.8.8.1
	1.8.10.1
	1.8.12.1
	1.8.14.1;
next	1.7;

1.7
date	2002.05.18.12.37.19;	author ru;	state Exp;
branches
	1.7.14.1
	1.7.26.1;
next	1.6;

1.6
date	2002.05.18.12.35.10;	author ru;	state Exp;
branches;
next	1.5;

1.5
date	2001.01.11.13.02.29;	author dougb;	state Exp;
branches;
next	1.4;

1.4
date	2000.01.11.07.57.09;	author rgrimes;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	99.08.27.23.24.01;	author peter;	state Exp;
branches;
next	1.2;

1.2
date	99.08.23.05.12.43;	author rgrimes;	state Exp;
branches;
next	1.1;

1.1
date	99.08.23.01.16.26;	author rgrimes;	state Exp;
branches;
next	;

1.10.2.1
date	2012.11.17.01.49.03;	author svnexp;	state dead;
branches;
next	1.10.2.2;

1.10.2.2
date	2013.03.28.13.02.42;	author svnexp;	state Exp;
branches;
next	;

1.9.2.1
date	2011.09.23.00.51.37;	author kensmith;	state Exp;
branches
	1.9.2.1.2.1
	1.9.2.1.4.1;
next	1.9.2.2;

1.9.2.2
date	2012.11.17.11.36.11;	author svnexp;	state Exp;
branches;
next	;

1.9.2.1.2.1
date	2011.11.11.04.20.22;	author kensmith;	state Exp;
branches;
next	1.9.2.1.2.2;

1.9.2.1.2.2
date	2012.11.17.08.36.11;	author svnexp;	state Exp;
branches;
next	;

1.9.2.1.4.1
date	2012.08.05.23.54.33;	author kensmith;	state Exp;
branches;
next	1.9.2.1.4.2;

1.9.2.1.4.2
date	2012.11.17.08.47.00;	author svnexp;	state Exp;
branches;
next	;

1.8.2.1
date	2012.11.17.08.01.17;	author svnexp;	state Exp;
branches;
next	;

1.8.6.1
date	2008.11.25.02.59.29;	author kensmith;	state Exp;
branches;
next	;

1.8.8.1
date	2009.04.15.03.14.26;	author kensmith;	state Exp;
branches;
next	;

1.8.10.1
date	2009.08.03.08.13.06;	author kensmith;	state Exp;
branches
	1.8.10.1.2.1
	1.8.10.1.4.1
	1.8.10.1.6.1
	1.8.10.1.8.1;
next	1.8.10.2;

1.8.10.2
date	2012.11.17.10.35.56;	author svnexp;	state Exp;
branches;
next	;

1.8.10.1.2.1
date	2009.10.25.01.10.29;	author kensmith;	state Exp;
branches;
next	;

1.8.10.1.4.1
date	2010.06.14.02.09.06;	author kensmith;	state Exp;
branches;
next	;

1.8.10.1.6.1
date	2010.12.21.17.09.25;	author kensmith;	state Exp;
branches;
next	;

1.8.10.1.8.1
date	2012.03.03.06.15.13;	author kensmith;	state Exp;
branches;
next	1.8.10.1.8.2;

1.8.10.1.8.2
date	2012.11.17.08.24.38;	author svnexp;	state Exp;
branches;
next	;

1.8.12.1
date	2010.02.10.00.26.20;	author kensmith;	state Exp;
branches;
next	;

1.8.14.1
date	2010.12.21.17.10.29;	author kensmith;	state Exp;
branches;
next	1.8.14.2;

1.8.14.2
date	2012.11.17.08.16.37;	author svnexp;	state Exp;
branches;
next	;

1.7.14.1
date	2012.11.17.07.39.04;	author svnexp;	state Exp;
branches;
next	;

1.7.26.1
date	2008.10.02.02.57.24;	author kensmith;	state Exp;
branches;
next	;

1.4.2.1
date	2001.01.11.13.06.22;	author dougb;	state Exp;
branches;
next	1.4.2.2;

1.4.2.2
date	2002.08.08.09.50.20;	author ru;	state Exp;
branches;
next	1.4.2.3;

1.4.2.3
date	2012.11.17.07.22.38;	author svnexp;	state Exp;
branches;
next	;


desc
@@


1.10
log
@Switching exporter and resync
@
text
@$FreeBSD: head/etc/mtree/README 217596 2011-01-19 20:16:47Z uqs $

Note: If you modify these files, please keep hier(7) updated!

These files are used to create empty file hierarchies for building the
system into.  Some notes about working with them are placed here to try
and keep them in good working order.

    a)  The files use 4 space indentation, and other than in the header
        comments, should not contain any tabs.  An indentation of 4 is
        preferable to the standard indentation of 8 because the indentation
        of levels in these files can become quite deep causing the line to
        overflow 80 characters.

        This also matches with the files generated when using the
        mtree -c option, which was implemented that way for the same reason.

    b)  Only directories should be listed here.

    c)  The listing should be kept in filename sorted order.

    d)  Sanity checking changes to these files can be done by following
        this procedure (the sed -e is ugly, but fixing mtree -c to
        not emit the trailing white space would be even uglier):

            mkdir /tmp/MTREE
            mtree -deU -f BSD.X.dist -p /tmp/MTREE
            mtree -cdin -k uname,gname,mode -p /tmp/MTREE | \
		sed -e 's/ *$//' >BSD.X.new
            diff -u BSD.X.dist BSD.X.new
            rm -r /tmp/MTREE

        Note that you will get some differences about /set lines,
        and uname= gname= on certain directory areas, mainly man page
        sections.  This is caused by mtree not having a look ahead
        mechanism for making better selections for these as it
        traverses the hierarchy.

        The BSD.X.new file should NOT be committed, as it will be missing
        the correct header, and important keywords like ``nochange''.
        Simply use the diff for a sanity check to make sure things are in
        the correct order and correctly indented.

    e)  Further sanity checking of the system builds with DESTDIR=/someplace
        are more complicated, but can often catch missing entries in these
        files.  I tend to run this more complete sanity check shortly after
        the target date for a new release is announced.

        If you want details on it bug me about it via email to
        rgrimes@@FreeBSD.org.
@


1.10.2.1
log
@file README was added on branch RELENG_8_4 on 2013-03-28 13:02:42 +0000
@
text
@d1 50
@


1.10.2.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 50
$FreeBSD: releng/8.4/etc/mtree/README 172421 2007-10-03 05:44:27Z ru $

Note: If you modify these files, please keep hier(7) updated!

These files are used to create empty file hierarchies for building the
system into.  Some notes about working with them are placed here to try
and keep them in good working order.

    a)  The files use 4 space indentation, and other than in the header
        comments, should not contain any tabs.  An indentation of 4 is
        preferable to the standard indentation of 8 because the indentation
        of levels in these files can become quite deep causing the line to
        overflow 80 characters.

        This also matches with the files generated when using the
        mtree -c option, which was implemented that way for the same reason.

    b)  Only directories should be listed here.

    c)  The listing should be kept in filename sorted order.

    d)  Sanity checking changes to these files can be done by following
        this procedure (the sed -e is ugly, but fixing mtree -c to
        not emit the trailing white space would be even uglier):

            mkdir /tmp/MTREE
            mtree -deU -f BSD.X.dist -p /tmp/MTREE
            mtree -cdin -k uname,gname,mode -p /tmp/MTREE | \
		sed -e 's/ *$//' >BSD.X.new
            diff -u BSD.X.dist BSD.X.new
            rm -r /tmp/MTREE

        Note that you will get some differences about /set lines,
        and uname= gname= on certain directory areas, mainly man page
        sections.  This is caused by mtree not having a look ahead
        mechanism for making better selections for these as it
        traverses the hierarchy.

        The BSD.X.new file should NOT be commited, will be missing the
        correct header, and important keywords like ``nochange''.  Simply
        use the diff for a sanity check to make sure things are in the
        correct order and correctly indented.

    e)  Further sanity checking of the system builds with DESTDIR=/someplace
        are more complicated, but can often catch missing entries in these
        files.  I tend to run this more complete sanity check shortly after
        the target date for a new release is announced.

        If you want details on it bug me about it via email to
        rgrimes@@FreeBSD.org.
@


1.9
log
@SVN rev 217596 on 2011-01-19 20:16:47Z by uqs

Fix a small typo nit
@
text
@d1 1
a1 1
$FreeBSD$
@


1.9.2.1
log
@SVN rev 225736 on 2011-09-23 00:51:37Z by kensmith

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.9.2.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242902
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242902 | dteske | 2012-11-11 23:29:45 +0000 (Sun, 11 Nov 2012) | 10 lines
## SVN ##
## SVN ## Fix a regression introduced by SVN r211417 that saw the breakage of a feature
## SVN ## documented in usr.sbin/sysinstall/help/shortcuts.hlp (reproduced below):
## SVN ##
## SVN ## If /usr/sbin/sysinstall is linked to another filename, say
## SVN ## `/usr/local/bin/configPackages', then the basename will be used
## SVN ## as an implicit command name.
## SVN ##
## SVN ## Reviewed by:	adrian (co-mentor)
## SVN ## Approved by:	adrian (co-mentor)
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d1 1
a1 1
$FreeBSD: stable/9/etc/mtree/README 217596 2011-01-19 20:16:47Z uqs $
@


1.9.2.1.4.1
log
@SVN rev 239080 on 2012-08-05 23:54:33Z by kensmith

Copy stable/9 to releng/9.1 as part of the 9.1-RELEASE release process.

Approved by:	re (implicit)
@
text
@@


1.9.2.1.4.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.1/etc/mtree/README 217596 2011-01-19 20:16:47Z uqs $
@


1.9.2.1.2.1
log
@SVN rev 227445 on 2011-11-11 04:20:22Z by kensmith

Copy stable/9 to releng/9.0 as part of the FreeBSD 9.0-RELEASE release
cycle.

Approved by:	re (implicit)
@
text
@@


1.9.2.1.2.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.0/etc/mtree/README 217596 2011-01-19 20:16:47Z uqs $
@


1.8
log
@Removed "tail +5" from the command used to sanity check changes to
mtree files -- the 5-line header is no longer printed when mtree(8)
is run with -n (as of mtree/create.c,v 1.34).

Approved by:	re (kensmith)
@
text
@d39 4
a42 4
        The BSD.X.new file should NOT be commited, will be missing the
        correct header, and important keywords like ``nochange''.  Simply
        use the diff for a sanity check to make sure things are in the
        correct order and correctly indented.
@


1.8.2.1
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/7/etc/mtree/README 172421 2007-10-03 05:44:27Z ru $
@


1.8.14.1
log
@SVN rev 216618 on 2010-12-21 17:10:29Z by kensmith

Copy stable/7 to releng/7.4 in preparation for FreeBSD-7.4 release.

Approved by:	re (implicit)
@
text
@@


1.8.14.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/7.4/etc/mtree/README 172421 2007-10-03 05:44:27Z ru $
@


1.8.12.1
log
@SVN rev 203736 on 2010-02-10 00:26:20Z by kensmith

Copy stable/7 to releng/7.3 as part of the 7.3-RELEASE process.

Approved by:	re (implicit)
@
text
@@


1.8.10.1
log
@SVN rev 196045 on 2009-08-03 08:13:06Z by kensmith

Copy head to stable/8 as part of 8.0 Release cycle.

Approved by:	re (Implicit)
@
text
@@


1.8.10.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242909
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242909 | dim | 2012-11-12 07:47:19 +0000 (Mon, 12 Nov 2012) | 20 lines
## SVN ##
## SVN ## MFC r242625:
## SVN ##
## SVN ## Remove duplicate const specifiers in many drivers (I hope I got all of
## SVN ## them, please let me know if not).  Most of these are of the form:
## SVN ##
## SVN ## static const struct bzzt_type {
## SVN ##       [...list of members...]
## SVN ## } const bzzt_devs[] = {
## SVN ##       [...list of initializers...]
## SVN ## };
## SVN ##
## SVN ## The second const is unnecessary, as arrays cannot be modified anyway,
## SVN ## and if the elements are const, the whole thing is const automatically
## SVN ## (e.g. it is placed in .rodata).
## SVN ##
## SVN ## I have verified this does not change the binary output of a full kernel
## SVN ## build (except for build timestamps embedded in the object files).
## SVN ##
## SVN ## Reviewed by:	yongari, marius
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d1 1
a1 1
$FreeBSD: stable/8/etc/mtree/README 172421 2007-10-03 05:44:27Z ru $
@


1.8.10.1.8.1
log
@SVN rev 232438 on 2012-03-03 06:15:13Z by kensmith

Copy stable/8 to releng/8.3 as part of 8.3-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.8.10.1.8.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/8.3/etc/mtree/README 172421 2007-10-03 05:44:27Z ru $
@


1.8.10.1.6.1
log
@SVN rev 216617 on 2010-12-21 17:09:25Z by kensmith

Copy stable/8 to releng/8.2 in preparation for FreeBSD-8.2 release.

Approved by:	re (implicit)
@
text
@@


1.8.10.1.4.1
log
@SVN rev 209145 on 2010-06-14 02:09:06Z by kensmith

Copy stable/8 to releng/8.1 in preparation for 8.1-RC1.

Approved by:	re (implicit)
@
text
@@


1.8.10.1.2.1
log
@SVN rev 198460 on 2009-10-25 01:10:29Z by kensmith

Copy stable/8 to releng/8.0 as part of 8.0-RELEASE release procedure.

Approved by:	re (implicit)
@
text
@@


1.8.8.1
log
@SVN rev 191087 on 2009-04-15 03:14:26Z by kensmith

Create releng/7.2 from stable/7 in preparation for 7.2-RELEASE.

Approved by:	re (implicit)
@
text
@@


1.8.6.1
log
@SVN rev 185281 on 2008-11-25 02:59:29Z by kensmith

Create releng/7.1 in preparation for moving into RC phase of 7.1 release
cycle.

Approved by:	re (implicit)
@
text
@@


1.7
log
@Sigh, this README is not a shell script.
@
text
@d1 1
a1 1
$FreeBSD: src/etc/mtree/README,v 1.6 2002/05/18 12:35:10 ru Exp $
d29 1
a29 1
		sed -e 's/ *$//' | tail +5 >BSD.X.new
@


1.7.14.1
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/6/etc/mtree/README 96856 2002-05-18 12:37:19Z ru $
@


1.7.26.1
log
@SVN rev 183531 on 2008-10-02 02:57:24Z by kensmith

Create releng/6.4 from stable/6 in preparation for 6.4-RC1.

Approved by:	re (implicit)
@
text
@d1 1
a1 1
$FreeBSD$
@


1.6
log
@Remind developers to update hier(7) if they make changes to these files.
@
text
@d1 1
a1 1
$FreeBSD: src/etc/mtree/README,v 1.5 2001/01/11 13:02:29 dougb Exp $
d3 1
a3 1
# Note: If you modify these files, please keep hier(7) updated!
@


1.5
log
@Fix a small typo
@
text
@d1 3
a3 1
$FreeBSD: src/etc/mtree/README,v 1.4 2000/01/11 07:57:09 rgrimes Exp $
@


1.4
log
@Add missing -p /tmp/MTREE to mtree command in README so that it
will actually work now.

Remove tabs and once again sort the *.dist files.
@
text
@d1 1
a1 1
$FreeBSD: src/etc/mtree/README,v 1.3 1999/08/27 23:24:01 peter Exp $
d18 1
a18 1
    c)  The listing should be keep in filename sorted order.
@


1.4.2.1
log
@MFC, fix a small typo
@
text
@d1 1
a1 1
$FreeBSD: src/etc/mtree/README,v 1.5 2001/01/11 13:02:29 dougb Exp $
d18 1
a18 1
    c)  The listing should be kept in filename sorted order.
@


1.4.2.2
log
@MFC: Reminder to keep hier(7) updated.
@
text
@d1 1
a1 3
$FreeBSD$

Note: If you modify these files, please keep hier(7) updated!
@


1.4.2.3
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/4/etc/mtree/README 101512 2002-08-08 09:50:20Z ru $
@


1.3
log
@$Id$ -> $FreeBSD$
@
text
@d1 1
a1 1
$FreeBSD$
d26 2
a27 2
            mtree -cdin -k uname,gname,mode | sed -e 's/ *$//' | \
                tail +5 >BSD.X.new
@


1.2
log
@Fix script in README to actually work, empty lines produce as
much a diff as lines with the wrong stuff on it.

Add references in mtree data files to the README.
@
text
@d1 1
a1 1
$Id: README,v 1.1 1999/08/23 01:16:26 rgrimes Exp $
@


1.1
log
@An explination of how to keep these files in good working order.

Reviewed by:	bde
@
text
@d1 1
a1 1
$Id$
d21 1
a21 1
        this procedure (the sed -e's are ugly, but fixing mtree -c to
d27 1
a27 1
                sed -e 's/^#\t//' >BSD.X.new
@

