[commit-womb] gnumaint howto-decommission.txt howto-spotlight...

[karl]

CVSROOT:        /sources/womb
Module name:    gnumaint
Changes by:     karl <karl>     15/03/17 17:05:24

Added files:
        .              : howto-decommission.txt howto-spotlight.txt 
                         spotlight.tmpl 
Removed files:
        .              : decommission 

Log message:
        spotlight construction info

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnumaint/howto-decommission.txt?cvsroot=womb&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnumaint/howto-spotlight.txt?cvsroot=womb&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnumaint/spotlight.tmpl?cvsroot=womb&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnumaint/decommission?cvsroot=womb&r1=1.30&r2=0

Patches:
Index: howto-decommission.txt
===================================================================
RCS file: howto-decommission.txt
diff -N howto-decommission.txt
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ howto-decommission.txt      17 Mar 2015 17:04:58 -0000      1.1
@@ -0,0 +1,29 @@
+$Id: howto-decommission.txt,v 1.1 2015/03/17 17:04:58 karl Exp $
+    Copyright 2013, 2014, 2015 Free Software Foundation, Inc.
+
+    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.
+
+Notes on what to do when a package becomes unmaintained or
+decommissioned.
+
+unmaintained:
+  for the new maintainer to do: look at mailing list archives,
+    any todo files, good to make quick release.
+  try writing mlist if there is one.
+  update: package web page - takeaction.html - www.gnu.org home page
+  on savannah: status=orphaned; note in summary; post job.
+
+decommissioned:
+  maintainers - activity-report.txt
+  - gnupackages.txt,pkgblurbs.txt -> oldpackages.txt
+  - directory
+  - address@hidden
+  - lists: advertised=no, mv domains/gnu.org ...
+  - project home page
+  - move to end list on software.html - webpages
+  - savannah: status=orphaned; note in summary.
+
+When a maintainer resigns, implicitly or explicitly, the story is
+similar; see /gd/gnuorg/README.

Index: howto-spotlight.txt
===================================================================
RCS file: howto-spotlight.txt
diff -N howto-spotlight.txt
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ howto-spotlight.txt 17 Mar 2015 17:05:00 -0000      1.1
@@ -0,0 +1,117 @@
+$Id: howto-spotlight.txt,v 1.1 2015/03/17 17:05:00 karl Exp $
+    Copyright 2015 Free Software Foundation, Inc.
+
+    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.
+
+Notes on making the spotlight feature for the Free Software Supporter.
+The general idea is to make markdown text and send it to
address@hidden, around the 23rd of each month.
+
+This is all pretty randomly messy.  The process never seemed worth
+refining, in light of who runs it and how often and that the final
+result needs to be carefully read anyway.  Of course all aspects can be
+tinkered with ad infinitum.
+
+-------------------------------------------------------------------------
+Top level outline, with more about the prerequisites following:
+
+1. Run the hacky little script below, call it gnubytime for the sake of
+example, which reads a previously-saved rsync listing of
+ftp.gnu.org::gnu, call that fp.gnu for the sake of example.  As in:
+  gnubytime fp.gnu >/tmp/s0
+
+2. Throw away everything after the latest release from the previous
+month, which just needs to be tracked in a working file somewhere.  For
+example, in February 2015 the latest release was parallel-20150222, so
+March 2015 should include everything after that.
+
+3. Reduce the list to just unique package names, as in:
+sed 's,^.*/,,' /tmp/s0 | sort -u >/tmp/s1
+
+4. Remove things we don't want to list here, such as aspell
+dictionaries, test releases (wrongly) put on ftp.gnu.org,
+and plenty more.
+
+5. Look at the info-gnu mailing list archives from
+ftp://lists.gnu.org/info-gnu/ for the current month and the previous
+month for releases not on ftp.gnu.org.  Add those by hand to /tmp/s1
+(and resort).  gnupg and related are the most likely.  Looking at the
+Subject: lines suffices.
+
+6. Convert the result to markdown with the one-line gnu2mdwn script below:
+gnu2mdwn /tmp/s1 >/tmp/s2
+
+7. Check that the result is actually correct, e.g., does not have version
+numbers in the urls, has correct package names in the urls.  Especially
+when there are dashes in either the package name or release version.
+
+8. Look at ./spotlight.tmpl in this womb/gnumaint directory.  The markdown
+list from /tmp/s2 goes at the top.  Also replace the NN and DD and YY in
+the first line.
+
+9. The list of people to welcome as new maintainers or as maintaining
+new packages comes from fp:~karl/src/gnumaint/activity-report.txt.  That
+file needs to be maintained in place, by hand, whenever a maintainer or
+package is added or removed, as noted in /gd/gnuorg/README.
+
+10. Send to the FSF as above.
+
+11. Update the new "latest release" wherever that info is stored.
+And, although not strictly necessary, keeping an archive of all
+spotlights as sent can be useful for quickly looking at past entries.
+
+-------------------------------------------------------------------------
+In step 1, the rsync listing can be generated like this:
+
+outfile=fp.gnu # or whatever
+excludes="--exclude=*.sig \
+  --exclude=video/TIME --exclude=find.txt.gz --exclude=ls-l*.txt.gz \
+  --exclude=gnu-keyring.gpg"
+rsync --no-h -r $excludes fp:/srv/data/ftp-mirror/ftp/ \
+  | egrep -v '^[dl]' \
+  >$outfile.new
+...
+mv $outfile.new $outfile
+
+By the way, this same rsync listing is intended to be the source for the
+ftplisting check in gm-check.pl.
+
+Also, this same rsync listing can be the source for updating release
+information in gnupackages.txt, as they come through.  For that
+
+-------------------------------------------------------------------------
+Still in step 1, the "hacky little script" (gnubytime) is as follows.
+
+#!/usr/bin/env perl
+# ftp releases by time,via  rsync listing.
+# -rw-r--r--         918 2002/01/14 14:28:56 .message
+
+$ARGV[0] = "/u/karl/sys/ftp/fp.gnu" unless @ARGV;
+
+while (<>) {
+  next if / -> /;
+  next if /\.(diff|xdelta)\./;
+  next if /snapshot\.pkg/;
+  next if /\.darwin/;
+  next if /-latest/;
+  next if /\.sig/;
+  next unless /\.[tj]ar\./;
+  my (undef,undef,$date,undef,$pkg) = split (" "); # rsync
+  # my ($date,undef,$pkg) = split (" "); # ftp
+  $date =~ tr,-/,,d;
+  $pkg{$pkg} = $date;
+}
+
+for my $p (sort { $pkg{$b} <=> $pkg{$a} } keys %pkg) {
+  ($pfile = $p) =~ s/\.tar\..*$//;
+  print "$pkg{$p}\t$pfile\n";
+}
+-------------------------------------------------------------------------
+In step 6, the gnu2mdwn script is:
+
+#!/bin/sh
+sed \
+  -e 's,\(.*\)-\([^-]*\),* [\1-\2](http://www.gnu.org/software/\1/),' \
+  "$@"

Index: spotlight.tmpl
===================================================================
RCS file: spotlight.tmpl
diff -N spotlight.tmpl
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ spotlight.tmpl      17 Mar 2015 17:05:22 -0000      1.1
@@ -0,0 +1,38 @@
+$Id: spotlight.tmpl,v 1.1 2015/03/17 17:05:22 karl Exp $
+    Copyright 2015 Free Software Foundation, Inc.
+
+    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.
+
+Template for GNU Spotlight feature of the Free Software Supporter.
+See ./howto-spotlight.txt.
+
+---------------------------------------------------------------------
+NN new GNU releases in the last month (as of Month DD, 20YY):
+
+[[[markdown list of releases goes here]]]
+
+For announcements of most new GNU releases, subscribe to the info-gnu
+mailing list: <http://lists.gnu.org/mailman/listinfo/info-gnu>.
+
+To download: nearly all GNU software is available from
+<http://ftp.gnu.org/gnu/>, or preferably one of its mirrors from
+<http://www.gnu.org/prep/ftp.html>.  You can use the url
+<http://ftpmirror.gnu.org/> to be automatically redirected to a
+(hopefully) nearby and up-to-date mirror.
+
+This month, we welcome [[[list from activity-report.txt]]].
+
+A number of GNU packages, as well as the GNU operating system as a
+whole, are looking for maintainers and other assistance: please see
+<http://www.gnu.org/server/takeaction.html#unmaint> if you'd like to
+help.  The general page on how to help GNU is at
+<http://www.gnu.org/help/help.html>.
+
+If you have a working or partly working program that you'd like
+to offer to the GNU project as a GNU package, see
+<http://www.gnu.org/help/evaluation.html>.
+
+As always, please feel free to write to us, <address@hidden>,
+with any GNUish questions or suggestions for future installments.

Index: decommission
===================================================================
RCS file: decommission
diff -N decommission
--- decommission        14 Oct 2013 00:26:30 -0000      1.30
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,26 +0,0 @@
-Copyright 2013 Free Software Foundation, Inc.
-
-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.
-
-Notes on what to do when a package becomes unmaintained or
-decommissioned.
-
-
-unmaintained:
-  for the new maintainer to do: look at mailing list archives,
-    any todo files, good to make quick release.
-  try writing mlist if there is one.
-  update: package web page - takeaction.html - www.gnu.org home page
-  on savannah: status=orphaned; note in summary; post job.
-
-decommissioned:
-  maintainers - activity-report.txt
-  - gnupackages.txt,pkgblurbs.txt -> oldpackages.txt
-  - directory
-  - address@hidden
-  - lists: advertised=no, mv domains/gnu.org ...
-  - project home page
-  - move to end list on software.html - webpages
-  - savannah: status=orphaned; note in summary.