From: Brian I. <in...@tt...> - 2002-01-15 06:24:08
|
Hi all. I've applied all the YACs to YAML.pm. (Including YAC-10!). It seems to pass all the tests I can come up with. It ROCKS! FWIW, Implementing generic indentation was not easy. Getting it right, made my brain hurt. Badly! :( I have a few comments and some suggestions (YACs :) 1) It *is* possible to comment out lines on top level scalars. You just have to choose an indentation greater than one: --- - | Foo # Bar Baz ... 2) There is a seeming off-by-one error for top level indentation. The trick to understanding it is to consider the base indentation to be -1 (Where the first column offset is 0) Then it all works in a very consistent manner. Since the default indentation means adding 1 to the previous indentation, adding 1 to -1 gives 0 offset. # This --- | foo bar # Is the same as: --- |2 foo bar 3) '^' as an indicator kinda blows. It seems a little confusing. I'd like to YAC about switching it to '>'. This still has the 'folded' connotations of '^' but it points forward instead of up. --- foo: > multiline content goo: >\ multiline\n escaped hoo: >1 explicit indent 4) I'm writing my YAML.pm change log in YAML now. This has prompted yet another YAC. Let's make '-' mean chomp for all multilines, and let's have chomp strip off *all* trailing newlines, even if they are in the stream. That way we can put extra blank lines after multilines for spacing, and not have them be part of the content. --- version: 0.27 date: Mon Jan 14 22:17:47 PST 2002 change: Example change --- version: 0.27 date: Mon Jan 14 22:17:47 PST 2002 change: ^- Sometimes the change entry is too long for a single line. It would be nice if I could chomp off the following newlines. --- version: 0.27 date: Mon Jan 14 22:17:47 PST 2002 change: Example change That's all for now. If you guys really like the '>' over '^' thing, let me know right away. Then I can change it before I ship version 0.27 to CPAN tommorrow, and teach this stuff to a big group of Perl hackers. Cheers, Brian |