[svn:parrot] r45652 - in trunk/docs/pdds: . draft
coke at svn.parrot.org
coke at svn.parrot.org
Wed Apr 14 02:57:44 UTC 2010
Author: coke
Date: Wed Apr 14 02:57:43 2010
New Revision: 45652
URL: https://trac.parrot.org/parrot/changeset/45652
Log:
PDD cleanup (TT #1536); Remove maintainer, changes sections.
Also, put version after abstract. Remove optional sections. Minor textual and
podular cleanups. Update copyrights on edited files.
Modified:
trunk/docs/pdds/draft/pdd01_overview.pod
trunk/docs/pdds/draft/pdd05_opfunc.pod
trunk/docs/pdds/draft/pdd06_pasm.pod
trunk/docs/pdds/draft/pdd08_keys.pod
trunk/docs/pdds/draft/pdd10_embedding.pod
trunk/docs/pdds/draft/pdd11_extending.pod
trunk/docs/pdds/draft/pdd14_numbers.pod
trunk/docs/pdds/draft/pdd16_native_call.pod
trunk/docs/pdds/draft/pdd29_compiler_tools.pod
trunk/docs/pdds/draft/pdd31_hll.pod
trunk/docs/pdds/draft/pdd31_hll_interop.pod
trunk/docs/pdds/pdd00_pdd.pod
trunk/docs/pdds/pdd03_calling_conventions.pod
trunk/docs/pdds/pdd07_codingstd.pod
trunk/docs/pdds/pdd09_gc.pod
trunk/docs/pdds/pdd15_objects.pod
trunk/docs/pdds/pdd17_pmc.pod
trunk/docs/pdds/pdd18_security.pod
trunk/docs/pdds/pdd19_pir.pod
trunk/docs/pdds/pdd20_lexical_vars.pod
trunk/docs/pdds/pdd21_namespaces.pod
trunk/docs/pdds/pdd22_io.pod
trunk/docs/pdds/pdd23_exceptions.pod
trunk/docs/pdds/pdd24_events.pod
trunk/docs/pdds/pdd25_concurrency.pod
trunk/docs/pdds/pdd26_ast.pod
trunk/docs/pdds/pdd27_multiple_dispatch.pod
trunk/docs/pdds/pdd28_strings.pod
trunk/docs/pdds/pdd30_install.pod
trunk/docs/pdds/pdd_template.pod
Modified: trunk/docs/pdds/draft/pdd01_overview.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd01_overview.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd01_overview.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 1: Overview
@@ -190,7 +190,7 @@
bytecode and save it for later use. Essentially, we would compile a program as
normal, but then simply freeze the bytecode to disk for later loading.
-=head3 Your HLL in, Java, CLI, or whatever out
+=head3 Your HLL in; Java, CLI, or whatever out
The previous section assumes that we will be emitting Parrot bytecode.
However, there are other possibilities: we could translate the bytecode
@@ -200,7 +200,7 @@
=head2 References
-To come.
+None.
=cut
Modified: trunk/docs/pdds/draft/pdd05_opfunc.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd05_opfunc.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd05_opfunc.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 5: Opcodes
@@ -13,6 +13,10 @@
{{ NOTE: standardize on underscores or no underscores? }}
+=head2 Version
+
+$Revision$
+
=head2 Description
The opcode functions are the workhorse of the Parrot engine. They control
@@ -169,34 +173,7 @@
=head2 References
-Oploop PDD, PDD 4 (Internal types)
-
-=head2 Footnotes
-
-None.
-
-=head2 Version
-
-1.0
-
-=head3 Current
-
- Maintainer: Dan Sugalski <dan at sidhe.org>
- Class: Internals
- PDD Number: 5
- Version: 1.0
- Status: Developing
- Last Modified: 16 Jul 2001
- PDD Format: 1
- Language: English
-
-=head3 History
-
-None. First version
-
-=head2 Changes
-
-None. First version
+Oploop PDD, PDD 4 (Internal types).
=cut
Modified: trunk/docs/pdds/draft/pdd06_pasm.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd06_pasm.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd06_pasm.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -7,6 +7,10 @@
The format of Parrot's bytecode assembly language.
+=head2 Version
+
+$Revision$
+
=head2 Description
Parrot's bytecode can be thought of as a form of machine language for a
@@ -1006,186 +1010,10 @@
=back
-=head2 Attachments
-
-None.
-
=head2 References
None.
-=head2 Version
-
-1.9
-
-=head3 Current
-
- Maintainer: Dan Sugalski
- Class: Internals
- PDD Number: 6
- Version: 1.9
- Status: Developing
- Last Modified: 28 February 2007
- PDD Format: 1
- Language: English
-
-=head3 History
-
-=over 4
-
-=item Version 1.9
-
-February 28, 2007
-
-=item Version 1.8
-
-December 11, 2002
-
-=item Version 1.7
-
-December 02, 2002
-
-=item Version 1.6
-
-November 05, 2001
-
-=item Version 1.5
-
-October 12, 2001
-
-=item Version 1.4
-
-September 24, 2001
-
-=item Version 1.3
-
-September 12, 2001
-
-=item Version 1.2
-
-August 25, 2001
-
-=item Version 1.1
-
-August 8, 2001
-
-=item version 1
-
-None. First version
-
-=back
-
-=head2 Changes
-
-=over 4
-
-=item Version 1.9
-
-=over 4
-
-=item * Removed remark on "upper case names reserved for directives"
-
-=item * Fixed ".sub" directive, should be ".pcc_sub"
-
-=item * Added constant directive in description.
-
-=item * Added grammar overview.
-
-=back
-
-=item Version 1.8
-
-=over 4
-
-=item * Added property ops
-
-=item * Fixed some bad register designations
-
-=item * Opened up opcode name character list to include numbers
-
-=back
-
-=item Version 1.7
-
-=over 4
-
-=item * Fixed stack ops; push, pop, and clear properly documented according to
-the engine's behaviour now.
-
-=back
-
-=item Version 1.6
-
-=over 4
-
-=item * Added GC opcodes
-
-=back
-
-=item Version 1.5
-
-=over 4
-
-=item * Now have a bsr in addition to a jsr
-
-=item * return is now ret
-
-=item * Added save and restore ops for saving and restoring individual
-registers
-
-=back
-
-=item Version 1.4
-
-=over 4
-
-=item * Conditional branches have just a true destination now
-
-=item * Added the I/O ops
-
-=item * Added in the threading ops
-
-=item * Added in the interpreter ops
-
-=back
-
-=item Version 1.3
-
-=over 4
-
-=item * Added in the low-level module loading ops
-
-=item * Added in transcendental functions and modulo
-
-=item * Finished the pad/global variable fetching bits
-
-=back
-
-=item Version 1.2
-
-We have an interpreter now! Yay! (Okay, a simple one, but still...) Changes
-made to reflect that.
-
-=item Version 1.1
-
-=over 4
-
-=item * Added in object
-
-=item * Changed remnants of "perl" to "Parrot"
-
-=item * Branch destination may be integer constant
-
-=item * Added L<Assembly Syntax> section
-
-=back
-
-=item Version 1.0
-
-None. First version
-
-=back
-
=cut
__END__
Modified: trunk/docs/pdds/draft/pdd08_keys.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd08_keys.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd08_keys.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -8,6 +8,10 @@
This PDD aims to clear up the confusion regarding the implementation of keyed
access to PMCs in Parrot.
+=head2 Version
+
+$Revision$
+
=head2 Description
First, let's define some terminology. An C<aggregate PMC> is one which stores
@@ -265,44 +269,9 @@
The type values shown above are actually the C<PARROT_ARG_*> values taken from
F<include/parrot/op.h>.
-=head2 Version
-
-=head3 Current
-
- Maintainer: Simon Cozens <simon at netthink.co.uk>
- Class: Internals
- PDD Number: 8
- Version: 1.3
- Status: Developing
- Last Modified: 25 August, 2002
- PDD Format: 1
- Language: English
-
-=head3 History
-
-=over 4
-
-=item Sun Aug 25 11:14:43 GMT 2002 : Version 1.3
-
-Updated to reflect Dan's decision to change keys to use PMCs instead of a
-custom data structure. Also corrects documentation of multi-level keys and how
-they are compiled and work. tom at compton.nu.
-
-=item Thu Apr 25 18:30:36 UTC 2002 : Version 1.2
-
-Renamed C<KEY_PAIR> to C<KEY_ATOM>, updated to reflect changeover to linked
-list. - steve at fink.com
-
-=item Fri Mar 8 18:47:34 GMT 2002 : Version 1.1
-
-updated to reflect Dan's comments that non-aggregates also support C<_keyed>
-variant vtable functions.
-
-=back
-
=head2 References
-To come.
+None.
=cut
Modified: trunk/docs/pdds/draft/pdd10_embedding.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd10_embedding.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd10_embedding.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (c) 2001-2009, Parrot Foundation.
+# Copyright (c) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD10: Embedding and Extending
@@ -244,17 +244,9 @@
such that it is possible to load source code written in that language or pass
source code to an interpreter successfully.
-=head2 Attachments
-
-Any associated documents.
-
-=head2 Footnotes
-
-List of footnotes to the text.
-
=head2 References
-List of references.
+None.
=cut
Modified: trunk/docs/pdds/draft/pdd11_extending.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd11_extending.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd11_extending.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 11: Extending
@@ -9,6 +9,10 @@
Parrot for code written in C or other compiled languages. It provides about
the same level of access to Parrot that bytecode programs have.
+=head2 Version
+
+$Revision$
+
=head2 Description
The API presents to C programs roughly the same interface presented to
@@ -349,51 +353,10 @@
=back
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
F<docs/glossary.pod>
-=head2 Version
-
-=head3 Current
-
- Maintainer:
- Class: Internals
- PDD Number: 11
- Version: 1.0
- Status: Developing
- Last Modified: February 20, 2004
- PDD Format: 1
- Language: English
-
-=head3 History
-
-=over 4
-
-=item Version 1
-
-None. First version
-
-=back
-
-=head2 Changes
-
-=over 4
-
-=item Version 1.0
-
-None. First version
-
-=back
-
=cut
__END__
Modified: trunk/docs/pdds/draft/pdd14_numbers.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd14_numbers.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd14_numbers.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 14: Numbers
@@ -574,10 +574,6 @@
suitable opcodes. Conversion to and from Parrot strings, conversion to and
from floating point types, sprintf output of bignumbers.
-=head2 Attachments
-
-=head2 Footnotes
-
=head2 References
IBM's Standard Decimal Arithmetic, with tests
Modified: trunk/docs/pdds/draft/pdd16_native_call.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd16_native_call.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd16_native_call.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 16: Native Call Interface (NCI)
@@ -8,6 +8,10 @@
This PDD describes the native call interface, and the function signatures used
to describe those functions.
+=head2 Version
+
+$Revision$
+
=head2 Description
The NCI is designed to allow Parrot to interface to I<most> of the functions
@@ -313,50 +317,15 @@
}
The file containing this C code should be compiled as a shared library
-(specifying the C<include> directory so C<<parrot/parrot.h>> can be found.)
+(specifying the C<include> directory so F<parrot/parrot.h> can be found.)
=head2 References
-L<pdd06_pasm.pod>
+F<pdd06_pasm.pod>
=head2 See Also
-L<t/pmc/nci.t>, L<src/nci_test.c>
-
-=head2 Version
-
-=head3 Current
-
- Maintainer: Dan Sugalski
- Class: Internals
- PDD Number: 16
- Version: 1.3
- Status: Developing
- Last Modified: Feb 26, 2007
- PDD Format: 1
- Language: English
-
-=head3 History
-
-=over 4
-
-=item version 1.3
-
-Updated with example for callbacks
-
-=item version 1.2
-
-Updated with basic example for NCI.
-
-=item version 1.1
-
-Changed callback section to reflect current status.
-
-=item version 1
-
-None. First version
-
-=back
+F<t/pmc/nci.t>, F<src/nci_test.c>
=cut
Modified: trunk/docs/pdds/draft/pdd29_compiler_tools.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd29_compiler_tools.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd29_compiler_tools.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,16 +1,15 @@
-# Copyright (C) 2008-2009, Parrot Foundation.
+# Copyright (C) 2008-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 29: Compiler Tools
-=head2 Version
+=head2 Abstract
-$Revision$
+This PDD specifies the Parrot Compiler Tools (PCT).
-=head2 Maintainer
+=head2 Version
-Will "Coke" Coleda
-Klaas-Jan Stol
+$Revision$
=head2 Definitions
@@ -23,10 +22,6 @@
A High-Level Language. Examples are: Perl, Ruby, Python, Lua, Tcl, etc.
-=head2 Abstract
-
-This PDD specifies the Parrot Compiler Tools (PCT).
-
=head2 Synopsis
Creating a PCT-based compiler can be done as follows:
@@ -356,15 +351,9 @@
=back
-=head2 Attachments
-
-None.
-
=head2 References
-docs/pdd26_ast.pod
-
-http://dev.perl.org/perl6/doc/design/syn/S05.html
+F<docs/pdd26_ast.pod>, L<http://dev.perl.org/perl6/doc/design/syn/S05.html>
=cut
Modified: trunk/docs/pdds/draft/pdd31_hll.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd31_hll.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd31_hll.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,17 +1,17 @@
-# Copyright (C) 2009, Parrot Foundation.
+# Copyright (C) 2009-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 31: HLL Compilers and Libraries
-=head2 Version
-
-$Revision$
-
=head2 Abstract
This PDD describes the standard compiler API and support for
cross-library communication between high-level languages (HLLs).
+=head2 Version
+
+$Revision$
+
=head2 Description
Parrot's support for HLL interoperability is primarily focused on
@@ -299,7 +299,7 @@
=head2 References
-L<pdd21_namespaces.pod>
+F<pdd21_namespaces.pod>
=cut
Modified: trunk/docs/pdds/draft/pdd31_hll_interop.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd31_hll_interop.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/draft/pdd31_hll_interop.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,18 +1,18 @@
-# Copyright (C) 2008-2009, Parrot Foundation.
+# Copyright (C) 2008-2010, Parrot Foundation.
# $Id$
=head1 [DRAFT] PDD 31: Inter-Language Calling
-=head2 Version
-
-$Revision$
-
=head2 Abstract
This PDD describes Parrot's conventions and support for communication between
high-level languages (HLLs). It is focused mostly on what implementors should
do in order to provide this capability to their users.
+=head2 Version
+
+$Revision$
+
=head2 Description
The ability to mix different high-level languages at runtime has always been
Modified: trunk/docs/pdds/pdd00_pdd.pod
==============================================================================
--- trunk/docs/pdds/pdd00_pdd.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd00_pdd.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,17 +1,17 @@
-# Copyright (C) 2001-2008, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 0: Design Document Format
-=head2 Version
-
-$Revision$
-
=head2 Abstract
This document defines the content and format of Parrot Design Documents
(PDDs).
+=head2 Version
+
+$Revision$
+
=head2 Synopsis
Not applicable.
@@ -99,13 +99,6 @@
Document version. Since Parrot is currently kept in a Subversion repository,
the $$-delimited keyword "Revision" will do nicely.
-=item Maintainer I<(optional)>:
-
-The name and current email address for the point of contact for the PDD. This
-is the person to whom questions, comments, and patches should generally be
-addressed. This need not be the author of the document. By default, all PDDs
-are maintained by the Parrot Architect.
-
=item Abstract:
A quick blurb explaining the purpose of the PDD.
@@ -149,6 +142,7 @@
Proposed PDDs should be submitted to the parrot-dev mailing list (located
at parrot-dev at lists.parrot.org) for discussion, criticism and general
kibitzing.
+
Acceptance of a particular PDD is ultimately up to the Parrot Architect.
=head3 PDD Translations
@@ -159,22 +153,14 @@
=item *
-The C<Maintainer> section should record who made the translation.
-
-=item *
-
-The C<Version> section should include an additional note of the translation
+The C<Version> section should include an additional note of the translated
version.
=back
-=head2 Attachments
-
-(none)
-
=head2 References
-(none)
+None.
=cut
Modified: trunk/docs/pdds/pdd03_calling_conventions.pod
==============================================================================
--- trunk/docs/pdds/pdd03_calling_conventions.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd03_calling_conventions.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2008, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 3: Calling Conventions
@@ -391,13 +391,9 @@
=end PIR_FRAGMENT
-=head2 Attachments
-
-None.
-
=head2 References
-L<pdd23_exceptions.pod>
+F<pdd23_exceptions.pod>
=cut
Modified: trunk/docs/pdds/pdd07_codingstd.pod
==============================================================================
--- trunk/docs/pdds/pdd07_codingstd.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd07_codingstd.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2008, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 7: Conventions and Guidelines for Parrot Source Code
@@ -1006,7 +1006,7 @@
=head2 References
-none
+None.
=cut
Modified: trunk/docs/pdds/pdd09_gc.pod
==============================================================================
--- trunk/docs/pdds/pdd09_gc.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd09_gc.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -602,36 +602,28 @@
=back
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
"Uniprocessor Garbage Collection Techniques"
-http://www.cs.rice.edu/~javaplt/311/Readings/wilson92uniprocessor.pdf
+L<http://www.cs.rice.edu/~javaplt/311/Readings/wilson92uniprocessor.pdf>
"A unified theory of garbage collection":
-http://portal.acm.org/citation.cfm?id=1028982
+L<http://portal.acm.org/citation.cfm?id=1028982>
"Scalable Locality-Conscious Multithreaded Memory Allocation":
-http://people.cs.vt.edu/~scschnei/papers/ismm06.pdf
+L<http://people.cs.vt.edu/~scschnei/papers/ismm06.pdf>
"Parallel and concurrent garbage collectors":
-http://chaoticjava.com/posts/parallel-and-concurrent-garbage-collectors/
+L<http://chaoticjava.com/posts/parallel-and-concurrent-garbage-collectors/>
"Region-Based Memory Management":
-http://www.irisa.fr/prive/talpin/papers/ic97.pdf
+L<http://www.irisa.fr/prive/talpin/papers/ic97.pdf>
Dan's first musings on the GC subsystem:
-http://www.mail-archive.com/perl6-all@perl.org/msg14072.html
+L<http://www.mail-archive.com/perl6-all@perl.org/msg14072.html>
Semi-timely and ordered destruction:
-http://www.sidhe.org/~dan/blog/archives/000199.html
+L<http://www.sidhe.org/~dan/blog/archives/000199.html>
=cut
Modified: trunk/docs/pdds/pdd15_objects.pod
==============================================================================
--- trunk/docs/pdds/pdd15_objects.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd15_objects.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2007, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 15: Objects and Classes
@@ -1630,11 +1630,6 @@
=end html
-
-=head2 Footnotes
-
-None.
-
=head2 References
None.
Modified: trunk/docs/pdds/pdd17_pmc.pod
==============================================================================
--- trunk/docs/pdds/pdd17_pmc.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd17_pmc.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -3,15 +3,15 @@
=head1 PDD 17: Polymorphic Containers
-=head2 Version
-
-$Revision$
-
=head2 Abstract
This PDD describes the internal structure and behavior of the Polymorphic
Container (PMC) data type.
+=head2 Version
+
+$Revision$
+
=head2 Description
PMCs implement all internal data types more complex than a simple integer,
@@ -1809,17 +1809,9 @@
=back
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
- docs/pmc2c.pod
+F<docs/pmc2c.pod>
=cut
Modified: trunk/docs/pdds/pdd18_security.pod
==============================================================================
--- trunk/docs/pdds/pdd18_security.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd18_security.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2007-2008, Parrot Foundation.
+# Copyright (C) 2007-2010, Parrot Foundation.
# $Id$
=head1 PDD 18: Security Model
@@ -217,19 +217,13 @@
form is standard across high-level languages running on Parrot, the tools can
be written once and applied to many languages.
-=head2 Attachments
-
-
-=head2 Footnotes
-
-
=head2 References
-"Exploring the Broken Web": http://talks.php.net/show/osdc07
+"Exploring the Broken Web": L<http://talks.php.net/show/osdc07>
-"Safe ERB": http://agilewebdevelopment.com/plugins/safe_erb
+"Safe ERB": L<http://agilewebdevelopment.com/plugins/safe_erb>
-pecl/filter: http://us2.php.net/filter
+pecl/filter: L<http://us2.php.net/filter>
Rasmus Lerdorf for the term "data firewall".
Modified: trunk/docs/pdds/pdd19_pir.pod
==============================================================================
--- trunk/docs/pdds/pdd19_pir.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd19_pir.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,18 +1,17 @@
-# Copyright (C) 2007, Parrot Foundation.
+# Copyright (C) 2007-2010, Parrot Foundation.
# $Id$
=head1 PDD 19: Parrot Intermediate Representation (PIR)
-=head2 Version
-
-$Revision$
-
-
=head2 Abstract
This document outlines the architecture and core syntax of Parrot
Intermediate Representation (PIR).
+=head2 Version
+
+$Revision$
+
=head2 Description
PIR is a stable, middle-level language intended both as a target for the
@@ -1444,18 +1443,9 @@
=back
-
-=head2 Attachments
-
-N/A
-
-=head2 Footnotes
-
-N/A
-
=head2 References
-N/A
+None.
=cut
Modified: trunk/docs/pdds/pdd20_lexical_vars.pod
==============================================================================
--- trunk/docs/pdds/pdd20_lexical_vars.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd20_lexical_vars.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,17 +1,17 @@
-# Copyright (C) 2001-2006, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 20: Lexical Variables
-=head2 Version
-
-$Revision$
-
=head2 Abstract
This document defines the requirements and implementation strategy for
lexically scoped variables.
+=head2 Version
+
+$Revision$
+
=head2 Synopsis
=begin PIR
@@ -402,23 +402,9 @@
TK.
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
-=over 4
-
-=item [1]
-
-t/op/lexicals.t
-
-=back
+F<t/op/lexicals.t>
=cut
Modified: trunk/docs/pdds/pdd21_namespaces.pod
==============================================================================
--- trunk/docs/pdds/pdd21_namespaces.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd21_namespaces.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,16 +1,16 @@
-# Copyright (C) 2005-2007, Parrot Foundation.
+# Copyright (C) 2005-2010, Parrot Foundation.
# $Id$
=head1 PDD 21: Namespaces
-=head2 Version
-
-$Revision$
-
=head2 Abstract
Description and implementation of Parrot namespaces.
+=head2 Version
+
+$Revision$
+
=head2 Description
=over 4
@@ -737,14 +737,6 @@
=end PIR
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
None.
Modified: trunk/docs/pdds/pdd22_io.pod
==============================================================================
--- trunk/docs/pdds/pdd22_io.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd22_io.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2009, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 22: I/O
@@ -1038,14 +1038,6 @@
(http://www.ietf.org/rfc/rfc4038.txt) and "Basic Socket Interface
Extensions for IPv6" (http://www.ietf.org/rfc/rfc3493.txt).
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 Links
L<http://en.wikipedia.org/wiki/Asynchronous_I/O> for a relatively
@@ -1053,14 +1045,9 @@
=head2 References
- F<src/io/core.c>
- F<src/ops/io.ops>
- F<include/parrot/io.h>
- F<runtime/parrot/library/Stream/*>
- F<src/io/unix.c>
- F<src/io/win32.c>
- Perl 5's IO::AIO
- Perl 5's POE
+F<src/io/core.c>, F<src/ops/io.ops>, F<include/parrot/io.h>,
+F<runtime/parrot/library/Stream/*>, F<src/io/unix.c>, F<src/io/win32.c>,
+Perl 5's IO::AIO, and POE
=cut
Modified: trunk/docs/pdds/pdd23_exceptions.pod
==============================================================================
--- trunk/docs/pdds/pdd23_exceptions.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd23_exceptions.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2007, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 23: Exceptions
@@ -447,20 +447,10 @@
=end PIR_FRAGMENT
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
- src/ops/core.ops
- src/exceptions.c
- src/pmc/exception.pmc
- src/pmc/exceptionhandler.pmc
+F<src/ops/core.ops>, F<src/exceptions.c>, F<src/pmc/exception.pmc>,
+F<src/pmc/exceptionhandler.pmc>
=cut
Modified: trunk/docs/pdds/pdd24_events.pod
==============================================================================
--- trunk/docs/pdds/pdd24_events.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd24_events.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2007, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 24: Events
@@ -368,17 +368,9 @@
own implementations of timers, which may be used when performance on a
particular platform is more important than portability.
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
-src/events.c
+F<src/events.c>
L<http://www.seas.upenn.edu/~lipeng/homepage/unify.html>
Modified: trunk/docs/pdds/pdd25_concurrency.pod
==============================================================================
--- trunk/docs/pdds/pdd25_concurrency.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd25_concurrency.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2001-2007, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 PDD 25: Concurrency
@@ -422,40 +422,32 @@
=back
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
Dec 2003 - (Dan ponders threads based on POSIX and Perl 5 experience)
-<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/e64b22ab7de0a7a6/889b5d8c4cd267b7?lnk=gst&q=threads&rnum=3#889b5d8c4cd267b7>
+L<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/e64b22ab7de0a7a6/889b5d8c4cd267b7?lnk=gst&q=threads&rnum=3#889b5d8c4cd267b7>
Dec. 2003 - "threads and shared interpreter data structures"
-<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/e64ea4ff287e04fd/b71333e282d3d187?lnk=gst&q=threads&rnum=9#b71333e282d3d187>
+L<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/e64ea4ff287e04fd/b71333e282d3d187?lnk=gst&q=threads&rnum=9#b71333e282d3d187>
Jan. 2004 - "Threads Design. A Win32 perspective."
-<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/3209629b23306029/52ba9d37425ba015?lnk=gst&q=threads&rnum=8#52ba9d37425ba015>
+L<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/3209629b23306029/52ba9d37425ba015?lnk=gst&q=threads&rnum=8#52ba9d37425ba015>
Jan. 2004 - "Start of threads proposal"
-<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/4c7de440da84d5c6/04cfb70b0d81dfba?tvc=1&q=threads#04cfb70b0d81dfba>
+L<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/4c7de440da84d5c6/04cfb70b0d81dfba?tvc=1&q=threads#04cfb70b0d81dfba>
Sept. 2005 - "consider using OS threads"
-<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/40b50e3aa9255f8e/036a87b5d2b5ed2c?lnk=gst&q=threads&rnum=2#036a87b5d2b5ed2c>
+L<http://groups.google.com/group/perl.perl6.internals/browse_frm/thread/40b50e3aa9255f8e/036a87b5d2b5ed2c?lnk=gst&q=threads&rnum=2#036a87b5d2b5ed2c>
Aug. 2007 - "multi-threading a work in progress"
-<http://perlmonks.org/?node_id=636466>
+L<http://perlmonks.org/?node_id=636466>
Concurrency as Futures -
-<http://www.cincomsmalltalk.com/userblogs/mls/blogView?showComments=true&entry=3336838959>
+L<http://www.cincomsmalltalk.com/userblogs/mls/blogView?showComments=true&entry=3336838959>
-Io language - <http://www.iolanguage.com/about/>
+Io language - L<http://www.iolanguage.com/about/>
-Java memory and concurrency - http://www.cs.umd.edu/~pugh/java/memoryModel/
+Java memory and concurrency - L<http://www.cs.umd.edu/~pugh/java/memoryModel/>
=cut
Modified: trunk/docs/pdds/pdd26_ast.pod
==============================================================================
--- trunk/docs/pdds/pdd26_ast.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd26_ast.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2007, Parrot Foundation
+# Copyright (C) 2007-2010, Parrot Foundation
# $Id$
=head1 PDD 26: Compiler Tools - Abstract Syntax Tree
@@ -561,7 +561,7 @@
=head2 References
-NA.
+None.
=cut
Modified: trunk/docs/pdds/pdd27_multiple_dispatch.pod
==============================================================================
--- trunk/docs/pdds/pdd27_multiple_dispatch.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd27_multiple_dispatch.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2007, Parrot Foundation.
+# Copyright (C) 2007-2010, Parrot Foundation.
# $Id$
=head1 PDD 27: Multiple Dispatch
@@ -256,15 +256,9 @@
Multiple dispatch calls from within vtable functions call the
C<Parrot_mmd_invoke> routine from the public MMD API.
-=head2 Attachments
-
-None.
-
=head2 References
-docs/mmd.pod
-src/multidispatch.c
-src/pmc/multisub.pmc
+F<docs/mmd.pod>, F<src/multidispatch.c>, F<src/pmc/multisub.pmc>
=cut
Modified: trunk/docs/pdds/pdd28_strings.pod
==============================================================================
--- trunk/docs/pdds/pdd28_strings.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd28_strings.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,4 +1,4 @@
-# Copyright (C) 2008-2009, Parrot Foundation.
+# Copyright (C) 2008-2010, Parrot Foundation.
# $Id$
=head1 PDD 28: Strings
@@ -826,15 +826,15 @@
=head2 References
-http://sirviente.9grid.es/sources/plan9/sys/doc/utf.ps - Plan 9's Runes are
+L<http://sirviente.9grid.es/sources/plan9/sys/doc/utf.ps> - Plan 9's Runes are
not dissimilar to NFG strings, and this is a good introduction to the Unicode
world.
-http://www.unicode.org/reports/tr15/ - The Unicode Consortium's
+L<http://www.unicode.org/reports/tr15/> - The Unicode Consortium's
explanation of different normalization forms.
-http://unicode.org/reports/tr29/ - "grapheme clusters" in the Unicode Standard
-Annex
+L<http://unicode.org/reports/tr29/> - "grapheme clusters" in the Unicode
+Standard Annex
"Unicode: A Primer", Tony Graham - Arguably the most readable book on
how Unicode works.
Modified: trunk/docs/pdds/pdd30_install.pod
==============================================================================
--- trunk/docs/pdds/pdd30_install.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd30_install.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -160,14 +160,6 @@
good choice, and can be combined with Autoconf, CMake, Perl, Python,
etc. for more complex conditional builds).
-=head2 Attachments
-
-None.
-
-=head2 Footnotes
-
-None.
-
=head2 References
None.
Modified: trunk/docs/pdds/pdd_template.pod
==============================================================================
--- trunk/docs/pdds/pdd_template.pod Wed Apr 14 02:53:49 2010 (r45651)
+++ trunk/docs/pdds/pdd_template.pod Wed Apr 14 02:57:43 2010 (r45652)
@@ -1,16 +1,16 @@
-# Copyright (C) 2001-2008, Parrot Foundation.
+# Copyright (C) 2001-2010, Parrot Foundation.
# $Id$
=head1 Design Document Template
-=head2 Version
-
-$Revision$
-
=head2 Abstract
Summary of the contents of the PDD.
+=head2 Version
+
+$Revision$
+
=head2 Synopsis I<(optional)>
Code snippets showing the semantics of the PDD (if applicable).
@@ -33,11 +33,11 @@
=head2 Attachments
-Any associated documents.
+Any associated documents. (optional)
=head2 Footnotes
-List of footnotes to the text.
+List of footnotes to the text. (optional)
=head2 References
More information about the parrot-commits
mailing list