The mailing list for listmasters using Sympa

[Olivier Salaün <address@concealed>]

Hi Steven,

As an introduction to this email I provide some background and news 
about the user_data_source list parameter.
In the former days Sympa did not use a RDBMS and subscribers 
informations were stored in flat ''subscribers'' files. We then 
introduced the ability to include members defined in an external data 
source and also the optional use of a RDBMS to store subscribers. 
Therefore we created the 'user_data_source' parameter. We ended up 
merging the 'database' and 'include' features with 'include2'. The goal 
was then to give up the 'user_data_source' parameter and we have almost 
reached this goal. Starting with Sympa 5.3.x the 'include' mode is 
considered a sinonym for 'include2' and more recently we have removed 
the 'file' and 'database' modes in the development version of Sympa. 
This means that in Sympa 5.4 the only supported mode will be 'include2'. 
Note that migration process has been automated.

Steven Peterson a écrit :
> We would like to include the same two moderators in every list in a 
> given robot, and I believe the list parameter editor_include allows 
> for this but I am not sure how it works yet.
>
> 1. To which value do I need to set the user_data_source in order to 
> use an editor_include data_source that has an include_file directive?  
> include or include2
The editor_include and owner_include don't require a special value for 
the user_data_source. The reason is that it was introduced in Sympa 
after 'include2' was defined as the default mode.
> o  When talking about data_sources, the manual seems to say that for 
> any data_source to use the include_file directive, the 
> user_data_source value for the robot must be set to 'include'
>    http://www.sympa.org/wiki/manual/parameters-data-sources#include_file
This page was not uptodate ; I've fixed it.
Sorry about this mistake ; the behavior around user_data_source has 
evolved quite a lot in Sympa along the versions.
> o  But when the manual is talking about data_includes in list 
> configuration, it seems to say the user_data_source must be set to 
> 'include2'
>    http://www.sympa.org/wiki/manual/list-definition#data_inclusion_file
>
> 2. If I use a local file path to the include_file parameter 
> (editors.txt below), where is the path relative to (the data_sources 
> directory?)
I've fixed the sentence.
> 3. Is the below configuration correct?
>
> robot.conf has:
>  user_data_source include2
You can't set the 'user_data_source' parameter in a robot.conf or 
sympa.conf. It is a list configuration parameter ; it should be set in 
the list 'config' file manually or via the web interface.
> config file for list has:
>  editor_include
>  reception mail
>  source editorfile
>
> data_sources/editorfile:
Wrong ; the file should be 'data_sources/editorfile_*.incl*_'
>  include_file ./editors.txt
You should use an absolute file path because the sympa processes perform 
chdir() 
> editors.txt:
>  address@concealed Joe Blow
>  address@concealed  Jane Doe
Correct.

I've completed the example provided in 
https://www.sympa.org/wiki/manual/list-definition#data_inclusion_file to 
provide complete file path.