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

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        04/08/14 14:21:22

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Texinfo clean-up

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

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.26 
administration/docs/hacking_savannah/hacking_savannah.texi:1.27
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.26     Fri Aug 
13 22:23:58 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Sat Aug 14 
14:21:22 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.26 2004/08/13 22:23:58 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.27 2004/08/14 14:21:22 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -81,6 +81,12 @@
 @node Introduction, Communication, Top, Top
 @chapter Introduction
 
address@hidden
+* Savannah.gnu.org::            
+* This manual::                 
address@hidden menu
+
address@hidden Savannah.gnu.org, This manual, Introduction, Introduction
 @section Savannah.gnu.org
 
 @multitable @columnfractions .33 .33 .33
@@ -98,6 +104,7 @@
 
 [TODO: complete this section]
 
address@hidden This manual,  , Savannah.gnu.org, Introduction
 @section This manual
 
 The present documentation aims at teaching new volunteers how to
@@ -117,6 +124,14 @@
 @node Communication, Savannah configuration, Introduction, Top
 @chapter Communication
 
+
address@hidden
+* WWW::                         
+* Mailing lists::               
+* IRC::                         
address@hidden menu
+
address@hidden WWW, Mailing lists, Communication, Communication
 @section WWW
 
 Read the latest news on the Savannah main page, so you know what is
@@ -134,7 +149,17 @@
 Also read Savannah's FAQ.
 
 
address@hidden savannah-hackers@@gnu.org
address@hidden Mailing lists, IRC, WWW, Communication
address@hidden Mailing lists
+
address@hidden
+* savannah-hackers::            
+* savannah-root::               
+* sysadmin::                    
address@hidden menu
+
address@hidden savannah-hackers, savannah-root, Mailing lists, Mailing lists
address@hidden @email{savannah-hackers@@gnu.org}
 
 Savannah hackers is a group of volunteers.
 
@@ -163,7 +188,8 @@
 Savannah a good development platform.
 
 
address@hidden savannah-root@@gnu.org
address@hidden savannah-root, sysadmin, savannah-hackers, Mailing lists
address@hidden @email{savannah-root@@gnu.org}
 
 @uref{http://lists.gnu.org/mailman/listinfo/savannah-root}
 
@@ -178,7 +204,8 @@
 Archives are managed using Mailman and are accessible to list members.
 
 
address@hidden sysadmin@@gnu.org
address@hidden sysadmin,  , savannah-root, Mailing lists
address@hidden @email{sysadmin@@gnu.org}
 
 This sends a message to Paul Fisher (rao) and James E. Blair (corvus),
 who are employees of the FSF working as Sysadmins. It is managed via
@@ -197,6 +224,7 @@
 says Rudy.
 
 
address@hidden IRC,  , Mailing lists, Communication
 @section IRC
 
 Currently, we have a channel, #savannah, on irc.freenode.net for discussion 
@@ -220,6 +248,13 @@
 It is still incomplete.
 
 
address@hidden
+* Some technical information::  
+* Here is how I made [am making] a Savannah test install on my faithful 
PI-133::  
+* Old documentation::           
address@hidden menu
+
address@hidden Some technical information, Here is how I made [am making] a 
Savannah test install on my faithful PI-133, Savannah configuration, Savannah 
configuration
 @section Some technical information
 
 CVS repositories are located at /savannah/cvsroot.
@@ -230,6 +265,7 @@
 Log is /var/log/exim/main/log
 
 
address@hidden Here is how I made [am making] a Savannah test install on my 
faithful PI-133, Old documentation, Some technical information, Savannah 
configuration
 @section Here is how I made [am making] a Savannah test install on my faithful 
PI-133
 
 @verbatim
@@ -333,6 +369,7 @@
 @end verbatim
 
 
address@hidden Old documentation,  , Here is how I made [am making] a Savannah 
test install on my faithful PI-133, Savannah configuration
 @section Old documentation
 
 I came across some documentation of a 2 years-old Savannah setup, which may 
@@ -348,6 +385,11 @@
 This chapter is about MySQL: its configuration, and how to perform
 simple tasks.
 
address@hidden
+* User privileges::             
address@hidden menu
+
address@hidden User privileges,  , MySQL, MySQL
 @section User privileges
 
 There are three principal users in the Savannah MySQL database (the
@@ -404,6 +446,12 @@
 to be performed for Savannah projects (GNU and non-GNU).
 
 
address@hidden
+* Access to lists.gnu.org::     
+* Creating a new list::         
address@hidden menu
+
address@hidden Access to lists.gnu.org, Creating a new list, Mailman 
Administration, Mailman Administration
 @section Access to lists.gnu.org
 
 Some Mailman admin tasks need to be performed on the actual machine
@@ -425,6 +473,7 @@
 that are discussed below.
 
 
address@hidden Creating a new list,  , Access to lists.gnu.org, Mailman 
Administration
 @section Creating a new list
 
 To Create a new mailing list, you first need the following information:
@@ -463,6 +512,13 @@
 @chapter Some Savannah tasks
 
 
address@hidden
+* Adding a Frequently Asked Question::  
+* Manually setting up commit e-mail notification::  
+* Updating the menu::           
address@hidden menu
+
address@hidden Adding a Frequently Asked Question, Manually setting up commit 
e-mail notification, Some Savannah tasks, Some Savannah tasks
 @section Adding a Frequently Asked Question
 
 First, all site-specific content in the savannah project under module
@@ -483,6 +539,7 @@
 commit :)
 
 
address@hidden Manually setting up commit e-mail notification, Updating the 
menu, Adding a Frequently Asked Question, Some Savannah tasks
 @section Manually setting up commit e-mail notification
 
 The infra/ module of the 'savannah' project contains install-log-accum.
@@ -505,7 +562,8 @@
 you'll have to do that by hand.
 
 
address@hidden Updating the menu:
address@hidden Updating the menu,  , Manually setting up commit e-mail 
notification, Some Savannah tasks
address@hidden Updating the menu
 
 Check /savannah/etc/gnu-content/menu.txt and
 /savannah/etc/nongnu-content/menu.txt. There are also other menu*.txt
@@ -528,6 +586,18 @@
 @cindex invoking @command{sample}
 
 
address@hidden
+* Manually change an e-mail ::  
+* Unexpected Savannah password change notifications::  
+* Moving from non-GNU to GNU::  
+* Removing a project group::    
+* Deleting a user account::     
+* Renaming a project group::    
+* Renaming a user account::     
+* Impersonating somebody::      
address@hidden menu
+
address@hidden Manually change an e-mail , Unexpected Savannah password change 
notifications, Frequent support requests, Frequent support requests
 @section Manually change an e-mail 
 
 Bradley Kuhn says:
@@ -618,6 +688,11 @@
 message, that no attacker have an already signed copy of.
 
 
address@hidden
+* Examples::                    
address@hidden menu
+
address@hidden Examples,  , Manually change an e-mail , Manually change an 
e-mail
 @subsection Examples
 
 For the record, he is an appraisal of X's reply:
@@ -646,6 +721,7 @@
 to forge a whole website and domain name to get this Savannah account.
 
 
address@hidden Unexpected Savannah password change notifications, Moving from 
non-GNU to GNU, Manually change an e-mail , Frequent support requests
 @section Unexpected Savannah password change notifications
 
 What should we do when the user reports a password change that was not
@@ -675,6 +751,7 @@
 that the user check whether his account have been untouched.
 
 
address@hidden Moving from non-GNU to GNU, Removing a project group, Unexpected 
Savannah password change notifications, Frequent support requests
 @section Moving from non-GNU to GNU
 
 @verbatim
@@ -703,8 +780,15 @@
 @end verbatim
 
 
address@hidden Removing a project group, Deleting a user account, Moving from 
non-GNU to GNU, Frequent support requests
 @section Removing a project group
 
address@hidden
+* Policies::                    
+* Actually doing it::           
address@hidden menu
+
address@hidden Policies, Actually doing it, Removing a project group, Removing 
a project group
 @subsection Policies
 
 If the request is because the project is hosted elsewhere, keeping it
@@ -725,6 +809,7 @@
 -- 
 Mathieu Roy
 
address@hidden Actually doing it,  , Policies, Removing a project group
 @subsection Actually doing it
 
 Steps to remove a project:
@@ -748,6 +833,7 @@
 @end itemize
 
 
address@hidden Deleting a user account, Renaming a project group, Removing a 
project group, Frequent support requests
 @section Deleting a user account
 
 @enumerate
@@ -756,7 +842,7 @@
 @item @code{DELETE FROM user WHERE user_id=uid;}
 @end enumerate
 
-
address@hidden Renaming a project group, Renaming a user account, Deleting a 
user account, Frequent support requests
 @section Renaming a project group
 
 @code{update groups set unix_group_name="<newname>" where
@@ -802,6 +888,7 @@
 Sylvain
 
 
address@hidden Renaming a user account, Impersonating somebody, Renaming a 
project group, Frequent support requests
 @section Renaming a user account
 
 [We need to define a policy about whether it is OK to rename accounts. Since 
accounts can be removed and then recreated under a different user name, I guess 
it is OK.]
@@ -830,6 +917,7 @@
 associated with each change. Is there a cvs command to do that?
 
 
address@hidden Impersonating somebody,  , Renaming a user account, Frequent 
support requests
 @section Impersonating somebody
 
 Change the savannah password using MySQL.
@@ -842,6 +930,14 @@
 @node Some quirks, Projects approval, Frequent support requests, Top
 @chapter Some quirks
 
address@hidden
+* sshd_config::                 
+* new root /etc/group's::       
+* Uncommited local changes to Savannah's repository::  
+* Web Server Syndication::      
address@hidden menu
+
address@hidden sshd_config, new root /etc/group's, Some quirks, Some quirks
 @section sshd_config
 @verbatim
 On 2004.04.26 16:44, Paul Fisher wrote:
@@ -867,6 +963,7 @@
 @end verbatim
 
 
address@hidden new root /etc/group's, Uncommited local changes to Savannah's 
repository, sshd_config, Some quirks
 @section new root /etc/group's
 
 @verbatim
@@ -878,6 +975,7 @@
 @end verbatim
 
 
address@hidden Uncommited local changes to Savannah's repository, Web Server 
Syndication, new root /etc/group's, Some quirks
 @section Uncommited local changes to Savannah's repository
 
 As of March 6th:
@@ -910,6 +1008,7 @@
 Elfyn plans to make a temporary patchset and upgrade to Savane, Really Soon 
(tm).
 
 
address@hidden Web Server Syndication,  , Uncommited local changes to 
Savannah's repository, Some quirks
 @section Web Server Syndication
 
 Content for pages on www.gnu.org and www.nongnu.org is controlled by
@@ -944,6 +1043,18 @@
 @node Projects approval, Terminology, Some quirks, Top
 @chapter Projects approval
 
address@hidden
+* Prerequisites::               
+* The current situation::       
+* Keeping each other in sync::  
+* Overview of the approval process::  
+* Approval Policies::           
+* GNU projects::                
+* Rudy's Little HOWTO::         
+* Mathieu's Little HOWTO::      
address@hidden menu
+
address@hidden Prerequisites, The current situation, Projects approval, 
Projects approval
 @section Prerequisites
 
 Reviewing projects requires notions of licensing, GNU policies, and
@@ -956,6 +1067,7 @@
 Savannah hackers need in order to properly do their job.
 
 
address@hidden The current situation, Keeping each other in sync, 
Prerequisites, Projects approval
 @section The current situation
 
 Currently, project approvals are underway.
@@ -1000,6 +1112,7 @@
 optimistic, and will be delayed.
 
 
address@hidden Keeping each other in sync, Overview of the approval process, 
The current situation, Projects approval
 @section Keeping each other in sync
 
 We are using the channel #savannah on @uref{irc.freenode.net} to
@@ -1016,6 +1129,7 @@
 Pending'' should be reviewed in priority.
 
 
address@hidden Overview of the approval process, Approval Policies, Keeping 
each other in sync, Projects approval
 @section Overview of the approval process
 
 When a user wants to host a project at Savannah, he clicks on the ``Register 
project'' link in the menu on the left. He is then ask a number of questions, 
including:
@@ -1079,6 +1193,10 @@
 (Note: this is not enabled at the moment, deletion has to be done
 manually if necessary).
 
address@hidden project_name --user="rudy@@fencepost"
+--comment="reason"} should do the Right Thing, but needs to be checked
+for compliance with the chroot'd repositories.
+
 (Note: the ``Delete project'' button in the ``Pending projects'' page
 is deleting the project from te pending list, but not from the system,
 so you had better not use it at the moment).
@@ -1095,6 +1213,7 @@
 architecture.
 
 
address@hidden Approval Policies, GNU projects, Overview of the approval 
process, Projects approval
 @section Approval Policies
 
 Savannah does not host all kinds of software, and not even all kinds
@@ -1104,6 +1223,17 @@
 canned text in your replies to save time. Feel free to adapt these
 texts to the current project if needed.
 
address@hidden
+* Program License::             
+* Dependencies::                
+* Legal Notices::               
+* Kind of software::            
+* Words to avoid::              
+* GIFs::                        
+* Mirroring::                   
address@hidden menu
+
address@hidden Program License, Dependencies, Approval Policies, Approval 
Policies
 @subsection Program License
 
 Savannah only hosts code that is compatible with the GNU General
@@ -1118,6 +1248,7 @@
 licenses, telling whether they are compatible with the GNU GPL, and
 whether they are Free Software licenses.
 
address@hidden Dependencies, Legal Notices, Program License, Approval Policies
 @subsection Dependencies
 
 Dependencies are pieces of software used or required by the project,
@@ -1151,6 +1282,13 @@
 If you are unsure of the compatibility of a license, please ask the
 GPL Compliance Lab at @email{licensing@@gnu.org}.
 
address@hidden
+* Perl and the Dual GPL&Artistic License::  
+* Java::                        
+* .Net::                        
address@hidden menu
+
address@hidden Perl and the Dual GPL&Artistic License, Java, Dependencies, 
Dependencies
 @subsubsection Perl and the Dual GPL&Artistic License
 
 Speaking of Perl, it is dual-licensed, under both the GNU GPL and the
@@ -1171,6 +1309,7 @@
 already a GNU project for the same task, it would be good to recommend
 it to the submitted project's author.
 
address@hidden Java, .Net, Perl and the Dual GPL&Artistic License, Dependencies
 @subsubsection Java
 
 [savannah.el: sv-problem-java]
@@ -1194,15 +1333,26 @@
 environment. People at GNU Classpath may want to help project
 submitters to make their project work that way [NEEDS CONFIRMATION].
 
address@hidden .Net,  , Java, Dependencies
address@hidden .Net
+
+.Net as a dependency has similar issues to Java. You have to make sure
+the program can be run under a free implementation of .Net, such as
+DotGNU or Mono.
+
+[TODO: add links]
+
address@hidden Legal Notices, Kind of software, Dependencies, Approval Policies
 @subsection Legal Notices
 
 We require that all non-trivial files in a project contain a copyright
 notice and a license notice. This process is described is
-``Information For Maintainers of GNU Software'' [TODO, make an
-appropriate xref call]; see
+``Information For Maintainers of GNU Software'' @pxref{Top,,,standards}; see
 @uref{http://www.gnu.org/@/prep/@/maintain_8.html} and
 @uref{http://www.gnu.org/@/prep/@/maintain_9.html}.
 
+[TODO: make appropriate xref call, with links to Info sections]
+
 Here are some steps to perform when checking the notices:
 @itemize
 @item Check the presence of the copyright notice in the top of the file
@@ -1214,6 +1364,7 @@
 @end itemize
 
 
address@hidden Kind of software, Words to avoid, Legal Notices, Approval 
Policies
 @subsection Kind of software
 
 We accept any kind of software except in a few cases.
@@ -1236,6 +1387,7 @@
 reached at @email{user-groups@@gnu.org}. Once the GUG is listed on that
 page, the project can be accepted.
 
address@hidden Words to avoid, GIFs, Kind of software, Approval Policies
 @subsection Words to avoid
 
 The approval process is adequate to teach our users about our
@@ -1250,6 +1402,7 @@
 Ditto for Linux and GNU/Linux.
 
 
address@hidden GIFs, Mirroring, Words to avoid, Approval Policies
 @subsection GIFs
 
 GIF is a symbol in the fight against software patents. For that
@@ -1264,6 +1417,7 @@
 interesting materials about software patents and the damages they
 cause.
 
address@hidden Mirroring,  , GIFs, Approval Policies
 @subsection Mirroring
 
 We only accept projects if they are going to use Savannah as their
@@ -1274,6 +1428,7 @@
 @uref{https://mail.gna.org/@/public/@/project/@/2004-05/@/msg00001.html}
 
 
address@hidden GNU projects, Rudy's Little HOWTO, Approval Policies, Projects 
approval
 @section GNU projects
 
 We do not accept GNU projects directly. If a project mention the 'GNU'
@@ -1299,8 +1454,8 @@
 project is approved as non-GNU (even if the project is requesting
 review by the GNU evaluation team), you have to ask the user for a new
 system name. Renaming is only possible via the web interface before to
-turn a project active. It can be done later, though; just check this
-document :)
+turn a project active. It can be done later, though; @xref{Renaming a
+project group}.
 
 Not all 'GNU' registrations are requests to be part of GNU, some are
 already part of it.  You can see if a project is already part of the
@@ -1312,13 +1467,13 @@
 If you can't find it in there, you can use the link to ask
 maintainers@@gnu if it is a gnu package.
 
address@hidden Rudy's Little HOWTO, Mathieu's Little HOWTO, GNU projects, 
Projects approval
 @section Rudy's Little HOWTO
 
 @verbatim
 
 To delete a project type the following as root on savannah:
 
-sv_register_discard project_name --user="address@hidden" --comment="reason"
 
 We have an emacs .el file for this, when using m-x sv_register_discad
 it asks for projectname and reason and pasts the command above in the
@@ -1389,6 +1544,7 @@
 @end verbatim
 
 
address@hidden Mathieu's Little HOWTO,  , Rudy's Little HOWTO, Projects approval
 @section Mathieu's Little HOWTO
 
 @verbatim