autoupdate
[pspp] / doc / maintain.texi
index c04722c8a8f1fe3bf7efd3f6a3938d3e71ed1226..013785d480bdff30fd70bf658f56632bb4290e01 100644 (file)
@@ -5,7 +5,7 @@
 @c For double-sided printing, uncomment:
 @c @setchapternewpage odd
 @c This date is automagically updated when you save this file:
-@set lastupdate February 1, 2009
+@set lastupdate May 26, 2009
 @c %**end of header
 
 @dircategory GNU organization
@@ -322,7 +322,7 @@ contributor the papers; if they haven't, then you should send the
 papers.  In any case, you should wait for the confirmation from the
 FSF that the signed papers have been received and accepted before
 integrating the new contributor's material, as usual.
+
 If a contributor is reluctant to sign an assignment for a large change,
 and is willing to sign a disclaimer instead, that is acceptable, so you
 should offer this alternative if it helps you reach agreement.  We
@@ -526,9 +526,9 @@ instead of a copyright notice, it should have a notice saying explicitly
 that it is in the public domain.
 
 Even image files and sound files should contain copyright notices and
-license notices, if they can.  Some formats do not have room for textual
-annotations; for these files, state the copyright and copying
-permissions in a README file in the same directory.
+license notices, if their format permits.  Some formats do not have
+room for textual annotations; for these files, state the copyright and
+copying permissions in a @file{README} file in the same directory.
 
 Change log files should have a copyright notice and license notice at
 the end, since new material is added at the beginning but the end
@@ -759,15 +759,20 @@ usually simplest to include the GFDL in each manual.
 @subsection License Notices for Other Files
 
 Small supporting files, short manuals (under 300 lines long) and rough
-documentation (README files, INSTALL files, etc) can use a simple
-all-permissive license like this one:
+documentation (@file{README} files, @file{INSTALL} files, etc.)@: can
+use a simple all-permissive license like this one:
 
 @smallexample
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
-notice and this notice are preserved.
+notice and this notice are preserved.  This file is offered as-is,
+without any warranty.
 @end smallexample
 
+Older versions of this license did not have the second sentence with
+the express warranty disclaimer.  There is no urgent need to update
+existing files, but new files should use the new text.
+
 If your package distributes Autoconf macros that are intended to be
 used (hence distributed) by third-party packages under possibly
 incompatible licenses, you may also use the above all-permissive
@@ -1490,25 +1495,51 @@ official new releases, including those made just to fix bugs, we
 strongly recommend using the (moderated) general GNU announcements
 list, @email{info-gnu@@gnu.org}.  Doing so makes it easier for users
 and developers to find the latest GNU releases.  On the other hand,
-please do not announce test releases on @code{info-gnu} unless it's an
-unusual situation.
+please do not announce test releases on @code{info-gnu} unless it's a
+highly unusual situation.
 
 @cindex @url{http://planet.gnu.org}
 @cindex Savannah, news area
 Please also post release announcements in the news section of your
 Savannah project site.  It is fine to also write news entries for test
 releases and any other newsworthy events.  The news feeds from all GNU
-projects at savannah are aggregated at @url{http://planet.gnu.org}.
-(You can also post items directly, or arrange for feeds from other
-locations; see contact information on the GNU Planet web page.) 
+projects at savannah are aggregated at @url{http://planet.gnu.org}
+(GNU Planet).  You can also post items directly, or arrange for feeds
+from other locations; see contact information on the GNU Planet web
+page.
 
 @cindex announcement mailing list, project-specific
 You can maintain your own mailing list (typically
 @email{info-@var{program}@@gnu.org}) for announcements as well if you
-like.  For your own list, of course you can decide as you see fit what
+like.  For your own list, of course you decide as you see fit what
 events are worth announcing.  (@xref{Mail}, for more suggestions on
 handling mail for your package.)
 
+@cindex contents of announcements
+When writing an announcement, please include the following:
+
+@itemize @bullet
+@item
+A very brief description (a few sentences at most) of the general
+purpose of your package.
+
+@item
+Your package's web page (normally
+@indicateurl{http://www.gnu.org/software/@var{package}/}).
+
+@item
+Your package's download location (normally
+@indicateurl{http://ftp.gnu.org/gnu/@var{package}/}).  It is also
+useful to mention the FTP mirror list at
+@url{http://www.gnu.org/order/ftp.html}, and that
+@url{http://ftpmirror.gnu.org/@var{package/}} will automatically
+redirect to a nearby mirror.
+
+@item
+The NEWS (@pxref{NEWS File,,, standards, GNU Coding Standards}) for
+the present release.
+@end itemize
+
 
 @node Web Pages
 @chapter Web Pages
@@ -1521,11 +1552,11 @@ The overall goals are to support a wide variety of browsers, to focus
 on information rather than flashy eye candy, and to keep the site
 simple and uniform.
 
-The simplest 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 the source files there too, but if
-you want to use @code{savannah.gnu.org} only for the web pages, simply
-register a ``web-only'' project.
+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.
 
 If you don't want to use that method, please talk with
 @email{webmasters@@gnu.org} about other possible methods.  For
@@ -1682,10 +1713,10 @@ correspondence to @email{bug-texinfo@@gnu.org}.
 
 @node CVS Keywords in Web Pages
 @section CVS Keywords in Web Pages
-@cindex cvs keywords in web pages
-@cindex rcs keywords in web pages
+@cindex CVS keywords in web pages
+@cindex RCS keywords in web pages
 @cindex $ keywords in web pages
-@cindex web pages, and cvs keywords
+@cindex web pages, and CVS keywords
 
 Since @code{www.gnu.org} works through CVS, CVS keywords in your
 manual, such as @code{@w{$}Log$}, need special treatment (even if you