| Index: reflectable/README.md
|
| diff --git a/reflectable/README.md b/reflectable/README.md
|
| index e1aa92e3d35272188c0e295a856e57706e2fbe16..5e8cc8bde5c8c873c6845d37ecaa9a69bd0cda32 100644
|
| --- a/reflectable/README.md
|
| +++ b/reflectable/README.md
|
| @@ -139,10 +139,18 @@ transformers:
|
| formatted: true # Optional.
|
| ```
|
|
|
| -Note that it is possible to use globbing with entry points, based on the
|
| -package [glob](https://pub.dartlang.org/packages/glob). For instance,
|
| -`entry_points: ["test/*_test.dart"]` can be used to specify that all Dart
|
| -source files in `test` whose name ends in `_test.dart` are entry points.
|
| +Note that it is necessary to include the reflectable transformer in the
|
| +`pubspec.yaml` of your package if you use reflectable directly *or indirectly*
|
| +(by depending on a package that uses reflectable), because the transformer may
|
| +need to generate code based on files in your package. In particular, if you
|
| +are writing a package which uses reflectable and is expected to be used by
|
| +clients, please make it explicit that such clients must include the reflectable
|
| +transformer in their `pubspec.yaml`.
|
| +
|
| +It is possible to use globbing with entry points, based on the package
|
| +[glob](https://pub.dartlang.org/packages/glob). For instance, `entry_points:
|
| +["test/*_test.dart"]` can be used to specify that all Dart source files in
|
| +`test` whose name ends in `_test.dart` are entry points.
|
|
|
| Now run `pub build --mode=debug web` to perform the transformation. This will
|
| rename the file `web/main.dart` and generate a new file `build/web/main.dart`.
|
|
|