Mercurial > p > roundup > code

annotate website/issues/config.ini @ 5296:b48e2fe4a7bd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Make tracker user native (postgres) test indexer. This is apparently how things are expected to be set up on the server. Leaving it blank pulls in the xapian indexer which they don't want.
author John Rouillard <rouilj@ieee.org>
date Thu, 28 Sep 2017 19:22:21 -0400
parents 33e1cf136f1d
children b7fa56ced601 d3a23d918c27
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
1 # Roundup issue tracker configuration file
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
2 # Autogenerated at Wed Sep 20 20:03:15 2017
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
3
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
4 # WARNING! Following options need adjustments:
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
5 # [mail]: host
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
6
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
7 [main]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
8
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
9 # Database directory path.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
10 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
11 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
12 # Default: db
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
13 database = db
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
14
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
15 # Templating engine to use.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
16 # Possible values are 'zopetal' for the old TAL engine
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
17 # ported from Zope, or 'chameleon' for Chameleon.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
18 # Default: zopetal
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
19 template_engine = zopetal
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
20
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
21 # Path to the HTML templates directory.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
22 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
23 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
24 # Default: html
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
25 templates = html
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
26
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
27 # A list of space separated directory paths (or a single
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
28 # directory). These directories hold additional static
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
29 # files available via Web UI. These directories may
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
30 # contain sitewide images, CSS stylesheets etc. If a '-'
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
31 # is included, the list processing ends and the TEMPLATES
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
32 # directory is not searched after the specified
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
33 # directories. If this option is not set, all static
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
34 # files are taken from the TEMPLATES directory.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
35 # The space separated paths may be either absolute or
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
36 # relative to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
37 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
38 static_files =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
39
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
40 # Email address that roundup will complain to if it runs
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
41 # into trouble.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
42 # If no domain is specified then the config item
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
43 # mail -> domain is added.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
44 # Default: roundup-admin
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
45 admin_email = admin@issues.roundup-tracker.org
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
46
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
47 # The 'dispatcher' is a role that can get notified
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
48 # of new items to the database.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
49 # It is used by the ERROR_MESSAGES_TO config setting.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
50 # If no domain is specified then the config item
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
51 # mail -> domain is added.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
52 # Default: roundup-admin
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
53 dispatcher_email = admin@issues.roundup-tracker.org
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
54
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
55 # Additional text to include in the "name" part
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
56 # of the From: address used in nosy messages.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
57 # If the sending user is "Foo Bar", the From: line
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
58 # is usually: "Foo Bar" <issue_tracker@tracker.example>
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
59 # the EMAIL_FROM_TAG goes inside the "Foo Bar" quotes like so:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
60 # "Foo Bar EMAIL_FROM_TAG" <issue_tracker@tracker.example>
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
61 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
62 email_from_tag =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
63
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
64 # Roles that a user gets when they register with Web User Interface.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
65 # This is a comma-separated string of role names (e.g. 'Admin,User').
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
66 # Default: User
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
67 new_web_user_roles = User
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
68
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
69 # Roles that a user gets when they register with Email Gateway.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
70 # This is a comma-separated string of role names (e.g. 'Admin,User').
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
71 # Default: User
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
72 new_email_user_roles = User
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
73
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
74 # Send error message emails to the dispatcher, user, or both?
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
75 # The dispatcher is configured using the DISPATCHER_EMAIL setting.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
76 # Default: user
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
77 error_messages_to = user
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
78
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
79 # HTML version to generate. The templates are html4 by default.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
80 # If you wish to make them xhtml, then you'll need to change this
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
81 # var to 'xhtml' too so all auto-generated HTML is compliant.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
82 # Allowed values: html4, xhtml
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
83 # Default: html4
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
84 html_version = xhtml
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
85
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
86 # Default timezone offset, applied when user's timezone is not set.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
87 # If pytz module is installed, value may be any valid
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
88 # timezone specification (e.g. EET or Europe/Warsaw).
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
89 # If pytz is not installed, value must be integer number
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
90 # giving local timezone offset from UTC in hours.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
91 # Default: UTC
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
92 timezone = UTC
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
93
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
94 # Register new users instantly, or require confirmation via
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
95 # email?
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
96 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
97 # Default: no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
98 instant_registration = no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
99
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
100 # Offer registration confirmation by email or only through the web?
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
101 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
102 # Default: yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
103 email_registration_confirmation = yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
104
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
105 # Force Roundup to use a particular text indexer.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
106 # If no indexer is supplied, the first available indexer
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
107 # will be used in the following order:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
108 # Possible values: xapian, whoosh, native (internal).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
109 # Default:
5296
b48e2fe4a7bd Make tracker user native (postgres) test indexer. This is apparently
John Rouillard <rouilj@ieee.org>
parents: 5290
diff changeset
110 indexer = native
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
111
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
112 # Additional stop-words for the full-text indexer specific to
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
113 # your tracker. See the indexer source for the default list of
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
114 # stop-words (eg. A,AND,ARE,AS,AT,BE,BUT,BY, ...)
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
115 # Allowed values: comma-separated list of words
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
116 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
117 indexer_stopwords =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
118
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
119 # Defines the file creation mode mask.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
120 # Default: 02
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
121 umask = 02
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
122
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
123 # Maximum size of a csv-field during import. Roundups export
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
124 # format is a csv (comma separated values) variant. The csv
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
125 # reader has a limit on the size of individual fields
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
126 # starting with python 2.5. Set this to a higher value if you
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
127 # get the error 'Error: field larger than field limit' during
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
128 # import.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
129 # Default: 131072
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
130 csv_field_size = 131072
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
131
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
132 # Sets the default number of rounds used when encoding passwords
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
133 # using the PBKDF2 scheme. Set this to a higher value on faster
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
134 # systems which want more security.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
135 # PBKDF2 (Password-Based Key Derivation Function) is a
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
136 # password hashing mechanism that derives hash from the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
137 # password and a random salt. For authentication this process
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
138 # is repeated with the same salt as in the stored hash.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
139 # If both hashes match, the authentication succeeds.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
140 # PBKDF2 supports a variable 'rounds' parameter which varies
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
141 # the time-cost of calculating the hash - doubling the number
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
142 # of rounds doubles the cpu time required to calculate it. The
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
143 # purpose of this is to periodically adjust the rounds as CPUs
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
144 # become faster. The currently enforced minimum number of
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
145 # rounds is 1000.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
146 # See: http://en.wikipedia.org/wiki/PBKDF2 and RFC2898
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
147 # Default: 10000
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
148 password_pbkdf2_default_rounds = 10000
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
149
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
150 [tracker]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
151
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
152 # A descriptive name for your roundup instance.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
153 # Default: Roundup issue tracker
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
154 name = Roundup tracker
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
155
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
156 # The web address that the tracker is viewable at.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
157 # This will be included in information sent to users of the tracker.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
158 # The URL MUST include the cgi-bin part or anything else
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
159 # that is required to get to the home page of the tracker.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
160 # You MUST include a trailing '/' in the URL.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
161 # Default: NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
162 web = http://issues.roundup-tracker.org/
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
163
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
164 # Email address that mail to roundup should go to.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
165 # If no domain is specified then mail_domain is added.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
166 # Default: issue_tracker
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
167 email = issues@roundup-tracker.org
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
168
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
169 # Controls the reply-to header address used when sending
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
170 # nosy messages.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
171 # If the value is unset (default) the roundup tracker's
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
172 # email address (above) is used.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
173 # If set to "AUTHOR" then the primary email address of the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
174 # author of the change will be used as the reply-to
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
175 # address. This allows email exchanges to occur outside of
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
176 # the view of roundup and exposes the address of the person
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
177 # who updated the issue, but it could be useful in some
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
178 # unusual circumstances.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
179 # If set to some other value, the value is used as the reply-to
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
180 # address. It must be a valid RFC2822 address or people will not be
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
181 # able to reply.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
182 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
183 replyto_address =
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
184
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
185 # Default locale name for this tracker.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
186 # If this option is not set, the language is determined
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
187 # by OS environment variable LANGUAGE, LC_ALL, LC_MESSAGES,
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
188 # or LANG, in that order of preference.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
189 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
190 language =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
191
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
192 [web]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
193
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
194 # Setting this option enables Roundup to serve uploaded HTML
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
195 # file content *as HTML*. This is a potential security risk
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
196 # and is therefore disabled by default. Set to 'yes' if you
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
197 # trust *all* users uploading content to your tracker.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
198 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
199 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
200 allow_html_file = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
201
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
202 # Whether to use HTTP Basic Authentication, if present.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
203 # Roundup will use either the REMOTE_USER or HTTP_AUTHORIZATION
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
204 # variables supplied by your web server (in that order).
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
205 # Set this option to 'no' if you do not wish to use HTTP Basic
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
206 # Authentication in your web interface.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
207 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
208 # Default: yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
209 http_auth = yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
210
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
211 # Set the mode of the SameSite cookie option for
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
212 # the session cookie. Choices are 'Lax' or
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
213 # 'Strict'. 'None' can be used to suppress the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
214 # option. Strict mode provides additional security
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
215 # against CSRF attacks, but may confuse users who
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
216 # are logged into roundup and open a roundup link
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
217 # from a source other than roundup (e.g. link in
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
218 # email).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
219 # Allowed values: Strict, Lax, None
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
220 # Default: Lax
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
221 samesite_cookie_setting = Lax
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
222
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
223 # How do we deal with @csrf fields in posted forms.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
224 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
225 # the user if the field is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
226 # Set this to 'yes' to block the post and notify the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
227 # if the token is invalid, but accept the form if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
228 # the field is missing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
229 # Set this to 'logfailure' to log a notice to the roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
230 # log if the field is invalid or missing, but accept
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
231 # the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
232 # Set this to 'no' to ignore the field and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
233 #
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
234 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
235 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
236 csrf_enforce_token = required
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
237
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
238 # csrf_tokens have a limited lifetime. If they are not
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
239 # used they are purged from the database after this
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
240 # number of minutes. Default (20160) is 2 weeks.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
241 # Default: 20160
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
242 csrf_token_lifetime = 10080
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
243
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
244 # This is only used for xmlrpc requests. This test is
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
245 # done after Origin and Referer headers are checked. It only
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
246 # verifies that the X-Requested-With header exists. The value
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
247 # is ignored.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
248 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
249 # the user if the header is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
250 # Set this to 'yes' is the same as required.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
251 # Set this to 'logfailure' is the same as 'no'.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
252 # Set this to 'no' to ignore the header and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
253 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
254 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
255 csrf_enforce_header_x-requested-with = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
256
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
257 # Verify that the Referer http header matches the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
258 # tracker.web setting in config.ini.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
259 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
260 # the user if the header is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
261 # Set this to 'yes' to block the post and notify the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
262 # if the header is invalid, but accept the form if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
263 # the field is missing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
264 # Set this to 'logfailure' to log a notice to the roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
265 # log if the header is invalid or missing, but accept
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
266 # the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
267 # Set this to 'no' to ignore the header and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
268 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
269 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
270 csrf_enforce_header_referer = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
271
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
272 # Verify that the Origin http header matches the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
273 # tracker.web setting in config.ini.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
274 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
275 # the user if the header is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
276 # Set this to 'yes' to block the post and notify the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
277 # if the header is invalid, but accept the form if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
278 # the field is missing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
279 # Set this to 'logfailure' to log a notice to the roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
280 # log if the header is invalid or missing, but accept
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
281 # the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
282 # Set this to 'no' to ignore the header and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
283 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
284 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
285 csrf_enforce_header_origin = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
286
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
287 # Verify that the X-Forwarded-Host http header matches
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
288 # the host part of the tracker.web setting in config.ini.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
289 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
290 # the user if the header is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
291 # Set this to 'yes' to block the post and notify the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
292 # if the header is invalid, but accept the form if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
293 # the field is missing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
294 # Set this to 'logfailure' to log a notice to the roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
295 # log if the header is invalid or missing, but accept
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
296 # the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
297 # Set this to 'no' to ignore the header and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
298 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
299 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
300 csrf_enforce_header_x-forwarded-host = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
301
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
302 # "If there is no X-Forward-Host header, verify that
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
303 # the Host http header matches the host part of the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
304 # tracker.web setting in config.ini.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
305 # Set this to 'required' to block the post and notify
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
306 # the user if the header is missing or invalid.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
307 # Set this to 'yes' to block the post and notify the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
308 # if the header is invalid, but accept the form if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
309 # the field is missing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
310 # Set this to 'logfailure' to log a notice to the roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
311 # log if the header is invalid or missing, but accept
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
312 # the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
313 # Set this to 'no' to ignore the header and accept the post.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
314 # Allowed values: required, yes, logfailure, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
315 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
316 csrf_enforce_header_host = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
317
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
318 # Minimum number of header checks that must pass
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
319 # to accept the request. Set to 0 to accept post
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
320 # even if no header checks pass. Usually the Host header check
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
321 # always passes, so setting it less than 1 is not recommended.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
322 # Default: 1
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
323 csrf_header_min_count = 1
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
324
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
325 # Whether to use HTTP Accept-Language, if present.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
326 # Browsers send a language-region preference list.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
327 # It's usually set in the client's browser or in their
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
328 # Operating System.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
329 # Set this option to 'no' if you want to ignore it.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
330 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
331 # Default: yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
332 use_browser_language = no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
333
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
334 # Setting this option makes Roundup display error tracebacks
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
335 # in the user's browser rather than emailing them to the
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
336 # tracker admin.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
337 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
338 # Default: no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
339 debug = no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
340
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
341 # Setting this option makes Roundup migrate passwords with
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
342 # an insecure password-scheme to a more secure scheme
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
343 # when the user logs in via the web-interface.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
344 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
345 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
346 migrate_passwords = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
347
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
348 # Settings in this section are used by RDBMS backends only
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
349 [rdbms]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
350
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
351 # Name of the database to use.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
352 # Default: roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
353 name = roundup_roundup_tracker
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
354
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
355 # Database backend.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
356 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
357 backend = postgresql
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
358
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
359 # Database server host.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
360 # Default: localhost
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
361 host = localhost
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
362
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
363 # TCP port number of the database server.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
364 # Postgresql usually resides on port 5432 (if any),
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
365 # for MySQL default port number is 3306.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
366 # Leave this option empty to use backend default
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
367 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
368 port =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
369
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
370 # Database user name that Roundup should use.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
371 # Default: roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
372 user = roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
373
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
374 # Database user password.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
375 # Default: roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
376 password = roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
377
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
378 # Name of the MySQL defaults file.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
379 # Only used in MySQL connections.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
380 # Default: ~/.my.cnf
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
381 read_default_file = ~/.my.cnf
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
382
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
383 # Name of the group to use in the MySQL defaults file (.my.cnf).
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
384 # Only used in MySQL connections.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
385 # Default: roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
386 read_default_group = roundup
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
387
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
388 # Number of seconds to wait when the SQLite database is locked
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
389 # Default: use a 30 second timeout (extraordinarily generous)
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
390 # Only used in SQLite connections.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
391 # Default: 30
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
392 sqlite_timeout = 30
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
393
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
394 # Size of the node cache (in elements)
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
395 # Default: 100
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
396 cache_size = 100
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
397
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
398 # Setting this option to 'no' protects the database against table creations.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
399 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
400 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
401 allow_create = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
402
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
403 # Setting this option to 'no' protects the database against table alterations.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
404 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
405 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
406 allow_alter = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
407
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
408 # Setting this option to 'no' protects the database against table drops.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
409 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
410 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
411 allow_drop = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
412
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
413 # Name of the PostgreSQL template for database creation.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
414 # For database creation the template used has to match
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
415 # the character encoding used (UTF8), there are different
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
416 # PostgreSQL installations using different templates with
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
417 # different encodings. If you get an error:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
418 # new encoding (UTF8) is incompatible with the encoding of
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
419 # the template database (SQL_ASCII)
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
420 # HINT: Use the same encoding as in the template database,
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
421 # or use template0 as template.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
422 # then set this option to the template name given in the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
423 # error message.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
424 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
425 template =
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
426
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
427 # Database isolation level, currently supported for
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
428 # PostgreSQL and mysql. See, e.g.,
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
429 # http://www.postgresql.org/docs/9.1/static/transaction-iso.html
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
430 # Allowed values: 'read uncommitted', 'read committed', 'repeatable read', 'serializable'
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
431 # Default: read committed
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
432 isolation_level = read committed
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
433
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
434 [logging]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
435
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
436 # Path to configuration file for standard Python logging module.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
437 # If this option is set, logging configuration is loaded
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
438 # from specified file; options 'filename' and 'level'
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
439 # in this section are ignored.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
440 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
441 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
442 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
443 config =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
444
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
445 # Log file name for minimal logging facility built into Roundup.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
446 # If no file name specified, log messages are written on stderr.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
447 # If above 'config' option is set, this option has no effect.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
448 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
449 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
450 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
451 filename =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
452
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
453 # Minimal severity level of messages written to log file.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
454 # If above 'config' option is set, this option has no effect.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
455 # Allowed values: DEBUG, INFO, WARNING, ERROR
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
456 # Default: ERROR
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
457 level = ERROR
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
458
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
459 # Outgoing email options.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
460 # Used for nosy messages and approval requests
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
461 [mail]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
462
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
463 # The email domain that admin_email, issue_tracker and
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
464 # dispatcher_email belong to.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
465 # This domain is added to those config items if they don't
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
466 # explicitly include a domain.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
467 # Do not include the '@' symbol.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
468 # Default: NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
469 domain = psf.upfronthosting.co.za
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
470
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
471 # SMTP mail host that roundup will use to send mail
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
472 # Default: NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
473 #host = NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
474 host = localhost
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
475
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
476 # SMTP login name.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
477 # Set this if your mail host requires authenticated access.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
478 # If username is not empty, password (below) MUST be set!
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
479 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
480 username =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
481
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
482 # SMTP login password.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
483 # Set this if your mail host requires authenticated access.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
484 # Default: NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
485 #password = NO DEFAULT
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
486
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
487 # Default port to send SMTP on.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
488 # Set this if your mail server runs on a different port.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
489 # Default: 25
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
490 port = 25
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
491
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
492 # The local hostname to use during SMTP transmission.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
493 # Set this if your mail server requires something specific.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
494 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
495 local_hostname =
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
496
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
497 # If your SMTP mail host provides or requires TLS
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
498 # (Transport Layer Security) then set this option to 'yes'.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
499 # Allowed values: yes, no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
500 # Default: no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
501 tls = no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
502
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
503 # If TLS is used, you may set this option to the name
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
504 # of a PEM formatted file that contains your private key.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
505 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
506 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
507 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
508 tls_keyfile =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
509
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
510 # If TLS is used, you may set this option to the name
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
511 # of a PEM formatted certificate chain file.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
512 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
513 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
514 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
515 tls_certfile =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
516
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
517 # Character set to encode email headers with.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
518 # We use utf-8 by default, as it's the most flexible.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
519 # Some mail readers (eg. Eudora) can't cope with that,
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
520 # so you might need to specify a more limited character set
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
521 # (eg. iso-8859-1).
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
522 # Default: utf-8
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
523 charset = utf-8
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
524
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
525 # Setting this option makes Roundup write all outgoing email
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
526 # messages to this file *instead* of sending them.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
527 # This option has the same effect as environment variable SENDMAILDEBUG.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
528 # Environment variable takes precedence.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
529 # The path may be either absolute or relative
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
530 # to the directory containing this config file.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
531 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
532 #debug = /home/roundup/outgoing-mail
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
533 debug =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
534
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
535 # Add a line with author information at top of all messages
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
536 # sent by roundup
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
537 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
538 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
539 add_authorinfo = yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
540
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
541 # Add the mail address of the author to the author information at
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
542 # the top of all messages.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
543 # If this is false but add_authorinfo is true, only the name
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
544 # of the actor is added which protects the mail address of the
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
545 # actor from being exposed at mail archives, etc.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
546 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
547 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
548 add_authoremail = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
549
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
550 # Roundup Mail Gateway options
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
551 [mailgw]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
552
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
553 # Keep email citations when accepting messages.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
554 # Setting this to "no" strips out "quoted" text
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
555 # from the message. Setting this to "new" keeps quoted
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
556 # text only if a new issue is being created.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
557 # Signatures are also stripped.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
558 # Allowed values: yes, no, new
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
559 # Default: yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
560 keep_quoted_text = yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
561
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
562 # Setting this to "yes" preserves the email body
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
563 # as is - that is, keep the citations _and_ signatures.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
564 # Setting this to "new" keeps the body only if we are
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
565 # creating a new issue.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
566 # Allowed values: yes, no, new
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
567 # Default: no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
568 leave_body_unchanged = no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
569
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
570 # Default class to use in the mailgw
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
571 # if one isn't supplied in email subjects.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
572 # To disable, leave the value blank.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
573 # Default: issue
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
574 default_class = issue
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
575
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
576 # Default locale name for the tracker mail gateway.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
577 # If this option is not set, mail gateway will use
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
578 # the language of the tracker instance.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
579 # Default:
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
580 language =
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
581
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
582 # Controls the parsing of the [prefix] on subject
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
583 # lines in incoming emails. "strict" will return an
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
584 # error to the sender if the [prefix] is not recognised.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
585 # "loose" will attempt to parse the [prefix] but just
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
586 # pass it through as part of the issue title if not
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
587 # recognised. "none" will always pass any [prefix]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
588 # through as part of the issue title.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
589 # Default: strict
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
590 subject_prefix_parsing = loose
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
591
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
592 # Controls the parsing of the [suffix] on subject
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
593 # lines in incoming emails. "strict" will return an
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
594 # error to the sender if the [suffix] is not recognised.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
595 # "loose" will attempt to parse the [suffix] but just
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
596 # pass it through as part of the issue title if not
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
597 # recognised. "none" will always pass any [suffix]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
598 # through as part of the issue title.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
599 # Default: strict
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
600 subject_suffix_parsing = loose
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
601
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
602 # Defines the brackets used for delimiting the prefix and
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
603 # suffix in a subject line. The presence of "suffix" in
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
604 # the config option name is a historical artifact and may
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
605 # be ignored.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
606 # Default: []
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
607 subject_suffix_delimiters = []
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
608
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
609 # Controls matching of the incoming email subject line
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
610 # against issue titles in the case where there is no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
611 # designator [prefix]. "never" turns off matching.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
612 # "creation + interval" or "activity + interval"
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
613 # will match an issue for the interval after the issue's
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
614 # creation or last activity. The interval is a standard
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
615 # Roundup interval.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
616 # Default: always
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
617 subject_content_match = always
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
618
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
619 # Update issue title if incoming subject of email is different.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
620 # Setting this to "no" will ignore the title part of the subject
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
621 # of incoming email messages.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
622 #
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
623 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
624 # Default: yes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
625 subject_updates_title = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
626
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
627 # Regular expression matching a single reply or forward
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
628 # prefix prepended by the mailer. This is explicitly
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
629 # stripped from the subject during parsing.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
630 # Value is Python Regular Expression (UTF8-encoded).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
631 # Default: (\s*\W?\s*(fw|fwd|re|aw|sv|ang)\W)+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
632 refwd_re = (\s*\W?\s*(fw|fwd|re|aw|sv|ang)\W)+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
633
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
634 # Regular expression matching start of an original message
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
635 # if quoted the in body.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
636 # Value is Python Regular Expression (UTF8-encoded).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
637 # Default: ^[>|\s]*-----\s?Original Message\s?-----$
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
638 origmsg_re = ^[>|\s]*-----\s?Original Message\s?-----$
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
639
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
640 # Regular expression matching the start of a signature
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
641 # in the message body.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
642 # Value is Python Regular Expression (UTF8-encoded).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
643 # Default: ^[>|\s]*-- ?$
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
644 sign_re = ^[>|\s]*-- ?$
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
645
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
646 # Regular expression matching end of line.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
647 # Value is Python Regular Expression (UTF8-encoded).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
648 # Default: [\r\n]+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
649 eol_re = [\r\n]+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
650
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
651 # Regular expression matching a blank line.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
652 # Value is Python Regular Expression (UTF8-encoded).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
653 # Default: [\r\n]+\s*[\r\n]+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
654 blankline_re = [\r\n]+\s*[\r\n]+
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
655
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
656 # Unpack attached messages (encoded as message/rfc822 in MIME)
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
657 # as multiple parts attached as files to the issue, if not
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
658 # set we handle message/rfc822 attachments as a single file.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
659 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
660 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
661 unpack_rfc822 = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
662
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
663 # When parsing incoming mails, roundup uses the first
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
664 # text/plain part it finds. If this part is inside a
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
665 # multipart/alternative, and this option is set, all other
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
666 # parts of the multipart/alternative are ignored. The default
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
667 # is to keep all parts and attach them to the issue.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
668 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
669 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
670 ignore_alternatives = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
671
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
672 # When handling emails ignore the Resent-From:-header
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
673 # and use the original senders From:-header instead.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
674 # (This might be desirable in some situations where a moderator
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
675 # reads incoming messages first before bouncing them to Roundup)
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
676 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
677 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
678 keep_real_from = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
679
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
680 # OpenPGP mail processing options
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
681 [pgp]
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
682
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
683 # Enable PGP processing. Requires pyme. If you're planning
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
684 # to send encrypted PGP mail to the tracker, you should also
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
685 # enable the encrypt-option below, otherwise mail received
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
686 # encrypted might be sent unencrypted to another user.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
687 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
688 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
689 enable = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
690
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
691 # If specified, a comma-separated list of roles to perform
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
692 # PGP processing on. If not specified, it happens for all
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
693 # users. Note that received PGP messages (signed and/or
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
694 # encrypted) will be processed with PGP even if the user
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
695 # doesn't have one of the PGP roles, you can use this to make
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
696 # PGP processing completely optional by defining a role here
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
697 # and not assigning any users to that role.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
698 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
699 roles =
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
700
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
701 # Location of PGP directory. Defaults to $HOME/.gnupg if
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
702 # not specified.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
703 # Default:
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
704 homedir =
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
705
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
706 # Enable PGP encryption. All outgoing mails are encrypted.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
707 # This requires that keys for all users (with one of the gpg
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
708 # roles above or all users if empty) are available. Note that
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
709 # it makes sense to educate users to also send mails encrypted
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
710 # to the tracker, to enforce this, set 'require_incoming'
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
711 # option below (but see the note).
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
712 # Allowed values: yes, no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
713 # Default: no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
714 encrypt = no
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
715
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
716 # Require that pgp messages received by roundup are either
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
717 # 'signed', 'encrypted' or 'both'. If encryption is required
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
718 # we do not return the message (in clear) to the user but just
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
719 # send an informational message that the message was rejected.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
720 # Note that this still presents known-plaintext to an attacker
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
721 # when the users sends the mail a second time with encryption
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
722 # turned on.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
723 # Default: signed
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
724 require_incoming = signed
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
725
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
726 # Nosy messages sending
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
727 [nosy]
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
728
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
729 # Send nosy messages to the author of the message.
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
730 # Allowed values: yes, no, new, nosy -- if yes, messages
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
731 # are sent to the author even if not on the nosy list, same
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
732 # for new (but only for new messages). When set to nosy,
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
733 # the nosy list controls sending messages to the author.
4024
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
734 # Default: no
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
735 messages_to_author = yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
736
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
737 # Where to place the email signature.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
738 # Allowed values: top, bottom, none
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
739 # Default: bottom
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
740 signature_position = bottom
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
741
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
742 # Does the author of a message get placed on the nosy list
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
743 # automatically? If 'new' is used, then the author will
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
744 # only be added when a message creates a new issue.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
745 # If 'yes', then the author will be added on followups too.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
746 # If 'no', they're never added to the nosy.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
747 #
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
748 # Allowed values: yes, no, new
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
749 # Default: new
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
750 add_author = yes
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
751
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
752 # Do the recipients (To:, Cc:) of a message get placed on the
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
753 # nosy list? If 'new' is used, then the recipients will
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
754 # only be added when a message creates a new issue.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
755 # If 'yes', then the recipients will be added on followups too.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
756 # If 'no', they're never added to the nosy.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
757 #
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
758 # Allowed values: yes, no, new
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
759 # Default: new
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
760 add_recipients = new
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
761
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
762 # Controls the email sending from the nosy reactor. If
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
763 # "multiple" then a separate email is sent to each
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
764 # recipient. If "single" then a single email is sent with
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
765 # each recipient as a CC address.
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
766 # Default: single
c2d0d3e9099d svn repository setup
Stefan Seefeld <stefan@users.sourceforge.net>
parents:
diff changeset
767 email_sending = multiple
5290
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
768
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
769 # Attachments larger than the given number of bytes
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
770 # won't be attached to nosy mails. They will be replaced by
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
771 # a link to the tracker's download page for the file.
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
772 # Default: 9223372036854775807
33e1cf136f1d Updated with new config settings and updated docs.
John Rouillard <rouilj@ieee.org>
parents: 4024
diff changeset
773 max_attachment_size = 9223372036854775807
Roundup Issue Tracker: http://roundup-tracker.org/