[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Savannah-cvs] administration/docs/hacking_savannah hacking_sa...
From: |
Sylvain Beucler |
Subject: |
[Savannah-cvs] administration/docs/hacking_savannah hacking_sa... |
Date: |
Sat, 14 Aug 2004 10:25:38 -0400 |
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
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/09
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Elfyn McBratney, 2004/08/09
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/09
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/12
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/12
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/12
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/12
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/12
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/13
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa...,
Sylvain Beucler <=
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/14
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/15
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/15
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/16
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/22
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/22
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/22
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Elfyn McBratney, 2004/08/22
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/22
- [Savannah-cvs] administration/docs/hacking_savannah hacking_sa..., Sylvain Beucler, 2004/08/24