From: Clark C. E. <cc...@cl...> - 2004-12-29 18:00:46
|
Oren has spent a huge amount of time incorporating the slurry of changes [1] we agreed upon in September. This is our very first 1.1 working draft, and we will move it to a release candidate after we have two or more implementations. HTML http://yaml.org/spec/current.html PDF http://yaml.org/spec/current.pdf PS http://yaml.org/spec/current.pdf Historical versions, including the very last (and de-facto final 1.0) draft are also available, at http://yaml.org/spec/ towards the bottom. Cheers, Clark [1] http://sf.net/mailarchive/forum.php?forum_id=1771&viewmonth=200409 -- Clark C. Evans Prometheus Research, LLC. http://www.prometheusresearch.com/ o office: +1.203.777.2550 ~/ , mobile: +1.203.444.0557 // (( Prometheus Research: Transforming Data Into Knowledge \\ , \/ - Research Exchange Database /\ - Survey & Assessment Technologies ` \ - Software Tools for Researchers ~ * |
From: Oren Ben-K. <or...@be...> - 2004-12-29 21:10:35
|
On Wednesday 29 December 2004 20:00, Clark C. Evans wrote: > Oren has spent a huge amount of time incorporating the slurry of > changes [1] we agreed upon in September. This is our very first > 1.1 working draft, and we will move it to a release candidate after > we have two or more implementations. The spec is rather large (~80 pages), what with the introduction chapter, all the examples, and not trying to conserve space. I don't see a good way to split it (other than to chapters, which we already did), and I don't see a good way of squeezing it without using the kind of terse telegraphic spec-speak which many people find unreadable. Because this spec contains tons of changes, it also contains tons of potential for typos, inconsistencies, unclear wordings, bad examples, uncovered edge cases and other forms of the plague. I'm also not 100% certain that the HTML tricks I did in the examples work properly in all browsers. It is heavily cross-indexed - which may be useful or annoying... and so on. So please - give it a look, and don't be shy of posting any problems you find or ideas for improvement. Have fun, Oren Ben-Kiki |
From: Rich M. <rd...@cf...> - 2004-12-30 06:33:20
|
Is this sort of preafrooding useful? -r ======= Page ii ======= We expect all further changes will be strictly limited to wording corrections and fixing production bugs. We expect that all further changes will be strictly limited to wording corrections and the fixing of production bugs. or perhaps We expect all further changes to be strictly limited to wording corrections and the fixing of production bugs. ====== We wish to thank implementers who have tirelessly tracked earlier versions of this specification, and our fabulous user community whose feedback has both validated and clarified our direction. We wish to thank our implementers, who have tirelessly tracked earlier versions of this specification, as well as our fabulous user community, whose feedback has both validated and clarified our direction. ====== ... [http://www.unicode.org/] ... URLs should probably be displayed in monospace font. ====== ... and to creating programs ... ... and to create programs ... ====== This document may be freely copied provided it is not modified. This document may be freely copied, provided that it is not modified. ======= Page iv ======= In the page header, "Language" is split across two lines. ====== Terms Index Why not just "Index"? ======= Page 1 ======= This specification is both an introduction to the YAML language and the concepts supporting it and also a complete reference of the information needed to develop applications for processing YAML. This specification is an introduction to the YAML language and the concepts supporting it; it is also a complete reference of the information needed to develop applications for processing YAML. ====== ... of structural characters, and allowing the data ... ... of structural characters and allowing the data ... A comma is not needed before "and" or "or" if only two items are involved. ====== ... colons separate mapping key: value pairs, ... ... colons separate mapping "key: value" pairs, ... ====== ... and dashes are used to "bullet" lists. ... and dashes are used to create "bullet" lists. ====== ... YAML excels in those languages ... ... YAML excels in working with those languages ... ====== ... PHP, Ruby and Javascript. ... PHP, Ruby, and Javascript. A comma IS needed before "and" or "or" if only three or more items are involved. Tom Christensen uses the example: "I'd like to thank my parents, God and Mother Teresa." ====== Later on it directly incorporated ... Later on, it directly incorporated ... ====== Since then YAML has matured ... Since then, YAML has matured ... ====== More URLs to put into fixed-width font. ======= Page 2 ======= ... ] and SOAP ... ... ], and SOAP ... ====== YAML's indentation based scoping ... YAML's indentation-based scoping ... Actually, there are quite a few places where hyphens might help to clarify things... ====== ... of traditional indicator-based scoping similar to Perl's. ... of traditional indicator-based scoping, similar to Perl's. ====== ... Java's DNS based package naming convention and XML's URI based namespaces. ... Java's DNS-based package naming convention and XML's URI-based namespaces. ====== YAML was designed to support incremental interfaces that includes both input pull-style and output push-style one-pass (SAX-like) interfaces. YAML was designed to support incremental interfaces, including both input (pull-style) and SAX-like output (push-style) interfaces. ??? ====== Together these enable YAML to support the processing of large documents, such as a transaction log, or continuous streams, such as a feed from a production machine. Together, these enable YAML to support the processing of large documents (e.g., transaction logs) or continuous streams (e.g., feeds from production machines or systems). ====== While the two languages ... Although the two languages ... ====== -- email: rd...@cf...; phone: +1 650-873-7841 http://www.cfcl.com - Canta Forda Computer Laboratory http://www.cfcl.com/Meta - The FreeBSD Browser, Meta Project, etc. http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series |
From: Braòo T. <ti...@ds...> - 2004-12-30 09:30:56
|
d2ViIHNpdGU6DQogIC9zcGVjL2luZGV4Lmh0bWw6IC9zcGVjL3R5cGUvIGRvZXMgbm90IHdvcmss IC90eXBlLyBkb2VzDQogIC9zcGVjL2N1cnJlbnQuaHRtbDogInRoaXMgdmVyc2lvbiIgbGluayBp cyBicm9rZW4gKC9zcGVjLzIwMDQtMTItMjguaHRtbCBpbnN0ZWFkIG9mIC9zcGVjL2hpc3Rvcnkv MjAwNC0xMi0yOC8yMDA0LTEyLTI4Lmh0bWwpDQogIC90eXBlL2luZGV4Lmh0bWw6IGluIENvbGxl Y3Rpb24gVHlwZXMgc2VjdGlvbiB0aGVyZSBpcyAhIXNldCB0d2ljZSAtIHRoZSBzZWNvbmQgb25l IHNob3VsZCBwcm9iYWJseSBiZSAhIXNlcQ0KDQp0eXBlcyByZXBvc2l0b3J5Og0KICBmbG9hdGlu Zy1wb2ludCBzZXhhZ2VzaW1hbCBudW1iZXJzOiBtYXliZSBpdCBzaG91bGQgYmUgbm90ZWQgZXhw bGljaXRseSB0aGF0IHRoZSBmcmFjdGlvbmFsIHBhcnQgYWZ0ZXIgX2RlY2ltYWxfIHBvaW50IGlz IHJlYWxseSBkZWNpbWFsDQoNCmJyYfJvDQo= |
From: Oren Ben-K. <or...@be...> - 2004-12-30 18:18:39
|
On Thursday 30 December 2004 11:30, Bra=C3=B2o Tich=C3=BD wrote: > web site: [fixes] > types repository: [fixes] Thanks! I fixed all of these in the CVS version. Have fun, Oren Ben-Kiki |
From: Oren Ben-K. <or...@be...> - 2004-12-30 17:46:13
|
On Thursday 30 December 2004 08:24, Rich Morin wrote: > Is this sort of preafrooding useful? Very! Nice work. I've incorporated (most of) the corrections to the CVS version. > In the page [iv] header, "Language" is split across two lines. I'm not shy about hacking and patching DocBook and XEP inputs and outputs - In fact, I already do strange and wondrous things to both. I had to give up on this one, though. <rationalize>It is just a single place...</rationalize> > YAML was designed to support incremental interfaces, including > both input (pull-style) and SAX-like output (push-style) > interfaces. > > ??? "Pull-style" input means you have a "getNextToken()" method as opposed to having a callback invoked for each token. "Push-style" output means you have a "putNextToken()" method - that is, that you are invoking a callback on the target of the tokens. Combined, this means that the C stack is owned by your code, which makes programming much easier. > A comma IS needed before "and" or "or" if only three or more items > are involved. Tom Christensen uses the example: > > "I'd like to thank my parents, God and Mother Teresa." Hmmm. So, if I got it right, the rule is: one and two; one, two and three; one, two, three, and four; one, two, three, four, and five; etc.? If this is true, I'll have to go over every list in the spec... Sigh. English. In what other language would you play at a recital and recite at a play? Not that Hebrew doesn't have its quirks... I guess some things you just have to absorb by the age of 10 :-( > ... there are quite a few places where hyphens might help > to clarify things... No argument here, but I doubt my intuition is worth anything here. Have fun, Oren Ben-Kiki |
From: Tim P. <ti...@po...> - 2004-12-31 11:01:25
|
On Thu, 2004-12-30 at 19:46 +0200, Oren Ben-Kiki wrote: > > A comma IS needed before "and" or "or" if only three or more items > > are involved. Tom Christensen uses the example: > > > > "I'd like to thank my parents, God and Mother Teresa." > > Hmmm. So, if I got it right, the rule is: one and two; one, two and > three; one, two, three, and four; one, two, three, four, and five; > etc.? If this is true, I'll have to go over every list in the spec... > > Sigh. English. In what other language would you play at a recital and > recite at a play? Not that Hebrew doesn't have its quirks... I guess > some things you just have to absorb by the age of 10 :-( Firstly, congrats on getting the spec out, although I'm using Syck at the moment due to time pressures, I'll hopefully have time to put the spec to use with pyyaml this coming year. Back to 'The Comma'. This comma (before the last item) is commonly known as the 'Oxford comma' (or serial comma); To quote from an excellent resource on punctuation "Eats(,) Shoots and Leaves - The Zero Tolerance Approach to Punctuation" by Lynne Truss: Oh, the Oxford comma. Here, in case you don't know what it is yet, is the perennial example as espoused by Harold Ross: "The flag is red, white, and blue." So what do you think of it? (It's the comma after "white".) Are you for it or against it? Do you hover in between? In Britain, where standard usage is to leave it out, there are those that put it in - including, interestingly, Fowler's Modern English Usage. In America, conversely, where standard usage is to leave it in, there are those who make a point in removing it (especially journalists). British grammarians will concede that sometimes the extra comma prevents confusion when there are other ands in the vicinity, but this isn't much of a concession when you think about it. My own feeling is that one shouldn't be too rigid about the Oxford comma. Sometimes the sentence is improved by including it; sometimes it isn't. ... and so, as you are an international author, I think you should do what comes naturally and then change your behaviour if the sentence calls out for amendment. Then again, having used the suffix "-ize" throughout the documentation, perhaps you should add adopt the 'Oxford comma'? Just as a rejoinder to the 'son of god' quote : "A little known meeting happened before 9/11 between George Bush, a member of the Bin Laden family, and James R. Bath, a friend of the Bush family." Wouldn't you know it, a member of the Bin Ladens all along ... references :- http://www.askoxford.com/asktheexperts/faq/aboutother/oxfordcomma http://www.worldwidewords.org/qa/qa-oxf1.htm http://en.wikipedia.org/wiki/Oxford_comma |
From: Oren Ben-K. <or...@be...> - 2004-12-31 15:03:42
|
On Friday 31 December 2004 13:01, Tim Parkin wrote: > Firstly, congrats on getting the spec out, Thanks. > Oh, the Oxford comma... Ah, it has a name. I fele better already :-) > ... and so, as you are an international author, I think you should do > what comes naturally and then change your behaviour if the sentence > calls out for amendment. Personally I tend to write it in, and Clark seems to prefer to leave it out. At this point in time the posted draft doesn't have it but the CVS one does. Sigh. > Then again, having used the suffix "-ize" > throughout the documentation, perhaps you should add adopt the > 'Oxford comma'? Probably; I studied "British" at school, and I still have an irrational belief in the Oxford English Dictionary as the ultimare authority on what is "proper" English. However, the world being what it is, almost everything I have read for the last 20 years was in "American". My writing has therefore drifted towards "American", with remnants of "British" showing through. It seems I'm doomed to writing "Mongrel" for the rest of my life. This brings to mind a piece of code I saw once: /* Isn't it great we all speak the same language? */ #define strrchr rindex Have fun, Oren Ben-Kiki |