diff options
Diffstat (limited to 'cli/tsc/README.md')
| -rw-r--r-- | cli/tsc/README.md | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/cli/tsc/README.md b/cli/tsc/README.md index e8287f3c0..657aa2b5a 100644 --- a/cli/tsc/README.md +++ b/cli/tsc/README.md @@ -2,3 +2,33 @@ This directory contains the typescript compiler and a small compiler host for the runtime snapshot. + +## How to upgrade TypeScript. + +The files in this directory are mostly from the TypeScript repository. We +currently (unfortunately) have a rather manual process for upgrading TypeScript. +It works like this currently: + +1. Checkout denoland/TypeScript repo in a separate directory. +1. Add Microsoft/TypeScript as a remote and fetch its latest tags +1. Checkout a new branch based on this tag. +1. Cherry pick the custom commit we made in a previous release to the new one. +1. This commit has a "deno.ts" file in it. Read the instructions in it. +1. Copy typescript.js into Deno repo. +1. Copy d.ts files into dts directory. + +So that might look something like this: + +``` +git clone https://github.com/denoland/TypeScript.git +cd typescript +git remote add upstream https://github.com/Microsoft/TypeScript +git fetch upstream +git checkout v3.9.7 +git checkout -b branch_v3.9.7 +git cherry pick <previous-release-branch-commit-we-did> +npm install +gulp local +rsync lib/typescript.js ~/src/deno/cli/tsc/00_typescript.js +rsync --exclude=protocol.d.ts --exclude=tsserverlibrary.d.ts --exclude=typescriptServices.d.ts lib/*.d.ts ~/src/deno/cli/tsc/dts/ +``` |