docs

cli/flags.rs

@@ -134,7 +134,7 @@ pub fn create_cli_app<'a, 'b>() -> App<'a, 'b> {
  .global_settings(&[AppSettings::ColorNever, AppSettings::UnifiedHelpMessage, AppSettings::DisableVersion])
  .settings(&[AppSettings::AllowExternalSubcommands])
  .after_help(ENV_VARIABLES_HELP)
- .long_about("A secure runtime for JavaScript and TypeScript built with V8, Rust, and Tokio.
+ .long_about("A secure JavaScript and TypeScript runtime
 
 Docs: https://deno.land/manual.html
 Modules: https://deno.land/x/
@@ -146,7 +146,7 @@ To run the REPL:
 
 To execute a sandboxed script:
 
- deno https://deno.land/welcome.ts
+ deno https://deno.land/std/examples/welcome.ts
 
 To evaluate code from the command line:
 
@@ -236,7 +236,7 @@ Examples: https://github.com/WICG/import-maps#the-import-map",
  ).arg(
  Arg::with_name("lock-write")
  .long("lock-write")
- .help("Write lock file. Use with --lock to specify file.")
+ .help("Write lock file. Use with --lock.")
  .global(true),
  ).arg(
  Arg::with_name("v8-options")

std/manual.md

@@ -574,6 +574,10 @@ always bundle its dependencies. In Deno this is done by checking the `$DENO_DIR`
 into your source control system, and specifying that path as the `$DENO_DIR`
 environmental variable at runtime.
 
+**How can I trust a URL that may change** By using a lock file (using the
+`--lock` command line flag) you can ensure you're running the code you expect to
+be.
+
 **How do you import to a specific version?** Simply specify the version in the
 URL. For example, this URL fully specifies the code being run:
 `https://unpkg.com/[email protected]/dist/liltest.js`. Combined with the
@@ -666,8 +670,8 @@ if (import.meta.main) {
 Use `deno help` to see the help text.
 
 ```
-deno
-A secure runtime for JavaScript and TypeScript built with V8, Rust, and Tokio.
+deno 
+A secure JavaScript and TypeScript runtime
 
 Docs: https://deno.land/manual.html
 Modules: https://deno.land/x/
@@ -704,6 +708,8 @@ OPTIONS:
  --current-thread Use tokio::runtime::current_thread
  -h, --help Prints help information
  --importmap <FILE> Load import map file
+ --lock <FILE> Check the specified lock file
+ --lock-write Write lock file. Use with --lock.
  -L, --log-level <log-level> Set log level [possible values: debug, info]
  --no-fetch Do not download remote modules
  -r, --reload=<CACHE_BLACKLIST> Reload source code cache (recompile TypeScript)
@@ -905,6 +911,12 @@ Proxy configuration is read from environmental variables: `HTTP_PROXY` and
 In case of Windows if environmental variables are not found Deno falls back to
 reading proxies from registry.
 
+## Lock file
+
+Deno can store and check module subresource integrity for modules using a small
+JSON file. Use the `--lock=lock.json` to enable and specify lock file checking.
+To update or create a lock use `--lock=lock.json --lock-write`.
+
 ## Import maps
 
 Deno supports [import maps](https://github.com/WICG/import-maps).