This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
regen/opcode.pl: display duplicate bit name
[perl5.git] / regen / opcode.pl
index 9369c2e..d1c0faf 100755 (executable)
@@ -4,10 +4,13 @@
 #
 #    opcode.h
 #    opnames.h
-#    pp.sym
+#    pp_proto.h
+#    lib/B/Op_private.pm
 #
-# from information stored in the DATA section of this file, plus the
-# values hardcoded into this script in @raw_alias.
+# from:
+#  * information stored in regen/opcodes;
+#  * information stored in regen/op_private (which is actually perl code);
+#  * the values hardcoded into this script in @raw_alias.
 #
 # Accepts the standard regen_lib -q and -v args.
 #
@@ -17,29 +20,45 @@ use strict;
 
 BEGIN {
     # Get function prototypes
-    require 'regen/regen_lib.pl';
+    require './regen/regen_lib.pl';
 }
 
-my $opcode_new = 'opcode.h-new';
-my $opname_new = 'opnames.h-new';
-my $oc = safer_open($opcode_new);
-my $on = safer_open($opname_new);
-select $oc;
+my $oc = open_new('opcode.h', '>',
+                 {by => 'regen/opcode.pl', from => 'its data',
+                  file => 'opcode.h', style => '*',
+                  copyright => [1993 .. 2007]});
 
-# Read data.
+my $on = open_new('opnames.h', '>',
+                 { by => 'regen/opcode.pl', from => 'its data', style => '*',
+                   file => 'opnames.h', copyright => [1999 .. 2008] });
+
+my $oprivpm = open_new('lib/B/Op_private.pm', '>',
+                 { by => 'regen/opcode.pl',
+                    from => "data in\nregen/op_private "
+                           ."and pod embedded in regen/opcode.pl",
+                    style => '#',
+                   file => 'lib/B/Op_private.pm',
+                    copyright => [2014 .. 2014] });
+
+# Read 'opcodes' data.
 
 my %seen;
 my (@ops, %desc, %check, %ckname, %flags, %args, %opnum);
 
-while (<DATA>) {
+open OPS, '<', 'regen/opcodes' or die $!;
+
+while (<OPS>) {
     chop;
     next unless $_;
     next if /^#/;
     my ($key, $desc, $check, $flags, $args) = split(/\t+/, $_, 5);
     $args = '' unless defined $args;
 
-    warn qq[Description "$desc" duplicates $seen{$desc}\n] if $seen{$desc};
+    warn qq[Description "$desc" duplicates $seen{$desc}\n]
+     if $seen{$desc} and $key !~ "transr|(?:intro|clone)cv|lvref";
     die qq[Opcode "$key" duplicates $seen{$key}\n] if $seen{$key};
+    die qq[Opcode "freed" is reserved for the slab allocator\n]
+       if $key eq 'freed';
     $seen{$desc} = qq[description of opcode "$key"];
     $seen{$key} = qq[opcode "$key"];
 
@@ -52,25 +71,25 @@ while (<DATA>) {
     $args{$key} = $args;
 }
 
-# Set up aliases
+# Set up aliases, and alternative funcs
 
-my %alias;
+my (%alias, %alts);
 
 # Format is "this function" => "does these op names"
 my @raw_alias = (
                 Perl_do_kv => [qw( keys values )],
-                Perl_unimplemented_op => [qw(padany mapstart custom)],
+                Perl_unimplemented_op => [qw(padany custom)],
                 # All the ops with a body of { return NORMAL; }
                 Perl_pp_null => [qw(scalar regcmaybe lineseq scope)],
 
                 Perl_pp_goto => ['dump'],
                 Perl_pp_require => ['dofile'],
                 Perl_pp_untie => ['dbmclose'],
-                Perl_pp_sysread => [qw(read recv)],
+                Perl_pp_sysread => {read => '', recv => '#ifdef HAS_SOCKET'},
                 Perl_pp_sysseek => ['seek'],
                 Perl_pp_ioctl => ['fcntl'],
-                Perl_pp_ssockopt => ['gsockopt'],
-                Perl_pp_getpeername => ['getsockname'],
+                Perl_pp_ssockopt => {gsockopt => '#ifdef HAS_SOCKET'},
+                Perl_pp_getpeername => {getsockname => '#ifdef HAS_SOCKET'},
                 Perl_pp_stat => ['lstat'],
                 Perl_pp_ftrowned => [qw(fteowned ftzero ftsock ftchr ftblk
                                         ftfile ftdir ftpipe ftsuid ftsgid
@@ -91,7 +110,7 @@ my @raw_alias = (
                 Perl_pp_ftrread => [qw(ftrwrite ftrexec fteread ftewrite
                                        fteexec)],
                 Perl_pp_shmwrite => [qw(shmread msgsnd msgrcv semop)],
-                Perl_pp_send => ['syswrite'],
+                Perl_pp_syswrite => {send => '#ifdef HAS_SOCKET'},
                 Perl_pp_defined => [qw(dor dorassign)],
                  Perl_pp_and => ['andassign'],
                 Perl_pp_or => ['orassign'],
@@ -103,87 +122,869 @@ my @raw_alias = (
                 Perl_pp_shift => ['pop'],
                 Perl_pp_sin => [qw(cos exp log sqrt)],
                 Perl_pp_bit_or => ['bit_xor'],
+                Perl_pp_nbit_or => ['nbit_xor'],
+                Perl_pp_sbit_or => ['sbit_xor'],
                 Perl_pp_rv2av => ['rv2hv'],
                 Perl_pp_akeys => ['avalues'],
-                Perl_pp_rkeys => [qw(rvalues reach)],
+                Perl_pp_trans => [qw(trans transr)],
+                Perl_pp_chop => [qw(chop chomp)],
+                Perl_pp_schop => [qw(schop schomp)],
+                Perl_pp_bind => {connect => '#ifdef HAS_SOCKET'},
+                Perl_pp_preinc => ['i_preinc'],
+                Perl_pp_predec => ['i_predec'],
+                Perl_pp_postinc => ['i_postinc'],
+                Perl_pp_postdec => ['i_postdec'],
+                Perl_pp_ehostent => [qw(enetent eprotoent eservent
+                                        spwent epwent sgrent egrent)],
+                Perl_pp_shostent => [qw(snetent sprotoent sservent)],
+                Perl_pp_aelemfast => ['aelemfast_lex'],
+                Perl_pp_grepstart => ['mapstart'],
+
+                # 2 i_modulo mappings: 2nd is alt, needs 1st (explicit default) to not override the default
+                Perl_pp_i_modulo  => ['i_modulo'],
+                Perl_pp_i_modulo_glibc_bugfix => {
+                     'i_modulo' =>
+                         '#if defined(__GLIBC__) && IVSIZE == 8 '.
+                         ' && ( __GLIBC__ < 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ < 8))' },
                );
 
 while (my ($func, $names) = splice @raw_alias, 0, 2) {
-    foreach (@$names) {
-       $alias{$_} = $func;
+    if (ref $names eq 'ARRAY') {
+       foreach (@$names) {
+            defined $alias{$_}
+            ? $alts{$_} : $alias{$_} = [$func, ''];
+       }
+    } else {
+       while (my ($opname, $cond) = each %$names) {
+            defined $alias{$opname}
+            ? $alts{$opname} : $alias{$opname} = [$func, $cond];
+       }
     }
 }
 
-# Emit defines.
+foreach my $sock_func (qw(socket bind listen accept shutdown
+                         ssockopt getpeername)) {
+    $alias{$sock_func} = ["Perl_pp_$sock_func", '#ifdef HAS_SOCKET'],
+}
 
-print <<"END";
-/* -*- buffer-read-only: t -*-
- *
- *    opcode.h
- *
- *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
- *    2001, 2002, 2003, 2004, 2005, 2006, 2007 by Larry Wall and others
- *
- *    You may distribute under the terms of either the GNU General Public
- *    License or the Artistic License, as specified in the README file.
- *
- * !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by regen/opcode.pl from its data.  Any changes made
- *  here will be lost!
- */
+
+
+# =================================================================
+#
+# Functions for processing regen/op_private data.
+#
+# Put them in a separate package so that croak() does the right thing
+
+package OP_PRIVATE;
+
+use Carp;
+
+
+# the vars holding the global state built up by all the calls to addbits()
+
+
+# map OPpLVAL_INTRO => LVINTRO
+my %LABELS;
+
+
+# the numeric values of flags - what will get output as a #define
+my %DEFINES;
+
+# %BITFIELDS: the various bit field types. The key is the concatenation of
+# all the field values that make up a bit field hash; the values are bit
+# field hash refs.  This allows us to de-dup identical bit field defs
+# across different ops, and thus make the output tables more compact (esp
+# important for the C version)
+my %BITFIELDS;
+
+# %FLAGS: the main data structure. Indexed by op name, then bit index:
+# single bit flag:
+#   $FLAGS{rv2av}{2} = 'OPpSLICEWARNING';
+# bit field (bits 5 and 6):
+#   $FLAGS{rv2av}{5} = $FLAGS{rv2av}{6} = { .... };
+my %FLAGS;
+
+
+# do, with checking, $LABELS{$name} = $label
+
+sub add_label {
+    my ($name, $label) = @_;
+    if (exists $LABELS{$name} and $LABELS{$name} ne $label) {
+        croak "addbits(): label for flag '$name' redefined:\n"
+        .  "  was '$LABELS{$name}', now '$label'";
+    }
+    $LABELS{$name} = $label;
+}
+
+#
+# do, with checking, $DEFINES{$name} = $val
+
+sub add_define {
+    my ($name, $val) = @_;
+    if (exists $DEFINES{$name} && $DEFINES{$name} != $val) {
+        croak "addbits(): value for flag '$name' redefined:\n"
+        .  "  was $DEFINES{$name}, now $val";
+    }
+    $DEFINES{$name} = $val;
+}
+
+
+# intended to be called from regen/op_private; see that file for details
+
+sub ::addbits {
+    my @args = @_;
+
+    croak "too few arguments for addbits()" unless @args >= 3;
+    my $op = shift @args;
+    croak "invalid op name: '$op'" unless exists $opnum{$op};
+
+    while (@args) {
+        my $bits = shift @args;
+        if ($bits =~ /^[0-7]$/) {
+            # single bit
+            croak "addbits(): too few arguments for single bit flag"
+                unless @args >= 2;
+            my $flag_name   = shift @args;
+            my $flag_label  = shift @args;
+            add_label($flag_name, $flag_label);
+            croak "addbits(): bit $bits of $op already specified ($FLAGS{$op}{$bits})"
+                if defined $FLAGS{$op}{$bits};
+            $FLAGS{$op}{$bits} = $flag_name;
+            add_define($flag_name, (1 << $bits));
+        }
+        elsif ($bits =~ /^([0-7])\.\.([0-7])$/) {
+            # bit range
+            my ($bitmin, $bitmax) = ($1,$2);
+
+            croak "addbits(): min bit > max bit in bit range '$bits'"
+                unless $bitmin <= $bitmax;
+            croak "addbits(): bit field argument missing"
+                unless @args >= 1;
+
+            my $arg_hash = shift @args;
+            croak "addbits(): arg to $bits must be a hash ref"
+                unless defined $arg_hash and ref($arg_hash) =~ /HASH/;
+
+            my %valid_keys;
+            @valid_keys{qw(baseshift_def bitcount_def mask_def label enum)} = ();
+            for (keys %$arg_hash) {
+                croak "addbits(): unrecognised bifield key: '$_'"
+                    unless exists $valid_keys{$_};
+            }
+
+            my $bitmask = 0;
+            $bitmask += (1 << $_) for $bitmin..$bitmax;
+
+            my $enum_id ='';
+
+            if (defined $arg_hash->{enum}) {
+                my $enum = $arg_hash->{enum};
+                croak "addbits(): arg to enum must be an array ref"
+                    unless defined $enum and ref($enum) =~ /ARRAY/;
+                croak "addbits(): enum list must be in triplets"
+                    unless @$enum % 3 == 0;
+
+                my $max_id = (1 << ($bitmax - $bitmin + 1)) - 1;
+
+                my @e = @$enum;
+                while (@e) {
+                    my $enum_ix     = shift @e;
+                    my $enum_name   = shift @e;
+                    my $enum_label  = shift @e;
+                    croak "addbits(): enum index must be a number: '$enum_ix'"
+                        unless $enum_ix =~ /^\d+$/;
+                    croak "addbits(): enum index too big: '$enum_ix'"
+                        unless $enum_ix  <= $max_id;
+                    add_label($enum_name, $enum_label);
+                    add_define($enum_name, $enum_ix << $bitmin);
+                    $enum_id .= "($enum_ix:$enum_name:$enum_label)";
+                }
+            }
+
+            # id is a fingerprint of all the content of the bit field hash
+            my $id = join ':', map defined() ? $_ : "-undef-",
+                $bitmin, $bitmax,
+                $arg_hash->{label},
+                $arg_hash->{mask_def},
+                $arg_hash->{baseshift_def},
+                $arg_hash->{bitcount_def},
+                $enum_id;
+
+            unless (defined $BITFIELDS{$id}) {
+
+                if (defined $arg_hash->{mask_def}) {
+                    add_define($arg_hash->{mask_def}, $bitmask);
+                }
+
+                if (defined $arg_hash->{baseshift_def}) {
+                    add_define($arg_hash->{baseshift_def}, $bitmin);
+                }
+
+                if (defined $arg_hash->{bitcount_def}) {
+                    add_define($arg_hash->{bitcount_def}, $bitmax-$bitmin+1);
+                }
+
+                # create deep copy
+
+                my $copy = {};
+                for (qw(baseshift_def  bitcount_def mask_def label)) {
+                    $copy->{$_} = $arg_hash->{$_} if defined $arg_hash->{$_};
+                }
+                if (defined $arg_hash->{enum}) {
+                    $copy->{enum} = [ @{$arg_hash->{enum}} ];
+                }
+
+                # and add some extra fields
+
+                $copy->{bitmask} = $bitmask;
+                $copy->{bitmin} = $bitmin;
+                $copy->{bitmax} = $bitmax;
+
+                $BITFIELDS{$id} = $copy;
+            }
+
+            for my $bit ($bitmin..$bitmax) {
+                croak "addbits(): bit $bit of $op already specified ($FLAGS{$op}{$bit})"
+                    if defined $FLAGS{$op}{$bit};
+                $FLAGS{$op}{$bit} = $BITFIELDS{$id};
+            }
+        }
+        else {
+            croak "addbits(): invalid bit specifier '$bits'";
+        }
+    }
+}
+
+
+# intended to be called from regen/op_private; see that file for details
+
+sub ::ops_with_flag {
+    my $flag = shift;
+    return grep $flags{$_} =~ /\Q$flag/, sort keys %flags;
+}
+
+
+# intended to be called from regen/op_private; see that file for details
+
+sub ::ops_with_check {
+    my $c = shift;
+    return grep $check{$_} eq $c, sort keys %check;
+}
+
+
+# intended to be called from regen/op_private; see that file for details
+
+sub ::ops_with_arg {
+    my ($i, $arg_type) = @_;
+    my @ops;
+    for my $op (sort keys %args) {
+        my @args = split(' ',$args{$op});
+        push @ops, $op if defined $args[$i] and $args[$i] eq $arg_type;
+    }
+    @ops;
+}
+
+
+# output '#define OPpLVAL_INTRO 0x80' etc
+
+sub print_defines {
+    my $fh = shift;
+
+    for (sort { $DEFINES{$a} <=> $DEFINES{$b} || $a cmp $b } keys %DEFINES) {
+        printf $fh "#define %-23s 0x%02x\n", $_, $DEFINES{$_};
+    }
+}
+
+
+# Generate the content of B::Op_private
+
+sub print_B_Op_private {
+    my $fh = shift;
+
+    my $header = <<'EOF';
+@=head1 NAME
+@
+@B::Op_private -  OP op_private flag definitions
+@
+@=head1 SYNOPSIS
+@
+@    use B::Op_private;
+@
+@    # flag details for bit 7 of OP_AELEM's op_private:
+@    my $name  = $B::Op_private::bits{aelem}{7}; # OPpLVAL_INTRO
+@    my $value = $B::Op_private::defines{$name}; # 128
+@    my $label = $B::Op_private::labels{$name};  # LVINTRO
+@
+@    # the bit field at bits 5..6 of OP_AELEM's op_private:
+@    my $bf  = $B::Op_private::bits{aelem}{6};
+@    my $mask = $bf->{bitmask}; # etc
+@
+@=head1 DESCRIPTION
+@
+@This module provides four global hashes:
+@
+@    %B::Op_private::bits
+@    %B::Op_private::defines
+@    %B::Op_private::labels
+@    %B::Op_private::ops_using
+@
+@which contain information about the per-op meanings of the bits in the
+@op_private field.
+@
+@=head2 C<%bits>
+@
+@This is indexed by op name and then bit number (0..7). For single bit flags,
+@it returns the name of the define (if any) for that bit:
+@
+@   $B::Op_private::bits{aelem}{7} eq 'OPpLVAL_INTRO';
+@
+@For bit fields, it returns a hash ref containing details about the field.
+@The same reference will be returned for all bit positions that make
+@up the bit field; so for example these both return the same hash ref:
+@
+@    $bitfield = $B::Op_private::bits{aelem}{5};
+@    $bitfield = $B::Op_private::bits{aelem}{6};
+@
+@The general format of this hash ref is
+@
+@    {
+@        # The bit range and mask; these are always present.
+@        bitmin        => 5,
+@        bitmax        => 6,
+@        bitmask       => 0x60,
+@
+@        # (The remaining keys are optional)
+@
+@        # The names of any defines that were requested:
+@        mask_def      => 'OPpFOO_MASK',
+@        baseshift_def => 'OPpFOO_SHIFT',
+@        bitcount_def  => 'OPpFOO_BITS',
+@
+@        # If present, Concise etc will display the value with a 'FOO='
+@        # prefix. If it equals '-', then Concise will treat the bit
+@        # field as raw bits and not try to interpret it.
+@        label         => 'FOO',
+@
+@        # If present, specifies the names of some defines and the
+@        # display labels that are used to assign meaning to particu-
+@        # lar integer values within the bit field; e.g. 3 is dis-
+@        # played as 'C'.
+@        enum          => [ qw(
+@                             1   OPpFOO_A  A
+@                             2   OPpFOO_B  B
+@                             3   OPpFOO_C  C
+@                         )],
+@
+@    };
+@
+@
+@=head2 C<%defines>
+@
+@This gives the value of every C<OPp> define, e.g.
+@
+@    $B::Op_private::defines{OPpLVAL_INTRO} == 128;
+@
+@=head2 C<%labels>
+@
+@This gives the short display label for each define, as used by C<B::Concise>
+@and C<perl -Dx>, e.g.
+@
+@    $B::Op_private::labels{OPpLVAL_INTRO} eq 'LVINTRO';
+@
+@If the label equals '-', then Concise will treat the bit as a raw bit and
+@not try to display it symbolically.
+@
+@=head2 C<%ops_using>
+@
+@For each define, this gives a reference to an array of op names that use
+@the flag.
+@
+@    @ops_using_lvintro = @{ $B::Op_private::ops_using{OPp_LVAL_INTRO} };
+@
+@=cut
+
+package B::Op_private;
+
+our %bits;
+
+EOF
+    # remove podcheck.t-defeating leading char
+    $header =~ s/^\@//gm;
+    print $fh $header;
+    my $v = (::perl_version())[3];
+    print $fh qq{\nour \$VERSION = "$v";\n\n};
+
+    my %ops_using;
+
+    # for each flag/bit combination, find the ops which use it
+    my %combos;
+    for my $op (sort keys %FLAGS) {
+        my $entry = $FLAGS{$op};
+        for my $bit (0..7) {
+            my $e = $entry->{$bit};
+            next unless defined $e;
+            next if ref $e; # bit field, not flag
+            push @{$combos{$e}{$bit}}, $op;
+            push @{$ops_using{$e}}, $op;
+        }
+    }
+
+    # dump flags used by multiple ops
+    for my $flag (sort keys %combos) {
+        for my $bit (sort keys %{$combos{$flag}}) {
+            my $ops = $combos{$flag}{$bit};
+            next unless @$ops > 1;
+            my @o = sort @$ops;
+            print $fh "\$bits{\$_}{$bit} = '$flag' for qw(@o);\n";
+        }
+    }
+
+    # dump bit field definitions
+
+    my %bitfield_ix;
+    {
+        my %bitfields;
+        # stringified-ref to ref mapping
+        $bitfields{$_} = $_ for values %BITFIELDS;
+        my $ix = -1;
+        my $s = "\nmy \@bf = (\n";
+        for my $bitfield_key (sort keys %BITFIELDS) {
+            my $bitfield = $BITFIELDS{$bitfield_key};
+            $ix++;
+            $bitfield_ix{$bitfield} = $ix;
+
+            $s .= "    {\n";
+            for (qw(label mask_def baseshift_def bitcount_def)) {
+                next unless defined $bitfield->{$_};
+                $s .= sprintf "        %-9s => '%s',\n",
+                            $_,  $bitfield->{$_};
+            }
+            for (qw(bitmin bitmax bitmask)) {
+                croak "panic" unless defined $bitfield->{$_};
+                $s .= sprintf "        %-9s => %d,\n",
+                            $_,  $bitfield->{$_};
+            }
+            if (defined $bitfield->{enum}) {
+                $s .= "        enum      => [\n";
+                my @enum = @{$bitfield->{enum}};
+                while (@enum) {
+                    my $i     = shift @enum;
+                    my $name  = shift @enum;
+                    my $label = shift @enum;
+                    $s .= sprintf "            %d, %-10s, %s,\n",
+                            $i, "'$name'", "'$label'";
+                }
+                $s .= "        ],\n";
+            }
+            $s .= "    },\n";
+
+        }
+        $s .= ");\n";
+        print $fh "$s\n";
+    }
+
+    # dump bitfields and remaining labels
+
+    for my $op (sort keys %FLAGS) {
+        my @indices;
+        my @vals;
+        my $entry = $FLAGS{$op};
+        my $bit;
+
+        for ($bit = 7; $bit >= 0; $bit--) {
+            next unless defined $entry->{$bit};
+            my $e = $entry->{$bit};
+            if (ref $e) {
+                my $ix = $bitfield_ix{$e};
+                for (reverse $e->{bitmin}..$e->{bitmax}) {
+                    push @indices,  $_;
+                    push @vals, "\$bf[$ix]";
+                }
+                $bit = $e->{bitmin};
+            }
+            else {
+                next if @{$combos{$e}{$bit}} > 1;  # already output
+                push @indices, $bit;
+                push @vals, "'$e'";
+            }
+        }
+        if (@indices) {
+            my $s = '';
+            $s = '@{' if @indices > 1;
+            $s .= "\$bits{$op}";
+            $s .= '}' if @indices > 1;
+            $s .= '{' . join(',', @indices) . '} = ';
+            $s .= '(' if @indices > 1;
+            $s .= join ', ', @vals;
+            $s .= ')' if @indices > 1;
+            print $fh "$s;\n";
+        }
+    }
+
+    # populate %defines and %labels
+
+    print  $fh "\n\nour %defines = (\n";
+    printf $fh "    %-23s  => %3d,\n", $_ , $DEFINES{$_} for sort keys %DEFINES;
+    print  $fh ");\n\nour %labels = (\n";
+    printf $fh "    %-23s  => '%s',\n", $_ , $LABELS{$_}  for sort keys %LABELS;
+    print  $fh ");\n";
+
+    # %ops_using
+    print  $fh "\n\nour %ops_using = (\n";
+    # Save memory by using the same array wherever possible.
+    my %flag_by_op_list;
+    my $pending = '';
+    for my $flag (sort keys %ops_using) {
+        my $op_list = $ops_using{$flag} = "@{$ops_using{$flag}}";
+        if (!exists $flag_by_op_list{$op_list}) {
+            $flag_by_op_list{$op_list} = $flag;
+            printf $fh "    %-23s  => %s,\n", $flag , "[qw($op_list)]"
+        }
+        else {
+            $pending .= "\$ops_using{$flag} = "
+                      . "\$ops_using{$flag_by_op_list{$op_list}};\n";
+        }
+    }
+    print  $fh ");\n\n$pending";
+
+}
+
+
+
+# output the contents of the assorted PL_op_private_*[] tables
+
+sub print_PL_op_private_tables {
+    my $fh = shift;
+
+    my $PL_op_private_labels     = '';
+    my $PL_op_private_valid      = '';
+    my $PL_op_private_bitdef_ix  = '';
+    my $PL_op_private_bitdefs    = '';
+    my $PL_op_private_bitfields  = '';
+
+    my %label_ix;
+    my %bitfield_ix;
+
+    # generate $PL_op_private_labels
+
+    {
+        my %labs;
+        $labs{$_} = 1 for values %LABELS; # de-duplicate labels
+        # add in bit field labels
+        for (values %BITFIELDS) {
+            next unless defined $_->{label};
+            $labs{$_->{label}} = 1;
+        }
+
+        my $labels = '';
+        for my $lab (sort keys %labs) {
+            $label_ix{$lab} = length $labels;
+            $labels .= "$lab\0";
+            $PL_op_private_labels .=
+                  "    "
+                . join(',', map("'$_'", split //, $lab))
+                . ",'\\0',\n";
+        }
+    }
+
+
+    # generate PL_op_private_bitfields
+
+    {
+        my %bitfields;
+        # stringified-ref to ref mapping
+        $bitfields{$_} = $_ for values %BITFIELDS;
+
+        my $ix = 0;
+        for my $bitfield_key (sort keys %BITFIELDS) {
+            my $bf = $BITFIELDS{$bitfield_key};
+            $bitfield_ix{$bf} = $ix;
+
+            my @b;
+            push @b, $bf->{bitmin},
+                defined $bf->{label} ? $label_ix{$bf->{label}} : -1;
+            my $enum = $bf->{enum};
+            if (defined $enum) {
+                my @enum = @$enum;
+                while (@enum) {
+                    my $i     = shift @enum;
+                    my $name  = shift @enum;
+                    my $label = shift @enum;
+                    push @b, $i, $label_ix{$label};
+                }
+            }
+            push @b, -1; # terminate enum list
+
+            $PL_op_private_bitfields .= "    " .  join(', ', @b) .",\n";
+            $ix += @b;
+        }
+    }
+
+
+    # generate PL_op_private_bitdefs, PL_op_private_bitdef_ix
+
+    {
+        my $bitdef_count = 0;
+
+        my %not_seen = %FLAGS;
+        my @seen_bitdefs;
+        my %seen_bitdefs;
+
+        my $opnum = -1;
+        for my $op (sort { $opnum{$a} <=> $opnum{$b} } keys %opnum) {
+            $opnum++;
+            die "panic: opnum misorder: opnum=$opnum opnum{op}=$opnum{$op}"
+                unless $opnum == $opnum{$op};
+            delete $not_seen{$op};
+
+            my @bitdefs;
+            my $entry = $FLAGS{$op};
+            my $bit;
+            my $index;
+
+            for ($bit = 7; $bit >= 0; $bit--) {
+                my $e = $entry->{$bit};
+                next unless defined $e;
+
+                my $ix;
+                if (ref $e) {
+                    $ix = $bitfield_ix{$e};
+                    die "panic: \$bit =\= $e->{bitmax}"
+                        unless $bit == $e->{bitmax};
+
+                    push @bitdefs, ( ($ix << 5) | ($bit << 2) | 2 );
+                    $bit = $e->{bitmin};
+                }
+                else {
+                    $ix = $label_ix{$LABELS{$e}};
+                    die "panic: no label ix for '$e'" unless defined $ix;
+                    push @bitdefs, ( ($ix << 5) | ($bit << 2));
+                }
+                if ($ix > 2047) {
+                    die "Too many labels or bitfields (ix=$ix): "
+                    . "maybe the type of PL_op_private_bitdefs needs "
+                    . "expanding from U16 to U32???";
+                }
+            }
+            if (@bitdefs) {
+                $bitdefs[-1] |= 1; # stop bit
+                my $key = join(', ', map(sprintf("0x%04x", $_), @bitdefs));
+                if (!$seen_bitdefs{$key}) {
+                    $index = $bitdef_count;
+                    $bitdef_count += @bitdefs;
+                    push @seen_bitdefs,
+                         $seen_bitdefs{$key} = [$index, $key];
+                }
+                else {
+                    $index = $seen_bitdefs{$key}[0];
+                }
+                push @{$seen_bitdefs{$key}}, $op;
+            }
+            else {
+                $index = -1;
+            }
+            $PL_op_private_bitdef_ix .= sprintf "    %4d, /* %s */\n", $index, $op;
+        }
+        if (%not_seen) {
+            die "panic: unprocessed ops: ". join(',', keys %not_seen);
+        }
+        for (@seen_bitdefs) {
+            local $" = ", ";
+            $PL_op_private_bitdefs .= "    $$_[1], /* @$_[2..$#$_] */\n";
+        }
+    }
+
+
+    # generate PL_op_private_valid
+
+    for my $op (@ops) {
+        my $last;
+        my @flags;
+        for my $bit (0..7) {
+            next unless exists $FLAGS{$op};
+            my $entry = $FLAGS{$op}{$bit};
+            next unless defined $entry;
+            if (ref $entry) {
+                # skip later entries for the same bit field
+                next if defined $last and $last == $entry;
+                $last = $entry;
+                push @flags,
+                    defined $entry->{mask_def}
+                        ? $entry->{mask_def}
+                        : $entry->{bitmask};
+            }
+            else {
+                push @flags, $entry;
+            }
+        }
+
+        # all bets are off
+        @flags = '0xff' if $op eq 'null' or $op eq 'custom';
+
+        $PL_op_private_valid .= sprintf "    /* %-10s */ (%s),\n", uc($op),
+                                    @flags ? join('|', @flags): '0';
+    }
+
+    print $fh <<EOF;
+START_EXTERN_C
 
 #ifndef PERL_GLOBAL_STRUCT_INIT
 
-#define Perl_pp_i_preinc Perl_pp_preinc
-#define Perl_pp_i_predec Perl_pp_predec
-#define Perl_pp_i_postinc Perl_pp_postinc
-#define Perl_pp_i_postdec Perl_pp_postdec
+#  ifndef DOINIT
 
-PERL_PPDEF(Perl_unimplemented_op)
+/* data about the flags in op_private */
+
+EXTCONST I16  PL_op_private_bitdef_ix[];
+EXTCONST U16  PL_op_private_bitdefs[];
+EXTCONST char PL_op_private_labels[];
+EXTCONST I16  PL_op_private_bitfields[];
+EXTCONST U8   PL_op_private_valid[];
+
+#  else
 
-END
 
-print $on <<"END";
-/* -*- buffer-read-only: t -*-
- *
- *    opnames.h
- *
- *    Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
- *    2007, 2008 by Larry Wall and others
- *
- *    You may distribute under the terms of either the GNU General Public
- *    License or the Artistic License, as specified in the README file.
- *
- *
- * !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by regen/opcode.pl from its data.  Any changes made
- *  here will be lost!
+/* PL_op_private_labels[]: the short descriptions of private flags.
+ * All labels are concatenated into a single char array
+ * (separated by \\0's) for compactness.
  */
 
-typedef enum opcode {
-END
+EXTCONST char PL_op_private_labels[] = {
+$PL_op_private_labels
+};
+
+
+
+/* PL_op_private_bitfields[]: details about each bit field type.
+ * Each definition consists of the following list of words:
+ *    bitmin
+ *    label (index into PL_op_private_labels[]; -1 if no label)
+ *    repeat for each enum entry (if any):
+ *       enum value
+ *       enum label (index into PL_op_private_labels[])
+ *    -1
+ */
+
+EXTCONST I16 PL_op_private_bitfields[] = {
+$PL_op_private_bitfields
+};
+
+
+/* PL_op_private_bitdef_ix[]: map an op number to a starting position
+ * in PL_op_private_bitdefs.  If -1, the op has no bits defined */
+
+EXTCONST I16  PL_op_private_bitdef_ix[] = {
+$PL_op_private_bitdef_ix
+};
+
+
+
+/* PL_op_private_bitdefs[]: given a starting position in this array (as
+ * supplied by PL_op_private_bitdef_ix[]), each word (until a stop bit is
+ * seen) defines the meaning of a particular op_private bit for a
+ * particular op. Each word consists of:
+ *  bit  0:     stop bit: this is the last bit def for the current op
+ *  bit  1:     bitfield: if set, this defines a bit field rather than a flag
+ *  bits 2..4:  unsigned number in the range 0..7 which is the bit number
+ *  bits 5..15: unsigned number in the range 0..2047 which is an index
+ *              into PL_op_private_labels[]    (for a flag), or
+ *              into PL_op_private_bitfields[] (for a bit field)
+ */
+
+EXTCONST U16  PL_op_private_bitdefs[] = {
+$PL_op_private_bitdefs
+};
+
+
+/* PL_op_private_valid: for each op, indexed by op_type, indicate which
+ * flags bits in op_private are legal */
+
+EXTCONST U8 PL_op_private_valid[] = {
+$PL_op_private_valid
+};
+
+#  endif /* !DOINIT */
+#endif /* !PERL_GLOBAL_STRUCT_INIT */
+
+END_EXTERN_C
+
+
+EOF
+
+}
+
+
+# =================================================================
+
+
+package main;
+
+# read regen/op_private data
+#
+# This file contains Perl code that builds up some data structures
+# which define what bits in op_private have what meanings for each op.
+# It populates %LABELS, %DEFINES, %FLAGS, %BITFIELDS.
+
+require './regen/op_private';
+
+#use Data::Dumper;
+#print Dumper \%LABELS, \%DEFINES, \%FLAGS, \%BITFIELDS;
+
+
+# Emit defines.
+
+print $oc    "#ifndef PERL_GLOBAL_STRUCT_INIT\n\n";
+
+{
+    my $last_cond = '';
+    my @unimplemented;
+
+    sub unimplemented {
+       if (@unimplemented) {
+           print $oc "#else\n";
+           foreach (@unimplemented) {
+               print $oc "#define $_ Perl_unimplemented_op\n";
+           }
+           print $oc "#endif\n";
+           @unimplemented = ();
+       }
+
+    }
+
+    for (@ops) {
+       my ($impl, $cond) = @{$alias{$_} || ["Perl_pp_$_", '']};
+       my $op_func = "Perl_pp_$_";
+
+       if ($cond ne $last_cond) {
+           # A change in condition. (including to or from no condition)
+           unimplemented();
+           $last_cond = $cond;
+           if ($last_cond) {
+               print $oc "$last_cond\n";
+           }
+       }
+       push @unimplemented, $op_func if $last_cond;
+       print $oc "#define $op_func $impl\n" if $impl ne $op_func;
+    }
+    # If the last op was conditional, we need to close it out:
+    unimplemented();
+}
+
+print $on "typedef enum opcode {\n";
 
 my $i = 0;
 for (@ops) {
-    # print $on "\t", &tab(3,"OP_\U$_,"), "/* ", $i++, " */\n";
-      print $on "\t", &tab(3,"OP_\U$_"), " = ", $i++, ",\n";
+      print $on "\t", tab(3,"OP_\U$_"), " = ", $i++, ",\n";
 }
-print $on "\t", &tab(3,"OP_max"), "\n";
+print $on "\t", tab(3,"OP_max"), "\n";
 print $on "} opcode;\n";
 print $on "\n#define MAXO ", scalar @ops, "\n";
-print $on "#define OP_phoney_INPUT_ONLY -1\n";
-print $on "#define OP_phoney_OUTPUT_ONLY -2\n\n";
+print $on "#define OP_FREED MAXO\n";
 
 # Emit op names and descriptions.
 
-print <<END;
+print $oc <<'END';
 START_EXTERN_C
 
-#define OP_NAME(o) ((o)->op_type == OP_CUSTOM ? custom_op_name(o) : \\
-                    PL_op_name[(o)->op_type])
-#define OP_DESC(o) ((o)->op_type == OP_CUSTOM ? custom_op_desc(o) : \\
-                    PL_op_desc[(o)->op_type])
-
 #ifndef DOINIT
 EXTCONST char* const PL_op_name[];
 #else
@@ -191,16 +992,14 @@ EXTCONST char* const PL_op_name[] = {
 END
 
 for (@ops) {
-    print qq(\t"$_",\n);
+    print $oc qq(\t"$_",\n);
 }
 
-print <<END;
+print $oc <<'END';
+       "freed",
 };
 #endif
 
-END
-
-print <<END;
 #ifndef DOINIT
 EXTCONST char* const PL_op_desc[];
 #else
@@ -213,10 +1012,11 @@ for (@ops) {
     # Have to escape double quotes and escape characters.
     $safe_desc =~ s/([\\"])/\\$1/g;
 
-    print qq(\t"$safe_desc",\n);
+    print $oc qq(\t"$safe_desc",\n);
 }
 
-print <<END;
+print $oc <<'END';
+       "freed op",
 };
 #endif
 
@@ -225,32 +1025,18 @@ END_EXTERN_C
 #endif /* !PERL_GLOBAL_STRUCT_INIT */
 END
 
-# Emit function declarations.
-
-#for (sort keys %ckname) {
-#    print "OP *\t", &tab(3,$_),"(pTHX_ OP* o);\n";
-#}
-#
-#print "\n";
-#
-#for (@ops) {
-#    print "OP *\t", &tab(3, "pp_$_"), "(pTHX);\n";
-#}
-
 # Emit ppcode switch array.
 
-print <<END;
+print $oc <<'END';
 
 START_EXTERN_C
 
 #ifdef PERL_GLOBAL_STRUCT_INIT
 #  define PERL_PPADDR_INITED
 static const Perl_ppaddr_t Gppaddr[]
-#else
-#  ifndef PERL_GLOBAL_STRUCT
-#    define PERL_PPADDR_INITED
+#elif !defined(PERL_GLOBAL_STRUCT)
+#  define PERL_PPADDR_INITED
 EXT Perl_ppaddr_t PL_ppaddr[] /* or perlvars.h */
-#  endif
 #endif /* PERL_GLOBAL_STRUCT */
 #if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
 #  define PERL_PPADDR_INITED
@@ -258,34 +1044,29 @@ EXT Perl_ppaddr_t PL_ppaddr[] /* or perlvars.h */
 END
 
 for (@ops) {
-    if (my $name = $alias{$_}) {
-       print "\t$name,\t/* Perl_pp_$_ */\n";
+    my $op_func = "Perl_pp_$_";
+    my $name = $alias{$_};
+    if ($name && $name->[0] ne $op_func) {
+       print $oc "\t$op_func,\t/* implemented by $name->[0] */\n";
     }
     else {
-       print "\tPerl_pp_$_,\n";
+       print $oc "\t$op_func,\n";
     }
 }
 
-print <<END;
+print $oc <<'END';
 }
 #endif
 #ifdef PERL_PPADDR_INITED
 ;
 #endif
 
-END
-
-# Emit check routines.
-
-print <<END;
 #ifdef PERL_GLOBAL_STRUCT_INIT
 #  define PERL_CHECK_INITED
 static const Perl_check_t Gcheck[]
-#else
-#  ifndef PERL_GLOBAL_STRUCT
-#    define PERL_CHECK_INITED
+#elif !defined(PERL_GLOBAL_STRUCT)
+#  define PERL_CHECK_INITED
 EXT Perl_check_t PL_check[] /* or perlvars.h */
-#  endif
 #endif
 #if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
 #  define PERL_CHECK_INITED
@@ -293,23 +1074,16 @@ EXT Perl_check_t PL_check[] /* or perlvars.h */
 END
 
 for (@ops) {
-    print "\t", &tab(3, "Perl_$check{$_},"), "\t/* $_ */\n";
+    print $oc "\t", tab(3, "Perl_$check{$_},"), "\t/* $_ */\n";
 }
 
-print <<END;
+print $oc <<'END';
 }
 #endif
 #ifdef PERL_CHECK_INITED
 ;
 #endif /* #ifdef PERL_CHECK_INITED */
 
-END
-
-# Emit allowed argument types.
-
-my $ARGBITS = 32;
-
-print <<END;
 #ifndef PERL_GLOBAL_STRUCT_INIT
 
 #ifndef DOINIT
@@ -318,6 +1092,10 @@ EXTCONST U32 PL_opargs[];
 EXTCONST U32 PL_opargs[] = {
 END
 
+# Emit allowed argument types.
+
+my $ARGBITS = 32;
+
 my %argnum = (
     'S',  1,           # scalar
     'L',  2,           # list
@@ -343,6 +1121,8 @@ my %opclass = (
     '%',  11,          # baseop_or_unop
     '-',  12,          # filestatop
     '}',  13,          # loopexop
+    '.',  14,          # methop
+    '+',  15,          # unop_aux
 );
 
 my %opflags = (
@@ -353,13 +1133,17 @@ my %opflags = (
     'T' =>   8 | 16,   # ... which may be lexical
     'i' =>   0,                # always produces integer (unused since e7311069)
     'I' =>  32,                # has corresponding int op
-    'd' =>  64,                # danger, unknown side effects
+    'd' =>  64,                # danger, make temp copy in list assignment
     'u' => 128,                # defaults to $_
 );
 
-my %OP_IS_SOCKET;
-my %OP_IS_FILETEST;
-my %OP_IS_FT_ACCESS;
+my %OP_IS_SOCKET;      # /Fs/
+my %OP_IS_FILETEST;    # /F-/
+my %OP_IS_FT_ACCESS;   # /F-+/
+my %OP_IS_NUMCOMPARE;  # /S</
+my %OP_IS_DIRHOP;      # /Fd/
+my %OP_IS_INFIX_BIT;   # /S\|/
+
 my $OCSHIFT = 8;
 my $OASHIFT = 12;
 
@@ -378,12 +1162,20 @@ for my $op (@ops) {
     $argsum |= $opclass{$flags} << $OCSHIFT;
     my $argshift = $OASHIFT;
     for my $arg (split(' ',$args{$op})) {
+       if ($arg =~ s/^D//) {
+           # handle 1st, just to put D 1st.
+           $OP_IS_DIRHOP{$op}   = $opnum{$op};
+       }
        if ($arg =~ /^F/) {
            # record opnums of these opnames
            $OP_IS_SOCKET{$op}   = $opnum{$op} if $arg =~ s/s//;
            $OP_IS_FILETEST{$op} = $opnum{$op} if $arg =~ s/-//;
            $OP_IS_FT_ACCESS{$op} = $opnum{$op} if $arg =~ s/\+//;
         }
+       elsif ($arg =~ /^S./) {
+           $OP_IS_NUMCOMPARE{$op} = $opnum{$op} if $arg =~ s/<//;
+           $OP_IS_INFIX_BIT {$op} = $opnum{$op} if $arg =~ s/\|//;
+       }
        my $argnum = ($arg =~ s/\?//) ? 8 : 0;
         die "op = $op, arg = $arg\n"
            unless exists $argnum{$arg};
@@ -395,32 +1187,34 @@ for my $op (@ops) {
        $argshift += 4;
     }
     $argsum = sprintf("0x%08x", $argsum);
-    print "\t", &tab(3, "$argsum,"), "/* $op */\n";
+    print $oc "\t", tab(3, "$argsum,"), "/* $op */\n";
 }
 
-print <<END;
+print $oc <<'END';
 };
 #endif
 
 #endif /* !PERL_GLOBAL_STRUCT_INIT */
 
 END_EXTERN_C
-
 END
 
 # Emit OP_IS_* macros
 
-print $on <<EO_OP_IS_COMMENT;
-
-/* the OP_IS_(SOCKET|FILETEST) macros are optimized to a simple range
-    check because all the member OPs are contiguous in opcode.pl
-    <DATA> table.  opcode.pl verifies the range contiguity.  */
+print $on <<'EO_OP_IS_COMMENT';
 
+/* the OP_IS_* macros are optimized to a simple range check because
+    all the member OPs are contiguous in regen/opcodes table.
+    opcode.pl verifies the range contiguity, or generates an OR-equals
+    expression */
 EO_OP_IS_COMMENT
 
 gen_op_is_macro( \%OP_IS_SOCKET, 'OP_IS_SOCKET');
 gen_op_is_macro( \%OP_IS_FILETEST, 'OP_IS_FILETEST');
 gen_op_is_macro( \%OP_IS_FT_ACCESS, 'OP_IS_FILETEST_ACCESS');
+gen_op_is_macro( \%OP_IS_NUMCOMPARE, 'OP_IS_NUMCOMPARE');
+gen_op_is_macro( \%OP_IS_DIRHOP, 'OP_IS_DIRHOP');
+gen_op_is_macro( \%OP_IS_INFIX_BIT, 'OP_IS_INFIX_BIT');
 
 sub gen_op_is_macro {
     my ($op_is, $macname) = @_;
@@ -434,674 +1228,51 @@ sub gen_op_is_macro {
        my $last = pop @rest;   # @rest slurped, get its last
        die "Invalid range of ops: $first .. $last\n" unless $last;
 
-       print $on "#define $macname(op) \\\n\t(";
+       print $on "\n#define $macname(op)       \\\n\t(";
 
        # verify that op-ct matches 1st..last range (and fencepost)
        # (we know there are no dups)
        if ( $op_is->{$last} - $op_is->{$first} == scalar @rest + 1) {
            
            # contiguous ops -> optimized version
-           print $on "(op) >= OP_" . uc($first) . " && (op) <= OP_" . uc($last);
-           print $on ")\n\n";
+           print $on "(op) >= OP_" . uc($first)
+               . " && (op) <= OP_" . uc($last);
        }
        else {
            print $on join(" || \\\n\t ",
-                         map { "(op) == OP_" . uc() } sort keys %$op_is);
-           print $on ")\n\n";
+                          map { "(op) == OP_" . uc() } sort keys %$op_is);
        }
+       print $on ")\n";
     }
 }
 
-print $oc "/* ex: set ro: */\n";
-print $on "/* ex: set ro: */\n";
-
-safer_close($oc);
-safer_close($on);
-
-rename_if_different $opcode_new, 'opcode.h';
-rename_if_different $opname_new, 'opnames.h';
-
-my $pp_sym_new  = 'pp.sym-new';
-my $ppsym = safer_open($pp_sym_new);
+my $pp = open_new('pp_proto.h', '>',
+                 { by => 'opcode.pl', from => 'its data' });
 
-print $ppsym <<"END";
-# -*- buffer-read-only: t -*-
-#
-# !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
-#   This file is built by regen/opcode.pl from its data.  Any changes made
-#   here will be lost!
-#
-
-END
-
-
-for (sort keys %ckname) {
-    print $ppsym "Perl_$_\n";
-#OP *\t", &tab(3,$_),"(OP* o);\n";
-}
-
-for (@ops) {
-    next if /^i_(pre|post)(inc|dec)$/;
-    next if /^custom$/;
-    print $ppsym "Perl_pp_$_\n";
+{
+    my %funcs;
+    for (@ops) {
+       my $name = $alias{$_} ? $alias{$_}[0] : "Perl_pp_$_";
+       ++$funcs{$name};
+    }
+    print $pp "PERL_CALLCONV OP *$_(pTHX);\n" foreach sort keys %funcs;
+
+    print $pp "\n/* alternative functions */\n" if keys %alts;
+    for my $fn (sort keys %alts) {
+        my ($x, $cond) = @{$alts{$fn}};
+        print $pp "$cond\n" if $cond;
+        print $pp "PERL_CALLCONV OP *$x(pTHX);\n";
+        print $pp "#endif\n" if $cond;
+    }
 }
-print $ppsym "\n# ex: set ro:\n";
 
-safer_close($ppsym);
+print $oc "\n\n";
+OP_PRIVATE::print_defines($oc);
+OP_PRIVATE::print_PL_op_private_tables($oc);
 
-rename_if_different $pp_sym_new, 'pp.sym';
+OP_PRIVATE::print_B_Op_private($oprivpm);
 
-END {
-  foreach ('opcode.h', 'opnames.h', 'pp.sym') {
-    1 while unlink "$_-old";
-  }
+foreach ($oc, $on, $pp, $oprivpm) {
+    read_only_bottom_close_and_rename($_);
 }
 
-###########################################################################
-sub tab {
-    my ($l, $t) = @_;
-    $t .= "\t" x ($l - (length($t) + 1) / 8);
-    $t;
-}
-###########################################################################
-
-# Some comments about 'T' opcode classifier:
-
-# Safe to set if the ppcode uses:
-#      tryAMAGICbin, tryAMAGICun, SETn, SETi, SETu, PUSHn, PUSHTARG, SETTARG,
-#      SETs(TARG), XPUSHn, XPUSHu,
-
-# Unsafe to set if the ppcode uses dTARG or [X]RETPUSH[YES|NO|UNDEF]
-
-# lt and friends do SETs (including ncmp, but not scmp)
-
-# Additional mode of failure: the opcode can modify TARG before it "used"
-# all the arguments (or may call an external function which does the same).
-# If the target coincides with one of the arguments ==> kaboom.
-
-# pp.c pos substr each not OK (RETPUSHUNDEF)
-#      substr vec also not OK due to LV to target (are they???)
-#      ref not OK (RETPUSHNO)
-#      trans not OK (dTARG; TARG = sv_newmortal();)
-#      ucfirst etc not OK: TMP arg processed inplace
-#      quotemeta not OK (unsafe when TARG == arg)
-#      each repeat not OK too due to list context
-#      pack split - unknown whether they are safe
-#      sprintf: is calling do_sprintf(TARG,...) which can act on TARG
-#        before other args are processed.
-
-#      Suspicious wrt "additional mode of failure" (and only it):
-#      schop, chop, postinc/dec, bit_and etc, negate, complement.
-
-#      Also suspicious: 4-arg substr, sprintf, uc/lc (POK_only), reverse, pack.
-
-#      substr/vec: doing TAINT_off()???
-
-# pp_hot.c
-#      readline - unknown whether it is safe
-#      match subst not OK (dTARG)
-#      grepwhile not OK (not always setting)
-#      join not OK (unsafe when TARG == arg)
-
-#      Suspicious wrt "additional mode of failure": concat (dealt with
-#      in ck_sassign()), join (same).
-
-# pp_ctl.c
-#      mapwhile flip caller not OK (not always setting)
-
-# pp_sys.c
-#      backtick glob warn die not OK (not always setting)
-#      warn not OK (RETPUSHYES)
-#      open fileno getc sysread syswrite ioctl accept shutdown
-#       ftsize(etc) readlink telldir fork alarm getlogin not OK (RETPUSHUNDEF)
-#      umask select not OK (XPUSHs(&PL_sv_undef);)
-#      fileno getc sysread syswrite tell not OK (meth("FILENO" "GETC"))
-#      sselect shm* sem* msg* syscall - unknown whether they are safe
-#      gmtime not OK (list context)
-
-#      Suspicious wrt "additional mode of failure": warn, die, select.
-
-__END__
-
-# New ops always go at the end
-# The restriction on having custom as the last op has been removed
-
-# A recapitulation of the format of this file:
-# The file consists of five columns: the name of the op, an English
-# description, the name of the "check" routine used to optimize this
-# operation, some flags, and a description of the operands.
-
-# The flags consist of options followed by a mandatory op class signifier
-
-# The classes are:
-# baseop      - 0            unop     - 1            binop      - 2
-# logop       - |            listop   - @            pmop       - /
-# padop/svop  - $            padop    - # (unused)   loop       - {
-# baseop/unop - %            loopexop - }            filestatop - -
-# pvop/svop   - "            cop      - ;
-
-# Other options are:
-#   needs stack mark                    - m
-#   needs constant folding              - f
-#   produces a scalar                   - s
-#   produces an integer                 - i
-#   needs a target                      - t
-#   target can be in a pad              - T
-#   has a corresponding integer version - I
-#   has side effects                    - d
-#   uses $_ if no argument given        - u
-
-# Values for the operands are:
-# scalar      - S            list     - L            array     - A
-# hash        - H            sub (CV) - C            file      - F
-# socket      - Fs           filetest - F-           filetest_access - F-+
-
-# reference - R
-# "?" denotes an optional operand.
-
-# Nothing.
-
-null           null operation          ck_null         0       
-stub           stub                    ck_null         0
-scalar         scalar                  ck_fun          s%      S
-
-# Pushy stuff.
-
-pushmark       pushmark                ck_null         s0      
-wantarray      wantarray               ck_null         is0     
-
-const          constant item           ck_svconst      s$      
-
-gvsv           scalar variable         ck_null         ds$     
-gv             glob value              ck_null         ds$     
-gelem          glob elem               ck_null         d2      S S
-padsv          private variable        ck_null         ds0
-padav          private array           ck_null         d0
-padhv          private hash            ck_null         d0
-padany         private value           ck_null         d0
-
-pushre         push regexp             ck_null         d/
-
-# References and stuff.
-
-rv2gv          ref-to-glob cast        ck_rvconst      ds1     
-rv2sv          scalar dereference      ck_rvconst      ds1     
-av2arylen      array length            ck_null         is1     
-rv2cv          subroutine dereference  ck_rvconst      d1
-anoncode       anonymous subroutine    ck_anoncode     $       
-prototype      subroutine prototype    ck_null         s%      S
-refgen         reference constructor   ck_spair        m1      L
-srefgen                single ref constructor  ck_null         fs1     S
-ref            reference-type operator ck_fun          stu%    S?
-bless          bless                   ck_fun          s@      S S?
-
-# Pushy I/O.
-
-backtick       quoted execution (``, qx)       ck_open         tu%     S?
-# glob defaults its first arg to $_
-glob           glob                    ck_glob         t@      S?
-readline       <HANDLE>                ck_readline     t%      F?
-rcatline       append I/O operator     ck_null         t$
-
-# Bindable operators.
-
-regcmaybe      regexp internal guard   ck_fun          s1      S
-regcreset      regexp internal reset   ck_fun          s1      S
-regcomp                regexp compilation      ck_null         s|      S
-match          pattern match (m//)     ck_match        d/
-qr             pattern quote (qr//)    ck_match        s/
-subst          substitution (s///)     ck_match        dis/    S
-substcont      substitution iterator   ck_null         dis|    
-trans          transliteration (tr///) ck_match        is"     S
-
-# Lvalue operators.
-# sassign is special-cased for op class
-
-sassign                scalar assignment       ck_sassign      s0
-aassign                list assignment         ck_null         t2      L L
-
-chop           chop                    ck_spair        mts%    L
-schop          scalar chop             ck_null         stu%    S?
-chomp          chomp                   ck_spair        mTs%    L
-schomp         scalar chomp            ck_null         sTu%    S?
-defined                defined operator        ck_defined      isu%    S?
-undef          undef operator          ck_lfun         s%      S?
-study          study                   ck_fun          su%     S?
-pos            match position          ck_lfun         stu%    S?
-
-preinc         preincrement (++)               ck_lfun         dIs1    S
-i_preinc       integer preincrement (++)       ck_lfun         dis1    S
-predec         predecrement (--)               ck_lfun         dIs1    S
-i_predec       integer predecrement (--)       ck_lfun         dis1    S
-postinc                postincrement (++)              ck_lfun         dIst1   S
-i_postinc      integer postincrement (++)      ck_lfun         disT1   S
-postdec                postdecrement (--)              ck_lfun         dIst1   S
-i_postdec      integer postdecrement (--)      ck_lfun         disT1   S
-
-# Ordinary operators.
-
-pow            exponentiation (**)     ck_null         fsT2    S S
-
-multiply       multiplication (*)      ck_null         IfsT2   S S
-i_multiply     integer multiplication (*)      ck_null         ifsT2   S S
-divide         division (/)            ck_null         IfsT2   S S
-i_divide       integer division (/)    ck_null         ifsT2   S S
-modulo         modulus (%)             ck_null         IifsT2  S S
-i_modulo       integer modulus (%)     ck_null         ifsT2   S S
-repeat         repeat (x)              ck_repeat       mt2     L S
-
-add            addition (+)            ck_null         IfsT2   S S
-i_add          integer addition (+)    ck_null         ifsT2   S S
-subtract       subtraction (-)         ck_null         IfsT2   S S
-i_subtract     integer subtraction (-) ck_null         ifsT2   S S
-concat         concatenation (.) or string     ck_concat       fsT2    S S
-stringify      string                  ck_fun          fsT@    S
-
-left_shift     left bitshift (<<)      ck_bitop        fsT2    S S
-right_shift    right bitshift (>>)     ck_bitop        fsT2    S S
-
-lt             numeric lt (<)          ck_null         Iifs2   S S
-i_lt           integer lt (<)          ck_null         ifs2    S S
-gt             numeric gt (>)          ck_null         Iifs2   S S
-i_gt           integer gt (>)          ck_null         ifs2    S S
-le             numeric le (<=)         ck_null         Iifs2   S S
-i_le           integer le (<=)         ck_null         ifs2    S S
-ge             numeric ge (>=)         ck_null         Iifs2   S S
-i_ge           integer ge (>=)         ck_null         ifs2    S S
-eq             numeric eq (==)         ck_null         Iifs2   S S
-i_eq           integer eq (==)         ck_null         ifs2    S S
-ne             numeric ne (!=)         ck_null         Iifs2   S S
-i_ne           integer ne (!=)         ck_null         ifs2    S S
-ncmp           numeric comparison (<=>)        ck_null         Iifst2  S S
-i_ncmp         integer comparison (<=>)        ck_null         ifst2   S S
-
-slt            string lt               ck_null         ifs2    S S
-sgt            string gt               ck_null         ifs2    S S
-sle            string le               ck_null         ifs2    S S
-sge            string ge               ck_null         ifs2    S S
-seq            string eq               ck_null         ifs2    S S
-sne            string ne               ck_null         ifs2    S S
-scmp           string comparison (cmp) ck_null         ifst2   S S
-
-bit_and                bitwise and (&)         ck_bitop        fst2    S S
-bit_xor                bitwise xor (^)         ck_bitop        fst2    S S
-bit_or         bitwise or (|)          ck_bitop        fst2    S S
-
-negate         negation (-)            ck_null         Ifst1   S
-i_negate       integer negation (-)    ck_null         ifsT1   S
-not            not                     ck_null         ifs1    S
-complement     1's complement (~)      ck_bitop        fst1    S
-
-smartmatch     smart match             ck_smartmatch   s2
-
-# High falutin' math.
-
-atan2          atan2                   ck_fun          fsT@    S S
-sin            sin                     ck_fun          fsTu%   S?
-cos            cos                     ck_fun          fsTu%   S?
-rand           rand                    ck_fun          sT%     S?
-srand          srand                   ck_fun          sT%     S?
-exp            exp                     ck_fun          fsTu%   S?
-log            log                     ck_fun          fsTu%   S?
-sqrt           sqrt                    ck_fun          fsTu%   S?
-
-# Lowbrow math.
-
-int            int                     ck_fun          fsTu%   S?
-hex            hex                     ck_fun          fsTu%   S?
-oct            oct                     ck_fun          fsTu%   S?
-abs            abs                     ck_fun          fsTu%   S?
-
-# String stuff.
-
-length         length                  ck_fun          ifsTu%  S?
-substr         substr                  ck_substr       st@     S S S? S?
-vec            vec                     ck_fun          ist@    S S S
-
-index          index                   ck_index        isT@    S S S?
-rindex         rindex                  ck_index        isT@    S S S?
-
-sprintf                sprintf                 ck_fun          fmst@   S L
-formline       formline                ck_fun          ms@     S L
-ord            ord                     ck_fun          ifsTu%  S?
-chr            chr                     ck_fun          fsTu%   S?
-crypt          crypt                   ck_fun          fsT@    S S
-ucfirst                ucfirst                 ck_fun          fstu%   S?
-lcfirst                lcfirst                 ck_fun          fstu%   S?
-uc             uc                      ck_fun          fstu%   S?
-lc             lc                      ck_fun          fstu%   S?
-quotemeta      quotemeta               ck_fun          fstu%   S?
-
-# Arrays.
-
-rv2av          array dereference       ck_rvconst      dt1     
-aelemfast      constant array element  ck_null         s$      A S
-aelem          array element           ck_null         s2      A S
-aslice         array slice             ck_null         m@      A L
-
-aeach          each on array           ck_each         %       A
-akeys          keys on array           ck_each         t%      A
-avalues                values on array         ck_each         t%      A
-
-# Hashes.
-
-each           each                    ck_each         %       H
-values         values                  ck_each         t%      H
-keys           keys                    ck_each         t%      H
-delete         delete                  ck_delete       %       S
-exists         exists                  ck_exists       is%     S
-rv2hv          hash dereference        ck_rvconst      dt1     
-helem          hash element            ck_null         s2      H S
-hslice         hash slice              ck_null         m@      H L
-boolkeys       boolkeys                ck_fun          %       H
-
-# Explosives and implosives.
-
-unpack         unpack                  ck_unpack       @       S S?
-pack           pack                    ck_fun          mst@    S L
-split          split                   ck_split        t@      S S S
-join           join or string          ck_join         mst@    S L
-
-# List operators.
-
-list           list                    ck_null         m@      L
-lslice         list slice              ck_null         2       H L L
-anonlist       anonymous list ([])     ck_fun          ms@     L
-anonhash       anonymous hash ({})     ck_fun          ms@     L
-
-splice         splice                  ck_push         m@      A S? S? L
-push           push                    ck_push         imsT@   A L
-pop            pop                     ck_shift        s%      A?
-shift          shift                   ck_shift        s%      A?
-unshift                unshift                 ck_push         imsT@   A L
-sort           sort                    ck_sort         dm@     C? L
-reverse                reverse                 ck_fun          mt@     L
-
-grepstart      grep                    ck_grep         dm@     C L
-grepwhile      grep iterator           ck_null         dt|     
-
-mapstart       map                     ck_grep         dm@     C L
-mapwhile       map iterator            ck_null         dt|
-
-# Range stuff.
-
-range          flipflop                ck_null         |       S S
-flip           range (or flip)         ck_null         1       S S
-flop           range (or flop)         ck_null         1
-
-# Control.
-
-and            logical and (&&)                ck_null         |       
-or             logical or (||)                 ck_null         |       
-xor            logical xor                     ck_null         fs2     S S     
-dor            defined or (//)                 ck_null         |
-cond_expr      conditional expression          ck_null         d|      
-andassign      logical and assignment (&&=)    ck_null         s|      
-orassign       logical or assignment (||=)     ck_null         s|      
-dorassign      defined or assignment (//=)     ck_null         s|
-
-method         method lookup           ck_method       d1
-entersub       subroutine entry        ck_subr         dmt1    L
-leavesub       subroutine exit         ck_null         1       
-leavesublv     lvalue subroutine return        ck_null         1       
-caller         caller                  ck_fun          t%      S?
-warn           warn                    ck_fun          imst@   L
-die            die                     ck_die          dimst@  L
-reset          symbol reset            ck_fun          is%     S?
-
-lineseq                line sequence           ck_null         @       
-nextstate      next statement          ck_null         s;      
-dbstate                debug next statement    ck_null         s;      
-unstack                iteration finalizer     ck_null         s0
-enter          block entry             ck_null         0       
-leave          block exit              ck_null         @       
-scope          block                   ck_null         @       
-enteriter      foreach loop entry      ck_null         d{      
-iter           foreach loop iterator   ck_null         0       
-enterloop      loop entry              ck_null         d{      
-leaveloop      loop exit               ck_null         2       
-return         return                  ck_return       dm@     L
-last           last                    ck_null         ds}     
-next           next                    ck_null         ds}     
-redo           redo                    ck_null         ds}     
-dump           dump                    ck_null         ds}     
-goto           goto                    ck_null         ds}     
-exit           exit                    ck_exit         ds%     S?
-method_named   method with known name  ck_null         d$
-
-entergiven     given()                 ck_null         d|
-leavegiven     leave given block       ck_null         1
-enterwhen      when()                  ck_null         d|
-leavewhen      leave when block        ck_null         1
-break          break                   ck_null         0
-continue       continue                ck_null         0
-
-# I/O.
-
-open           open                    ck_open         ismt@   F S? L
-close          close                   ck_fun          is%     F?
-pipe_op                pipe                    ck_fun          is@     F F
-
-fileno         fileno                  ck_fun          ist%    F
-umask          umask                   ck_fun          ist%    S?
-binmode                binmode                 ck_fun          s@      F S?
-
-tie            tie                     ck_fun          idms@   R S L
-untie          untie                   ck_fun          is%     R
-tied           tied                    ck_fun          s%      R
-dbmopen                dbmopen                 ck_fun          is@     H S S
-dbmclose       dbmclose                ck_fun          is%     H
-
-sselect                select system call      ck_select       t@      S S S S
-select         select                  ck_select       st@     F?
-
-getc           getc                    ck_eof          st%     F?
-read           read                    ck_fun          imst@   F R S S?
-enterwrite     write                   ck_fun          dis%    F?
-leavewrite     write exit              ck_null         1       
-
-prtf           printf                  ck_listiob      ims@    F? L
-print          print                   ck_listiob      ims@    F? L
-say            say                     ck_listiob      ims@    F? L
-
-sysopen                sysopen                 ck_fun          s@      F S S S?
-sysseek                sysseek                 ck_fun          s@      F S S
-sysread                sysread                 ck_fun          imst@   F R S S?
-syswrite       syswrite                ck_fun          imst@   F S S? S?
-
-eof            eof                     ck_eof          is%     F?
-tell           tell                    ck_fun          st%     F?
-seek           seek                    ck_fun          s@      F S S
-# truncate really behaves as if it had both "S S" and "F S"
-truncate       truncate                ck_trunc        is@     S S
-
-fcntl          fcntl                   ck_fun          st@     F S S
-ioctl          ioctl                   ck_fun          st@     F S S
-flock          flock                   ck_fun          isT@    F S
-
-# Sockets.  OP_IS_SOCKET wants them consecutive (so moved 1st 2)
-
-send           send                    ck_fun          imst@   Fs S S S?
-recv           recv                    ck_fun          imst@   Fs R S S
-
-socket         socket                  ck_fun          is@     Fs S S S
-sockpair       socketpair              ck_fun          is@     Fs Fs S S S
-
-bind           bind                    ck_fun          is@     Fs S
-connect                connect                 ck_fun          is@     Fs S
-listen         listen                  ck_fun          is@     Fs S
-accept         accept                  ck_fun          ist@    Fs Fs
-shutdown       shutdown                ck_fun          ist@    Fs S
-
-gsockopt       getsockopt              ck_fun          is@     Fs S S
-ssockopt       setsockopt              ck_fun          is@     Fs S S S
-
-getsockname    getsockname             ck_fun          is%     Fs
-getpeername    getpeername             ck_fun          is%     Fs
-
-# Stat calls.  OP_IS_FILETEST wants them consecutive.
-
-lstat          lstat                   ck_ftst         u-      F
-stat           stat                    ck_ftst         u-      F
-ftrread                -R                      ck_ftst         isu-    F-+
-ftrwrite       -W                      ck_ftst         isu-    F-+
-ftrexec                -X                      ck_ftst         isu-    F-+
-fteread                -r                      ck_ftst         isu-    F-+
-ftewrite       -w                      ck_ftst         isu-    F-+
-fteexec                -x                      ck_ftst         isu-    F-+
-ftis           -e                      ck_ftst         isu-    F-
-ftsize         -s                      ck_ftst         istu-   F-
-ftmtime                -M                      ck_ftst         stu-    F-
-ftatime                -A                      ck_ftst         stu-    F-
-ftctime                -C                      ck_ftst         stu-    F-
-ftrowned       -O                      ck_ftst         isu-    F-
-fteowned       -o                      ck_ftst         isu-    F-
-ftzero         -z                      ck_ftst         isu-    F-
-ftsock         -S                      ck_ftst         isu-    F-
-ftchr          -c                      ck_ftst         isu-    F-
-ftblk          -b                      ck_ftst         isu-    F-
-ftfile         -f                      ck_ftst         isu-    F-
-ftdir          -d                      ck_ftst         isu-    F-
-ftpipe         -p                      ck_ftst         isu-    F-
-ftsuid         -u                      ck_ftst         isu-    F-
-ftsgid         -g                      ck_ftst         isu-    F-
-ftsvtx         -k                      ck_ftst         isu-    F-
-ftlink         -l                      ck_ftst         isu-    F-
-fttty          -t                      ck_ftst         is-     F-
-fttext         -T                      ck_ftst         isu-    F-
-ftbinary       -B                      ck_ftst         isu-    F-
-
-# File calls.
-
-# chdir really behaves as if it had both "S?" and "F?"
-chdir          chdir                   ck_chdir        isT%    S?
-chown          chown                   ck_fun          imsT@   L
-chroot         chroot                  ck_fun          isTu%   S?
-unlink         unlink                  ck_fun          imsTu@  L
-chmod          chmod                   ck_fun          imsT@   L
-utime          utime                   ck_fun          imsT@   L
-rename         rename                  ck_fun          isT@    S S
-link           link                    ck_fun          isT@    S S
-symlink                symlink                 ck_fun          isT@    S S
-readlink       readlink                ck_fun          stu%    S?
-mkdir          mkdir                   ck_fun          isTu@   S? S?
-rmdir          rmdir                   ck_fun          isTu%   S?
-
-# Directory calls.
-
-open_dir       opendir                 ck_fun          is@     F S
-readdir                readdir                 ck_fun          %       F
-telldir                telldir                 ck_fun          st%     F
-seekdir                seekdir                 ck_fun          s@      F S
-rewinddir      rewinddir               ck_fun          s%      F
-closedir       closedir                ck_fun          is%     F
-
-# Process control.
-
-fork           fork                    ck_null         ist0    
-wait           wait                    ck_null         isT0    
-waitpid                waitpid                 ck_fun          isT@    S S
-system         system                  ck_exec         imsT@   S? L
-exec           exec                    ck_exec         dimsT@  S? L
-kill           kill                    ck_fun          dimsT@  L
-getppid                getppid                 ck_null         isT0    
-getpgrp                getpgrp                 ck_fun          isT%    S?
-setpgrp                setpgrp                 ck_fun          isT@    S? S?
-getpriority    getpriority             ck_fun          isT@    S S
-setpriority    setpriority             ck_fun          isT@    S S S
-
-# Time calls.
-
-# NOTE: MacOS patches the 'i' of time() away later when the interpreter
-# is created because in MacOS time() is already returning times > 2**31-1,
-# that is, non-integers.
-
-time           time                    ck_null         isT0    
-tms            times                   ck_null         0       
-localtime      localtime               ck_fun          t%      S?
-gmtime         gmtime                  ck_fun          t%      S?
-alarm          alarm                   ck_fun          istu%   S?
-sleep          sleep                   ck_fun          isT%    S?
-
-# Shared memory.
-
-shmget         shmget                  ck_fun          imst@   S S S
-shmctl         shmctl                  ck_fun          imst@   S S S
-shmread                shmread                 ck_fun          imst@   S S S S
-shmwrite       shmwrite                ck_fun          imst@   S S S S
-
-# Message passing.
-
-msgget         msgget                  ck_fun          imst@   S S
-msgctl         msgctl                  ck_fun          imst@   S S S
-msgsnd         msgsnd                  ck_fun          imst@   S S S
-msgrcv         msgrcv                  ck_fun          imst@   S S S S S
-
-# Semaphores.
-
-semop          semop                   ck_fun          imst@   S S
-semget         semget                  ck_fun          imst@   S S S
-semctl         semctl                  ck_fun          imst@   S S S S
-
-# Eval.
-
-require                require                 ck_require      du%     S?
-dofile         do "file"               ck_fun          d1      S
-hintseval      eval hints              ck_svconst      s$
-entereval      eval "string"           ck_eval         d%      S
-leaveeval      eval "string" exit      ck_null         1       S
-#evalonce      eval constant string    ck_null         d1      S
-entertry       eval {block}            ck_eval         d%      
-leavetry       eval {block} exit       ck_null         @       
-
-# Get system info.
-
-ghbyname       gethostbyname           ck_fun          %       S
-ghbyaddr       gethostbyaddr           ck_fun          @       S S
-ghostent       gethostent              ck_null         0       
-gnbyname       getnetbyname            ck_fun          %       S
-gnbyaddr       getnetbyaddr            ck_fun          @       S S
-gnetent                getnetent               ck_null         0       
-gpbyname       getprotobyname          ck_fun          %       S
-gpbynumber     getprotobynumber        ck_fun          @       S
-gprotoent      getprotoent             ck_null         0       
-gsbyname       getservbyname           ck_fun          @       S S
-gsbyport       getservbyport           ck_fun          @       S S
-gservent       getservent              ck_null         0       
-shostent       sethostent              ck_fun          is%     S
-snetent                setnetent               ck_fun          is%     S
-sprotoent      setprotoent             ck_fun          is%     S
-sservent       setservent              ck_fun          is%     S
-ehostent       endhostent              ck_null         is0     
-enetent                endnetent               ck_null         is0     
-eprotoent      endprotoent             ck_null         is0     
-eservent       endservent              ck_null         is0     
-gpwnam         getpwnam                ck_fun          %       S
-gpwuid         getpwuid                ck_fun          %       S
-gpwent         getpwent                ck_null         0       
-spwent         setpwent                ck_null         is0     
-epwent         endpwent                ck_null         is0     
-ggrnam         getgrnam                ck_fun          %       S
-ggrgid         getgrgid                ck_fun          %       S
-ggrent         getgrent                ck_null         0       
-sgrent         setgrent                ck_null         is0     
-egrent         endgrent                ck_null         is0     
-getlogin       getlogin                ck_null         st0     
-
-# Miscellaneous.
-
-syscall                syscall                 ck_fun          imst@   S L
-
-# For multi-threading
-lock           lock                    ck_rfun         s%      R
-
-# For state support
-
-once           once                    ck_null         |       
-
-custom         unknown custom operator         ck_null         0
-
-# For smart dereference for each/keys/values
-reach          each on reference                       ck_each         %       S
-rkeys          keys on reference                       ck_each         t%      S
-rvalues                values on reference                     ck_each         t%      S