[PATCH][RFC] perlfunc.pod

[email protected] (Alexey Toptygin) Mon, 2 May 2005 18:54:11 +0000 (UTC)
Newsgroups perl.documentation
Message-ID <[email protected]>
The wording in the description of the 'w' pack conversion in perlfunc.pod
is misleading - it says BER, which usually refers to ASN.1 BER, but in
this case refers to a "Binary Encoded Representation" as defined by the
Scarab project at http://www.casbah.org/Scarab/binary-serialization.html
This patch adds clarifying text.

			Alexey

--- perl-5.9.2/pod/perlfunc.pod	2005-04-01 04:43:07.000000000 -0500
+++ perlmine/pod/perlfunc.pod	2005-04-25 12:04:59.000000000 -0400
@@ -3358,10 +3358,10 @@
     U	A Unicode character number.  Encodes to UTF-8 internally
 	(or UTF-EBCDIC in EBCDIC platforms).

-    w	A BER compressed integer.  Its bytes represent an unsigned
-	integer in base 128, most significant digit first, with as
-        few digits as possible.  Bit eight (the high bit) is set
-        on each byte except the last.
+    w	A BER (not ASN.1 BER, see casbah.org) compressed integer.
+	Its bytes represent an unsigned integer in base 128, most
+	significant digit first, with as few digits as possible. Bit
+	eight (the high bit) is set on each byte except the last.

     x	A null byte.
     X	Back up a byte.
perldoc.patch (text/plain, 805 B)
--- perl-5.9.2/pod/perlfunc.pod	2005-04-01 04:43:07.000000000 -0500
+++ perlmine/pod/perlfunc.pod	2005-04-25 12:04:59.000000000 -0400
@@ -3358,10 +3358,10 @@
     U	A Unicode character number.  Encodes to UTF-8 internally
 	(or UTF-EBCDIC in EBCDIC platforms).
 
-    w	A BER compressed integer.  Its bytes represent an unsigned
-	integer in base 128, most significant digit first, with as
-        few digits as possible.  Bit eight (the high bit) is set
-        on each byte except the last.
+    w	A BER (not ASN.1 BER, see casbah.org) compressed integer.
+	Its bytes represent an unsigned integer in base 128, most
+	significant digit first, with as few digits as possible. Bit
+	eight (the high bit) is set on each byte except the last.
 
     x	A null byte.
     X	Back up a byte.