LISTSERV mailing list manager LISTSERV 16.0

Help for TEAM-ADA Archives


TEAM-ADA Archives

TEAM-ADA Archives


TEAM-ADA@LISTSERV.ACM.ORG


View:

Message:

[

First

|

Previous

|

Next

|

Last

]

By Topic:

[

First

|

Previous

|

Next

|

Last

]

By Author:

[

First

|

Previous

|

Next

|

Last

]

Font:

Proportional Font

LISTSERV Archives

LISTSERV Archives

TEAM-ADA Home

TEAM-ADA Home

TEAM-ADA  January 1998

TEAM-ADA January 1998

Subject:

New set of PAL submission instructions

From:

Richard Conn <[log in to unmask]>

Reply-To:

[log in to unmask]

Date:

Sat, 24 Jan 1998 09:46:06 -0500

Content-Type:

text/plain

Parts/Attachments:

Parts/Attachments

text/plain (303 lines)

Hi, Everyone,

Several of you have expressed interest in contributing to the
PAL (especially in light of the new Ada CDROM coming out), and
attached below is a new set of PAL submission instructions.
It constitutes a very minor revision over the old set.  In
particular, the "main" changes are that (1) you may freely use
either MSDOS or UNIX text file formats as you wish (everyone can
handle the conversions now) and (2) PAGER2 isn't necessary any
more (and does not make sense in some cases).

GWRL (pronounced "girl") --
In the future, GWRL will be fully online (GWRL = Generic Web-based
Reuse Library), and the submission instructions will change again
(the PAL's Item Description files will be replaced with GWRL Asset
Descriptors), but not a big deal ... the existing 600+ PAL
Item Description files can be automatically converted to GWRL
Asset Descriptors by one of the tools in the GWRL family.  Takes
about a minute or two (yes, when you see GWRL next month, it will
already be in Build 3 or even later).  Early next week, I'll bring
you up to speed with the SDE project and you'll be able to see what
GWRL can do.

Thanks for your interest in the PAL,
Rick
--
Richard Conn
mailto:[log in to unmask]                     http://monmouth.com/~conn/
Opinions expressed are my own and not necessarily those of anyone else.
=======================================================================
SUBMIT3.TXT - Detailed PAL Submission Instructions
by Richard Conn, mailto:[log in to unmask]
Last Update: 24 January 1998

In order to make the material in the PAL available to as wide an
audience as possible on as many platforms as possible, the following
guidelines are strongly suggested.  Files in other configurations will
be accepted, so these guidelines are not going to be enforced beyond the
PAL-specific file naming conventions, but your compliance with these
guidelines will be appreciated.

All items in the PAL are approved for public release with unlimited
distribution (EXCEPT, of course, to Designated Countries).  They may be
shareware, freeware, carry a GNU copyleft, an ACM copyright, or any
other copyright so long as they are approved for public release with
unlimited distribution.  Note that the distribution mentioned here is
international in nature.

This file is organized as follows:
  1. This introduction
  2. Overview of Guidelines
  3. Details of Guidelines with Rationale
  4. SID (Software Item Description) template
  5. TID (Text Item Description) template

Overview of Guidelines
----------------------
1. Package your files as larger ZIP files created by the Info-ZIP
program.
2. Keep the file sizes of the ZIP files down to around 1.2M bytes or
less.
3. Use short file names for all component and ZIP files (8 character
file
   names, 3 character file types).
4. Format all text files (Ada source code, documents, Postscript files,
etc.)
   in the MSDOS or UNIX text file formats.
5. Submit items to the PAL that you, yourself, have created or are
responsible
   for.  If an item is available that you think should be in the PAL,
let me
   know, and I will contact the original author or responsible
organization.
6. Fill out a SID or TID (Software Item Description or Text Item
Description)
   template and send it to me via email or FTP (this usually takes only
   a few minutes).

Details of Guidelines with Rationale
------------------------------------

1. Package your files as larger ZIP files created by the Info-ZIP
program.
  Rationale: The ZIP program provided by the Info-ZIP group on the
Internet has become a defacto standard for many of the major
repositories on the Internet, so users from these repositories as well
as the PAL will be able to deal with files created by this program.
Info-ZIP is extremely portable, running on more than 30 different
platforms (including MSDOS, MS Windows, many UNIX platforms, VAX/VMS,
NeXT, and Macintosh), and has no export control restrictions on it, so
foreign nationals (EXCEPT those in Designated Countries, of course) may
access and use it.  Additionally, Info-ZIP offers a very good
compression algorithm, saving significantly on the disk space used by
the distributed files.
  Info-ZIP's zip and unzip programs can be found in the PAL User's
Toolkit.

2. Keep the file sizes of the ZIP files down to around 1.2M bytes or
less.
  Rationale: Users can place your files on floppy disks with greater
ease. Additionally, large files sometimes cause problems with various
Internet file transfer mechanisms, but the 1.2M byte limit does not seem
to hurt anything.

3. Use short file names for all component and ZIP files (8 character
file names, 3 character file types).
  Rationale: This is the file name standard for MSDOS and ISO-9660,
which the most portable CDROM format.  The entire PAL is dumped onto
various CDROMs from time to time, so all directory names and file names
in the PAL are in ISO-9660 format.  Letters, digits, and underscores are
allowed.
  In the near future, ISO-9660 with the Rock Ridge Extensions will
become widely used.  The Rock Ridge Extensions provide for the automatic
mapping to longer file names on systems which will support them.  For
now, vanilla ISO-9660 is the only standard that can be counted on.
  If the component files of your ZIP files do not conform to the shorter
names, at least try to make the first 8 characters unique.  Most
Info-ZIP targets will try to convert to the shorter file names if they
can.

4. Format all text files (Ada source code, documents, Postscript files,
etc.) in the MSDOS or UNIX text file formats.
  Rationale: All major target platforms are able to read MSDOS or UNIX
text file formats and convert them into their local text file formats.
The PAL itself contains tools that users can copy and compile or run to
perform text file conversions (the tools in the PAL Toolkit are
presented in both source code and binary forms).  Text file converters
for UNIX-to-MSDOS, MSDOS-to-UNIX, and UNIX-or-MSDOS-to- current_target
can be found in the PAL User's Toolkit.

5. Submit items to the PAL that you, yourself, have created or are
responsible for.  If an item is available that you think should be in
the PAL, let me know, and I will contact the original author or
responsible organization.
  Rationale: All of the Internet archives have had problems from time to
time with submissions that did not come from the original source or a
responsible organization.  Sometimes submissions of commercial offerings
are inadvertently made; sometimes items that have been tampered with are
submitted.  Most of the archives now make attempts to deal directly with
the original author or a responsible organization.

6. Fill out a SID or TID (Software Item Description or Text Item
Description) template and send it to me via email or FTP.
  Rationale: You know your submission better than me, and you can
probably provide the information in the SID or TID file with greater
ease.  This is the only real hastle I ask of you.  The SID and TID files
are the basis for the database in the PAL that generates the online
database files, the browser database, and the PAL Catalog.  These files
contain abstracts, release notices, version information, review codes,
keywords, catalog taxonomy information, copyright information, and other
items of interest to the users of the PAL.
  SID and TID templates are attached to the end of this file for your
convenience.

------ SID template -- Cut here --------------
%UNIT NAME
<You fill this in ... I may change it to be more mnemonic later>
%VERSION
<You fill this in>
%REVIEW CODE
NR
%INET ADDRESS
<You fill this in>
%AUTHOR
<You fill this in ... as many lines as you like ... suggest including
mailing address and phone number>
%RIGHTS
Approved for Public Release; Distribution Unlimited
%COPYRIGHT
<You fill this in with year and person/company who owns the copyright>
%DATE CREATED
<You fill this in>
%DATE RELEASED
<You fill this in>
%DATE LAST UPDATED
<You fill this in ... same as %DATE RELEASED>
%LOCATION
<You fill this in with info on some other place this item can be found>
PAL
%ENVIRONMENT
<You fill this in ... what target platforms/Ada compilers/etc are used?>
%LIMITATIONS
<You fill this in ... Special limits, like proprietary products needed>
%=CLASSIFICATION
%CATEGORY LEVEL 1
<I fill this in>
%CATEGORY LEVEL 2
<I fill this in>
%CATEGORY LEVEL 3
<I fill this in>
%CATEGORY LEVEL 4
<I fill this in>
%KEYWORD
<You fill this in ... 1 keyword or phrase per line>
%INDEX
<I fill this in>
%TAXONOMY
<I fill this in>
%DEPENDENCIES
<You fill this in ... does your software use some other parts library
like CS Parts or with some compiler-specific packages?>
%SEE ALSO
<You and I fill this in ... alternate references>
%SHORT DESCRIPTION
<You fill this in ... 40 characters>
%=FILE LISTING
%FILE SPECS
<I fill this in>
%DIRECTORY DISPLAY
<I fill this in>
%=ABSTRACT
<You fill this in>
%=REVISION HISTORY
<You fill this in ... suggest date, version number, comments>
%=RELEASE NOTICE
This prologue must be included in all copies of this software.
Restrictions on use or distribution:  NONE
<You add to this as you desire>
%=DISCLAIMER
        This software and its documentation are provided "AS IS" and
without any expressed or implied warranties whatsoever.  No warranties
as to performance, merchantability, or fitness for a particular
purpose exist.
        The user is advised to test the software thoroughly before
relying on it.  The user must assume the entire risk and liability of
using this software.  In no event shall any person or organization of
people be held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.

<You add to this as you desire>
%=
------ End SID template -- Cut here --------------

------ TID template -- Cut here --------------
%UNIT NAME
<You fill this in ... I may change it to be more mnemonic later>
%VERSION
<You fill this in>
%ORIGIN
<You fill this in with info on where the item came from>
%REVIEW CODE
NR
%INET ADDRESS
<You fill this in>
%AUTHOR
<You fill this in ... as many lines as you like ... suggest including
mailing address and phone number>
%RIGHTS
Approved for Public Release; Distribution Unlimited
%COPYRIGHT
<You fill this in with year and person/company who owns the copyright>
%LOCATION
<You fill this in with info on some other place this item can be found>
PAL
%=CLASSIFICATION
%CATEGORY LEVEL 1
<I fill this in>
%CATEGORY LEVEL 2
<I fill this in>
%CATEGORY LEVEL 3
<I fill this in>
%CATEGORY LEVEL 4
<I fill this in>
%KEYWORDS
<You fill this in ... 1 keyword or phrase per line>
%INDEX
<I fill this in>
%TAXONOMY
<I fill this in>
%DEPENDENCIES
<You fill this in ... does your document require other documents
in order to understand it?>
%SEE ALSO
<You and I fill this in ... alternate references>
%SHORT DESCRIPTION
<You fill this in ... 40 characters>
%=FILE LISTING
%FILE SPECS
<I fill this in>
%DIRECTORY DISPLAY
<I fill this in>
%=ABSTRACT
<You fill this in>
%=REVISION HISTORY
<You fill this in ... suggest date, version number, comments>
%=RELEASE NOTICE
This prologue must be included in all copies of this software.
Restrictions on use or distribution:  NONE
<You add to this as you desire>
%=DISCLAIMER
This documentation is provided "AS IS" and without any expressed or
implied warranties whatsoever.  No warranties as to performance,
merchantability, or fitness for a particular purpose exist.

The user must assume the entire risk and liability of using this
document.  In no event shall any person or organization of people be
held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.

<You add to this as you desire>
%=
------ End TID template -- Cut here --------------

Top of Message | Previous Page | Permalink

Advanced Options


Options

Log In

Log In

Get Password

Get Password


Search Archives

Search Archives


Subscribe or Unsubscribe

Subscribe or Unsubscribe


Archives

December 2017
November 2017
October 2017
September 2017
June 2017
May 2017
April 2017
January 2017
December 2016
November 2016
October 2016
August 2016
July 2016
June 2016
May 2016
April 2016
March 2016
February 2016
January 2016
December 2015
November 2015
October 2015
September 2015
August 2015
June 2015
May 2015
April 2015
March 2015
February 2015
January 2015
December 2014
November 2014
September 2014
August 2014
July 2014
June 2014
May 2014
April 2014
March 2014
February 2014
January 2014
December 2013
November 2013
October 2013
September 2013
June 2013
May 2013
April 2013
March 2013
February 2013
January 2013
December 2012
November 2012
October 2012
September 2012
August 2012
July 2012
June 2012
May 2012
April 2012
February 2012
January 2012
December 2011
November 2011
October 2011
September 2011
August 2011
July 2011
June 2011
May 2011
April 2011
December 2010
November 2010
October 2010
September 2010
June 2010
May 2010
April 2010
March 2010
February 2010
January 2010
December 2009
November 2009
October 2009
September 2009
August 2009
July 2009
June 2009
May 2009
April 2009
February 2009
January 2009
December 2008
November 2008
October 2008
September 2008
August 2008
June 2008
May 2008
April 2008
March 2008
February 2008
January 2008
December 2007
November 2007
October 2007
September 2007
June 2007
May 2007
March 2007
February 2007
December 2006
November 2006
October 2006
September 2006
August 2006
July 2006
June 2006
May 2006
April 2006
March 2006
February 2006
January 2006
December 2005
November 2005
October 2005
August 2005
July 2005
June 2005
May 2005
April 2005
March 2005
February 2005
January 2005
December 2004
November 2004
October 2004
September 2004
August 2004
July 2004
June 2004
May 2004
March 2004
February 2004
January 2004
December 2003
November 2003
October 2003
September 2003
August 2003
July 2003
June 2003
May 2003
April 2003
March 2003
February 2003
January 2003
December 2002
November 2002
October 2002
September 2002
August 2002
July 2002
June 2002
May 2002
April 2002
March 2002
February 2002
December 2001
November 2001
October 2001
September 2001
August 2001
July 2001
June 2001
May 2001
April 2001
March 2001
February 2001
January 2001
December 2000
November 2000
October 2000
September 2000
August 2000
July 2000
June 2000
May 2000
April 2000
March 2000
February 2000
January 2000
December 1999
November 1999
October 1999
September 1999
August 1999
July 1999
June 1999
May 1999
April 1999
March 1999
February 1999
January 1999
December 1998
November 1998
October 1998
September 1998
August 1998
July 1998
June 1998
May 1998
April 1998
March 1998
February 1998
January 1998
December 1997
November 1997
October 1997
September 1997
August 1997
July 1997
June 1997
May 1997
April 1997
March 1997
February 1997
January 1997
December 1996
November 1996
October 1996

ATOM RSS1 RSS2



LISTSERV.ACM.ORG

Secured by F-Secure Anti-Virus CataList Email List Search Powered by the LISTSERV Email List Manager