typescript
Advanced tools
Comparing version 1.8.0-dev.20151019 to 1.8.0-dev.20151020
## Contributing bug fixes | ||
TypeScript is currently accepting contributions in the form of bug fixes. A bug must have an issue tracking it in the issue tracker that has been approved ("Milestone == Community") by the TypeScript team. Your pull request should include a link to the bug that you are fixing. If you've submitted a PR for a bug, please post a comment in the bug to avoid duplication of effort. | ||
## Contributing features | ||
Features (things that add new or improved functionality to TypeScript) may be accepted, but will need to first be approved (marked as "Milestone == Community" by a TypeScript coordinator with the message "Approved") in the suggestion issue. Features with language design impact, or that are adequately satisfied with external tools, will not be accepted. | ||
@@ -10,2 +12,3 @@ | ||
## Legal | ||
You will need to complete a Contributor License Agreement (CLA). Briefly, this agreement testifies that you are granting us permission to use the submitted change according to the terms of the project's license, and that the work being submitted is under appropriate copyright. | ||
@@ -16,2 +19,3 @@ | ||
## Housekeeping | ||
Your pull request should: | ||
@@ -34,4 +38,5 @@ | ||
## Running the Tests | ||
To run all tests, invoke the runtests target using jake: | ||
To run all tests, invoke the `runtests` target using jake: | ||
```Shell | ||
@@ -61,3 +66,3 @@ jake runtests | ||
To debug the tests, invoke the runtests-browser using jake. | ||
To debug the tests, invoke the `runtests-browser` task from jake. | ||
You will probably only want to debug one test at a time: | ||
@@ -82,12 +87,10 @@ | ||
## Adding a Test | ||
To add a new testcase, simply place a `.ts` file in `tests\cases\compiler` containing code that exemplifies the bugfix or change you are making. | ||
These files support metadata tags in the format `// @metaDataName: value`. The supported names and values are: | ||
To add a new test case, simply place a `.ts` file in `tests\cases\compiler` containing code that exemplifies the bugfix or change you are making. | ||
* `comments`, `sourcemap`, `noimplicitany`, `declaration`: true or false (corresponds to the compiler command-line options of the same name) | ||
* `target`: ES3 or ES5 (same as compiler) | ||
* `out`, outDir: path (same as compiler) | ||
* `module`: local, commonjs, or amd (local corresponds to not passing any compiler --module flag) | ||
* `fileName`: path | ||
* These tags delimit sections of a file to be used as separate compilation units. They are useful for tests relating to modules. See below for examples. | ||
These files support metadata tags in the format `// @metaDataName: value`. | ||
The supported names and values are the same as those supported in the compiler itself, with the addition of the `fileName` flag. | ||
`fileName` tags delimit sections of a file to be used as separate compilation units. | ||
They are useful for tests relating to modules. | ||
See below for examples. | ||
@@ -115,2 +118,3 @@ **Note** that if you have a test corresponding to a specific spec compliance item, you can place it in `tests\cases\conformance` in an appropriately-named subfolder. | ||
## Managing the Baselines | ||
Compiler testcases generate baselines that track the emitted `.js`, the errors produced by the compiler, and the type of each expression in the file. Additionally, some testcases opt in to baselining the source map output. | ||
@@ -132,2 +136,2 @@ | ||
**Note** that baseline-accept should only be run after a full test run! Accepting baselines after running a subset of tests will delete baseline files for the tests that didn't run. | ||
**Note** that `baseline-accept` should only be run after a full test run! Accepting baselines after running a subset of tests will delete baseline files for the tests that didn't run. |
@@ -5,3 +5,3 @@ { | ||
"homepage": "http://typescriptlang.org/", | ||
"version": "1.8.0-dev.20151019", | ||
"version": "1.8.0-dev.20151020", | ||
"license": "Apache-2.0", | ||
@@ -8,0 +8,0 @@ "description": "TypeScript is a language for application scale JavaScript development", |
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
12262255
235856