[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
gnustandards ChangeLog maintain.texi
From: |
Karl Berry |
Subject: |
gnustandards ChangeLog maintain.texi |
Date: |
Fri, 24 Jul 2009 18:44:42 +0000 |
CVSROOT: /sources/gnustandards
Module name: gnustandards
Changes by: Karl Berry <karl> 09/07/24 18:44:42
Modified files:
. : ChangeLog maintain.texi
Log message:
informational changes only: split Web Pages node, mention
savannah-announce, mention http://identi.ca/group/fsfstatus url
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnustandards/ChangeLog?cvsroot=gnustandards&r1=1.98&r2=1.99
http://cvs.savannah.gnu.org/viewcvs/gnustandards/maintain.texi?cvsroot=gnustandards&r1=1.174&r2=1.175
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/gnustandards/gnustandards/ChangeLog,v
retrieving revision 1.98
retrieving revision 1.99
diff -u -b -r1.98 -r1.99
--- ChangeLog 4 Jul 2009 22:14:36 -0000 1.98
+++ ChangeLog 24 Jul 2009 18:44:41 -0000 1.99
@@ -1,3 +1,10 @@
+2009-07-24 Karl Berry <address@hidden>
+
+ * maintain.texi (Web Pages): reorganize into subnodes.
+ (Old Versions): mention savannah-announce mailing list.
+ (About This Document): mention fsfstatus url.
+ No substantive changes in all of that.
+
2009-06-07 Karl Berry <address@hidden>
* standards.texi (Man Pages): refer to the all-permissive license
Index: maintain.texi
===================================================================
RCS file: /sources/gnustandards/gnustandards/maintain.texi,v
retrieving revision 1.174
retrieving revision 1.175
diff -u -b -r1.174 -r1.175
--- maintain.texi 5 Jun 2009 13:48:41 -0000 1.174
+++ maintain.texi 24 Jul 2009 18:44:41 -0000 1.175
@@ -1,11 +1,11 @@
\input texinfo.tex @c -*-texinfo-*-
@c %**start of header
@setfilename maintain.info
address@hidden Information For Maintainers of GNU Software
address@hidden Information for Maintainers of GNU Software
@c For double-sided printing, uncomment:
@c @setchapternewpage odd
@c This date is automagically updated when you save this file:
address@hidden lastupdate May 26, 2009
address@hidden lastupdate July 24, 2009
@c %**end of header
@dircategory GNU organization
@@ -17,9 +17,7 @@
@c Put everything in one index (arbitrarily chosen to be the concept index).
@syncodeindex fn cp
address@hidden ky cp
@syncodeindex pg cp
address@hidden vr cp
@copying
Information for maintainers of GNU software, last updated @value{lastupdate}.
@@ -39,7 +37,7 @@
@end copying
@titlepage
address@hidden Information For Maintainers of GNU Software
address@hidden Information for Maintainers of GNU Software
@author Richard Stallman
@author last updated @value{lastupdate}
@page
@@ -91,6 +89,7 @@
In addition to this document, please read and follow the GNU Coding
Standards (@pxref{Top, , Contents, standards, GNU Coding Standards}).
address@hidden @code{maintainers@@gnu.org} email address
Please send corrections or suggestions for this document to
@email{maintainers@@gnu.org}. If you make a suggestion, please include
a suggested new wording for it, to help us consider the suggestion
@@ -99,11 +98,26 @@
other version of this document, or propose it in any way that makes it
clear.
address@hidden @code{mentors@@gnu.org} mailing list
If you have general questions or encounter a situation where it isn't
clear what to do, you can ask @email{mentors@@gnu.org}, which is a
list of a few other GNU contributor who have offered to answer
questions for new maintainers.
+The directory @file{/gd/gnuorg} mentioned throughout this document is
+found on the GNU file server, currently @code{fencepost.gnu.org}; if
+you are the maintainer of a GNU package, you should have an account
+there. See @url{http://www.gnu.org/software/README.accounts.html} if
+you don't have one. (You can also ask for accounts for people who
+help you a large amount in working on the package.)
+
+If on occasion you find that any GNU computer systems
+(@code{fencepost.gnu.org}, @code{ftp.gnu.org},
address@hidden, or others) seem to be down, you can check the
+current status at @url{http://identi.ca/group/fsfstatus}. Most likely
+the problem, if it is at the FSF end, is already being worked on.
+
address@hidden Piercy, Marge
This document uses the gender-neutral third-person pronouns ``person'',
``per'', ``pers'' and ``perself'' which were promoted, and perhaps
invented, by Marge Piercy in @cite{Woman on the Edge of Time}. They are
@@ -112,13 +126,6 @@
per new program under the GNU GPL, to let the public benefit from per
work, and to enable per to feel person has done the right thing.''
-The directory @file{/gd/gnuorg} is found on the GNU file server,
-currently @code{fencepost.gnu.org}; if you are the maintainer of a GNU
-package, you should have an account there. See
address@hidden://www.gnu.org/software/README.accounts.html} if you don't
-have one. (You can also ask for accounts for people who help you a
-large amount in working on the package.)
-
This release of the GNU Maintenance Instructions was last updated
@value{lastupdate}.
@@ -141,10 +148,11 @@
a person is capable of doing the job will carry a lot of weight.
As your final act as maintainer, it would be helpful to set up the
-package under @code{savannah.gnu.org} (@pxref{Old Versions}). This will
-make it much easier for the new maintainer to pick up where you left off
-and will ensure that the source tree is not misplaced if it takes us a
-while to find a new maintainer.
+package under @code{savannah.gnu.org} if it is not there already
+(@pxref{Old Versions}). This will make it much easier for the new
+maintainer to pick up where you left off and will ensure that the
+source tree is not misplaced if it takes us a while to find a new
+maintainer.
@node Recruiting Developers
@@ -1011,6 +1019,7 @@
change log that you would not want to hand over to another maintainer
some day.
address@hidden @code{savannah-hackers@@gnu.org}
The GNU Project provides a server that GNU software packages can use
for source control and other package needs: @code{savannah.gnu.org}.
You don't have to use this repository, but if you plan to allow public
@@ -1018,9 +1027,17 @@
people to be able to find various GNU packages in a central place.
Savannah is managed by @email{savannah-hackers@@gnu.org}.
-All GNU maintainers are encouraged to take advantage of Savannah, as
-sharing such a central point can serve to foster a sense of community
-among GNU developers and help in keeping up with project management.
+All GNU maintainers are strongly encouraged to take advantage of
+Savannah, as sharing such a central point can serve to foster a sense
+of community among GNU developers and help in keeping up with project
+management.
+
address@hidden @code{savannah-announce@@gnu.org} mailing list
+If you do use Savannah, it is a good idea to subscribe to the
address@hidden@@gnu.org} mailing list
+(@url{http://lists.gnu.org/mailman/listinfo/savannah-announce}). This
+is a very low-volume list to keep Savannah users informed of system
+upgrades, problems, and the like.
@node Distributions
@@ -1552,29 +1569,46 @@
on information rather than flashy eye candy, and to keep the site
simple and uniform.
+Some GNU packages have just simple web pages, but the more information
+you provide, the better. So please write as much as you usefully can,
+and put all of it on @code{www.gnu.org}. However, pages that access
+databases (including mail logs and bug tracking) are an exception; set
+them up on whatever site is convenient for you, and make the pages on
address@hidden link to that site.
+
address@hidden
+* Hosting for Web Pages::
+* Freedom for Web Pages::
+* Manuals on Web Pages::
+* CVS Keywords in Web Pages::
address@hidden menu
+
address@hidden Hosting for Web Pages
address@hidden Hosting for Web Pages
+
The best way to maintain the web pages for your project is to register
the project on @code{savannah.gnu.org}. Then you can edit the pages
-using CVS. You can keep your source files there too, but if you want
-to use @code{savannah.gnu.org} only for the web pages, that's ok;
-simply register a ``web-only'' project.
+using CVS, using the separate ``web repository'' available on
+Savannah, which corresponds to
address@hidden://www.gnu.org/software/@var{package}/}. You can
+keep your source files there too (using any of a variety of version
+control systems), but you can use @code{savannah.gnu.org} only for
+your gnu.org web pages if you wish; simply register a ``web-only''
+project.
If you don't want to use that method, please talk with
@email{webmasters@@gnu.org} about other possible methods. For
instance, you can mail them pages to install, if necessary. But that
-is more work for them, so please use CVS if you can.
+is more work for them, so please use Savannah if you can.
-Some GNU packages have just simple web pages, but the more information
-you provide, the better. So please write as much as you usefully can,
-and put all of it on @code{www.gnu.org}. However, pages that access
-databases (including mail logs and bug tracking) are an exception; set
-them up on whatever site is convenient for you, and make the pages on
address@hidden link to that site.
+If you use Savannah, you can use a special @file{.symlinks} file in
+order to create symbolic links, which are not supported in CVS. For
+details, see
address@hidden://www.gnu.org/server/standards/README.webmastering.html#symlinks}.
-Historically, web pages for GNU packages did not include GIF images,
-because of patent problems (@pxref{Ethical and Philosophical
-Consideration}). Although the GIF patents expired in 2006, using GIF
-images is still not recommended, as the PNG and JPEG formats are
-generally superior. See @url{http://www.gnu.org/philosophy/gif.html}.
+
address@hidden Freedom for Web Pages
address@hidden Freedom for Web Pages
If you use a site other than @code{www.gnu.org}, please make sure that
the site runs on free software alone. (It is ok if the site uses
@@ -1589,13 +1623,24 @@
public might perceive as connected with it and reflecting the position
of its developers, unless it follows that criterion.
+Historically, web pages for GNU packages did not include GIF images,
+because of patent problems (@pxref{Ethical and Philosophical
+Consideration}). Although the GIF patents expired in 2006, using GIF
+images is still not recommended, as the PNG and JPEG formats are
+generally superior. See @url{http://www.gnu.org/philosophy/gif.html}.
+
+
address@hidden Manuals on Web Pages
address@hidden Manuals on Web Pages
+
The web pages for the package should include its manuals, in HTML,
DVI, Info, PostScript, PDF, plain ASCII, and Texinfo format (source).
-(All of these can be generated automatically from the Texinfo source
-using Makeinfo and other programs.) When there is only one manual,
-put it in a subdirectory called @file{manual}; the file
address@hidden/index.html} should have a link to the manual in each of
-its forms.
+All of these can be generated automatically from the Texinfo source
+using Makeinfo and other programs.
+
+When there is only one manual, put it in a subdirectory called
address@hidden; the file @file{manual/index.html} should have a link to
+the manual in each of its forms.
If the package has more than one manual, put each one in a
subdirectory of @file{manual}, set up @file{index.html} in each
@@ -1605,20 +1650,19 @@
See the section below for details on a script to make the job of
creating all these different formats and index pages easier.
-We would like to include links to all these manuals in the page
address@hidden://www.gnu.org/manual}. Just send mail to
address@hidden@@gnu.org} telling them the name of your package and
-asking them to edit @url{http://www.gnu.org/manual}, and they will do
-so based on the contents of your @file{manual} directory.
+We would like to include links to all GNU manuals on the page
address@hidden://www.gnu.org/manual}, so if yours isn't listed, please send
+mail to @code{webmasters@@gnu.org} telling them the name of your
+package and asking them to edit @url{http://www.gnu.org/manual}, and
+they will do so based on the contents of your @file{manual} directory.
@menu
* Invoking gendocs.sh::
-* CVS Keywords in Web Pages::
@end menu
@node Invoking gendocs.sh
address@hidden Invoking @command{gendocs.sh}
address@hidden Invoking @command{gendocs.sh}
@pindex gendocs.sh
@cindex generating documentation output
@@ -1895,6 +1939,7 @@
repository for your package, and, even more so, using
@code{ftp.gnu.org} as the standard distribution site. Doing so makes
it easier for developers and users to find the latest GNU releases.
address@hidden Versions}, for more information about Savannah.
However, it is ok to use other machines if you wish. If you use a
company's machine to hold the repository for your program, or as its
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- gnustandards ChangeLog maintain.texi,
Karl Berry <=