utf8.h Swap which definition is the base

The GOT defines are now the principal ones, and the ALLOW ones are
changed to be in terms of the GOT.  This seems right to me, as the GOT
ones are the ones anyone might actually care about.  (The ALLOW ones are
for weird cases.)  More importantly this makes the next commit make more
sense.

Author: khwilliamson

utf8.h

@@ -1175,27 +1175,27 @@ point's representation.
 
 /* The ordering of these bits is important to a switch() statement in utf8.c
  * for handling problems in converting UTF-8 to a UV */
-#define UTF8_ALLOW_OVERFLOW             0x0001
-#define UTF8_GOT_OVERFLOW               UTF8_ALLOW_OVERFLOW
+#define UTF8_GOT_OVERFLOW               0x0001
+#define UTF8_ALLOW_OVERFLOW             UTF8_GOT_OVERFLOW
 
-#define UTF8_ALLOW_EMPTY		0x0002	/* Allow a zero length string */
-#define UTF8_GOT_EMPTY                  UTF8_ALLOW_EMPTY
+#define UTF8_GOT_EMPTY                  0x0002 /* Allow a zero length string */
+#define UTF8_ALLOW_EMPTY                UTF8_GOT_EMPTY
 
 /* Allow first byte to be a continuation byte */
-#define UTF8_ALLOW_CONTINUATION		0x0004
-#define UTF8_GOT_CONTINUATION		UTF8_ALLOW_CONTINUATION
+#define UTF8_GOT_CONTINUATION           0x0004
+#define UTF8_ALLOW_CONTINUATION         UTF8_GOT_CONTINUATION
 
 /* expecting more bytes than were available in the string */
-#define UTF8_ALLOW_SHORT		0x0008
-#define UTF8_GOT_SHORT		        UTF8_ALLOW_SHORT
+#define UTF8_GOT_SHORT                  0x0008
+#define UTF8_ALLOW_SHORT                UTF8_GOT_SHORT
 
 /* Unexpected non-continuation byte */
-#define UTF8_ALLOW_NON_CONTINUATION	0x0010
-#define UTF8_GOT_NON_CONTINUATION	UTF8_ALLOW_NON_CONTINUATION
+#define UTF8_GOT_NON_CONTINUATION       0x0010
+#define UTF8_ALLOW_NON_CONTINUATION     UTF8_GOT_NON_CONTINUATION
 
-#define UTF8_DISALLOW_SURROGATE		0x0020	/* Unicode surrogates */
-#define UTF8_GOT_SURROGATE		UTF8_DISALLOW_SURROGATE
-#define UTF8_WARN_SURROGATE		0x0040
+#define UTF8_GOT_SURROGATE              0x0020  /* Unicode surrogates */
+#define UTF8_DISALLOW_SURROGATE         UTF8_GOT_SURROGATE
+#define UTF8_WARN_SURROGATE             0x0040
 
 /* The original UTF-8 standard did not define UTF-8 with start bytes of 0xFE or
  * 0xFF, though UTF-EBCDIC did.  This allowed both versions to represent code
@@ -1206,27 +1206,27 @@ point's representation.
  * extensions, and not likely to be interchangeable with other languages.  Note
  * that on ASCII platforms, FE overflows a signed 32-bit word, and FF an
  * unsigned one. */
-#define UTF8_DISALLOW_PERL_EXTENDED     0x0080
-#define UTF8_GOT_PERL_EXTENDED          UTF8_DISALLOW_PERL_EXTENDED
+#define UTF8_GOT_PERL_EXTENDED          0x0080
+#define UTF8_DISALLOW_PERL_EXTENDED     UTF8_GOT_PERL_EXTENDED
 #define UTF8_WARN_PERL_EXTENDED         0x0100
 
 /* Super-set of Unicode: code points above the legal max */
-#define UTF8_DISALLOW_SUPER		0x0200
-#define UTF8_GOT_SUPER		        UTF8_DISALLOW_SUPER
-#define UTF8_WARN_SUPER		        0x0400
+#define UTF8_GOT_SUPER                  0x0200
+#define UTF8_DISALLOW_SUPER             UTF8_GOT_SUPER
+#define UTF8_WARN_SUPER                 0x0400
 
 /* Unicode non-character  code points */
-#define UTF8_DISALLOW_NONCHAR           0x0800
-#define UTF8_GOT_NONCHAR                UTF8_DISALLOW_NONCHAR
+#define UTF8_GOT_NONCHAR                0x0800
+#define UTF8_DISALLOW_NONCHAR           UTF8_GOT_NONCHAR
 #define UTF8_WARN_NONCHAR               0x1000
 
 /* Overlong sequence; i.e., the code point can be specified in fewer bytes.
  * First one will convert the overlong to the REPLACEMENT CHARACTER; second
  * will return what the overlong evaluates to */
-#define UTF8_ALLOW_LONG                 0x2000
-#define UTF8_GOT_LONG                   UTF8_ALLOW_LONG
-#define UTF8_ALLOW_LONG_AND_ITS_VALUE   0x4000
-#define UTF8_GOT_LONG_WITH_VALUE        UTF8_ALLOW_LONG_AND_ITS_VALUE
+#define UTF8_GOT_LONG                   0x2000
+#define UTF8_ALLOW_LONG                 UTF8_GOT_LONG
+#define UTF8_GOT_LONG_WITH_VALUE        0x4000
+#define UTF8_ALLOW_LONG_AND_ITS_VALUE   UTF8_GOT_LONG_WITH_VALUE
 
 /* For back compat, these old names are misleading for overlongs and
  * UTF_EBCDIC. */
@@ -1236,7 +1236,7 @@ point's representation.
 #define UTF8_DISALLOW_FE_FF             UTF8_DISALLOW_PERL_EXTENDED
 #define UTF8_WARN_FE_FF                 UTF8_WARN_PERL_EXTENDED
 
-#define UTF8_CHECK_ONLY			0x8000
+#define UTF8_CHECK_ONLY                 0x8000
 #define UTF8_NO_CONFIDENCE_IN_CURLEN_   0x10000  /* Internal core use only */
 #define UTF8_DIE_IF_MALFORMED           0x20000
 #define UTF8_FORCE_WARN_IF_MALFORMED    0x40000