CSV Documentation

[dsimcha]

On 8/10/2011 10:36 PM, Jesse Phillips wrote:
> I'm hoping to be able to get a review of the documentation in terms of
> content. The things I'm interested in.
>
> Can you easily identify it's capabilities? Does it answer questions if you
> are interested in how do do something? Opinions on the TODO items?
> Do I need more examples, fewer?
> Is the documentation too long?
>
> I'm not looking to add functionality, I'm interested in opinions of the
> interface/naming for what it is capable of. I think other functionality
> can be added onto the interface.
>
> I'll be working on a Phobos branch so that it is ready for a true review,
> vote, and being pulled in.
>
> The URL for documentation is:
> http://nascent.freeshell.org/programming/D/csv.html

Looks pretty good.  The examples are very simple and useful.  I'd be 
able to figure out how to use that module in a few minutes.

One point of clarification:  You can combine the struct example with the 
header example, right?  E.g.:

  string str = "Name,Value,Other\nHello,65,63.63\nWorld,123,3673.562";
  struct Layout {
      string name;
      int value;
  }

  auto records = csvText!Layout(str, ["Name", "Value"]);

  foreach(record; records) {
      writeln(record.name);
      writeln(record.value);
  }

Also, I'd strongly recommend using CandyDoc or something when presenting 
ddoc documentation.  IMHO ddoc needs a more reasonable/readable default 
documentation style.  The default is very annoying to read.