xref: /OpenGrok/opengrok-indexer/src/test/resources/repositories/bitkeeper/BitKeeper/etc/config (revision 9a303f1948b99409943e5b2e00a139a726dbc8d4)
1*9a303f19SAdam Hornacek# This is the BitKeeper configuration for this package.
2*9a303f19SAdam Hornacek#
3*9a303f19SAdam Hornacek# Please fill in the "description:" and "email:" fields, BK/Web needs those.
4*9a303f19SAdam Hornacek# For the rest of the fields you may use the defaults.
5*9a303f19SAdam Hornacek#
6*9a303f19SAdam Hornacek
7*9a303f19SAdam Hornacek#
8*9a303f19SAdam Hornacek# Automatically populate missing components as needed to perform a safe
9*9a303f19SAdam Hornacek# pull.  Unless you have very large components and slow networks this
10*9a303f19SAdam Hornacek# should be set to on.
11*9a303f19SAdam Hornacek#
12*9a303f19SAdam Hornacek# Default: off
13*9a303f19SAdam Hornacek#
14*9a303f19SAdam Hornacekauto_populate: off
15*9a303f19SAdam Hornacek
16*9a303f19SAdam Hornacek#
17*9a303f19SAdam Hornacek# Default is to enable the Binary Asset Manager.
18*9a303f19SAdam Hornacek# If you want to use the older uuencoded binaries, set this to "no".
19*9a303f19SAdam Hornacek#
20*9a303f19SAdam HornacekBAM: on
21*9a303f19SAdam Hornacek
22*9a303f19SAdam Hornacek#
23*9a303f19SAdam Hornacek# BitKeeper supports the following check out modes (which defines what
24*9a303f19SAdam Hornacek# permissions/state versioned files are in after a clone/delta/commit):
25*9a303f19SAdam Hornacek#
26*9a303f19SAdam Hornacek#   edit		- check out files locked such that they are writable
27*9a303f19SAdam Hornacek#   get		- check out files in read-only mode (can be higher
28*9a303f19SAdam Hornacek#   		  performance in large repos; also supports keywords)
29*9a303f19SAdam Hornacek#   last		- preserve the previous state of the file
30*9a303f19SAdam Hornacek#   none		- do not check out any files
31*9a303f19SAdam Hornacek#
32*9a303f19SAdam Hornacek# Most users are least surprised by checkout:edit, it is what they expect.
33*9a303f19SAdam Hornacek#
34*9a303f19SAdam Hornacek# If this is a repository full of big binary files then checkout:none or
35*9a303f19SAdam Hornacek# checkout:last is better, especially when combined with BAM.
36*9a303f19SAdam Hornacek#
37*9a303f19SAdam Hornacek# Default: none
38*9a303f19SAdam Hornacek#
39*9a303f19SAdam Hornacekcheckout: edit
40*9a303f19SAdam Hornacek
41*9a303f19SAdam Hornacek#
42*9a303f19SAdam Hornacek# The clock skew field controls how recent a file has to be before
43*9a303f19SAdam Hornacek# BitKeeper will not trust the timestamp database.  It defaults to
44*9a303f19SAdam Hornacek# a week and that default was chosen to overcome clock drift problems
45*9a303f19SAdam Hornacek# on network file systems.  If you know your clocks are 100% accurate
46*9a303f19SAdam Hornacek# and your workflow is such that many of your files change all the
47*9a303f19SAdam Hornacek# time, then setting the clock skew down to a day or two (172800)
48*9a303f19SAdam Hornacek# will improve performance.  For most people, the default is fine.
49*9a303f19SAdam Hornacek#
50*9a303f19SAdam Hornacek# Default: on
51*9a303f19SAdam Hornacek#
52*9a303f19SAdam Hornacekclock_skew: on
53*9a303f19SAdam Hornacek
54*9a303f19SAdam Hornacek#
55*9a303f19SAdam Hornacek# When cloning a product, limit the components cloned to the alias
56*9a303f19SAdam Hornacek# specified.
57*9a303f19SAdam Hornacek#
58*9a303f19SAdam Hornacek# Default: ALL
59*9a303f19SAdam Hornacek#
60*9a303f19SAdam Hornacekclone_default: ALL
61*9a303f19SAdam Hornacek
62*9a303f19SAdam Hornacek#
63*9a303f19SAdam Hornacek# Name of the project, such as "BitKeeper source management system",
64*9a303f19SAdam Hornacek# "Linux kernel" or "MySQL database system".  Used when listing
65*9a303f19SAdam Hornacek# repositories.
66*9a303f19SAdam Hornacek#
67*9a303f19SAdam Hornacek# Default: empty
68*9a303f19SAdam Hornacek#
69*9a303f19SAdam Hornacek# description:
70*9a303f19SAdam Hornacek
71*9a303f19SAdam Hornacek#
72*9a303f19SAdam Hornacek# Email address of the person or alias that should get administrative
73*9a303f19SAdam Hornacek# questions about this project.  Currently only used by BK/Web.
74*9a303f19SAdam Hornacek#
75*9a303f19SAdam Hornacek# Default: empty
76*9a303f19SAdam Hornacek#
77*9a303f19SAdam Hornacek# email:
78*9a303f19SAdam Hornacek
79*9a303f19SAdam Hornacek#
80*9a303f19SAdam Hornacek# When checking out text files in operating systems with different
81*9a303f19SAdam Hornacek# conventions, which End-Of-Line marker to use. The options are:
82*9a303f19SAdam Hornacek#
83*9a303f19SAdam Hornacek#   native  - Use \n on Unix systems and \r\n on Windows
84*9a303f19SAdam Hornacek#   windows - Always use \r\n
85*9a303f19SAdam Hornacek#   unix    - Always use \n
86*9a303f19SAdam Hornacek#
87*9a303f19SAdam Hornacek# Default: native
88*9a303f19SAdam Hornacek#
89*9a303f19SAdam Hornacekeoln: native
90*9a303f19SAdam Hornacek
91*9a303f19SAdam Hornacek#
92*9a303f19SAdam Hornacek# Controls whether BitKeeper will expands keywords embedded in new
93*9a303f19SAdam Hornacek# files.  The values are 'sccs' or 'rcs', with an optional ', expand1'
94*9a303f19SAdam Hornacek# (i.e., 'sccs, expand1' or 'rcs, expand1').
95*9a303f19SAdam Hornacek#
96*9a303f19SAdam Hornacek# The 'expand1' says "expand only the first line found containing keywords"
97*9a303f19SAdam Hornacek# and is supported because sometimes the keyword string is a legitimate
98*9a303f19SAdam Hornacek# part of the source and shouldn't be expanded.
99*9a303f19SAdam Hornacek#
100*9a303f19SAdam Hornacek# Note that this is a property of the file at the time of creation. The
101*9a303f19SAdam Hornacek# setting is persistent and can be changed using 'bk admin'.
102*9a303f19SAdam Hornacek#
103*9a303f19SAdam Hornacek# Keywords are only expanded in 'checkout:get' mode.
104*9a303f19SAdam Hornacek#
105*9a303f19SAdam Hornacek# Default: none
106*9a303f19SAdam Hornacek#
107*9a303f19SAdam Hornacekkeyword: none
108*9a303f19SAdam Hornacek
109*9a303f19SAdam Hornacek#
110*9a303f19SAdam Hornacek# Old BK computed checksums using a set based method and new bk
111*9a303f19SAdam Hornacek# computes using a graph based system.  Checksum can look back
112*9a303f19SAdam Hornacek# and see that they compute the same thing.  In some rare cases,
113*9a303f19SAdam Hornacek# involving an exclude of a merge cset, the two sums might not match.
114*9a303f19SAdam Hornacek#
115*9a303f19SAdam Hornacek# This option skips running the graph based checksum test on old or
116*9a303f19SAdam Hornacek# all depending on how it is set.
117*9a303f19SAdam Hornacek#
118*9a303f19SAdam Hornacek#   0 (or off)   - run graph verify test on all (the default)
119*9a303f19SAdam Hornacek#   1 (or on)    - skip running the verify on all
120*9a303f19SAdam Hornacek#   Other number - interpret as a time_t and only run verify on newer csets
121*9a303f19SAdam Hornacek#
122*9a303f19SAdam Hornacek# Default: off
123*9a303f19SAdam Hornacek#
124*9a303f19SAdam Hornacekno_graphverify: off
125*9a303f19SAdam Hornacek
126*9a303f19SAdam Hornacek#
127*9a303f19SAdam Hornacek# BitKeeper can automatically run multiple processes to take advantage
128*9a303f19SAdam Hornacek# of the multi-core architectures of today. The parallel variable
129*9a303f19SAdam Hornacek# can be set to 0 to prevent this, to a number greater than zero to use
130*9a303f19SAdam Hornacek# that number of parallel processes, or to the value 'on' to let
131*9a303f19SAdam Hornacek# BitKeeper determine what the best value is.
132*9a303f19SAdam Hornacek#
133*9a303f19SAdam Hornacek# Default: on
134*9a303f19SAdam Hornacek#
135*9a303f19SAdam Hornacekparallel: on
136*9a303f19SAdam Hornacek
137*9a303f19SAdam Hornacek#
138*9a303f19SAdam Hornacek# With partial_check set to on, repositories are checked no more than once
139*9a303f19SAdam Hornacek# every check_frequency days.  This is a performance win for large
140*9a303f19SAdam Hornacek# repositories.
141*9a303f19SAdam Hornacek#
142*9a303f19SAdam Hornacek# Customers who have reason to believe that their data may be corrupted
143*9a303f19SAdam Hornacek# by hardware or software problems (bad memory, bad disks, bugs in the
144*9a303f19SAdam Hornacek# file system, etc.) should set this field to "off".
145*9a303f19SAdam Hornacek#
146*9a303f19SAdam Hornacek# Default: on
147*9a303f19SAdam Hornacek#
148*9a303f19SAdam Hornacekpartial_check: on
149*9a303f19SAdam Hornacek
150*9a303f19SAdam Hornacek#
151*9a303f19SAdam Hornacek# If stats_after_pull is set to 'on', BitKeeper will print diffstat
152*9a303f19SAdam Hornacek# output after a pull.
153*9a303f19SAdam Hornacek#
154*9a303f19SAdam Hornacek# Default: off
155*9a303f19SAdam Hornacek#
156*9a303f19SAdam Hornacekstats_after_pull: off
157*9a303f19SAdam Hornacek
158*9a303f19SAdam Hornacek#
159*9a303f19SAdam Hornacek# If sync is set to 'on', BitKeeper will call fsync() after writing
160*9a303f19SAdam Hornacek# data to the filesystem.  On some Linux systems fsync() has significant
161*9a303f19SAdam Hornacek# performance problems (google it).
162*9a303f19SAdam Hornacek#
163*9a303f19SAdam Hornacek# Default: off
164*9a303f19SAdam Hornacek#
165*9a303f19SAdam Hornaceksync: off
166*9a303f19SAdam Hornacek
167*9a303f19SAdam Hornacek#
168*9a303f19SAdam Hornacek# Where to look for triggers. Different paths are separated by the '|'
169*9a303f19SAdam Hornacek# character. Besides path names (such as /etc/bktriggers), the following
170*9a303f19SAdam Hornacek# special values are supported:
171*9a303f19SAdam Hornacek#
172*9a303f19SAdam Hornacek#   $NONE		- Do not run any triggers
173*9a303f19SAdam Hornacek#   $PRODUCT	- Run the triggers in the product's BitKeeper/triggers
174*9a303f19SAdam Hornacek#   		  directory (ignored in a non-nested collection)
175*9a303f19SAdam Hornacek#   $BK_DOTBK	- Run the triggers in the user's
176*9a303f19SAdam Hornacek#   		  ~/.bk/BitKeeper/triggers directory.
177*9a303f19SAdam Hornacek#   $BK_BIN	- Run the triggers in `bk bin`/BitKeeper/triggers
178*9a303f19SAdam Hornacek#   .		- Run the triggers in `bk root -S`/BitKeeper/triggers
179*9a303f19SAdam Hornacek#
180*9a303f19SAdam Hornacek# Default: $PRODUCT|.
181*9a303f19SAdam Hornacek#
182*9a303f19SAdam Hornacektriggers: $PRODUCT|.
183