svn commit: samba r10381 - in branches/SAMBA_4_0/source/pidl: .

[jelmer at samba.org]

Author: jelmer
Date: 2005-09-21 09:27:17 +0000 (Wed, 21 Sep 2005)
New Revision: 10381

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=10381

Log:
Be a bit stricter on pod syntax

Modified:
   branches/SAMBA_4_0/source/pidl/pidl


Changeset:
Modified: branches/SAMBA_4_0/source/pidl/pidl
===================================================================
--- branches/SAMBA_4_0/source/pidl/pidl	2005-09-21 09:16:55 UTC (rev 10380)
+++ branches/SAMBA_4_0/source/pidl/pidl	2005-09-21 09:27:17 UTC (rev 10381)
@@ -7,6 +7,7 @@
 # Copyright jelmer at samba.org 2005
 # released under the GNU GPL
 
+=pod
 =head1 NAME
 
 pidl - IDL Compiler written in Perl
@@ -48,7 +49,7 @@
 
 =item I<--help>
 
-Show list of available options.</para></listitem>
+Show list of available options.
 		
 =item I<--outputdir OUTNAME>
 
@@ -62,7 +63,7 @@
 
 =item I<--dump-idl>
 
-Generate a new IDL file. File will be named OUTNAME.idl.</para></listitem>
+Generate a new IDL file. File will be named OUTNAME.idl.
 
 =item I<--header>
 
@@ -132,13 +133,10 @@
 =head2 CONFORMANT ARRAYS
 
 A conformant array is one with that ends in [*] or []. The strange
-things about conformant arrays are:
+things about conformant arrays are that they can only appear as the last 
+element of a structure (unless there is a pointer to the conformant array, 
+of course) and the array size appears before the structure itself on the wire. 
 
-=over 1
-=item they can only appear as the last element of a structure
-=item the array size appears before the structure itself on the wire. 
-=back
-
 So, in this example:
 
 	typedef struct {
@@ -231,9 +229,19 @@
 or are implemented with an incompatible interface:
 
 =over
-=item Asynchronous communication
-=item Typelibs (.tlb files)
-=item Datagram support (ncadg_*)
+
+=item *
+
+Asynchronous communication
+
+=item * 
+
+Typelibs (.tlb files)
+
+=item *
+
+Datagram support (ncadg_*)
+
 =back
 
 =head2 Supported attributes
@@ -408,6 +416,7 @@
 	
 =cut
 
+
 use strict;
 use FindBin qw($RealBin);
 use lib "$RealBin";