[Savannah-cvs] administration/docs/hacking_savannah hacking_sa...

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        04/12/03 20:09:15

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Added ML naming policy, updated ml.pl usage, and renamed "Mailman" 
chapter to "mailing lists"

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/administration/administration/docs/hacking_savannah/hacking_savannah.texi.diff?tr1=1.76&tr2=1.77&r1=text&r2=text

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.76 
administration/docs/hacking_savannah/hacking_savannah.texi:1.77
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.76     Wed Nov 
17 23:51:04 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Fri Dec  3 
20:09:14 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.76 2004/11/17 23:51:04 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.77 2004/12/03 20:09:14 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -59,7 +59,7 @@
 * Team work::                   
 * Savannah configuration::      Savannah configuration in-depth description.
 * Using MySQL::                 
-* Mailman Administration::      Mailman command line tips.
+* Mailing lists administration::  
 * Some Savannah tasks::         Frequent administration tasks.
 * Frequent support requests::   How to answer common support requests.
 * Some quirks::                 To clear up sooner or later.
@@ -1435,7 +1435,7 @@
 # edit sv_users and replace mkdir($home) by 'mkdir -p $home`
 
 
address@hidden Using MySQL, Mailman Administration, Savannah configuration, Top
address@hidden Using MySQL, Mailing lists administration, Savannah 
configuration, Top
 @chapter Using MySQL
 
 This chapter is about MySQL: its configuration, and how to perform
@@ -1495,16 +1495,17 @@
 
 
 
address@hidden Mailman Administration, Some Savannah tasks, Using MySQL, Top
address@hidden Mailman Administration
address@hidden Mailing lists administration, Some Savannah tasks, Using MySQL, 
Top
address@hidden Mailing lists administration
 
-This chapter details common Mailman administration tasks that need
-to be performed for Savannah projects (GNU and non-GNU).
+This chapter details common administration tasks related to mailing
+lists that need to be performed for Savannah projects (GNU and
+non-GNU).
 
 
 @menu
 * Access to lists.gnu.org::     
-* Creating a new list::         
+* Manually creating a new list::  
 * Testing the list::            
 * Old::                         
 * Moving a list::               
@@ -1512,7 +1513,7 @@
 * Archives policies::           
 @end menu
 
address@hidden Access to lists.gnu.org, Creating a new list, Mailman 
Administration, Mailman Administration
address@hidden Access to lists.gnu.org, Manually creating a new list, Mailing 
lists administration, Mailing lists administration
 @section Access to lists.gnu.org
 
 Some Mailman admin tasks need to be performed on the actual machine
@@ -1534,10 +1535,11 @@
 that are discussed below.
 
 
address@hidden Creating a new list, Testing the list, Access to lists.gnu.org, 
Mailman Administration
address@hidden Creating a new list
address@hidden Manually creating a new list, Testing the list, Access to 
lists.gnu.org, Mailing lists administration
address@hidden Manually ceating a new list
 
-To Create a new mailing list, you first need the following information:
+To create a new mailing list, you first need the following
+information:
 
 @itemize @bullet
 @item The name of the new list (and/or the project it belongs to)
@@ -1548,6 +1550,18 @@
 come from a project administrator on Savannah, use the email address
 attached to their account.
 
+The name of the list should match one of:
+
address@hidden
address@hidden @var{project_name}@@gnu.org
address@hidden @var{project_name}-*@@gnu.org
address@hidden address@hidden@@gnu.org
address@hidden address@hidden@@gnu.org
address@hidden address@hidden@@gnu.org
address@hidden @var{project_name}@@nongnu.org
address@hidden @var{project_name}-*@@nongnu.org
address@hidden itemize
+
 To actually create the list, run the following commands from the shell:
 
 @example
@@ -1562,11 +1576,12 @@
 There is a script in ~/Beuc which is rather crappy and hence
 unofficial. Use it with care.
 @example
-$ perl ml.pl @var{group_name} @var{admin_name} @var{list_name} | mysql savannah
+$ perl ml.pl -g @var{group_name} -a @var{admin_name} -l @var{list_name} | 
mysql savannah
 @end example
 @var{ml_name} does not contain the domain name.
 
address@hidden Testing the list, Old, Creating a new list, Mailman 
Administration
+
address@hidden Testing the list, Old, Manually creating a new list, Mailing 
lists administration
 @section Testing the list
 
 @example
@@ -1595,7 +1610,7 @@
 TODO: write some script?
 
 
address@hidden Old, Moving a list, Testing the list, Mailman Administration
address@hidden Old, Moving a list, Testing the list, Mailing lists 
administration
 @section Old
 
 The following is what we did before the script, ie what the script
@@ -1678,7 +1693,7 @@
 And that's it.
 
 
address@hidden Moving a list, Resetting a password, Old, Mailman Administration
address@hidden Moving a list, Resetting a password, Old, Mailing lists 
administration
 @section Moving a list
 
 [TODO]
@@ -1700,7 +1715,7 @@
 @end itemize
 
 
address@hidden Resetting a password, Archives policies, Moving a list, Mailman 
Administration
address@hidden Resetting a password, Archives policies, Moving a list, Mailing 
lists administration
 @section Resetting a password
 
 There are two ways, the manual way, and the automated way. Whatever
@@ -1722,7 +1737,7 @@
 That's all :)
 
 
address@hidden Archives policies,  , Resetting a password, Mailman 
Administration
address@hidden Archives policies,  , Resetting a password, Mailing lists 
administration
 @section Archives policies
 
 [TODO]
@@ -1748,7 +1763,7 @@
 @end quotation
 
 
address@hidden Some Savannah tasks, Frequent support requests, Mailman 
Administration, Top
address@hidden Some Savannah tasks, Frequent support requests, Mailing lists 
administration, Top
 @chapter Some Savannah tasks