Add README.md for package:fasta.

Add README.md for package:fasta.

R=johnniwinther@google.com

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

[ahe, 2017-01-13 12:06:46]

ahe@google.com changed reviewers:
+ johnniwinther@google.com

[Johnni Winther, 2017-01-13 13:03:51]

lgtm

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md
File pkg/fasta/README.md (right):

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode6
pkg/fasta/README.md:6: # Fasta -- Fully-resoved AST, Accelerated.
resoved -> resolved

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode8
pkg/fasta/README.md:8: Fasta is a compiler framework for compiling Dart sources
to Kernel IR. When Fasta works well, you won't even know you're using it, as it
will be tranparently integrated in tools like *dart*, *dartanalyzer*, *dart2js*,
etc.
Long line and below.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode8
pkg/fasta/README.md:8: Fasta is a compiler framework for compiling Dart sources
to Kernel IR. When Fasta works well, you won't even know you're using it, as it
will be tranparently integrated in tools like *dart*, *dartanalyzer*, *dart2js*,
etc.
tranparently -> transparently

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode19
pkg/fasta/README.md:19: ./tools/build.py --mode release --arch ia32 runtime
Isn't x64 the default now?

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode44
pkg/fasta/README.md:44: 2. Run `dart pkg/kernel/bin/dartk.dart outline.dill`
How are these steps connected?

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode49
pkg/fasta/README.md:49: ## Create a Platform Dill File
What is a 'platform dill file'?

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode55
pkg/fasta/README.md:55: Where `$DART_AOT_SDK` is defined as described
[above](#Building-The-Dart-SDK).
Not use in this section.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode73
pkg/fasta/README.md:73: In the above command, replace
`pkg/fasta/bin/compile.dart` by `pkg/fasta/bin/kompile.dart` to use `dartk`.
Just write it out directly instead of the indirection to the `above`...

[ahe, 2017-01-16 07:51:04]

Thank you, Johnni!

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md
File pkg/fasta/README.md (right):

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode6
pkg/fasta/README.md:6: # Fasta -- Fully-resoved AST, Accelerated.
On 2017/01/13 13:03:50, Johnni Winther wrote:
> resoved -> resolved

Done.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode8
pkg/fasta/README.md:8: Fasta is a compiler framework for compiling Dart sources
to Kernel IR. When Fasta works well, you won't even know you're using it, as it
will be tranparently integrated in tools like *dart*, *dartanalyzer*, *dart2js*,
etc.
On 2017/01/13 13:03:50, Johnni Winther wrote:
> Long line and below.

Wrapping interferes with Markdown rendering, I think it inserts a <br>.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode8
pkg/fasta/README.md:8: Fasta is a compiler framework for compiling Dart sources
to Kernel IR. When Fasta works well, you won't even know you're using it, as it
will be tranparently integrated in tools like *dart*, *dartanalyzer*, *dart2js*,
etc.
On 2017/01/13 13:03:50, Johnni Winther wrote:
> tranparently -> transparently

Done.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode19
pkg/fasta/README.md:19: ./tools/build.py --mode release --arch ia32 runtime
On 2017/01/13 13:03:50, Johnni Winther wrote:
> Isn't x64 the default now?

I don't know. IA32 is faster.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode44
pkg/fasta/README.md:44: 2. Run `dart pkg/kernel/bin/dartk.dart outline.dill`
On 2017/01/13 13:03:51, Johnni Winther wrote:
> How are these steps connected?

I've changed this to:

Optionally, run `dart pkg/kernel/bin/dartk.dart outline.dill` to view the
generated outline.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode49
pkg/fasta/README.md:49: ## Create a Platform Dill File
On 2017/01/13 13:03:50, Johnni Winther wrote:
> What is a 'platform dill file'?

I've added:

A `platform.dill` is a dill file that contains the Dart SDK platform libraries.
For now, this is generated with dartk until fasta reaches a higher rate of test
passes.

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode55
pkg/fasta/README.md:55: Where `$DART_AOT_SDK` is defined as described
[above](#Building-The-Dart-SDK).
On 2017/01/13 13:03:50, Johnni Winther wrote:
> Not use in this section.

Changed to:

Make sure to define `$DART_AOT_SDK` as described
[above](#Building-The-Dart-SDK).

https://codereview.chromium.org/2629353002/diff/1/pkg/fasta/README.md#newcode73
pkg/fasta/README.md:73: In the above command, replace
`pkg/fasta/bin/compile.dart` by `pkg/fasta/bin/kompile.dart` to use `dartk`.
On 2017/01/13 13:03:50, Johnni Winther wrote:
> Just write it out directly instead of the indirection to the `above`...

Done.

[ahe, 2017-01-16 07:51:33]

Description was changed from

==========
Add README.md for package:fasta.
==========

to

==========
Add README.md for package:fasta.

R=johnniwinther@google.com

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

[ahe, 2017-01-16 07:51:34]

Committed patchset #2 (id:20001) manually as
a4a68e9de6c17271f938a1c1ecc1e177fcc9c9f3 (presubmit successful).