Add documentation to the mixin superclass requirement description.

Add documentation to the mixin superclass requirement description.

Fixes issue #25312
BUG= http://dartbug.com/25312
R=eernst@google.com

Committed: https://github.com/dart-lang/sdk/commit/9e032f493d69503f043ed043eff837a36f008d73

[Lasse Reichstein Nielsen, 2016-09-28 11:53:10]

lrn@google.com changed reviewers:
+ eernst@google.com

[eernst, 2016-09-28 12:20:32]

lgtm

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec.tex
File docs/language/dartLangSpec.tex (right):

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec....
docs/language/dartLangSpec.tex:2086: The effect of a class definition of the
form \code{\CLASS{} $C$ = $M$; } or the form \code{\CLASS{} $C<T_1, \ldots,
T_n>$ = $M$; } in library $L$  is to introduce the name $C$ into the scope of
$L$, bound to the class (\ref{classes}) defined by the mixin application $M$.
The name of the class is also set to $C$. Iff the  class is prefixed by the
built-in identifier \ABSTRACT{}, the class being defined is an abstract class.
OK, let's keep it like this: It looks like this is the removal of an unmotivated
newline, but that's not enough of a reason to split the paragraph into smaller
pieces (e.g., newline at each end-of-sentence), as earlier discussed.

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec....
docs/language/dartLangSpec.tex:2874: A symbol literal \code{\#\_id} evaluates to
the object that would be returned by the call
\code{MirrorSystem.getSymbol("\_id", libraryMirror)} where \code{libraryMirror}
is an instance of the class \code{LibraryMirror} defined in the library
\code{dart:mirrors}, reflecting the current library.
Thinking .. aha, this is a fix to the fix (it used to say `getPrivateSymbol`):
OK

[Lasse Reichstein Nielsen, 2016-09-29 06:54:50]

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec.tex
File docs/language/dartLangSpec.tex (right):

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec....
docs/language/dartLangSpec.tex:2086: The effect of a class definition of the
form \code{\CLASS{} $C$ = $M$; } or the form \code{\CLASS{} $C<T_1, \ldots,
T_n>$ = $M$; } in library $L$  is to introduce the name $C$ into the scope of
$L$, bound to the class (\ref{classes}) defined by the mixin application $M$.
The name of the class is also set to $C$. Iff the  class is prefixed by the
built-in identifier \ABSTRACT{}, the class being defined is an abstract class.
On 2016/09/28 12:20:31, eernst wrote:
> OK, let's keep it like this: It looks like this is the removal of an
unmotivated
> newline, but that's not enough of a reason to split the paragraph into smaller
> pieces (e.g., newline at each end-of-sentence), as earlier discussed.

Acknowledged.

https://codereview.chromium.org/2375913002/diff/1/docs/language/dartLangSpec....
docs/language/dartLangSpec.tex:2874: A symbol literal \code{\#\_id} evaluates to
the object that would be returned by the call
\code{MirrorSystem.getSymbol("\_id", libraryMirror)} where \code{libraryMirror}
is an instance of the class \code{LibraryMirror} defined in the library
\code{dart:mirrors}, reflecting the current library.
On 2016/09/28 12:20:31, eernst wrote:
> Thinking .. aha, this is a fix to the fix (it used to say `getPrivateSymbol`):
> OK

Acknowledged.

[Lasse Reichstein Nielsen, 2016-09-29 08:24:39]

Description was changed from

==========
Add documentation to the mixin superclass requirement description.

Fixes issue #25312
BUG= http://dartbug.com/25312
==========

to

==========
Add documentation to the mixin superclass requirement description.

Fixes issue #25312
BUG= http://dartbug.com/25312
R=eernst@google.com

Committed:
https://github.com/dart-lang/sdk/commit/9e032f493d69503f043ed043eff837a36f008d73
==========

[Lasse Reichstein Nielsen, 2016-09-29 08:24:40]

Committed patchset #1 (id:1) manually as
9e032f493d69503f043ed043eff837a36f008d73 (presubmit successful).