mirror of https://github.com/status-im/metro.git
(cleanup/ fix grammer & typos) packager/README.md
-fix a few typos -edit grammar on a few sentences, adding punctuation or keeping tense consistent -make capitalization consistent in ReactPackager.middleware(options) section
This commit is contained in:
parent
3ec02183ae
commit
e76f175acb
28
README.md
28
README.md
|
@ -2,12 +2,12 @@ React Native Packager
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
React Native Packager is a project similar in scope to browserify or
|
React Native Packager is a project similar in scope to browserify or
|
||||||
webpack, it provides a CommonJS-like module system, JavaScript
|
webpack; it provides a CommonJS-like module system, JavaScript
|
||||||
compilation (ES6, Flow, JSX), bundling, and asset loading.
|
compilation (ES6, Flow, JSX), bundling, and asset loading.
|
||||||
|
|
||||||
The main difference is the Packager's focus on compilation and
|
The main difference is the Packager's focus on compilation and
|
||||||
bundling speed. We aim for a sub-second edit-reload
|
bundling speed. We aim for a sub-second edit-reload
|
||||||
cycles. Additionally, we don't want users -- with large code bases --
|
cycle. Additionally, we don't want users -- with large code bases --
|
||||||
to wait more than a few seconds after starting the packager.
|
to wait more than a few seconds after starting the packager.
|
||||||
|
|
||||||
The main deviation from the node module system is the support for our
|
The main deviation from the node module system is the support for our
|
||||||
|
@ -19,7 +19,7 @@ namely the node module format. We want to even go further, and let you
|
||||||
choose your own packager and asset pipeline or even integrate into
|
choose your own packager and asset pipeline or even integrate into
|
||||||
your existing infrastructure.
|
your existing infrastructure.
|
||||||
|
|
||||||
React Native users need not to understand how the packager work,
|
React Native users need not to understand how the packager works;
|
||||||
however, this documentation might be useful for advanced users and
|
however, this documentation might be useful for advanced users and
|
||||||
people who want to fix bugs or add features to the packager (patches
|
people who want to fix bugs or add features to the packager (patches
|
||||||
welcome!).
|
welcome!).
|
||||||
|
@ -45,10 +45,10 @@ Does the following in order:
|
||||||
### /path/to/moduleName.map
|
### /path/to/moduleName.map
|
||||||
|
|
||||||
* if the package has been previously generated via the `.bundle`
|
* if the package has been previously generated via the `.bundle`
|
||||||
endpoint then the source map will be generated from that package
|
endpoint, then the source map will be generated from that package
|
||||||
* if the package has not been previously asked for, this will go
|
* if the package has not been previously asked for, this will go
|
||||||
through the same steps outlined in the `.bundle` endpoint then
|
through the same steps outlined in the `.bundle` endpoint, then
|
||||||
generate the source map.
|
generate the source map
|
||||||
|
|
||||||
Note that source map generation currently assumes that the code has
|
Note that source map generation currently assumes that the code has
|
||||||
been compiled with jstransform, which preserves line and column
|
been compiled with jstransform, which preserves line and column
|
||||||
|
@ -66,15 +66,15 @@ Here are the current options the packager accepts:
|
||||||
* `minify` boolean, defaults to false: whether to minify the bundle.
|
* `minify` boolean, defaults to false: whether to minify the bundle.
|
||||||
* `runModule` boolean, defaults to true: whether to require your entry
|
* `runModule` boolean, defaults to true: whether to require your entry
|
||||||
point module. So if you requested `moduleName`, this option will add
|
point module. So if you requested `moduleName`, this option will add
|
||||||
a `require('moduleName')` the end of your bundle.
|
a `require('moduleName')` to the end of your bundle.
|
||||||
* `inlineSourceMap` boolean, defaults to false: whether to inline
|
* `inlineSourceMap` boolean, defaults to false: whether to inline
|
||||||
source maps.
|
source maps.
|
||||||
|
|
||||||
### /debug
|
### /debug
|
||||||
|
|
||||||
This is a page used for debugging, it has links to two pages:
|
This is a page used for debugging; it has links to two pages:
|
||||||
|
|
||||||
* Cached Packages: which shows you the packages that's been already
|
* Cached Packages: which shows you the packages that have already been
|
||||||
generated and cached
|
generated and cached
|
||||||
* Dependency Graph: is the in-memory graph of all the modules and
|
* Dependency Graph: is the in-memory graph of all the modules and
|
||||||
their dependencies
|
their dependencies
|
||||||
|
@ -103,8 +103,8 @@ middleware. Takes the following options:
|
||||||
packager
|
packager
|
||||||
* `polyfillModuleName` array: Paths to polyfills you want to be
|
* `polyfillModuleName` array: Paths to polyfills you want to be
|
||||||
included at the start of the bundle
|
included at the start of the bundle
|
||||||
* `cacheVersion` string: used in creating the cache file
|
* `cacheVersion` string: Used in creating the cache file
|
||||||
* `resetCache` boolean, defaults to false: whether to use the cache on
|
* `resetCache` boolean, defaults to false: Whether to use the cache on
|
||||||
disk
|
disk
|
||||||
* `transformModulePath` string: Path to the module used as a
|
* `transformModulePath` string: Path to the module used as a
|
||||||
JavaScript transformer
|
JavaScript transformer
|
||||||
|
@ -133,6 +133,6 @@ is informed by React Native needs.
|
||||||
|
|
||||||
### Why didn't you use webpack?
|
### Why didn't you use webpack?
|
||||||
|
|
||||||
We love webpack, however, when we tried on our codebase it was slower
|
We love webpack; however, when we tried it on our codebase, it was slower
|
||||||
than our developers would like it to be. You find can more discussion about
|
than our developers wanted it to be. You find can more discussion about
|
||||||
the subject [here](https://github.com/facebook/react-native/issues/5)
|
the subject [here](https://github.com/facebook/react-native/issues/5).
|
||||||
|
|
Loading…
Reference in New Issue