Fix for triple-slash dartdocs

Fix for triple-slash dartdocs

They had been ignoring multiline markdown such as code samples.
More information available at:
http://japhr.blogspot.com/2012/11/troubleshooting-triple-slash-dartdocs.html

This also includes a new test file, though I am unsure if the 
paths are correct.


BUG=

Committed: https://code.google.com/p/dart/source/detail?r=15095

[Andrei Mouravski, 2012-11-08 00:12:07]

Looks awesome! Thanks for this change!

I've added a few comments to this code review. Address those comments, then do 
git cl upload
 then come back here, comment on my comments (or click Done if you've addressed
the comments) and click "Publish+Mail Comments" in the top left of this page.

https://codereview.chromium.org/11358134/diff/1/sdk/lib/_internal/dartdoc/tes...
File sdk/lib/_internal/dartdoc/test/comment_map_test.dart (right):

https://codereview.chromium.org/11358134/diff/1/sdk/lib/_internal/dartdoc/tes...
sdk/lib/_internal/dartdoc/test/comment_map_test.dart:14: import
'../../../pkg/unittest/lib/unittest.dart';
Add ../../ to the path to get to the right relative path.

https://codereview.chromium.org/11358134/diff/1/sdk/lib/_internal/dartdoc/tes...
sdk/lib/_internal/dartdoc/test/comment_map_test.dart:26: """;
I think this """ literal string will still work correctly if you put in correct
indentation. Give it a shot, and if it doesn't work, leave as is.
That is, make it:
String get sourceText => """
  /// Testing
  ///     var testing = 'this is source code';
  get foo => 'bar';
""";

https://codereview.chromium.org/11358134/diff/1/sdk/lib/_internal/dartdoc/tes...
sdk/lib/_internal/dartdoc/test/comment_map_test.dart:33: expect(comment,
equals("Testing\n    var testing = 'this is source code';"));
Split this line at the , so that each line is less than 80 characters long.

[Andrei Mouravski, 2012-11-09 23:55:35]

Ping.

[Andrei Mouravski, 2012-11-14 17:50:29]

On 2012/11/09 23:55:35, Andrei Mouravski wrote:
> Ping.

Hey again,

Haven't heard back from you, so I'm just going to go and submit this change
myself unless you get this message.

Andrei.

[strom, 2012-11-16 04:12:53]

I incorporated all three suggestions into this updated patch.

[Andrei Mouravski, 2012-11-16 16:43:56]

One small nit and you're almost good to go.

http://codereview.chromium.org/11358134/diff/6001/sdk/lib/_internal/dartdoc/t...
File sdk/lib/_internal/dartdoc/test/comment_map_test.dart (right):

http://codereview.chromium.org/11358134/diff/6001/sdk/lib/_internal/dartdoc/t...
sdk/lib/_internal/dartdoc/test/comment_map_test.dart:23: /// Testing
:] Add 2 more spaces before lines 23-26
It should line up like so:
  String get sourceText => """
    /// Testing
    ///     var testing...
    get foo => 'bar';
  """;

[strom, 2012-11-16 17:05:56]

Increased the indent by 2 more spaces. Thanks for the suggestion -- that looks
much better :)

[Andrei Mouravski, 2012-11-16 17:33:52]

lgtm

Great! Please sync from master, run tests again, and commit your changes.

Thanks for your contribution!