[Yaml-core] Last call proposal for comments

[Brian I. <in...@tt...>]

I just spent the last 2 hours of my life debugging this:

    use lib 't';
    use TestYAML;
    test_round_trip(<DATA>);

    __DATA__
    perl: |
        {name => 'Brian Ingerson',
         rank => 'JAPH',
         'serial number' => 8675309,
        };
    yaml: |
        ---
        name: Brian Ingerson
        rank: JAPH
        serial number: 8675309
    #---
    #perl: |
    #    [
    #        1/100000000,
    #        10**20,
    #        -10**20,
    #    ]
    #yaml: |
    #    ---
    #    - 1e-08
    #    - 1e+20
    #    - -1e+20
    ---
    perl: |
        [
            23, 
            3.45, 
            123456789012345, 
        ]
    yaml: |
        ---
        - 23
        - 3.45
        - 123456789012345
    #---
    #perl: |
    #    my $rking = "monkey";
    #    [bless \$rking, "Banana"]
    #yaml: |
    #    --- 
    #    - !perl/$Bananas monkey

The problem I was not seeing is that commented out lines must start with
'# ', not just '#'.

Would someone please remind me why this is necessary for full
line comments?

This is going to cause no end of grief, I'm sure. I would propose that
we allow non-trailing throwaways to not require the space after the '#'.

Cheers, Brian