Sample code in Dart API reference not correctly formatted

[DartBot]

This issue was originally filed by [email protected]

---

What steps will reproduce the problem?
Sample code that is part of either class or method documentation is
not correctly formatted. Please check sample codes at the
following adresses:
http://api.dartlang.org/dart_core/Expect.html#throws
http://api.dartlang.org/dart_core/Future.html
http://api.dartlang.org/io/InputStream.html

What is the expected output? What do you see instead?

What version of the product are you using? On what operating system?

Please provide any additional information below.

---

Attachment:
dart-future-sample-code-not-correctly-formatted.png (13.91 KB)

[kasperl]

Added Area-Site, Triaged labels.

[sethladd]

Removed Area-Site label.
Added Area-DartDoc label.

[munificent]

These can be easily fixed by using Markdown code blocks (i.e. indent four spaces) instead of [: ... :] style, which currently only works for inline code.

---

Added this to the M1 milestone.

[DartBot]

This comment was originally written by [email protected]

---

The given examples are currently fixed, e.g. Future in r8569.

I searched for other examples of two-space indented code blocks in doc comments, and found only this one:
http://api.dartlang.org/docs/continuous/dart_core/Completer.html

Gory details of that:

find . -name '.dart' -print
| xargs pcregrep -M ' [] {2,4}\S.\n [] {2,4}\S'
2>&1 | tee log.txt

// two-space indent used for code block.
dart/lib/core/future.dart (on Completer)
runtime/lib/byte_array.dart (on ByteArray, which isn't in API docs)

// two-space indent used for list items.
tests/co19/src/{many tests} (co19 isn't trying to use Markdown)
runtime/bin/http_parser.dart
runtime/bin/mime_multipart_parser.dart
utils/testrunner/testrunner.dart
lib/mirrors/mirrors.dart (hanging indent on "-" bullets)

// used in a doc comment that doesn't generate docs.
pkg/unittest/unittest.dart
pkg/intl/date_format.dart

// other / unsure of the intent.
tools/testing/dart/status_expression.dart: one-space indent

// ignoring.
frog/*

---

Set owner to [email protected].

[DartBot]

This comment was originally written by [email protected]

---

Completer fixed to use a code block by https://chromiumcodereview.appspot.com/10905165/

(Well, it comes out as three code blocks, but I think that's a bug in dartdoc,
http://code.google.com/p/dart/issues/detail?id=5054 )

[DartBot]

This comment was originally written by [email protected]

---

Added Fixed label.