[commit-womb] gnumaint/rec gnupackages.rec package-descriptor...

[Brandon Invergo]

CVSROOT:        /sources/womb
Module name:    gnumaint
Changes by:     Brandon Invergo <brandon>       16/03/19 10:13:08

Modified files:
        rec            : gnupackages.rec 
Added files:
        rec            : package-descriptor.rec 

Log message:
        move recutils Package descriptor to separate file

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnumaint/rec/gnupackages.rec?cvsroot=womb&r1=1.13&r2=1.14
http://cvs.savannah.gnu.org/viewcvs/gnumaint/rec/package-descriptor.rec?cvsroot=womb&rev=1.1

Patches:
Index: gnupackages.rec
===================================================================
RCS file: /sources/womb/gnumaint/rec/gnupackages.rec,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- gnupackages.rec     16 Mar 2016 22:48:42 -0000      1.13
+++ gnupackages.rec     19 Mar 2016 10:13:07 -0000      1.14
@@ -1,4 +1,4 @@
-# $Id: gnupackages.rec,v 1.13 2016/03/16 22:48:42 brandon Exp $
+# $Id: gnupackages.rec,v 1.14 2016/03/19 10:13:07 brandon Exp $
 # Public domain.
 #
 # This file is maintained in the CVS repository of GNU womb,
@@ -61,35 +61,11 @@
 # identifier, for human convenience.  However, software reading this
 # file should accept any order of packages or fields.
 
-%rec: Package
-%doc: Basic package metadata
-%key: package
-%mandatory: activity_status
-%allowed: package alias mundane_name copyright_holder savannah fsd
-+ language logo doc_category doc_summary doc_url doc_shop download_url
-+ other_download_url gplv3_status activity_status last_activity
-+ last_release last_release_date last_contact next_contact note
-+ container tech_address doc_source_format blurb_id
-# lower-case package names
-%type: package regexp /[a-z0-9-]+/
-%type: blurb_id rec Blurb
-## Allowed activity statuses:
-%type: activity_status enum
-+ ok newmaint newcomaint newpkg nomaint container subpkg stable
-+ stale moribund alpha
-## Except in a few cases, there should always be a last_activity
-%constraint: activity_status != 'container' &&
-+ activity_status != 'subpkg' &&
-+ activity_status != 'stable' &&
-+ note != 'no-release' &&
-+ note != 'released-through-vc' &&
-+ note != 'many packages' => #last_activity
-%type: last_activity,last_release_date date
-## If there has been a release, then the last activity should at least
-## be the date of the last release
-%constraint: last_release_date => last_release_date << last_activity ||
-+ last_release_date == last_activity
-%constraint: activity_status = 'ok' => last_release_date >> '3 years ago'
+# See the file pkg-descriptor.rec in this directory for the full
+# definition of the Package record type.
+
+%rec: Package rec/package-descriptor.rec
+%doc: Current GNU packages
 
 
 package: 3dldf

Index: package-descriptor.rec
===================================================================
RCS file: package-descriptor.rec
diff -N package-descriptor.rec
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ package-descriptor.rec      19 Mar 2016 10:13:07 -0000      1.1
@@ -0,0 +1,86 @@
+# $Id: package-descriptor.rec,v 1.1 2016/03/19 10:13:07 brandon Exp $
+# Public domain.
+#
+# This file is maintained in the CVS repository of GNU womb,
+# http://cvs.savannah.gnu.org/viewvc/gnumaint/?root=womb
+#
+# Info/constraints about the fields:
+# - The package name should always be all-lowercase.
+#
+# - When mundane_name is not specified, default is to capitalize the first
+#   letter of the package identifier.
+#
+# - Default for download_url is http://ftp.gnu.org/gnu/PKGNAME.
+#
+# - A doc_url value of "none" means no specific documentation page (home
+#     page is used).
+#   "htmlxref" means to extract a list of additional manuals from the
+#     Texinfo htmlxref.cnf file.
+#   Otherwise, it can be a url, which can be used together with htmlxref,
+#   but multiple explicit urls or other combinations are not supported.
+#
+# - doc_category values are in doc-categories.txt (following FSD).
+# (doc stuff is used to generate gnu.org/manual.)
+#
+# - each package should always have an activity_status
+#
+# - allowed activity_status values:
+#   ok;
+#   newmaint,newcomaint (newly-appointed);
+#   newpkg (newly-dubbed);
+#   nomaint (no maintainer);
+#   container (doesn't get released);
+#   subpkg (released as part of another package);
+#   stable (no current release, but none needed);
+#   stale (needs release);
+#   moribund (needs release, but not likely to ever get one).
+#   alpha (alpha-only releases so far)
+#
+# - most activity statuses must have an associated date of last
+#   activity
+#
+# - as a consistency check, the last activity should always be at
+# least the last release date
+#
+# The home page is not a field because that *always* is (should be)
+# /software/PACKAGE, even if that does nothing but redirect.  Any other
+# method leads to redundant (hence inevitably inconsistent) information.
+#
+# Finally, this file as a whole is more or less sorted by package
+# identifier, for human convenience.  However, software reading this
+# file should accept any order of packages or fields.
+
+%rec: Package
+%doc: Basic package metadata
+%key: package
+%mandatory: activity_status
+%allowed: package alias mundane_name copyright_holder savannah fsd
++ language logo doc_category doc_summary doc_url doc_shop download_url
++ other_download_url gplv3_status activity_status last_activity
++ last_release last_release_date last_contact next_contact note
++ container tech_address doc_source_format blurb_id
+# Package names should be all in lower-case
+%type: package regexp /[a-z0-9-]+/
+## Get the blurb separately via a join on the Blurb record type (in
+## pkgblurbs.rec)
+%type: blurb_id rec Blurb
+## Allowed activity statuses:
+%type: activity_status enum
++ ok newmaint newcomaint newpkg nomaint container subpkg stable
++ stale moribund alpha decommissioned
+%type: last_activity,last_release_date date
+##
+## CONSTRAINTS
+## Except in a few cases, there should always be a last_activity
+%constraint: activity_status != 'container' &&
++ activity_status != 'subpkg' &&
++ activity_status != 'stable' &&
++ activity_status != 'decommissioned' &&
++ note != 'no-release' &&
++ note != 'released-through-vc' &&
++ note != 'many packages' => #last_activity
+## If there has been a release, then the last activity should at least
+## be the date of the last release
+%constraint: last_release_date => last_release_date << last_activity ||
++ last_release_date == last_activity
+%constraint: activity_status = 'ok' => last_release_date >> '3 years ago'