Skip to content

Commit 905ecfc

Browse files
committed
6.2.57b.2: sympa.conf(5) and list_config(5) were moved to sympa_config(5).
1 parent 0cf9b84 commit 905ecfc

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+262
-262
lines changed

manual/admin/list-creation.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -271,7 +271,7 @@ For more details on tt2 customization, templates path and so on, see "[Templates
271271
Using [`edit_list.conf`](/gpldoc/man/edit_list.conf.5.html),
272272
you can define privileges on the following lists parameters:
273273

274-
- All the lists config parameters ([those used in the config file](/gpldoc/man/list_config.5.html)),
274+
- All the lists config parameters ([those used in the config file](/gpldoc/man/sympa_config.5.html)),
275275

276276
- Any file used in list context and likely to be edited through the web interface:
277277

manual/admin/list-members.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -18,17 +18,17 @@ We'll first describe the standard way for Sympa to handle list members and owner
1818

1919
List members are often named *subscribers* because the default way to become member of a list is to subscribe to it. The subscription action can be performed via any of the three Sympa user interface : mail, web or SOAP. The mail command for subscribing is *SUBSCRIBE,* see ~~[user_commands](../mail-commands.md#user_commands)~~. Subscription feature is available from the list homepage on the web interface, but it requires prior user authentication.
2020

21-
The configuration of a list may restrict the right to subscribe to this list (closed, moderated, restricted to certain user categories,...) ; this is configured via [the subscribe list parameter](/gpldoc/man/list_config.5.html#subscribe). [A similar list configuration parameter](/gpldoc/man/list_config.5.html#unsubscribe) defines if list members can unsubscribe from the list. If the subscription process is moderated, then list owners will receive mail notifications for each subscription request; they can then validate the request via either web or mail interfaces of Sympa.
21+
The configuration of a list may restrict the right to subscribe to this list (closed, moderated, restricted to certain user categories,...) ; this is configured via [the subscribe list parameter](/gpldoc/man/sympa_config.5.html#subscribe). [A similar list configuration parameter](/gpldoc/man/sympa_config.5.html#unsubscribe) defines if list members can unsubscribe from the list. If the subscription process is moderated, then list owners will receive mail notifications for each subscription request; they can then validate the request via either web or mail interfaces of Sympa.
2222

23-
List owners can also add list members, though this feature should be used with care since users can easily confuse this with spam. It is easier for a subscriber to unsubscribe if (s)he did subscribe himself. List owners can use the ~~[ADD](../mail-commands.md#owner_commands)~~ mail command or the web interface to add new list members. The default right to add and remove list members is provided to list owners, but this behavior can be customized through the [add](/gpldoc/man/list_config.5.html#add) and [del](/gpldoc/man/list_config.5.html#del) list configuration parameters.
23+
List owners can also add list members, though this feature should be used with care since users can easily confuse this with spam. It is easier for a subscriber to unsubscribe if (s)he did subscribe himself. List owners can use the ~~[ADD](../mail-commands.md#owner_commands)~~ mail command or the web interface to add new list members. The default right to add and remove list members is provided to list owners, but this behavior can be customized through the [add](/gpldoc/man/sympa_config.5.html#add) and [del](/gpldoc/man/sympa_config.5.html#del) list configuration parameters.
2424

2525
Sympa stores the list membership data in its database, in the [`subscriber_table` table](/gpldoc/man/sympa_database.5.html#subscriber_table). Along with the list name and member email addresses, Sympa stores the following informations: user name, date of subscription, date of latest update, visibility option, reception option, selected topics, bouncing informations.
2626

2727
### Declaring list owners or moderators
2828

29-
A list owner is assigned to a list at the list creation time ; it corresponds to the user who requests the list creation. Additional list owners can later be addded by existing list owners or by the listmaster; this is achieved through the list admin web interface. List owners are defined by the [owner list configuration parameter](/gpldoc/man/list_config.5.html#owner).
29+
A list owner is assigned to a list at the list creation time ; it corresponds to the user who requests the list creation. Additional list owners can later be addded by existing list owners or by the listmaster; this is achieved through the list admin web interface. List owners are defined by the [owner list configuration parameter](/gpldoc/man/sympa_config.5.html#owner).
3030

31-
List moderators are managed the same way, defined by the [`editor` list configuration parameter](/gpldoc/man/list_config.5.html#editor). Note that if no list moderator is defined, then the list owners are taken as defaults for them.
31+
List moderators are managed the same way, defined by the [`editor` list configuration parameter](/gpldoc/man/sympa_config.5.html#editor). Note that if no list moderator is defined, then the list owners are taken as defaults for them.
3232

3333
Sympa defines two profiles for list owners: normal and privileged. Privileged owners have extended privileges, including the right to edit some list configuration parameters; this can be customized through the [`edit_list.conf`](/gpldoc/man/edit_list.conf.5.html) configuration file.
3434
See also "[List editing](list-creation.md#list-editing)".

manual/customize.md

+32-32
Original file line numberDiff line numberDiff line change
@@ -42,38 +42,38 @@ To manage these features, listmaster privileges and/or console login are
4242
needed.
4343

4444
* Receiving
45-
[🔧](/gpldoc/man/sympa.conf.5.html#receiving)
45+
[🔧](/gpldoc/man/sympa_config.5.html#receiving)
4646
* Sending related
47-
[🔧](/gpldoc/man/sympa.conf.5.html#sending-related)
47+
[🔧](/gpldoc/man/sympa_config.5.html#sending-related)
4848
[⚙](/gpldoc/man/nrcpt_by_domain.conf.5.html# "nrcpt_by_domain.conf")
4949
* Privileges
50-
[🔧](/gpldoc/man/sympa.conf.5.html#privileges)
50+
[🔧](/gpldoc/man/sympa_config.5.html#privileges)
5151
[⚙](/gpldoc/man/edit_list.conf.5.html# "edit_list.conf")
5252
* [Archives](customize/archives.md)
53-
[🔧](/gpldoc/man/sympa.conf.5.html#archives)
53+
[🔧](/gpldoc/man/sympa_config.5.html#archives)
5454
[⚙](/gpldoc/man/mhonarc-ressources.tt2.5.html# "mhonarc-ressources.tt2")
5555
* [Bounce management](customize/bounce-management.md)
56-
[🔧](/gpldoc/man/sympa.conf.5.html#bounce-management-and-tracking)
56+
[🔧](/gpldoc/man/sympa_config.5.html#bounce-management-and-tracking)
5757
* Loop prevention
58-
[🔧](/gpldoc/man/sympa.conf.5.html#loop-prevention)
58+
[🔧](/gpldoc/man/sympa_config.5.html#loop-prevention)
5959
* [Automatic list creation](customize/automatic-lists.md)
60-
[🔧](/gpldoc/man/sympa.conf.5.html#automatic-lists)
60+
[🔧](/gpldoc/man/sympa_config.5.html#automatic-lists)
6161
* Tag based spam filtering
62-
[🔧](/gpldoc/man/sympa.conf.5.html#tag-based-spam-filtering)
62+
[🔧](/gpldoc/man/sympa_config.5.html#tag-based-spam-filtering)
6363
* Directories
64-
[🔧](/gpldoc/man/sympa.conf.5.html#directories)
64+
[🔧](/gpldoc/man/sympa_config.5.html#directories)
6565
* Miscellaneous
66-
[🔧](/gpldoc/man/sympa.conf.5.html#miscellaneous)
66+
[🔧](/gpldoc/man/sympa_config.5.html#miscellaneous)
6767
* Others
6868

6969
- [Custom list parameters](customize/custom-parameters.md)
70-
[🔧](/gpldoc/man/list_config.5.html#custom_vars)
70+
[🔧](/gpldoc/man/sympa_config.5.html#custom_vars)
7171
- [Custom user attributes](customize/custom-user-attributes.md)
72-
[🔧](/gpldoc/man/list_config.5.html#custom_attribute)
72+
[🔧](/gpldoc/man/sympa_config.5.html#custom_attribute)
7373

7474
- Custom user attributes in database
75-
[🔧](/gpldoc/man/sympa.conf.5.html#db_additional_subscriber_fields)
76-
[🔧](/gpldoc/man/sympa.conf.5.html#db_additional_user_fields)
75+
[🔧](/gpldoc/man/sympa_config.5.html#db_additional_subscriber_fields)
76+
[🔧](/gpldoc/man/sympa_config.5.html#db_additional_user_fields)
7777

7878
Customizing web interface
7979
--------------------------
@@ -82,37 +82,37 @@ To manage these features, listmaster privileges and/or console login are
8282
needed.
8383

8484
* Appearances
85-
[🔧](/gpldoc/man/sympa.conf.5.html#web-interface-parameters-appearances)
85+
[🔧](/gpldoc/man/sympa_config.5.html#web-interface-parameters-appearances)
8686
* [Authentication on web interface](customize/authentication-web.md)
8787
[⚙](/gpldoc/man/auth.conf.5.html# "auth.conf")
8888
* Session and cookie
89-
[🔧](/gpldoc/man/sympa.conf.5.html#cookie_domain)
89+
[🔧](/gpldoc/man/sympa_config.5.html#cookie_domain)
9090
* ~~[Shared document repository](customize/shared-repository.md)~~
91-
[🔧](/gpldoc/man/sympa.conf.5.html#default_shared_quota)
91+
[🔧](/gpldoc/man/sympa_config.5.html#default_shared_quota)
9292
(Work in progress)
9393
* ~~[Web mailer](customize/web-mailer.md)~~
94-
[🔧](/gpldoc/man/sympa.conf.5.html#use_html_editor)
94+
[🔧](/gpldoc/man/sympa_config.5.html#use_html_editor)
9595
(Work in progress)
9696
* [Password](customize/builtin-auth.md)
9797
[⚙](/gpldoc/man/auth.conf.5.html#user_table-paragraph "auth.conf")
98-
[🔧](/gpldoc/man/sympa.conf.5.html#max_wrong_password)
98+
[🔧](/gpldoc/man/sympa_config.5.html#max_wrong_password)
9999
[📦](http://search.cpan.org/dist/Crypt-Eksblowfish/)
100100
* Miscellaneous
101-
[🔧](/gpldoc/man/sympa.conf.5.html#web-interface-parameters-miscellaneous)
101+
[🔧](/gpldoc/man/sympa_config.5.html#web-interface-parameters-miscellaneous)
102102

103103
- One time ticket
104-
[🔧](/gpldoc/man/sympa.conf.5.html#one_time_ticket_lifetime)
104+
[🔧](/gpldoc/man/sympa_config.5.html#one_time_ticket_lifetime)
105105
- Pictures
106-
[🔧](/gpldoc/man/sympa.conf.5.html#pictures_feature)
106+
[🔧](/gpldoc/man/sympa_config.5.html#pictures_feature)
107107
- Protection against spam harvesters
108-
[🔧](/gpldoc/man/sympa.conf.5.html#spam_protection)
108+
[🔧](/gpldoc/man/sympa_config.5.html#spam_protection)
109109
[⚙](/gpldoc/man/crawlers_detection.conf.5.html# "crawlers_detection.conf")
110110

111111
* [Message tracking](customize/message-tracking.md)
112-
[🔧](/gpldoc/man/sympa.conf.5.html#bounce-management-and-tracking)
112+
[🔧](/gpldoc/man/sympa_config.5.html#bounce-management-and-tracking)
113113
* [RSS feed](customize/rss-feed.md)
114114
* [User-friendly automatic lists](customize/friendly-automatic-lists.md)
115-
[🔧](/gpldoc/man/sympa.conf.5.html#automatic_list_families)
115+
[🔧](/gpldoc/man/sympa_config.5.html#automatic_list_families)
116116
[⚙](/gpldoc/man/automatic_lists_description.conf.5.html# "automatic_lists_description.conf")
117117

118118
Sympa services: Optional features
@@ -122,11 +122,11 @@ These features need installation of additional software components including
122122
external Perl modules.
123123

124124
* [S/MIME](customize/smime.md)
125-
[🔧](/gpldoc/man/sympa.conf.5.html#s-mime-and-tls)
125+
[🔧](/gpldoc/man/sympa_config.5.html#s-mime-and-tls)
126126
[📦](https://metacpan.org/release/Crypt-OpenSSL-X509 "Crypt-OpenSSL-X509")
127127
[📦](https://metacpan.org/release/Crypt-SMIME "Crypt-SMIME")
128128
* [Data sources](customize/data-sources.md)
129-
[🔧](/gpldoc/man/list_config.5.html#data-sources-setup)
129+
[🔧](/gpldoc/man/sympa_config.5.html#data-sources-setup)
130130
[📦](https://metacpan.org/release/DBD-CSV "DBD-CSV")
131131
[📦](https://metacpan.org/release/DBD-mysql "DBD-mysql")
132132
[📦](https://metacpan.org/release/DBD-ODBC "DBD-ODBC")
@@ -136,10 +136,10 @@ external Perl modules.
136136
[📦](https://metacpan.org/release/Net-LDAP "Net-LDAP")
137137
[📦](https://metacpan.org/release/IO-Socket-SSL "IO-Socket-SSL")
138138
* [DKIM and ARC](customize/dkim-arc.md)
139-
[🔧](/gpldoc/man/sympa.conf.5.html#dkim-and-arc)
139+
[🔧](/gpldoc/man/sympa_config.5.html#dkim-and-arc)
140140
[📦](https://metacpan.org/release/Mail-DKIM "Mail-DKIM")
141141
* [DMARC protection](customize/dmarc-protection.md)
142-
[🔧](/gpldoc/man/sympa.conf.5.html#dmarc-protection)
142+
[🔧](/gpldoc/man/sympa_config.5.html#dmarc-protection)
143143
[📦](https://metacpan.org/release/Net-DNS "Net-DNS")
144144
* Managing aliases with LDAP
145145
[⚙](/gpldoc/man/ldap_alias_manager.conf.5.html# "ldap_alias_manager.conf")
@@ -148,7 +148,7 @@ external Perl modules.
148148
[📦](https://metacpan.org/release/IO-Socket-SSL "IO-Socket-SSL")
149149
* ~~Managing aliases with RDBMS~~ (currently broken)
150150
* List address verification
151-
[🔧](/gpldoc/man/sympa.conf.5.html#list-address-verification)
151+
[🔧](/gpldoc/man/sympa_config.5.html#list-address-verification)
152152
[📦](https://metacpan.org/release/libnet "libnet")
153153
([📦](https://metacpan.org/pod/Net::SMTP "Net::SMTP"))
154154
* [Antivirus plug-in](customize/antivirus.md)
@@ -170,7 +170,7 @@ external Perl modules.
170170
* [TLS client authentication](customize/tls-client-auth.md)
171171
[📦](https://metacpan.org/release/Crypt-OpenSSL-X509 "Crypt-OpenSSL-X509")
172172
* Password validation
173-
[🔧](/gpldoc/man/sympa.conf.5.html#password-validation)
173+
[🔧](/gpldoc/man/sympa_config.5.html#password-validation)
174174
[📦](https://metacpan.org/release/Data-Password "Data-Password")
175175
* [Authentication with LDAP](customize/ldap-auth.md)
176176
[⚙](/gpldoc/man/auth.conf.5.html#ldap-paragraph "auth.conf")
@@ -180,7 +180,7 @@ external Perl modules.
180180
[⚙](/gpldoc/man/auth.conf.5.html#generic_sso-paragraph "auth.conf")
181181
[📦](http://shibboleth.internet2.edu "Shibboleth SP")
182182
* [SOAP/HTTP API](customize/soap-api.md)
183-
[🔧](/gpldoc/man/sympa.conf.5.html#soap-http-interface)
183+
[🔧](/gpldoc/man/sympa_config.5.html#soap-http-interface)
184184
[⚙](/gpldoc/man/trusted_applications.conf.5.html# "trusted_applications.conf")
185185
[⚙](/gpldoc/man/sympa.wsdl.5.html# "sympa.wsdl")
186186
[📦](https://metacpan.org/release/SOAP-Lite "SOAP-Lite")

manual/customize/antivirus.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ up: ../customize.md#sympa-services-optional-features
66
Antivirus plug-in
77
=================
88

9-
Sympa lets you use an external antivirus solution to check incoming mails. In this case you must set the `antivirus_path` and `antivirus_args` configuration parameters (see "[Antivirus plug-in](/gpldoc/man/sympa.conf.5.html#antivirus-plug-in)"). Sympa supports at least following products:
9+
Sympa lets you use an external antivirus solution to check incoming mails. In this case you must set the `antivirus_path` and `antivirus_args` configuration parameters (see "[Antivirus plug-in](/gpldoc/man/sympa_config.5.html#antivirus-plug-in)"). Sympa supports at least following products:
1010

1111
- McAfee/uvscan
1212
- Fsecure/fsav

manual/customize/archives.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,12 @@ This is probably the most interesting part of the Sympa web archives : you can
1919
restrict access to a list web archives to a certain population (members of the
2020
current list, members of another list, clients in particular IP address ranges,
2121
users defined in an SQL/LDAP base). This fine tuning is defined via the
22-
[`archive.web_access`](/gpldoc/man/list_config.5.html#archive) list parameter. This
22+
[`archive.web_access`](/gpldoc/man/sympa_config.5.html#archive) list parameter. This
2323
parameter refers to the corresponding
2424
[authorization scenario](../costomize/basics-scenarios.md).
2525

2626
Access via mail command (`INDEX` and `GET`) may also be controlled with
27-
[`archive.mail_access`](/gpldoc/man/list_config.5.html#archive) list parameter.
27+
[`archive.mail_access`](/gpldoc/man/sympa_config.5.html#archive) list parameter.
2828

2929
### Search engine
3030

@@ -141,7 +141,7 @@ Archives structure
141141

142142
The web archives are gathered in a common directory
143143
[`$ARCDIR`](../layout.md#arcdir) (location may be customized by the
144-
[`arc_path`](/gpldoc/man/sympa.conf.5.html#arc_path) sympa.conf parameter).
144+
[`arc_path`](/gpldoc/man/sympa_config.5.html#arc_path) sympa.conf parameter).
145145
This directory contains a subdirecty for each archived mailing list.
146146
The list archive directory is structured a subdirectory for each month.
147147
Eath month directory contains both the HTML pages for messages and indexes
@@ -187,7 +187,7 @@ Configuration parameters
187187
* `process_archive`
188188
* `web_archive_spam_protection`
189189

190-
See also "[Archives](/gpldoc/man/list_config.5.html#archives)" section of manpage.
190+
See also "[Archives](/gpldoc/man/sympa_config.5.html#archives)" section of manpage.
191191

192192
`archived.pl` daemon
193193
--------------------
@@ -198,7 +198,7 @@ rebuilding HTML files). This process is running as the `sympa` user; messages
198198
to archive and removal/rebuild commands are fetched from the archive spool
199199
located at [``$SPOOLDIR``](../layout.md#spooldir)``/outgoing`` directory
200200
(location may be customized by
201-
[queueoutgoing](/gpldoc/man/sympa.conf.5.html#queueoutgoing) site parameter).
201+
[queueoutgoing](/gpldoc/man/sympa_config.5.html#queueoutgoing) site parameter).
202202

203203
When it archives the first message ever for a given list, `archived.pl` will
204204
try to create its archive directory. If it can't, it copies the message into a

manual/customize/automatic-lists.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ sympafamily unix - n n - - pipe
6262
flags=R user=sympa argv=$LIBEXECDIR/familyqueue ${user} age-occupation
6363
```
6464

65-
A mail sent to `[email protected]` will be queued to the [``$SPOOLDIR``](../layout.md#spooldir)`/automatic` spool, defined by the `queueautomatic` `sympa.conf` parameter (see [`queueautomatic`](/gpldoc/man/sympa.conf.5.html#queueautomatic)). The mail will first be processed by an instance of the `sympa.pl` process dedicated to automatic list creation, then the mail will be sent to the newly created mailing list.
65+
A mail sent to `[email protected]` will be queued to the [``$SPOOLDIR``](../layout.md#spooldir)`/automatic` spool, defined by the `queueautomatic` `sympa.conf` parameter (see [`queueautomatic`](/gpldoc/man/sympa_config.5.html#queueautomatic)). The mail will first be processed by an instance of the `sympa.pl` process dedicated to automatic list creation, then the mail will be sent to the newly created mailing list.
6666

6767
### The sympa-milter solution (with Postfix or Sendmail)
6868

@@ -257,10 +257,10 @@ Configuring Sympa
257257

258258
Now we need to enable automatic list creation in Sympa. To do so, we have to:
259259

260-
- set the [`automatic_list_feature`](/gpldoc/man/sympa.conf.5.html#automatic_list_feature) parameter to `on` and define who can create automatic lists via the [`automatic_list_creation`](/gpldoc/man/sympa.conf.5.html#automatic_list_creation) (points to an `automatic_list_creation` scenario);
260+
- set the [`automatic_list_feature`](/gpldoc/man/sympa_config.5.html#automatic_list_feature) parameter to `on` and define who can create automatic lists via the [`automatic_list_creation`](/gpldoc/man/sympa_config.5.html#automatic_list_creation) (points to an `automatic_list_creation` scenario);
261261
- set the `queueautomatic` `sympa.conf` parameter to the spool location where we want these messages to be stored (it has to be different from the [``$SPOOLDIR``](../layout.md#spooldir)`/msg` spool).
262262

263-
You can make Sympa delete automatic lists that were created with zero list members; to do so, you should set the [`automatic_list_removal`](/gpldoc/man/sympa.conf.5.html#automatic_list_removal) parameter to `if_empty`.
263+
You can make Sympa delete automatic lists that were created with zero list members; to do so, you should set the [`automatic_list_removal`](/gpldoc/man/sympa_config.5.html#automatic_list_removal) parameter to `if_empty`.
264264

265265
[``sympa.conf``](../layout.md#config)
266266
``` code

0 commit comments

Comments
 (0)