X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fmaintain.texi;h=06ed3f43067220eda989d0c16b50075ab3035c4e;hb=cf74a3953bedd79cd53057aa00f1c90019c10102;hp=3f5571ae152650712eb3b41fdbae4c85706a0c15;hpb=48768ae733581a3bd2d2bd2050f0cfa728a51d91;p=pspp diff --git a/doc/maintain.texi b/doc/maintain.texi index 3f5571ae15..06ed3f4306 100644 --- a/doc/maintain.texi +++ b/doc/maintain.texi @@ -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 January 14, 2011 +@set lastupdate June 30, 2011 @c %**end of header @dircategory GNU organization @@ -128,10 +128,12 @@ This release of the GNU Maintainer Information was last updated @cindex help, getting @cindex @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 experienced GNU contributors who have offered to answer -questions for new maintainers. +If you have any general questions or encounter a situation where it +isn't clear how to get something done or who to ask, you (as a GNU +contributor) can always write to @email{mentors@@gnu.org}, which is a +list of a few experienced GNU folks who have volunteered to answer +questions. Any GNU-related question is fair game for the +@code{mentors} list. @cindex advisory committee The GNU Advisory Committee helps to coordinate activities in the GNU @@ -142,6 +144,21 @@ committee at @email{gnu-advisory@@gnu.org}. See committee members. Additional information is in @file{/gd/gnuorg/advisory}. +@cindex down, when GNU machines are +@cindex outage, of GNU machines +@cindex @url{http://identi.ca/group/fsfstatus} +If you find that any GNU computer systems (@code{fencepost.gnu.org}, +@code{ftp.gnu.org}, @code{www.gnu.org}, @code{savannah.gnu.org}, +@dots{}) seem to be down, you can check the current status at +@url{http://identi.ca/group/fsfstatus}. Most likely the problem, if +it can be alleviated at the FSF end, is already being worked on. + +@cindex sysadmin, FSF +@cindex FSF system administrators +@cindex GNU system administrators +The FSF system administrators are responsible for the network and GNU +hardware. You can email them at @email{sysadmin@@fsf.org}, but please +try not to burden them unnecessarily. @node Getting a GNU Account @@ -162,15 +179,6 @@ the package. @gdgnuorgtext{} -@cindex down, when GNU machines are -@cindex outage, of GNU machines -@cindex @url{http://identi.ca/group/fsfstatus} -If you find that any GNU computer systems (@code{fencepost.gnu.org}, -@code{ftp.gnu.org}, @code{www.gnu.org}, @code{savannah.gnu.org}, -@dots{}) seem to be down, you can check the current status at -@url{http://identi.ca/group/fsfstatus}. Most likely the problem, if -it can be alleviated at the FSF end, is already being worked on. - @node Stepping Down @chapter Stepping Down @@ -1163,8 +1171,9 @@ useful for your package. It is very important to keep backup files of all source files of GNU. You can do this using a source control system (such as Bazaar, RCS, CVS, Git, Subversion, @dots{}) if you like. The easiest way to use -RCS or CVS is via the Version Control library in Emacs (@pxref{VC -Concepts,, Concepts of Version Control, emacs, The GNU Emacs Manual}). +RCS or CVS is via the Version Control library in Emacs +(@pxref{Introduction to VC,, Introduction to Version Control, emacs, +The GNU Emacs Manual}). The history of previous revisions and log entries is very important for future maintainers of the package, so even if you do not make it @@ -1400,7 +1409,8 @@ maintain the web pages at @url{http://www.gnu.org} for your project @item In the @samp{My Account Conf} page on @code{savannah}, upload the GPG key you will use to sign your packages. If you haven't created one -before, you can do so with the command @code{gpg --gen-key}. +before, you can do so with the command @code{gpg --gen-key} (you can +accept all the default answers to its questions). Optional but recommended: Send your key to a GPG public key server: @code{gpg --keyserver keys.gnupg.net --send-keys @var{keyid}}, where @@ -1416,8 +1426,8 @@ finally email the resulting @file{@var{msgfile}.asc}), to @enumerate @item -Name of package(s) that you are the maintainer for, and your -preferred email address. +Name of package(s) that you are the maintainer for, your +preferred email address, and your Savannah username. @item An ASCII armored copy of your GPG key, as an attachment. (@samp{gpg @@ -1715,7 +1725,7 @@ useful to mention the mirror list at redirect to a nearby mirror. @item -The NEWS (@pxref{NEWS File,,, standards, GNU Coding Standards}) for +The @t{NEWS} (@pxref{NEWS File,,, standards, GNU Coding Standards}) for the present release. @end itemize @@ -2031,32 +2041,36 @@ about GNU. @node Free Software and Open Source @section Free Software and Open Source -@cindex free software +@cindex free software movement @cindex open source -@cindex movements, Free Software and Open Source - -The terms ``free software'' and ``open source'' are the slogans of two -different movements which differ in their basic philosophy. The Free -Software Movement is idealistic, and raises issues of freedom, ethics, -principle and what makes for a good society. The Open Source Movement, -founded in 1998, studiously avoids such questions. For more explanation, -see @url{http://www.gnu.org/philosophy/open-source-misses-the-point.html}. - -The GNU Project is aligned with the Free Software Movement. This +@cindex movement, free software +@cindex development method, open source + +The terms ``free software'' and ``open source'', while describing +almost the same category of software, stand for views based on +fundamentally different values. The free software movement is +idealistic, and raises issues of freedom, ethics, principle and what +makes for a good society. The term open source, initiated in 1998, is +associated with a philosophy which studiously avoids such questions. +For a detailed explanation, see +@url{http://www.gnu.org/philosophy/open-source-misses-the-point.html}. + +The GNU Project is aligned with the free software movement. This doesn't mean that all GNU contributors and maintainers have to agree; your views on these issues are up to you, and you're entitled to express them when speaking for yourself. -However, due to the much greater publicity that the Open Source -Movement receives, the GNU Project needs to overcome a widespread -mistaken impression that GNU is @emph{and always was} an activity of -the Open Source Movement. For this reason, please use the term ``free +However, due to the much greater publicity that the term ``open source'' +receives, the GNU Project needs to overcome a widespread +mistaken impression that GNU is @emph{and always was} an ``open +source'' activity. For this reason, please use the term ``free software'', not ``open source'', in GNU software releases, GNU documentation, and announcements and articles that you publish in your role as the maintainer of a GNU package. A reference to the URL given above, to explain the difference, is a useful thing to include as well. + @node GNU and Linux @section GNU and Linux @cindex Linux