[plt-dev] Patch: index planet info fields

From: Robby Findler (robby at eecs.northwestern.edu)
Date: Thu Apr 30 11:27:24 EDT 2009

Thanks!

Can you check it in, or do you need someone else to? (I never figured
out patch files, so if you can't check it in, please send me the whole
file and I will.)

Robby

On Thu, Apr 30, 2009 at 10:19 AM, David Van Horn <dvanhorn at ccs.neu.edu> wrote:
> The attached patch adds index entries for all the planet info.ss fields,
> such as 'blurb, 'release-notes, etc.
>
> David
>
>
> Index: collects/planet/planet.scrbl
> ===================================================================
> --- collects/planet/planet.scrbl        (revision 14668)
> +++ collects/planet/planet.scrbl        (working copy)
> @@ -766,41 +766,43 @@
>
>  @itemize[
>
> - at item{The @scheme['blurb] field: If present, the blurb field should contain
> a list of XHTML fragments
> -encoded as x-expressions (see the xml collection for details) that
> -PLaneT will use as a short description of your project.}
> + at item{The @indexed-scheme['blurb] field: If present, the blurb field
> +should contain a list of XHTML fragments encoded as x-expressions (see
> +the xml collection for details) that PLaneT will use as a short
> +description of your project.}
>
> - at item{The @scheme['release-notes] field: If present, the release-notes
> field should contain a list of XHTML
> -fragments encoded as x-expressions (see the xml collection for
> -details) that PLaneT will use as a short description of what's new
> -in this release of your package.}
> + at item{The @indexed-scheme['release-notes] field: If present, the
> +release-notes field should contain a list of XHTML fragments encoded
> +as x-expressions (see the xml collection for details) that PLaneT will
> +use as a short description of what's new in this release of your
> +package.}
>
> - at item{The @scheme['categories] field:
> -If present, the categories field should be a list of symbols
> -corresponding to the categories under which this package should be listed.
> + at item{The @indexed-scheme['categories] field: If present, the categories
> +field should be a list of symbols corresponding to the categories
> +under which this package should be listed.
>
>  The valid categories are:
>
>  @itemize[
> -  @item{@scheme['devtools]:         Development Tools}
> -  @item{@scheme['net]:              Networking and Protocols}
> -  @item{@scheme['media]:            Graphics and Audio}
> -  @item{@scheme['xml]:              XML-Related}
> -  @item{@scheme['datastructures]:   Data Structures and Algorithms}
> -  @item{@scheme['io]:               Input/Output and Filesystem}
> -  @item{@scheme['scientific]:       Mathematical and Scientific}
> -  @item{@scheme['system]:           Hardware/Operating System-Specific
> Tools}
> -  @item{@scheme['ui]:               Textual and Graphical User Interface}
> -  @item{@scheme['metaprogramming]:  Metaprogramming Tools}
> -  @item{@scheme['planet]:           PLaneT-Related}
> -  @item{@scheme['misc]:             Miscellaneous}]
> +  @item{@indexed-scheme['devtools]:         Development Tools}
> +  @item{@indexed-scheme['net]:              Networking and Protocols}
> +  @item{@indexed-scheme['media]:            Graphics and Audio}
> +  @item{@indexed-scheme['xml]:              XML-Related}
> +  @item{@indexed-scheme['datastructures]:   Data Structures and Algorithms}
> +  @item{@indexed-scheme['io]:               Input/Output and Filesystem}
> +  @item{@indexed-scheme['scientific]:       Mathematical and Scientific}
> +  @item{@indexed-scheme['system]:           Hardware/Operating
> System-Specific Tools}
> +  @item{@indexed-scheme['ui]:               Textual and Graphical User
> Interface}
> +  @item{@indexed-scheme['metaprogramming]:  Metaprogramming Tools}
> +  @item{@indexed-scheme['planet]:           PLaneT-Related}
> +  @item{@indexed-scheme['misc]:             Miscellaneous}]
>
>  If you put symbols other than these the categories field, they will be
>  ignored. If you put no legal symbols in the categories field or do not
>  include this field in your info.ss file, your package will be
>  categorized as "Miscellaneous."}
>
> - at item{The @scheme['can-be-loaded-with] field:
> + at item{The @indexed-scheme['can-be-loaded-with] field:
>  If present, the can-be-loaded-with field should be a quoted datum of
>  one of the following forms:
>
> @@ -819,13 +821,13 @@
>  file, then multiple versions of the same package being loaded
>  simultaneously may be a problem. This field allows you to specify
>  whether your package can be loaded simultaneously with older versions
> -of itself. If its value is @scheme['all], then the package may be loaded
> with
> -any older version. If it is @scheme['none], then it may not be loaded with
> -older versions at all. If it is @scheme[(list 'all-except VER-SPEC ...)]
> then
> -any package except those that match one of the given VER-SPEC forms
> -may be loaded with this package; if it is @scheme[(list 'only VER-SPEC
> ...)]
> -then only packages that match one of the given VER-SPEC forms may be
> -loaded with this package.
> +of itself. If its value is @indexed-scheme['all], then the package may be
> +loaded with any older version. If it is @indexed-scheme['none], then it
> +may not be loaded with older versions at all. If it is @scheme[(list
> +'all-except VER-SPEC ...)] then any package except those that match
> +one of the given VER-SPEC forms may be loaded with this package; if it
> +is @scheme[(list 'only VER-SPEC ...)]  then only packages that match
> +one of the given VER-SPEC forms may be loaded with this package.
>
>  When checking to see if a package may be loaded, PLaneT compares it to
>  all other currently-loaded instances of the same package with any
> @@ -834,16 +836,16 @@
>  such comparisons succeed then the new package may be loaded; otherwise
>  PLaneT signals an error.
>
> -The default for this field is @scheme['none] as a conservative protection
> -measure. For many packages it is safe to set this field to
> - at scheme['any].}
> +The default for this field is @indexed-scheme['none] as a conservative
> +protection measure. For many packages it is safe to set this field to
> + at indexed-scheme['any].}
>
> - at item{The @scheme['homepage] field:
> + at item{The @indexed-scheme['homepage] field:
>  If present, the URL field should be a string corresponding to a URL
>  for the package. PLaneT provides this link with the description of your
>  package on the main PLaneT web page.}
>
> - at item{The @scheme['primary-file] field:
> + at item{The @indexed-scheme['primary-file] field:
>  If present, the primary-file field should be a either a string
>  corresponding to the name (without path) of the main Scheme source
>  file of your package, or a list of such strings. The PLaneT web page
> @@ -856,7 +858,7 @@
>  line printed on your package's page. If you include a list of strings,
>  then the first legal file string in the list will be used.}
>
> - at item{The @scheme['required-core-version] field: If present, the
> + at item{The @indexed-scheme['required-core-version] field: If present, the
>  required-core-version field should be a string with the same syntax as
>  the output of the @scheme[version] function. Defining this field
>  indicates that PLaneT should only allow users of a version of mzscheme
> @@ -866,14 +868,14 @@
>  instance, setting this field to @scheme["300.2"] would cause the PLaneT
> server
>  not to serve it to MzScheme v300.1 or older clients.}
>
> - at item{The @scheme['version] field:
> + at item{The @indexed-scheme['version] field:
>  If present, the version field should be a string that describes the
>  version number of this code that should be presented to users (e.g.,
>  @scheme["0.15 alpha"]). This field does not override or in any way interact
>  with your package's package version number, which is assigned by
>  PLaneT, but may be useful to users.}
>
> - at item{The @scheme['repositories] field: If present, the repositories
> + at item{The @indexed-scheme['repositories] field: If present, the
> repositories
>  field should be a list consisting of some subset of the strings
>  @scheme["4.x"] and @scheme["3xx"]. The string @scheme["4.x"] indicates
>  that this package should be included in the v4.x repository (which
> @@ -886,9 +888,9 @@
>
>  In addition, PLaneT uses the setup-plt installer to install packages
>  on client machines, so most fields it looks for can be included with
> -their usual effects. In particular, adding a @scheme['name] field indicates
> that
> -the Scheme files in the package should be compiled during
> -installation; it is a good idea to add it.
> +their usual effects. In particular, adding a @indexed-scheme['name]
> +field indicates that the Scheme files in the package should be
> +compiled during installation; it is a good idea to add it.
>
>  An example info.ss file looks like this:
>
>
> _________________________________________________
>  For list-related administrative tasks:
>  http://list.cs.brown.edu/mailman/listinfo/plt-dev
>
>


Posted on the dev mailing list.