Newsgroups: comp.os.linux.announce,comp.os.linux
From: jeffk@cyberspace.org (Jeff Kopmanis)
Subject: [Repost] LSM Entry Template (26JUN93)
Message-ID: <1993Jul11.200624.22408@dg-rtp.dg.com>
Approved: linux-announce@tc.cornell.edu (Matt Welsh)
Date: Sun, 11 Jul 93 20:06:24 GMT

I've been getting entries pretty regularly now through mail channels. Thank
you developers for being so cooperative.  I *have* gotten some entries using
the older format, so just for the record and if I've neglected to do so up
till now, here's a current copy of the LSM Entry Template, released on
26JUN93.  Please read through the changes section, as there are some subtle,
but important changes.

Thanks for all of your support and cooperation,
-Jeff.  :)



Here's a copy of the template:


Linux Software Map Entry Template                           Release: 26JUNE93
=============================================================================

Synopsis:

The LSM is a directory of information about each of the software packages
available via FTP for the Linux operating system.  It is meant to be a public
information resource.  All entries have been entered by volunteers all over
the world via email using the template below.  New versions will appear
first on sunsite.unc.edu and will be announced in the newsgroup
comp.os.linux.announce .  Discussions pertaining to the LSM will be held in
the newsgroup comp.os.linux .  Any questions or comments can be entered in
comp.os.linux or sent to me directly at jeffk@cyberspace.org .

Instructions:

Any new packages or updates to old entries should be entered in the template
below and sent to jeffk@cyberspace.org (Jeff Kopmanis).  Each release of the
LSM will have the current template as part of the package.  Any changes to
the template will be made and released there.

*PLEASE* use the entry template below when submitting information.  It has
been designed so that all you have to do is fill in the blanks and send it
in as is.  Your entry will be read into the database directly from your
email response with little if any hand manipulation.

DO NOT ADD OR REMOVE FIELDS OR LINES.  DO NOT RENAME FIELDS.  DO NOT REMOVE
THE BEGIN OR END MARKERS.  Please pay attention to the field lengths listed to
the left of the field names, as any text beyond that length will be truncated.

Complete as many fields as possible.  If there are multiples of a field
type, such as DESC, fill the fields from the top down and be as complete
as possible..  Make any corrections that are necessary.  The initial data
came from a variety of sources, and is not at all assumed to be correct.

Once you have completed the documentation as best as possible, email the
modified version of this file to:   jeffk@cyberspace.org

Thank you VERY much for your time and enthusiasm.  Your contribution will
help to ensure that the Linux Software Map will be a success.

-Jeff.  :)   (jeffk@cyberspace.org) (Jeffrey J. Kopmanis)


============================================================================
Changes in 26JUN93:

No underscores are needed.  The template is now case-insensitive. Field
lengths are given beside the fields.  Type as much as you want...I'll just
truncate the extra text to fit in the fields.  Internationally understandable
date format: 26JUN93 -- it's clearer to everyone.

This is a direct result of the somewhat lukewarm acceptance of sending in
templates.  Hopefully, the improvements in my file reader make for a more
flexible, easy-to-use template.


=============================================================================
Descriptions of fields used in the LSM template
=============================================================================

PkgName:    The filename of the software archive or "package".
Title:      The name of the package.  example: "Emacs text editor"
Version:    The version number or designation.
Desc1:      3 lines of text describing the package's function or purpose.
Desc2:        The more descriptive you are the more useful the entry will be.
Desc3:     
Author:     Who wrote the package originally, or, the person who ported it.
              Specify email address, if known.
Maintby:    Who currently maintains the code, with email address if known.
MaintAt1:   FTP address of the primary site where this package is distributed.
PathFile1:  The path and file name of the package at the primary site.
MaintAt2:   Secondary FTP site address.
PathFile2:  The path and file name of the package at the secondary site.
Required1:  Required hardware or software needed to run this package.  Please
Required2:    be as specific as possible, for this information is VERY
Required3:    important.
CopyPolicy: The copyright policy of this package.  Put overflow in COMMENTs.
              example: for GCC you would enter:  "GNU Copyleft"
Keywords:   Keywords to use in searching for this package.
ApproxSize: The size of the filename in bytes.  Use K if not known for sure.
Last3Rel:   The version numbers of the last 3 releases of this package.
Comment1:   Put any pertenant information that doesn't fit in the above
Comment2:     fields or categories here.  The more you tell us, the better.
Comment3:  
CheckedBy:  Take credit for your work!  (Put your name here)
Date:       Tell us all when you took credit.  Use this format: 26JUN93


-------------------------------- cut here ------------------------------------
Begin
35:PkgName    =
35:Title      =
25:Version    =
65:Desc1      =
65:Desc2      =
65:Desc3      =
65:Author     =
65:MaintBy    =
65:MaintAt1   =
65:PathFile1  =
65:MaintAt2   =
65:PathFile2  =
65:Required1  =
65:Required2  =
65:Required3  =
65:CopyPolicy =
65:Keywords   =
15:ApproxSize =
65:Last3Rel   =
65:Comment1   =
65:Comment2   =
65:Comment3   =
30:CheckedBy  =
 8:Date       =
End


-- 
---------------------------------------------------------------------------
Jeff Kopmanis       (Ann Arbor, Michigan)   |  email:  jeffk@cyberspace.org
Organizer of the Linux Software Map (LSM)   |  phone: (313) 393-4784 (work)
---------------------------------------------------------------------------

--
Send submissions for comp.os.linux.announce to: linux-announce@tc.cornell.edu
