Mercurial > p > roundup > code

annotate website/issues/config.ini @ 8010:c10df5dfed95 2.4.0b1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Removed tag 2.4.1b1
author John Rouillard <rouilj@ieee.org>
date Mon, 27 May 2024 17:01:45 -0400
parents b0f9266e4ba2
children
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
6309
b0f9266e4ba2 Change output to html4.
John Rouillard <rouilj@ieee.org>
parents: 5612
diff changeset
84 html_version = html4
4024
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
5612
da2decb6d0c7 update http://issues.roundup-tracker.org to https://isues.... for the
John Rouillard <rouilj@ieee.org>
parents: 5494
diff changeset
162 web = https://issues.roundup-tracker.org/
4024
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
5494
b7fa56ced601 use gpg module instead of pyme module for PGP encryption
Christof Meerwald <cmeerw@cmeerw.org>
parents: 5296
diff changeset
683 # Enable PGP processing. Requires gpg. If you're planning
5290
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/