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