comparison doc/upgrading.txt @ 7064:3359dc1dabb0

Add OAuth authentication to the mailgw script Now IMAPS can be used with OAuth as required by several large cloud providers. Move command line processing of the mailgw script to ``argparse``. Note that the command line options of the mailgw have changed, see upgrading.txt for details.
author Ralf Schlatterbeck <rsc@runtux.com>
date Wed, 23 Nov 2022 10:13:48 +0100
parents d3593cbb8e6f
children 849e9b2d6926
comparison
equal deleted inserted replaced
7063:aca710a3b687 7064:3359dc1dabb0
63 63
64 to generate a new ini file preserving all your settings. 64 to generate a new ini file preserving all your settings.
65 You can then merge any local comments from the tracker's 65 You can then merge any local comments from the tracker's
66 ``config.ini`` to ``newconfig.ini`` and replace 66 ``config.ini`` to ``newconfig.ini`` and replace
67 ``config.ini`` with ``newconfig.ini``. 67 ``config.ini`` with ``newconfig.ini``.
68
69 Using the roundup-mailgw script
70 -------------------------------
71
72 In previous versions the roundup-mailgw script had a ``-C`` (or
73 ``--class``) option for specifying a class to be used with ``-S`` (or
74 ``--set``) option(s). In the latest version the ``-C`` option is gone,
75 the class for this option is specified as a prefix, e.g. instead of ::
76
77 roundup-mailgw -C issue -S issueprop=value
78
79 You now specify ::
80
81 roundup-mailgw -S issue.issueprop=value
82
83 If multiple values need to be set, this can be achieved with multiple
84 ``-S`` options or with delimiting multiple values with a semicolon (in
85 that case the string needs to be quoted because semicolon is a shell
86 special character)::
87
88 roundup-mailgw -S 'issue.issueprop1=value1;issueprop2=value2'
89 roundup-mailgw -S issue.issueprop1=value1 -S issue.issueprop2=value2
90
91 are equivalent. Note that the class is provided as a prefix for the
92 set-string, not for each property. The class can be omitted altogether
93 in which case it defaults to ``msg`` (this default existed in previous
94 versions).
95
96 If you do not use the ``-C`` (or ``--class``) option in your current
97 setup of mailgw you don't need to change anything.
68 98
69 Rdbms version change from 7 to 8 (required) 99 Rdbms version change from 7 to 8 (required)
70 ------------------------------------------- 100 -------------------------------------------
71 101
72 This release includes a change that requires updates to the 102 This release includes a change that requires updates to the

Roundup Issue Tracker: http://roundup-tracker.org/