Add comment to the top of most .c files explaining their purpose

p4raw-id: //depot/perl@23176

1 files changed, 184 insertions, 184 deletions

diff --git a/perly.act b/perly.act
index 9c5405eb24..5ad8ba3b87 100644
--- a/perly.act
+++ b/perly.act
@@ -1,56 +1,56 @@
 case 2:
-#line 88 "perly.y"
+#line 97 "perly.y"
     { yyval.ival = yyvsp[-1].ival; newPROG(block_end(yyvsp[-1].ival,yyvsp[0].opval)); ;}
     break;
 
   case 3:
-#line 93 "perly.y"
+#line 102 "perly.y"
     { if (PL_copline > (line_t)yyvsp[-3].ival)
 			      PL_copline = (line_t)yyvsp[-3].ival;
 			  yyval.opval = block_end(yyvsp[-2].ival, yyvsp[-1].opval); ;}
     break;
 
   case 4:
-#line 99 "perly.y"
+#line 108 "perly.y"
     { yyval.ival = block_start(TRUE); ;}
     break;
 
   case 5:
-#line 103 "perly.y"
+#line 112 "perly.y"
     {
 		    PL_expect = XSTATE; yyval.ival = block_start(TRUE);
 		;}
     break;
 
   case 6:
-#line 110 "perly.y"
+#line 119 "perly.y"
     { if (PL_copline > (line_t)yyvsp[-3].ival)
 			      PL_copline = (line_t)yyvsp[-3].ival;
 			  yyval.opval = block_end(yyvsp[-2].ival, yyvsp[-1].opval); ;}
     break;
 
   case 7:
-#line 116 "perly.y"
+#line 125 "perly.y"
     { yyval.ival = block_start(FALSE); ;}
     break;
 
   case 8:
-#line 120 "perly.y"
+#line 129 "perly.y"
     { yyval.ival = PL_savestack_ix; ;}
     break;
 
   case 9:
-#line 124 "perly.y"
+#line 133 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 10:
-#line 126 "perly.y"
+#line 135 "perly.y"
     { yyval.opval = yyvsp[-1].opval; ;}
     break;
 
   case 11:
-#line 128 "perly.y"
+#line 137 "perly.y"
     {   LEAVE_SCOPE(yyvsp[-1].ival);
 			    yyval.opval = append_list(OP_LINESEQ,
 				(LISTOP*)yyvsp[-2].opval, (LISTOP*)yyvsp[0].opval);
@@ -59,12 +59,12 @@ case 2:
     break;
 
   case 12:
-#line 137 "perly.y"
+#line 146 "perly.y"
     { yyval.opval = newSTATEOP(0, yyvsp[-1].pval, yyvsp[0].opval); ;}
     break;
 
   case 14:
-#line 140 "perly.y"
+#line 149 "perly.y"
     { if (yyvsp[-1].pval != Nullch) {
 			      yyval.opval = newSTATEOP(0, yyvsp[-1].pval, newOP(OP_NULL, 0));
 			    }
@@ -76,90 +76,90 @@ case 2:
     break;
 
   case 15:
-#line 149 "perly.y"
+#line 158 "perly.y"
     { yyval.opval = newSTATEOP(0, yyvsp[-2].pval, yyvsp[-1].opval);
 			  PL_expect = XSTATE; ;}
     break;
 
   case 16:
-#line 155 "perly.y"
+#line 164 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 17:
-#line 157 "perly.y"
+#line 166 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 18:
-#line 159 "perly.y"
+#line 168 "perly.y"
     { yyval.opval = newLOGOP(OP_AND, 0, yyvsp[0].opval, yyvsp[-2].opval); ;}
     break;
 
   case 19:
-#line 161 "perly.y"
+#line 170 "perly.y"
     { yyval.opval = newLOGOP(OP_OR, 0, yyvsp[0].opval, yyvsp[-2].opval); ;}
     break;
 
   case 20:
-#line 163 "perly.y"
+#line 172 "perly.y"
     { yyval.opval = newLOOPOP(OPf_PARENS, 1, scalar(yyvsp[0].opval), yyvsp[-2].opval); ;}
     break;
 
   case 21:
-#line 165 "perly.y"
+#line 174 "perly.y"
     { yyval.opval = newLOOPOP(OPf_PARENS, 1, yyvsp[0].opval, yyvsp[-2].opval);;}
     break;
 
   case 22:
-#line 167 "perly.y"
+#line 176 "perly.y"
     { yyval.opval = newFOROP(0, Nullch, (line_t)yyvsp[-1].ival,
 					Nullop, yyvsp[0].opval, yyvsp[-2].opval, Nullop); ;}
     break;
 
   case 23:
-#line 173 "perly.y"
+#line 182 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 24:
-#line 175 "perly.y"
+#line 184 "perly.y"
     { (yyvsp[0].opval)->op_flags |= OPf_PARENS; yyval.opval = scope(yyvsp[0].opval); ;}
     break;
 
   case 25:
-#line 177 "perly.y"
+#line 186 "perly.y"
     { PL_copline = (line_t)yyvsp[-5].ival;
 			    yyval.opval = newCONDOP(0, yyvsp[-3].opval, scope(yyvsp[-1].opval), yyvsp[0].opval);
 			    PL_hints |= HINT_BLOCK_SCOPE; ;}
     break;
 
   case 26:
-#line 184 "perly.y"
+#line 193 "perly.y"
     { PL_copline = (line_t)yyvsp[-6].ival;
 			    yyval.opval = block_end(yyvsp[-4].ival,
 				   newCONDOP(0, yyvsp[-3].opval, scope(yyvsp[-1].opval), yyvsp[0].opval)); ;}
     break;
 
   case 27:
-#line 188 "perly.y"
+#line 197 "perly.y"
     { PL_copline = (line_t)yyvsp[-6].ival;
 			    yyval.opval = block_end(yyvsp[-4].ival,
 				   newCONDOP(0, yyvsp[-3].opval, scope(yyvsp[-1].opval), yyvsp[0].opval)); ;}
     break;
 
   case 28:
-#line 195 "perly.y"
+#line 204 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 29:
-#line 197 "perly.y"
+#line 206 "perly.y"
     { yyval.opval = scope(yyvsp[0].opval); ;}
     break;
 
   case 30:
-#line 202 "perly.y"
+#line 211 "perly.y"
     { PL_copline = (line_t)yyvsp[-6].ival;
 			    yyval.opval = block_end(yyvsp[-4].ival,
 				   newSTATEOP(0, yyvsp[-7].pval,
@@ -168,7 +168,7 @@ case 2:
     break;
 
   case 31:
-#line 208 "perly.y"
+#line 217 "perly.y"
     { PL_copline = (line_t)yyvsp[-6].ival;
 			    yyval.opval = block_end(yyvsp[-4].ival,
 				   newSTATEOP(0, yyvsp[-7].pval,
@@ -177,26 +177,26 @@ case 2:
     break;
 
   case 32:
-#line 214 "perly.y"
+#line 223 "perly.y"
     { yyval.opval = block_end(yyvsp[-6].ival,
 				 newFOROP(0, yyvsp[-9].pval, (line_t)yyvsp[-8].ival, yyvsp[-5].opval, yyvsp[-3].opval, yyvsp[-1].opval, yyvsp[0].opval)); ;}
     break;
 
   case 33:
-#line 217 "perly.y"
+#line 226 "perly.y"
     { yyval.opval = block_end(yyvsp[-4].ival,
 				 newFOROP(0, yyvsp[-8].pval, (line_t)yyvsp[-7].ival, mod(yyvsp[-6].opval, OP_ENTERLOOP),
 					  yyvsp[-3].opval, yyvsp[-1].opval, yyvsp[0].opval)); ;}
     break;
 
   case 34:
-#line 221 "perly.y"
+#line 230 "perly.y"
     { yyval.opval = block_end(yyvsp[-4].ival,
 				 newFOROP(0, yyvsp[-7].pval, (line_t)yyvsp[-6].ival, Nullop, yyvsp[-3].opval, yyvsp[-1].opval, yyvsp[0].opval)); ;}
     break;
 
   case 35:
-#line 225 "perly.y"
+#line 234 "perly.y"
     { OP *forop;
 			  PL_copline = (line_t)yyvsp[-9].ival;
 			  forop = newSTATEOP(0, yyvsp[-10].pval,
@@ -214,119 +214,119 @@ case 2:
     break;
 
   case 36:
-#line 240 "perly.y"
+#line 249 "perly.y"
     { yyval.opval = newSTATEOP(0, yyvsp[-2].pval,
 				 newWHILEOP(0, 1, (LOOP*)Nullop,
 					    NOLINE, Nullop, yyvsp[-1].opval, yyvsp[0].opval)); ;}
     break;
 
   case 37:
-#line 247 "perly.y"
+#line 256 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 39:
-#line 253 "perly.y"
+#line 262 "perly.y"
     { (void)scan_num("1", &yylval); yyval.opval = yylval.opval; ;}
     break;
 
   case 41:
-#line 259 "perly.y"
+#line 268 "perly.y"
     { yyval.opval = invert(scalar(yyvsp[0].opval)); ;}
     break;
 
   case 42:
-#line 264 "perly.y"
+#line 273 "perly.y"
     { yyval.opval = yyvsp[0].opval; intro_my(); ;}
     break;
 
   case 43:
-#line 268 "perly.y"
+#line 277 "perly.y"
     { yyval.opval = yyvsp[0].opval; intro_my(); ;}
     break;
 
   case 44:
-#line 272 "perly.y"
+#line 281 "perly.y"
     { yyval.opval = yyvsp[0].opval; intro_my(); ;}
     break;
 
   case 45:
-#line 276 "perly.y"
+#line 285 "perly.y"
     { yyval.opval = yyvsp[0].opval; intro_my(); ;}
     break;
 
   case 46:
-#line 281 "perly.y"
+#line 290 "perly.y"
     { yyval.pval = Nullch; ;}
     break;
 
   case 48:
-#line 287 "perly.y"
+#line 296 "perly.y"
     { yyval.ival = 0; ;}
     break;
 
   case 49:
-#line 289 "perly.y"
+#line 298 "perly.y"
     { yyval.ival = 0; ;}
     break;
 
   case 50:
-#line 291 "perly.y"
+#line 300 "perly.y"
     { yyval.ival = 0; ;}
     break;
 
   case 51:
-#line 293 "perly.y"
+#line 302 "perly.y"
     { yyval.ival = 0; ;}
     break;
 
   case 52:
-#line 295 "perly.y"
+#line 304 "perly.y"
     { yyval.ival = 0; ;}
     break;
 
   case 53:
-#line 299 "perly.y"
+#line 308 "perly.y"
     { newFORM(yyvsp[-2].ival, yyvsp[-1].opval, yyvsp[0].opval); ;}
     break;
 
   case 54:
-#line 302 "perly.y"
+#line 311 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 55:
-#line 303 "perly.y"
+#line 312 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 56:
-#line 308 "perly.y"
+#line 317 "perly.y"
     { newMYSUB(yyvsp[-4].ival, yyvsp[-3].opval, yyvsp[-2].opval, yyvsp[-1].opval, yyvsp[0].opval); ;}
     break;
 
   case 57:
-#line 313 "perly.y"
+#line 322 "perly.y"
     { newATTRSUB(yyvsp[-4].ival, yyvsp[-3].opval, yyvsp[-2].opval, yyvsp[-1].opval, yyvsp[0].opval); ;}
     break;
 
   case 58:
-#line 317 "perly.y"
+#line 326 "perly.y"
     { yyval.ival = start_subparse(FALSE, 0); ;}
     break;
 
   case 59:
-#line 321 "perly.y"
+#line 330 "perly.y"
     { yyval.ival = start_subparse(FALSE, CVf_ANON); ;}
     break;
 
   case 60:
-#line 325 "perly.y"
+#line 334 "perly.y"
     { yyval.ival = start_subparse(TRUE, 0); ;}
     break;
 
   case 61:
-#line 329 "perly.y"
+#line 338 "perly.y"
     { STRLEN n_a; char *name = SvPV(((SVOP*)yyvsp[0].opval)->op_sv,n_a);
 			  if (strEQ(name, "BEGIN") || strEQ(name, "END")
 			      || strEQ(name, "INIT") || strEQ(name, "CHECK"))
@@ -335,99 +335,99 @@ case 2:
     break;
 
   case 62:
-#line 338 "perly.y"
+#line 347 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 64:
-#line 344 "perly.y"
+#line 353 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 65:
-#line 346 "perly.y"
+#line 355 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 66:
-#line 348 "perly.y"
+#line 357 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 67:
-#line 353 "perly.y"
+#line 362 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 68:
-#line 355 "perly.y"
+#line 364 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 69:
-#line 359 "perly.y"
+#line 368 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 70:
-#line 360 "perly.y"
+#line 369 "perly.y"
     { yyval.opval = Nullop; PL_expect = XSTATE; ;}
     break;
 
   case 71:
-#line 364 "perly.y"
+#line 373 "perly.y"
     { package(yyvsp[-1].opval); ;}
     break;
 
   case 72:
-#line 368 "perly.y"
+#line 377 "perly.y"
     { CvSPECIAL_on(PL_compcv); /* It's a BEGIN {} */ ;}
     break;
 
   case 73:
-#line 370 "perly.y"
+#line 379 "perly.y"
     { utilize(yyvsp[-6].ival, yyvsp[-5].ival, yyvsp[-3].opval, yyvsp[-2].opval, yyvsp[-1].opval); ;}
     break;
 
   case 74:
-#line 375 "perly.y"
+#line 384 "perly.y"
     { yyval.opval = newLOGOP(OP_AND, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 75:
-#line 377 "perly.y"
+#line 386 "perly.y"
     { yyval.opval = newLOGOP(yyvsp[-1].ival, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 76:
-#line 379 "perly.y"
+#line 388 "perly.y"
     { yyval.opval = newLOGOP(OP_DOR, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 78:
-#line 385 "perly.y"
+#line 394 "perly.y"
     { yyval.opval = yyvsp[-1].opval; ;}
     break;
 
   case 79:
-#line 387 "perly.y"
+#line 396 "perly.y"
     { yyval.opval = append_elem(OP_LIST, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 81:
-#line 393 "perly.y"
+#line 402 "perly.y"
     { yyval.opval = convert(yyvsp[-2].ival, OPf_STACKED,
 				prepend_elem(OP_LIST, newGVREF(yyvsp[-2].ival,yyvsp[-1].opval), yyvsp[0].opval) ); ;}
     break;
 
   case 82:
-#line 396 "perly.y"
+#line 405 "perly.y"
     { yyval.opval = convert(yyvsp[-4].ival, OPf_STACKED,
 				prepend_elem(OP_LIST, newGVREF(yyvsp[-4].ival,yyvsp[-2].opval), yyvsp[-1].opval) ); ;}
     break;
 
   case 83:
-#line 399 "perly.y"
+#line 408 "perly.y"
     { yyval.opval = convert(OP_ENTERSUB, OPf_STACKED,
 				append_elem(OP_LIST,
 				    prepend_elem(OP_LIST, scalar(yyvsp[-5].opval), yyvsp[-1].opval),
@@ -435,14 +435,14 @@ case 2:
     break;
 
   case 84:
-#line 404 "perly.y"
+#line 413 "perly.y"
     { yyval.opval = convert(OP_ENTERSUB, OPf_STACKED,
 				append_elem(OP_LIST, scalar(yyvsp[-2].opval),
 				    newUNOP(OP_METHOD, 0, yyvsp[0].opval))); ;}
     break;
 
   case 85:
-#line 408 "perly.y"
+#line 417 "perly.y"
     { yyval.opval = convert(OP_ENTERSUB, OPf_STACKED,
 				append_elem(OP_LIST,
 				    prepend_elem(OP_LIST, yyvsp[-1].opval, yyvsp[0].opval),
@@ -450,7 +450,7 @@ case 2:
     break;
 
   case 86:
-#line 413 "perly.y"
+#line 422 "perly.y"
     { yyval.opval = convert(OP_ENTERSUB, OPf_STACKED,
 				append_elem(OP_LIST,
 				    prepend_elem(OP_LIST, yyvsp[-3].opval, yyvsp[-1].opval),
@@ -458,60 +458,60 @@ case 2:
     break;
 
   case 87:
-#line 418 "perly.y"
+#line 427 "perly.y"
     { yyval.opval = convert(yyvsp[-1].ival, 0, yyvsp[0].opval); ;}
     break;
 
   case 88:
-#line 420 "perly.y"
+#line 429 "perly.y"
     { yyval.opval = convert(yyvsp[-3].ival, 0, yyvsp[-1].opval); ;}
     break;
 
   case 89:
-#line 422 "perly.y"
+#line 431 "perly.y"
     { yyvsp[0].opval = newANONATTRSUB(yyvsp[-1].ival, 0, Nullop, yyvsp[0].opval); ;}
     break;
 
   case 90:
-#line 424 "perly.y"
+#line 433 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				 append_elem(OP_LIST,
 				   prepend_elem(OP_LIST, yyvsp[-2].opval, yyvsp[0].opval), yyvsp[-4].opval)); ;}
     break;
 
   case 93:
-#line 438 "perly.y"
+#line 447 "perly.y"
     { yyval.opval = newBINOP(OP_GELEM, 0, yyvsp[-4].opval, scalar(yyvsp[-2].opval));
 			    PL_expect = XOPERATOR; ;}
     break;
 
   case 94:
-#line 441 "perly.y"
+#line 450 "perly.y"
     { yyval.opval = newBINOP(OP_AELEM, 0, oopsAV(yyvsp[-3].opval), scalar(yyvsp[-1].opval)); ;}
     break;
 
   case 95:
-#line 443 "perly.y"
+#line 452 "perly.y"
     { yyval.opval = newBINOP(OP_AELEM, 0,
 					ref(newAVREF(yyvsp[-4].opval),OP_RV2AV),
 					scalar(yyvsp[-1].opval));;}
     break;
 
   case 96:
-#line 447 "perly.y"
+#line 456 "perly.y"
     { yyval.opval = newBINOP(OP_AELEM, 0,
 					ref(newAVREF(yyvsp[-3].opval),OP_RV2AV),
 					scalar(yyvsp[-1].opval));;}
     break;
 
   case 97:
-#line 451 "perly.y"
+#line 460 "perly.y"
     { yyval.opval = newBINOP(OP_HELEM, 0, oopsHV(yyvsp[-4].opval), jmaybe(yyvsp[-2].opval));
 			    PL_expect = XOPERATOR; ;}
     break;
 
   case 98:
-#line 454 "perly.y"
+#line 463 "perly.y"
     { yyval.opval = newBINOP(OP_HELEM, 0,
 					ref(newHVREF(yyvsp[-5].opval),OP_RV2HV),
 					jmaybe(yyvsp[-2].opval));
@@ -519,7 +519,7 @@ case 2:
     break;
 
   case 99:
-#line 459 "perly.y"
+#line 468 "perly.y"
     { yyval.opval = newBINOP(OP_HELEM, 0,
 					ref(newHVREF(yyvsp[-4].opval),OP_RV2HV),
 					jmaybe(yyvsp[-2].opval));
@@ -527,184 +527,184 @@ case 2:
     break;
 
   case 100:
-#line 464 "perly.y"
+#line 473 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				   newCVREF(0, scalar(yyvsp[-3].opval))); ;}
     break;
 
   case 101:
-#line 467 "perly.y"
+#line 476 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				   append_elem(OP_LIST, yyvsp[-1].opval,
 				       newCVREF(0, scalar(yyvsp[-4].opval)))); ;}
     break;
 
   case 102:
-#line 472 "perly.y"
+#line 481 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				   append_elem(OP_LIST, yyvsp[-1].opval,
 					       newCVREF(0, scalar(yyvsp[-3].opval)))); ;}
     break;
 
   case 103:
-#line 476 "perly.y"
+#line 485 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				   newCVREF(0, scalar(yyvsp[-2].opval))); ;}
     break;
 
   case 104:
-#line 482 "perly.y"
+#line 491 "perly.y"
     { yyval.opval = newASSIGNOP(OPf_STACKED, yyvsp[-2].opval, yyvsp[-1].ival, yyvsp[0].opval); ;}
     break;
 
   case 105:
-#line 484 "perly.y"
+#line 493 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 106:
-#line 486 "perly.y"
+#line 495 "perly.y"
     {   if (yyvsp[-1].ival != OP_REPEAT)
 				scalar(yyvsp[-2].opval);
 			    yyval.opval = newBINOP(yyvsp[-1].ival, 0, yyvsp[-2].opval, scalar(yyvsp[0].opval)); ;}
     break;
 
   case 107:
-#line 490 "perly.y"
+#line 499 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 108:
-#line 492 "perly.y"
+#line 501 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 109:
-#line 494 "perly.y"
+#line 503 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 110:
-#line 496 "perly.y"
+#line 505 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 111:
-#line 498 "perly.y"
+#line 507 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 112:
-#line 500 "perly.y"
+#line 509 "perly.y"
     { yyval.opval = newBINOP(yyvsp[-1].ival, 0, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval)); ;}
     break;
 
   case 113:
-#line 502 "perly.y"
+#line 511 "perly.y"
     { yyval.opval = newRANGE(yyvsp[-1].ival, scalar(yyvsp[-2].opval), scalar(yyvsp[0].opval));;}
     break;
 
   case 114:
-#line 504 "perly.y"
+#line 513 "perly.y"
     { yyval.opval = newLOGOP(OP_AND, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 115:
-#line 506 "perly.y"
+#line 515 "perly.y"
     { yyval.opval = newLOGOP(OP_OR, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 116:
-#line 508 "perly.y"
+#line 517 "perly.y"
     { yyval.opval = newLOGOP(OP_DOR, 0, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 117:
-#line 510 "perly.y"
+#line 519 "perly.y"
     { yyval.opval = bind_match(yyvsp[-1].ival, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 118:
-#line 515 "perly.y"
+#line 524 "perly.y"
     { yyval.opval = newUNOP(OP_NEGATE, 0, scalar(yyvsp[0].opval)); ;}
     break;
 
   case 119:
-#line 517 "perly.y"
+#line 526 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 120:
-#line 519 "perly.y"
+#line 528 "perly.y"
     { yyval.opval = newUNOP(OP_NOT, 0, scalar(yyvsp[0].opval)); ;}
     break;
 
   case 121:
-#line 521 "perly.y"
+#line 530 "perly.y"
     { yyval.opval = newUNOP(OP_COMPLEMENT, 0, scalar(yyvsp[0].opval));;}
     break;
 
   case 122:
-#line 523 "perly.y"
+#line 532 "perly.y"
     { yyval.opval = newUNOP(OP_POSTINC, 0,
 					mod(scalar(yyvsp[-1].opval), OP_POSTINC)); ;}
     break;
 
   case 123:
-#line 526 "perly.y"
+#line 535 "perly.y"
     { yyval.opval = newUNOP(OP_POSTDEC, 0,
 					mod(scalar(yyvsp[-1].opval), OP_POSTDEC)); ;}
     break;
 
   case 124:
-#line 529 "perly.y"
+#line 538 "perly.y"
     { yyval.opval = newUNOP(OP_PREINC, 0,
 					mod(scalar(yyvsp[0].opval), OP_PREINC)); ;}
     break;
 
   case 125:
-#line 532 "perly.y"
+#line 541 "perly.y"
     { yyval.opval = newUNOP(OP_PREDEC, 0,
 					mod(scalar(yyvsp[0].opval), OP_PREDEC)); ;}
     break;
 
   case 126:
-#line 539 "perly.y"
+#line 548 "perly.y"
     { yyval.opval = newANONLIST(yyvsp[-1].opval); ;}
     break;
 
   case 127:
-#line 541 "perly.y"
+#line 550 "perly.y"
     { yyval.opval = newANONLIST(Nullop); ;}
     break;
 
   case 128:
-#line 543 "perly.y"
+#line 552 "perly.y"
     { yyval.opval = newANONHASH(yyvsp[-2].opval); ;}
     break;
 
   case 129:
-#line 545 "perly.y"
+#line 554 "perly.y"
     { yyval.opval = newANONHASH(Nullop); ;}
     break;
 
   case 130:
-#line 547 "perly.y"
+#line 556 "perly.y"
     { yyval.opval = newANONATTRSUB(yyvsp[-3].ival, yyvsp[-2].opval, yyvsp[-1].opval, yyvsp[0].opval); ;}
     break;
 
   case 131:
-#line 553 "perly.y"
+#line 562 "perly.y"
     { yyval.opval = dofile(yyvsp[0].opval); ;}
     break;
 
   case 132:
-#line 555 "perly.y"
+#line 564 "perly.y"
     { yyval.opval = newUNOP(OP_NULL, OPf_SPECIAL, scope(yyvsp[0].opval)); ;}
     break;
 
   case 133:
-#line 557 "perly.y"
+#line 566 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB,
 			    OPf_SPECIAL|OPf_STACKED,
 			    prepend_elem(OP_LIST,
@@ -715,7 +715,7 @@ case 2:
     break;
 
   case 134:
-#line 565 "perly.y"
+#line 574 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB,
 			    OPf_SPECIAL|OPf_STACKED,
 			    append_elem(OP_LIST,
@@ -727,14 +727,14 @@ case 2:
     break;
 
   case 135:
-#line 574 "perly.y"
+#line 583 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
 			    prepend_elem(OP_LIST,
 				scalar(newCVREF(0,scalar(yyvsp[-2].opval))), Nullop)); dep();;}
     break;
 
   case 136:
-#line 578 "perly.y"
+#line 587 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
 			    prepend_elem(OP_LIST,
 				yyvsp[-1].opval,
@@ -742,77 +742,77 @@ case 2:
     break;
 
   case 141:
-#line 590 "perly.y"
+#line 599 "perly.y"
     { yyval.opval = newCONDOP(0, yyvsp[-4].opval, yyvsp[-2].opval, yyvsp[0].opval); ;}
     break;
 
   case 142:
-#line 592 "perly.y"
+#line 601 "perly.y"
     { yyval.opval = newUNOP(OP_REFGEN, 0, mod(yyvsp[0].opval,OP_REFGEN)); ;}
     break;
 
   case 143:
-#line 594 "perly.y"
+#line 603 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 144:
-#line 596 "perly.y"
+#line 605 "perly.y"
     { yyval.opval = localize(yyvsp[0].opval,yyvsp[-1].ival); ;}
     break;
 
   case 145:
-#line 598 "perly.y"
+#line 607 "perly.y"
     { yyval.opval = sawparens(yyvsp[-1].opval); ;}
     break;
 
   case 146:
-#line 600 "perly.y"
+#line 609 "perly.y"
     { yyval.opval = sawparens(newNULLLIST()); ;}
     break;
 
   case 147:
-#line 602 "perly.y"
+#line 611 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 148:
-#line 604 "perly.y"
+#line 613 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 149:
-#line 606 "perly.y"
+#line 615 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 150:
-#line 608 "perly.y"
+#line 617 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 151:
-#line 610 "perly.y"
+#line 619 "perly.y"
     { yyval.opval = newUNOP(OP_AV2ARYLEN, 0, ref(yyvsp[0].opval, OP_AV2ARYLEN));;}
     break;
 
   case 152:
-#line 612 "perly.y"
+#line 621 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 153:
-#line 614 "perly.y"
+#line 623 "perly.y"
     { yyval.opval = newSLICEOP(0, yyvsp[-1].opval, yyvsp[-4].opval); ;}
     break;
 
   case 154:
-#line 616 "perly.y"
+#line 625 "perly.y"
     { yyval.opval = newSLICEOP(0, yyvsp[-1].opval, Nullop); ;}
     break;
 
   case 155:
-#line 618 "perly.y"
+#line 627 "perly.y"
     { yyval.opval = prepend_elem(OP_ASLICE,
 				newOP(OP_PUSHMARK, 0),
 				    newLISTOP(OP_ASLICE, 0,
@@ -821,7 +821,7 @@ case 2:
     break;
 
   case 156:
-#line 624 "perly.y"
+#line 633 "perly.y"
     { yyval.opval = prepend_elem(OP_HSLICE,
 				newOP(OP_PUSHMARK, 0),
 				    newLISTOP(OP_HSLICE, 0,
@@ -831,217 +831,217 @@ case 2:
     break;
 
   case 157:
-#line 631 "perly.y"
+#line 640 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 158:
-#line 633 "perly.y"
+#line 642 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, 0, scalar(yyvsp[0].opval)); ;}
     break;
 
   case 159:
-#line 635 "perly.y"
+#line 644 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED, scalar(yyvsp[-2].opval)); ;}
     break;
 
   case 160:
-#line 637 "perly.y"
+#line 646 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 			    append_elem(OP_LIST, yyvsp[-1].opval, scalar(yyvsp[-3].opval))); ;}
     break;
 
   case 161:
-#line 640 "perly.y"
+#line 649 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 			    append_elem(OP_LIST, yyvsp[0].opval, scalar(yyvsp[-1].opval))); ;}
     break;
 
   case 162:
-#line 643 "perly.y"
+#line 652 "perly.y"
     { yyval.opval = newOP(yyvsp[0].ival, OPf_SPECIAL);
 			    PL_hints |= HINT_BLOCK_SCOPE; ;}
     break;
 
   case 163:
-#line 646 "perly.y"
+#line 655 "perly.y"
     { yyval.opval = newLOOPEX(yyvsp[-1].ival,yyvsp[0].opval); ;}
     break;
 
   case 164:
-#line 648 "perly.y"
+#line 657 "perly.y"
     { yyval.opval = newUNOP(OP_NOT, 0, scalar(yyvsp[0].opval)); ;}
     break;
 
   case 165:
-#line 650 "perly.y"
+#line 659 "perly.y"
     { yyval.opval = newOP(yyvsp[0].ival, 0); ;}
     break;
 
   case 166:
-#line 652 "perly.y"
+#line 661 "perly.y"
     { yyval.opval = newUNOP(yyvsp[-1].ival, 0, yyvsp[0].opval); ;}
     break;
 
   case 167:
-#line 654 "perly.y"
+#line 663 "perly.y"
     { yyval.opval = newUNOP(yyvsp[-1].ival, 0, yyvsp[0].opval); ;}
     break;
 
   case 168:
-#line 656 "perly.y"
+#line 665 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 			    append_elem(OP_LIST, yyvsp[0].opval, scalar(yyvsp[-1].opval))); ;}
     break;
 
   case 169:
-#line 659 "perly.y"
+#line 668 "perly.y"
     { yyval.opval = newOP(yyvsp[0].ival, 0); ;}
     break;
 
   case 170:
-#line 661 "perly.y"
+#line 670 "perly.y"
     { yyval.opval = newOP(yyvsp[-2].ival, 0); ;}
     break;
 
   case 171:
-#line 663 "perly.y"
+#line 672 "perly.y"
     { yyval.opval = newUNOP(OP_ENTERSUB, OPf_STACKED,
 				scalar(yyvsp[0].opval)); ;}
     break;
 
   case 172:
-#line 666 "perly.y"
+#line 675 "perly.y"
     { yyval.opval = newOP(yyvsp[-2].ival, OPf_SPECIAL); ;}
     break;
 
   case 173:
-#line 668 "perly.y"
+#line 677 "perly.y"
     { yyval.opval = newUNOP(yyvsp[-3].ival, 0, yyvsp[-1].opval); ;}
     break;
 
   case 174:
-#line 670 "perly.y"
+#line 679 "perly.y"
     { yyval.opval = pmruntime(yyvsp[-3].opval, yyvsp[-1].opval, Nullop); ;}
     break;
 
   case 175:
-#line 672 "perly.y"
+#line 681 "perly.y"
     { yyval.opval = pmruntime(yyvsp[-5].opval, yyvsp[-3].opval, yyvsp[-1].opval); ;}
     break;
 
   case 178:
-#line 679 "perly.y"
+#line 688 "perly.y"
     { yyval.opval = my_attrs(yyvsp[-1].opval,yyvsp[0].opval); ;}
     break;
 
   case 179:
-#line 681 "perly.y"
+#line 690 "perly.y"
     { yyval.opval = localize(yyvsp[0].opval,yyvsp[-1].ival); ;}
     break;
 
   case 180:
-#line 686 "perly.y"
+#line 695 "perly.y"
     { yyval.opval = sawparens(yyvsp[-1].opval); ;}
     break;
 
   case 181:
-#line 688 "perly.y"
+#line 697 "perly.y"
     { yyval.opval = sawparens(newNULLLIST()); ;}
     break;
 
   case 182:
-#line 690 "perly.y"
+#line 699 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 183:
-#line 692 "perly.y"
+#line 701 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 184:
-#line 694 "perly.y"
+#line 703 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 185:
-#line 699 "perly.y"
+#line 708 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 186:
-#line 701 "perly.y"
+#line 710 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 187:
-#line 705 "perly.y"
+#line 714 "perly.y"
     { yyval.opval = Nullop; ;}
     break;
 
   case 188:
-#line 707 "perly.y"
+#line 716 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;
 
   case 189:
-#line 709 "perly.y"
+#line 718 "perly.y"
     { yyval.opval = yyvsp[-1].opval; ;}
     break;
 
   case 190:
-#line 715 "perly.y"
+#line 724 "perly.y"
     { PL_in_my = 0; yyval.opval = my(yyvsp[0].opval); ;}
     break;
 
   case 191:
-#line 719 "perly.y"
+#line 728 "perly.y"
     { yyval.opval = newCVREF(yyvsp[-1].ival,yyvsp[0].opval); ;}
     break;
 
   case 192:
-#line 723 "perly.y"
+#line 732 "perly.y"
     { yyval.opval = newSVREF(yyvsp[0].opval); ;}
     break;
 
   case 193:
-#line 727 "perly.y"
+#line 736 "perly.y"
     { yyval.opval = newAVREF(yyvsp[0].opval); ;}
     break;
 
   case 194:
-#line 731 "perly.y"
+#line 740 "perly.y"
     { yyval.opval = newHVREF(yyvsp[0].opval); ;}
     break;
 
   case 195:
-#line 735 "perly.y"
+#line 744 "perly.y"
     { yyval.opval = newAVREF(yyvsp[0].opval); ;}
     break;
 
   case 196:
-#line 739 "perly.y"
+#line 748 "perly.y"
     { yyval.opval = newGVREF(0,yyvsp[0].opval); ;}
     break;
 
   case 197:
-#line 744 "perly.y"
+#line 753 "perly.y"
     { yyval.opval = scalar(yyvsp[0].opval); ;}
     break;
 
   case 198:
-#line 746 "perly.y"
+#line 755 "perly.y"
     { yyval.opval = scalar(yyvsp[0].opval);  ;}
     break;
 
   case 199:
-#line 748 "perly.y"
+#line 757 "perly.y"
     { yyval.opval = scope(yyvsp[0].opval); ;}
     break;
 
   case 200:
-#line 751 "perly.y"
+#line 760 "perly.y"
     { yyval.opval = yyvsp[0].opval; ;}
     break;