Author: wayland
Date: 2008-12-20 04:44:08 +0100 (Sat, 20 Dec 2008)
New Revision: 24508
Modified:
docs/Perl6/Spec/S22-package-format.pod
Log:
Added some definitions
Modified: docs/Perl6/Spec/S22-package-format.pod
===================================================================
--- docs/Perl6/Spec/S22-package-format.pod 2008-12-20 03:19:23 UTC (rev
24507)
+++ docs/Perl6/Spec/S22-package-format.pod 2008-12-20 03:44:08 UTC (rev
24508)
@@ -13,24 +13,33 @@
=head1 VERSION
- Maintainer: Tim Nelson <wayl...@wayland.id.au>
+ Maintainer: Jos Boumans <k...@cpan.org>
Date: 3 Nov 2005
Last Modified: 19 Dec 2008
Number: 22
Version: 2
-=head1 Overview
+=head1 OVERVIEW
-=head2 What this isn't
+=head2 Terminology and Scope
+I'll start by listing a few terms, and whether this document is supposed to
cover them or
+not.
+
=over
-=item * This does not specify repositories. For information on that, see
-http://cpan6.org/
+=item * .jib files; this is the source package format, and is specified in
this document
-=item * This does not specify software for downloading, building, or
installing packages.
-For information on that, see build-and-install-notes.pod
+=item * CPAN6; this is a piece of software for managing an archive network
(such as CPAN).
+This is not specified in this document; see http://cpan6.org/
+=item * ???A; this is an actual network based on the cpan6 software (see
above). It also
+is not documented here.
+
+=item * ???B; this is a piece of software that starts with what it can get on
???A, and
+attempts to give you an installed perl module (this is a replacement for
+CPANPLUS/cpan2dist)
+
=back
=head2 Inspirations
@@ -42,11 +51,13 @@
=item * Debian Policy: http://www.us.debian.org/doc/debian-policy
=item * Software::Packager::Metadata:
-http://perlsoftpackmet.svn.sourceforge.net/viewvc/perlsoftpackmet/main/doc/
(click ont he
+http://perlsoftpackmet.svn.sourceforge.net/viewvc/perlsoftpackmet/main/doc/
(click on the
link in the Rev. column next to Overview)
-=head1 Package Layout
+=back
+=head1 PACKAGE LAYOUT
+
=head2 Project directory
Step 1 of the general flow should ideally be done by an automated tool, like
@@ -113,7 +124,7 @@
There is room to ship more files alongside the 2 above mentioned archives.
This allows us to ship an extra md5sum, version, signature, anything.
-=head1 Metadata Spec
+=head1 METADATA SPEC
- Define no more than needed to get started for now
- Allow for future extensions
@@ -162,7 +173,7 @@
[3] Steal more tags from debian policy
-=head1 Dependencies
+=head1 DEPENDENCIES
=head2 Dependency Notation
