Changeset 12704 for docs/Perl6/Perl5

Timestamp:

08/26/06 04:28:46 (2 years ago)

Author:

markstos

Message:

Add mention of kwid and Documentation.pod (S26) to Differences.pod

Files:

• docs/Perl6/Perl5/Differences.pod (modified) (1 diff)

docs/Perl6/Perl5/Differences.pod

@@ -215 +215 @@
 =cut 
 
+#S26 
+
+=head1 Documentation
+
+You now use <em>kwid</em> for documentation instead of POD. Kwid
+is a wiki-like syntax that is easy to write, and pleasant to read directly.
+
+Here is a side-by-side comparison of some of the major features of Pod and
+Kwid:
+
+     =head1 Big Thing                    = Big Thing
+
+     =head4 Small Thing                  ==== Small Thing
+
+     A paragraph of                      A paragraph of
+     plain text.                         plain text.
+
+         # verbatim                          # verbatim
+         sub v {                             sub v {
+             shift;                              shift;
+         }                                   }
+
+
+     =item * foo                         * foo
+     =item * bar                         * bar
+     =item2 N<> barber                   ++ barber
+     =item2 N<> bard                     ++ bard
+
+
+     Something B<strong>!                Something *strong*!
+
+     Something I<emphatic>!              Something /emphatic/!
+
+     Some code C<E = M * C ^ 2>!         Some code `E = M * C ^ 2`!
+
+     Some V<B<escaped>> markup           Some \*escaped\* markup
+
+     =begin Section_type                 .Section_type
+
+     =end Section_type                   !Section_type
+
+     =for Section_type                   :Section_type
+
+See L<S26> for details.
+
+=cut 
+
 #S29