Developers of Sympa

[David Verdin <address@concealed>]

Hi Soji,

Thank you very much for this compilation!

Le 11/11/13 07:47, IKEDA Soji a écrit :

address@concealed"> Hi all,

I compiled David's advice and subsequent comments into single tree.

• Paths indicated by strike-through are proposed/suggested to be removed or moved to other place.  These changes are not necessarily agreed by now.
  
• See notes at bottom for details.
  (I added more notes: [0.1], [1], [5].)
  

TOP
|-- several files to be read: AUTHORS, COPYING, ChangeLog, INSTALL, NEWS, README, README.charset, sympa.generic, sympa.in^{[note 0 SI]},  logrotate^{[note 0.1 SI]}, README.postfix^{[note 1 SI]}
|-- some scripts: important_changes.pl, sympa.spec.in, tap-driver.sh
|-- doc/: doc
|-- ext/: external modules
|-- t/: tests
|-- po/: localization
|   |-- user_interface/ -> sympa/: uesr interface localization.^{[note 2 SI]}
|   `-- web_help/: web help localization
|-- default/ -> default_src/: configuration and templates defaults
|   |-- create_list_templates/
|   |-- families/<sup>[note 3 DV]</sup>
|   |-- global_task_models/
|   |-- list_task_models/
|   |-- scenari/
|   |-- templates/: mail templates
|   |   |-- mail/: mail templates
|   |   `-- web/: web templates
|   |-- auth.conf
|   |-- ca-bundle.crt
|   |-- charset.conf
|   |-- crawlers_detection.conf
|   |-- create_list.conf
|   |-- edit_list.conf
|   |-- ldap_alias_entry.tt2
|   |-- ldap_alias_manager.conf
|   |-- list_aliases.tt2.in
|   |-- mime.types
|   |-- mhonarc-ressources.tt2
|   |-- nrcpt_by_domain.conf
|   |-- sympa.wsdl
|   `-- topics.conf
|-- www/: static files needed for the web
|   |-- Makefile.am
|   |-- icons/
|   `-- js/
|-- samples/: static files needed for the web
|   |-- families/
|   `-- sampleClient.php
`-- src/: source code. ^{[note 4 SI]}
    |-- README.postfix ^{[note 1 SI]}
    |-- script/: ponctual usage scripts
    |   |-- arc2webarc.pl.in
    |   |-- arcrepair.pl
    |   |-- create_db.Oracle
    |   |-- create_db.Pg
    |   |-- create_db.SQLite
    |   |-- create_db.Sybase
    |   |-- create_db.mysql
    |   |-- crypt_passwd.pl.in
    |   |-- find_missing_messages.pl
    |   |-- init_comment.pl.in
    |   |-- ldap_alias_manager.pl.in ^{[note 7 SI]}
    |   |-- logrotate ^{[note 0.1 SI]}
    |   |-- mod2html.pl.in
    |   |-- mysql_alias_manager.pl.in ^{[note 7 SI]}
    |   |-- p12topem.pl.in
    |   |-- sympa.generic ^{[note 0 SI]}
    |   |-- sympa.in ^{[note 0 SI]}
    |   |-- sympa_soap_client.pl.in
    |   |-- testldap.pl.in
    |   |-- testlogs.pl.in
    |   `-- tpl2tt2.pl.in
    |-- cgi/: daemons that run under a web server
    |   |-- web/: web daemon and associated files. <sup>[note 6 SI]</sup>
    |   |  |-- INSTALL <sup>[note 5 SI]</sup>
    |   |  |-- Makefile.am
    |   |  |-- README <sup>[note 5 SI]</sup>
    |   |  |-- wwsympa-wrapper.fcgi.c
    |   |  `-- wwsympa.fcgi.in
    |   `-- soap/: the SOAP server and associated files. <sup>[note 6 SI]</sup>
    |      |-- Makefile.am
    |      |-- sympa_soap_server-wrapper.fcgi.c
    |     `-- sympa_soap_server.fcgi.in
    |-- lib/: all modules (.pm files) in the Sympa namespace
    |   |-- Makefile.am
    |   `-- Sympa
    `-- sbin/: all excutable files needed for daily Sympa functionning (daemons and queue programs).
       |-- Makefile.am
       |-- alias_manager.pl.in ^{[note 7 SI]}
       |-- aliaswrapper.c ^{[note 7 SI]}
       |-- archived.pl.in
       |-- bounced.pl.in
       |-- bouncequeue.c ^{[note 7 SI]}
       |-- bulk.pl.in
       |-- familyqueue.c ^{[note 7 SI]}
       |-- queue.c ^{[note 7 SI]}
       |-- sympa.pl.in
       |-- sympa_wizard.pl.in ^{[note 8 DV]}
       |-- task_manager.pl.in
       `-- virtualwrapper.c ^{[note 7 SI]}

  libexec/ [note 7 SI]
      |-- alias_manager.pl.in
      |-- ldap_alias_manager.pl.in
      |-- mysql_alias_manager.pl.in
      |-- aliaswrapper.c
      |-- bouncequeue.c
      |-- familyqueue.c
      |-- queue.c
      `-- virtualwrapper.c

[0] [SI] sympa.generic and sympa.in may be moved to top level.

OK

address@concealed">

[0.1] [SI] And also logrotate may be moved to top level.

OK

address@concealed">

[1] [SI] README.postfix, currently placed under src/, would also be here.

OK

address@concealed">

[2] [SI] Use gettext domain names.

I don't understand this note. Would you please explain it?

address@concealed">

[3] [DV] No longer exists.

OK

address@concealed">

[4] [SI] I feel src/ is not needed.

Not sure. I still agree with Guillaume's argumnet: put all the code inside a single directory to facilitate grep and generally speaking, any search in the source code.

address@concealed">

[5] [SI] cgi/INSTALL and cgi/README May be removed or merged into INSTALL and README at toplevel.

OK

address@concealed">

[6] [SI] web/ and soap/ subdirectories would be wwsympa/ and sympa_soap_server/, names of programs.
    However, directories essentially contain only two files by each.  I suppose clarification is less important.

Understood. I feel the same, finally. We can get rid of wwsympa/ and sympa_soap_server: and put their content in a single cgi/ directory.

address@concealed">

[7] [SI] I wish to install wrappers not for CGIs into single place, libexec/, especially concerning setuid'ed excecutables.

OK

address@concealed">

[8] [DV] Maybe sympa_wizard.pl.in should move, the, as it is used at install time only?

OK

address@concealed">
Regards,

--- Soji

--
A bug in Sympa? Quick! To the bug tracker!

David Verdin Études et projets applicatifs
Tél : +33 2 23 23 69 71 Fax : +33 2 23 23 71 21   www.renater.fr	RENATER 263 Avenue du Gal Leclerc 35042 Rennes Cedex

Attachment: smime.p7s
Description: Signature cryptographique S/MIME