Version object combined patch

Message-ID: <3D9E593E.1060605@rowman.com>

p4raw-id: //depot/perl@17990

2 files changed, 27 insertions, 17 deletions

diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index 78e1044424..772be5f237 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -4579,32 +4579,42 @@ Returns a pointer to the upgraded SV.
 =for hackers
 Found in file util.c
 
+=item vcmp
+
+Version object aware cmp.  Both operands must already have been 
+converted into version objects.
+
+	int	vcmp(SV *lvs, SV *rvs)
+
+=for hackers
+Found in file util.c
+
 =item vnumify
 
-Accepts a version (or vstring) object and returns the
-normalized floating point representation.  Call like:
+Accepts a version object and returns the normalized floating
+point representation.  Call like:
 
-    sv = vnumify(sv,SvRV(rv));
+    sv = vnumify(rv);
 
-NOTE: no checking is done to see if the object is of the
-correct type (for speed).
+NOTE: you can pass either the object directly or the SV
+contained within the RV.
 
-	SV*	vnumify(SV *sv, SV *vs)
+	SV*	vnumify(SV *vs)
 
 =for hackers
 Found in file util.c
 
 =item vstringify
 
-Accepts a version (or vstring) object and returns the
-normalized representation.  Call like:
+Accepts a version object and returns the normalized string
+representation.  Call like:
 
-    sv = vstringify(sv,SvRV(rv));
+    sv = vstringify(rv);
 
-NOTE: no checking is done to see if the object is of the
-correct type (for speed).
+NOTE: you can pass either the object directly or the SV
+contained within the RV.
 
-	SV*	vstringify(SV *sv, SV *vs)
+	SV*	vstringify(SV *vs)
 
 =for hackers
 Found in file util.c
diff --git a/pod/perlintern.pod b/pod/perlintern.pod
index d256e7ec09..a9915d2fc7 100644
--- a/pod/perlintern.pod
+++ b/pod/perlintern.pod
@@ -402,7 +402,7 @@ Found in file pad.c
 =item cv_clone
 
 Clone a CV: make a new CV which points to the same code etc, but which
-has a newly-created pad done by copying the prototype pad and capturing
+has a newly-created pad built by copying the prototype pad and capturing
 any outer lexicals.
 
 	CV*	cv_clone(CV* proto)
@@ -491,7 +491,6 @@ Check for duplicate declarations: report any of:
        as C<ourstash>
 C<is_our> indicates that the name to check is an 'our' declaration
 
-
 	void	pad_check_dup(char* name, bool is_our, HV* ourstash)
 
 =for hackers
@@ -511,9 +510,10 @@ Found in file pad.c
 
 =item pad_findmy
 
-Given a lexical name, try to find it's offset, first in the current pad,
+Given a lexical name, try to find its offset, first in the current pad,
 or failing that, in the pads of any lexically enclosing subs (including
-the complications introduced by eval). If the name is found in an outer pad, then a fake entry is added to the current pad.
+the complications introduced by eval). If the name is found in an outer pad,
+then a fake entry is added to the current pad.
 Returns the offset in the current pad, or NOT_IN_PAD on failure.
 
 	PADOFFSET	pad_findmy(char* name)
@@ -552,7 +552,7 @@ Found in file pad.c
 
 =item pad_new
 
-Create a new comnpiling padlist, saving and updating the various global
+Create a new compiling padlist, saving and updating the various global
 vars at the same time as creating the pad itself. The following flags
 can be OR'ed together: