|
+
+## Examples
+
+Get the last 2 items
+```nu
+> [0,1,2,3,4,5] | slice 4..5
+╭───┬───╮
+│ 0 │ 4 │
+│ 1 │ 5 │
+╰───┴───╯
+
+```
+
+Get the last 2 items
+```nu
+> [0,1,2,3,4,5] | slice (-2)..
+╭───┬───╮
+│ 0 │ 4 │
+│ 1 │ 5 │
+╰───┴───╯
+
+```
+
+Get the next to last 2 items
+```nu
+> [0,1,2,3,4,5] | slice (-3)..-2
+╭───┬───╮
+│ 0 │ 3 │
+│ 1 │ 4 │
+╰───┴───╯
+
+```
diff --git a/commands/docs/sort-by.md b/commands/docs/sort-by.md
index fccc974b16d..c7549b52a1b 100644
--- a/commands/docs/sort-by.md
+++ b/commands/docs/sort-by.md
@@ -2,11 +2,13 @@
title: sort-by
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Sort by the given cell path or closure.
usage: |
Sort by the given cell path or closure.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sort.md b/commands/docs/sort.md
index 75a6fa1349e..2b17ece87c6 100644
--- a/commands/docs/sort.md
+++ b/commands/docs/sort.md
@@ -2,11 +2,13 @@
title: sort
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Sort in increasing order.
usage: |
Sort in increasing order.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/source-env.md b/commands/docs/source-env.md
index 04f60554e37..5c555674126 100644
--- a/commands/docs/source-env.md
+++ b/commands/docs/source-env.md
@@ -2,11 +2,13 @@
title: source-env
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Source the environment from a source file into the current environment.
usage: |
Source the environment from a source file into the current environment.
+editLink: false
+contributors: false
---
@@ -20,7 +22,7 @@ usage: |
## Parameters
- - `filename`: The filepath to the script file to source the environment from.
+ - `filename`: The filepath to the script file to source the environment from (`null` for no-op).
## Input/output types:
@@ -37,6 +39,12 @@ Sources the environment from foo.nu in the current context
```
+Sourcing `null` is a no-op.
+```nu
+> source-env null
+
+```
+
## Notes
This command is a parser keyword. For details, check:
https://www.nushell.sh/book/thinking_in_nu.html
\ No newline at end of file
diff --git a/commands/docs/source.md b/commands/docs/source.md
index e44d26f9685..9c19d19a604 100644
--- a/commands/docs/source.md
+++ b/commands/docs/source.md
@@ -2,11 +2,13 @@
title: source
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Runs a script file in the current context.
usage: |
Runs a script file in the current context.
+editLink: false
+contributors: false
---
@@ -20,7 +22,7 @@ usage: |
## Parameters
- - `filename`: The filepath to the script file to source.
+ - `filename`: The filepath to the script file to source (`null` for no-op).
## Input/output types:
@@ -43,6 +45,18 @@ Runs foo.nu in current context and call the command defined, suppose foo.nu has
```
+Sourcing `null` is a no-op.
+```nu
+> source null
+
+```
+
+Source can be used with const variables.
+```nu
+> const file = if $nu.is-interactive { "interactive.nu" } else { null }; source $file
+
+```
+
## Notes
This command is a parser keyword. For details, check:
https://www.nushell.sh/book/thinking_in_nu.html
\ No newline at end of file
diff --git a/commands/docs/split-by.md b/commands/docs/split-by.md
deleted file mode 100644
index 6a8802cce29..00000000000
--- a/commands/docs/split-by.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-title: split-by
-categories: |
- deprecated
-version: 0.101.0
-deprecated: |
- Split a record into groups.
-usage: |
- Split a record into groups.
----
-
-
-# `split-by` for [deprecated](/commands/categories/deprecated.md)
-
-Split a record into groups.
-
-## Signature
-
-```> split-by {flags} (splitter)```
-
-## Parameters
-
- - `splitter`: The splitter value to use.
-
-
-## Input/output types:
-
-| input | output |
-| ------ | ------ |
-| record | record |
-
-## Examples
-
-split items by column named "lang"
-```nu
-> {
- '2019': [
- { name: 'andres', lang: 'rb', year: '2019' },
- { name: 'jt', lang: 'rs', year: '2019' }
- ],
- '2021': [
- { name: 'storm', lang: 'rs', 'year': '2021' }
- ]
- } | split-by lang
-╭────┬─────────────────────────────────────────╮
-│ │ ╭──────┬──────────────────────────────╮ │
-│ rb │ │ │ ╭───┬────────┬──────┬──────╮ │ │
-│ │ │ 2019 │ │ # │ name │ lang │ year │ │ │
-│ │ │ │ ├───┼────────┼──────┼──────┤ │ │
-│ │ │ │ │ 0 │ andres │ rb │ 2019 │ │ │
-│ │ │ │ ╰───┴────────┴──────┴──────╯ │ │
-│ │ ╰──────┴──────────────────────────────╯ │
-│ │ ╭──────┬─────────────────────────────╮ │
-│ rs │ │ │ ╭───┬──────┬──────┬──────╮ │ │
-│ │ │ 2019 │ │ # │ name │ lang │ year │ │ │
-│ │ │ │ ├───┼──────┼──────┼──────┤ │ │
-│ │ │ │ │ 0 │ jt │ rs │ 2019 │ │ │
-│ │ │ │ ╰───┴──────┴──────┴──────╯ │ │
-│ │ │ │ ╭───┬───────┬──────┬──────╮ │ │
-│ │ │ 2021 │ │ # │ name │ lang │ year │ │ │
-│ │ │ │ ├───┼───────┼──────┼──────┤ │ │
-│ │ │ │ │ 0 │ storm │ rs │ 2021 │ │ │
-│ │ │ │ ╰───┴───────┴──────┴──────╯ │ │
-│ │ ╰──────┴─────────────────────────────╯ │
-╰────┴─────────────────────────────────────────╯
-```
diff --git a/commands/docs/split.md b/commands/docs/split.md
index b8d1db049c4..2c48adf5af4 100644
--- a/commands/docs/split.md
+++ b/commands/docs/split.md
@@ -2,11 +2,13 @@
title: split
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Split contents across desired subcommand (like row, column) via the separator.
usage: |
Split contents across desired subcommand (like row, column) via the separator.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_cell-path.md b/commands/docs/split_cell-path.md
index f34182a126c..bdd725cf797 100644
--- a/commands/docs/split_cell-path.md
+++ b/commands/docs/split_cell-path.md
@@ -2,11 +2,13 @@
title: split cell-path
categories: |
conversions
-version: 0.101.0
+version: 0.102.0
conversions: |
Split a cell-path into its components.
usage: |
Split a cell-path into its components.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_chars.md b/commands/docs/split_chars.md
index 82483272c24..87ed7735edb 100644
--- a/commands/docs/split_chars.md
+++ b/commands/docs/split_chars.md
@@ -2,11 +2,13 @@
title: split chars
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Split a string into a list of characters.
usage: |
Split a string into a list of characters.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_column.md b/commands/docs/split_column.md
index 58a943aa3eb..8aef03d592c 100644
--- a/commands/docs/split_column.md
+++ b/commands/docs/split_column.md
@@ -2,11 +2,13 @@
title: split column
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Split a string into multiple columns using a separator.
usage: |
Split a string into multiple columns using a separator.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_list.md b/commands/docs/split_list.md
index a474e6d778d..90234429798 100644
--- a/commands/docs/split_list.md
+++ b/commands/docs/split_list.md
@@ -2,11 +2,13 @@
title: split list
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Split a list into multiple lists using a separator.
usage: |
Split a list into multiple lists using a separator.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_row.md b/commands/docs/split_row.md
index 25e23042821..63ec3926632 100644
--- a/commands/docs/split_row.md
+++ b/commands/docs/split_row.md
@@ -2,11 +2,13 @@
title: split row
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Split a string into multiple rows using a separator.
usage: |
Split a string into multiple rows using a separator.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/split_words.md b/commands/docs/split_words.md
index bb63a6f4850..3ba2871f56d 100644
--- a/commands/docs/split_words.md
+++ b/commands/docs/split_words.md
@@ -2,11 +2,13 @@
title: split words
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Split a string's words into separate rows.
usage: |
Split a string's words into separate rows.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/start.md b/commands/docs/start.md
index e04d2097e35..7a0a8b2a144 100644
--- a/commands/docs/start.md
+++ b/commands/docs/start.md
@@ -2,17 +2,19 @@
title: start
categories: |
filesystem
-version: 0.101.0
+version: 0.102.0
filesystem: |
- Open a folder, file or website in the default application or viewer.
+ Open a folder, file, or website in the default application or viewer.
usage: |
- Open a folder, file or website in the default application or viewer.
+ Open a folder, file, or website in the default application or viewer.
+editLink: false
+contributors: false
---
# `start` for [filesystem](/commands/categories/filesystem.md)
-Open a folder, file or website in the default application or viewer.
+Open a folder, file, or website in the default application or viewer.
## Signature
@@ -20,7 +22,7 @@ usage: |
## Parameters
- - `path`: Path to open.
+ - `path`: Path or URL to open.
## Input/output types:
@@ -49,14 +51,20 @@ Open the current directory with the default file manager
```
-Open a pdf with the default pdf viewer
+Open a PDF with the default PDF viewer
```nu
> start file.pdf
```
-Open a website with default browser
+Open a website with the default browser
```nu
> start https://www.nushell.sh
```
+
+Open an application-registered protocol URL
+```nu
+> start obsidian://open?vault=Test
+
+```
diff --git a/commands/docs/stor.md b/commands/docs/stor.md
index 14a0a80d53f..f559abee500 100644
--- a/commands/docs/stor.md
+++ b/commands/docs/stor.md
@@ -2,11 +2,13 @@
title: stor
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Various commands for working with the in-memory sqlite database.
usage: |
Various commands for working with the in-memory sqlite database.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_create.md b/commands/docs/stor_create.md
index 868decbd519..e5349b13a18 100644
--- a/commands/docs/stor_create.md
+++ b/commands/docs/stor_create.md
@@ -2,11 +2,13 @@
title: stor create
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Create a table in the in-memory sqlite database.
usage: |
Create a table in the in-memory sqlite database.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_delete.md b/commands/docs/stor_delete.md
index 4b428987c78..dae554d0920 100644
--- a/commands/docs/stor_delete.md
+++ b/commands/docs/stor_delete.md
@@ -2,11 +2,13 @@
title: stor delete
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Delete a table or specified rows in the in-memory sqlite database.
usage: |
Delete a table or specified rows in the in-memory sqlite database.
+editLink: false
+contributors: false
---
@@ -20,7 +22,7 @@ usage: |
## Flags
- - `--table-name, -t {string}`: name of the table you want to insert into
+ - `--table-name, -t {string}`: name of the table you want to delete or delete from
- `--where-clause, -w {string}`: a sql string to use as a where clause without the WHERE keyword
diff --git a/commands/docs/stor_export.md b/commands/docs/stor_export.md
index 9f44b44a859..d1cc9c250ad 100644
--- a/commands/docs/stor_export.md
+++ b/commands/docs/stor_export.md
@@ -2,11 +2,13 @@
title: stor export
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Export the in-memory sqlite database to a sqlite database file.
usage: |
Export the in-memory sqlite database to a sqlite database file.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_import.md b/commands/docs/stor_import.md
index 5030ffe6c8a..eb3b491d8bc 100644
--- a/commands/docs/stor_import.md
+++ b/commands/docs/stor_import.md
@@ -2,11 +2,13 @@
title: stor import
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Import a sqlite database file into the in-memory sqlite database.
usage: |
Import a sqlite database file into the in-memory sqlite database.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_insert.md b/commands/docs/stor_insert.md
index 45c38a233f9..57716db6c24 100644
--- a/commands/docs/stor_insert.md
+++ b/commands/docs/stor_insert.md
@@ -2,11 +2,13 @@
title: stor insert
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Insert information into a specified table in the in-memory sqlite database.
usage: |
Insert information into a specified table in the in-memory sqlite database.
+editLink: false
+contributors: false
---
@@ -28,6 +30,7 @@ usage: |
| input | output |
| ------- | ------ |
+| any | table |
| nothing | table |
| record | table |
| table | table |
diff --git a/commands/docs/stor_open.md b/commands/docs/stor_open.md
index 2d618311f6f..5a0290ca0bd 100644
--- a/commands/docs/stor_open.md
+++ b/commands/docs/stor_open.md
@@ -2,11 +2,13 @@
title: stor open
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Opens the in-memory sqlite database.
usage: |
Opens the in-memory sqlite database.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_reset.md b/commands/docs/stor_reset.md
index 6b81e8b3dcc..b1844dfb86f 100644
--- a/commands/docs/stor_reset.md
+++ b/commands/docs/stor_reset.md
@@ -2,11 +2,13 @@
title: stor reset
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Reset the in-memory database by dropping all tables.
usage: |
Reset the in-memory database by dropping all tables.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/stor_update.md b/commands/docs/stor_update.md
index 0ca45e32704..30cfd245158 100644
--- a/commands/docs/stor_update.md
+++ b/commands/docs/stor_update.md
@@ -2,11 +2,13 @@
title: stor update
categories: |
database
-version: 0.101.0
+version: 0.102.0
database: |
Update information in a specified table in the in-memory sqlite database.
usage: |
Update information in a specified table in the in-memory sqlite database.
+editLink: false
+contributors: false
---
@@ -29,6 +31,7 @@ usage: |
| input | output |
| ------- | ------ |
+| any | table |
| nothing | table |
| record | table |
## Examples
diff --git a/commands/docs/str.md b/commands/docs/str.md
index 245f383ff44..6f5ff272377 100644
--- a/commands/docs/str.md
+++ b/commands/docs/str.md
@@ -2,11 +2,13 @@
title: str
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Various commands for working with string data.
usage: |
Various commands for working with string data.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_camel-case.md b/commands/docs/str_camel-case.md
index a2d1f770f39..56e1110f076 100644
--- a/commands/docs/str_camel-case.md
+++ b/commands/docs/str_camel-case.md
@@ -2,11 +2,13 @@
title: str camel-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to camelCase.
usage: |
Convert a string to camelCase.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_capitalize.md b/commands/docs/str_capitalize.md
index d1dc1e0fc8c..bcbe55573fa 100644
--- a/commands/docs/str_capitalize.md
+++ b/commands/docs/str_capitalize.md
@@ -2,11 +2,13 @@
title: str capitalize
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Capitalize first letter of text.
usage: |
Capitalize first letter of text.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_contains.md b/commands/docs/str_contains.md
index 8b7f5c79ebe..80a8a2330ce 100644
--- a/commands/docs/str_contains.md
+++ b/commands/docs/str_contains.md
@@ -2,11 +2,13 @@
title: str contains
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Checks if string input contains a substring.
usage: |
Checks if string input contains a substring.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_distance.md b/commands/docs/str_distance.md
index 71b65b93e29..18cfc8825f0 100644
--- a/commands/docs/str_distance.md
+++ b/commands/docs/str_distance.md
@@ -2,11 +2,13 @@
title: str distance
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Compare two strings and return the edit distance/Levenshtein distance.
usage: |
Compare two strings and return the edit distance/Levenshtein distance.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_downcase.md b/commands/docs/str_downcase.md
index 88671d2c3ff..7c1c89763e9 100644
--- a/commands/docs/str_downcase.md
+++ b/commands/docs/str_downcase.md
@@ -2,11 +2,13 @@
title: str downcase
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Make text lowercase.
usage: |
Make text lowercase.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_ends-with.md b/commands/docs/str_ends-with.md
index 5ea033ba439..07eb49d2873 100644
--- a/commands/docs/str_ends-with.md
+++ b/commands/docs/str_ends-with.md
@@ -2,11 +2,13 @@
title: str ends-with
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Check if an input ends with a string.
usage: |
Check if an input ends with a string.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_expand.md b/commands/docs/str_expand.md
index ebacccfc59c..06441dc587e 100644
--- a/commands/docs/str_expand.md
+++ b/commands/docs/str_expand.md
@@ -2,11 +2,13 @@
title: str expand
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Generates all possible combinations defined in brace expansion syntax.
usage: |
Generates all possible combinations defined in brace expansion syntax.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_index-of.md b/commands/docs/str_index-of.md
index 1c01f6a5ace..d8aa08f6c3e 100644
--- a/commands/docs/str_index-of.md
+++ b/commands/docs/str_index-of.md
@@ -2,11 +2,13 @@
title: str index-of
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Returns start index of first occurrence of string in input, or -1 if no match.
usage: |
Returns start index of first occurrence of string in input, or -1 if no match.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_join.md b/commands/docs/str_join.md
index 55146571111..88105c2c814 100644
--- a/commands/docs/str_join.md
+++ b/commands/docs/str_join.md
@@ -2,11 +2,13 @@
title: str join
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Concatenate multiple strings into a single string, with an optional separator between each.
usage: |
Concatenate multiple strings into a single string, with an optional separator between each.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_kebab-case.md b/commands/docs/str_kebab-case.md
index ac4ffc694c6..1ffdc62ba30 100644
--- a/commands/docs/str_kebab-case.md
+++ b/commands/docs/str_kebab-case.md
@@ -2,11 +2,13 @@
title: str kebab-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to kebab-case.
usage: |
Convert a string to kebab-case.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_length.md b/commands/docs/str_length.md
index a126bbae21e..67b5f9cf8ce 100644
--- a/commands/docs/str_length.md
+++ b/commands/docs/str_length.md
@@ -2,11 +2,13 @@
title: str length
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Output the length of any strings in the pipeline.
usage: |
Output the length of any strings in the pipeline.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_pascal-case.md b/commands/docs/str_pascal-case.md
index f27d428e944..dc603c6d0db 100644
--- a/commands/docs/str_pascal-case.md
+++ b/commands/docs/str_pascal-case.md
@@ -2,11 +2,13 @@
title: str pascal-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to PascalCase.
usage: |
Convert a string to PascalCase.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_replace.md b/commands/docs/str_replace.md
index e9edba82a28..f68a1ecd519 100644
--- a/commands/docs/str_replace.md
+++ b/commands/docs/str_replace.md
@@ -2,11 +2,13 @@
title: str replace
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Find and replace text.
usage: |
Find and replace text.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_reverse.md b/commands/docs/str_reverse.md
index 5a7f410a0ae..fb503983d80 100644
--- a/commands/docs/str_reverse.md
+++ b/commands/docs/str_reverse.md
@@ -2,11 +2,13 @@
title: str reverse
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Reverse every string in the pipeline.
usage: |
Reverse every string in the pipeline.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_screaming-snake-case.md b/commands/docs/str_screaming-snake-case.md
index 9d4646bd892..147243df643 100644
--- a/commands/docs/str_screaming-snake-case.md
+++ b/commands/docs/str_screaming-snake-case.md
@@ -2,11 +2,13 @@
title: str screaming-snake-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to SCREAMING_SNAKE_CASE.
usage: |
Convert a string to SCREAMING_SNAKE_CASE.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_snake-case.md b/commands/docs/str_snake-case.md
index 70407e00d38..b23a9a5516e 100644
--- a/commands/docs/str_snake-case.md
+++ b/commands/docs/str_snake-case.md
@@ -2,11 +2,13 @@
title: str snake-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to snake_case.
usage: |
Convert a string to snake_case.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_starts-with.md b/commands/docs/str_starts-with.md
index a49e53aa8d0..8b4045c391a 100644
--- a/commands/docs/str_starts-with.md
+++ b/commands/docs/str_starts-with.md
@@ -2,11 +2,13 @@
title: str starts-with
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Check if an input starts with a string.
usage: |
Check if an input starts with a string.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_stats.md b/commands/docs/str_stats.md
index 95732831d04..6b87bf7a6d1 100644
--- a/commands/docs/str_stats.md
+++ b/commands/docs/str_stats.md
@@ -2,11 +2,13 @@
title: str stats
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Gather word count statistics on the text.
usage: |
Gather word count statistics on the text.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_substring.md b/commands/docs/str_substring.md
index 85d786bfcb0..d22545d2f81 100644
--- a/commands/docs/str_substring.md
+++ b/commands/docs/str_substring.md
@@ -2,11 +2,13 @@
title: str substring
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Get part of a string. Note that the first character of a string is index 0.
usage: |
Get part of a string. Note that the first character of a string is index 0.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_title-case.md b/commands/docs/str_title-case.md
index 02d3391c071..9c6a33a03c1 100644
--- a/commands/docs/str_title-case.md
+++ b/commands/docs/str_title-case.md
@@ -2,11 +2,13 @@
title: str title-case
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Convert a string to Title Case.
usage: |
Convert a string to Title Case.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_trim.md b/commands/docs/str_trim.md
index 1626b4f4274..d75417a4c1d 100644
--- a/commands/docs/str_trim.md
+++ b/commands/docs/str_trim.md
@@ -2,11 +2,13 @@
title: str trim
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Trim whitespace or specific character.
usage: |
Trim whitespace or specific character.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/str_upcase.md b/commands/docs/str_upcase.md
index 41f97ca6ad1..b63a1e5ef02 100644
--- a/commands/docs/str_upcase.md
+++ b/commands/docs/str_upcase.md
@@ -2,11 +2,13 @@
title: str upcase
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Make text uppercase.
usage: |
Make text uppercase.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys.md b/commands/docs/sys.md
index 912f5b78374..430fcae6b65 100644
--- a/commands/docs/sys.md
+++ b/commands/docs/sys.md
@@ -2,11 +2,13 @@
title: sys
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system.
usage: |
View information about the system.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_cpu.md b/commands/docs/sys_cpu.md
index a76baa683ed..a6ad18c6fb2 100644
--- a/commands/docs/sys_cpu.md
+++ b/commands/docs/sys_cpu.md
@@ -2,11 +2,13 @@
title: sys cpu
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system CPUs.
usage: |
View information about the system CPUs.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_disks.md b/commands/docs/sys_disks.md
index f8b4a218462..d7dff0e834a 100644
--- a/commands/docs/sys_disks.md
+++ b/commands/docs/sys_disks.md
@@ -2,11 +2,13 @@
title: sys disks
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system disks.
usage: |
View information about the system disks.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_host.md b/commands/docs/sys_host.md
index 5af9f1b8e26..5c0a71df106 100644
--- a/commands/docs/sys_host.md
+++ b/commands/docs/sys_host.md
@@ -2,11 +2,13 @@
title: sys host
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system host.
usage: |
View information about the system host.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_mem.md b/commands/docs/sys_mem.md
index dfe4dc6c930..a2c0cb3c565 100644
--- a/commands/docs/sys_mem.md
+++ b/commands/docs/sys_mem.md
@@ -2,11 +2,13 @@
title: sys mem
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system memory.
usage: |
View information about the system memory.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_net.md b/commands/docs/sys_net.md
index 4138d4ba6e1..0917bcd5787 100644
--- a/commands/docs/sys_net.md
+++ b/commands/docs/sys_net.md
@@ -2,11 +2,13 @@
title: sys net
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the system network interfaces.
usage: |
View information about the system network interfaces.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_temp.md b/commands/docs/sys_temp.md
index 1215553acef..5c1607bb6e0 100644
--- a/commands/docs/sys_temp.md
+++ b/commands/docs/sys_temp.md
@@ -2,11 +2,13 @@
title: sys temp
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View the temperatures of system components.
usage: |
View the temperatures of system components.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/sys_users.md b/commands/docs/sys_users.md
index c3f169fc686..66a2179252e 100644
--- a/commands/docs/sys_users.md
+++ b/commands/docs/sys_users.md
@@ -2,11 +2,13 @@
title: sys users
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
View information about the users on the system.
usage: |
View information about the users on the system.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/table.md b/commands/docs/table.md
index 748aeb3b0af..64abbad553f 100644
--- a/commands/docs/table.md
+++ b/commands/docs/table.md
@@ -2,11 +2,13 @@
title: table
categories: |
viewers
-version: 0.101.0
+version: 0.102.0
viewers: |
Render the table.
usage: |
Render the table.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/take.md b/commands/docs/take.md
index 0176720d2c4..bfa5f5049e3 100644
--- a/commands/docs/take.md
+++ b/commands/docs/take.md
@@ -2,11 +2,13 @@
title: take
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Take only the first n elements of a list, or the first n bytes of a binary value.
usage: |
Take only the first n elements of a list, or the first n bytes of a binary value.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/take_until.md b/commands/docs/take_until.md
index bcd57d0259d..5739ab852dc 100644
--- a/commands/docs/take_until.md
+++ b/commands/docs/take_until.md
@@ -2,11 +2,13 @@
title: take until
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Take elements of the input until a predicate is true.
usage: |
Take elements of the input until a predicate is true.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/take_while.md b/commands/docs/take_while.md
index 61fa5595a34..b883a6a903d 100644
--- a/commands/docs/take_while.md
+++ b/commands/docs/take_while.md
@@ -2,11 +2,13 @@
title: take while
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Take elements of the input while a predicate is true.
usage: |
Take elements of the input while a predicate is true.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/tee.md b/commands/docs/tee.md
index fe73025c11a..7d94886de85 100644
--- a/commands/docs/tee.md
+++ b/commands/docs/tee.md
@@ -2,11 +2,13 @@
title: tee
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Copy a stream to another command in parallel.
usage: |
Copy a stream to another command in parallel.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/term.md b/commands/docs/term.md
index a772e7afea2..e4d0743e700 100644
--- a/commands/docs/term.md
+++ b/commands/docs/term.md
@@ -2,11 +2,13 @@
title: term
categories: |
platform
-version: 0.101.0
+version: 0.102.0
platform: |
Commands for querying information about the terminal.
usage: |
Commands for querying information about the terminal.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/term_query.md b/commands/docs/term_query.md
index e8b810e6889..8bf2c93a268 100644
--- a/commands/docs/term_query.md
+++ b/commands/docs/term_query.md
@@ -2,11 +2,13 @@
title: term query
categories: |
platform
-version: 0.101.0
+version: 0.102.0
platform: |
Query the terminal for information.
usage: |
Query the terminal for information.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/term_size.md b/commands/docs/term_size.md
index e2d9f8ed7d3..8c7621557af 100644
--- a/commands/docs/term_size.md
+++ b/commands/docs/term_size.md
@@ -2,11 +2,13 @@
title: term size
categories: |
platform
-version: 0.101.0
+version: 0.102.0
platform: |
Returns a record containing the number of columns (width) and rows (height) of the terminal.
usage: |
Returns a record containing the number of columns (width) and rows (height) of the terminal.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/timeit.md b/commands/docs/timeit.md
index 79756a22eb3..badf49dbe45 100644
--- a/commands/docs/timeit.md
+++ b/commands/docs/timeit.md
@@ -2,11 +2,13 @@
title: timeit
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
Time how long it takes a closure to run.
usage: |
Time how long it takes a closure to run.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to.md b/commands/docs/to.md
index ce334c26035..9c70d99f660 100644
--- a/commands/docs/to.md
+++ b/commands/docs/to.md
@@ -2,11 +2,13 @@
title: to
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Translate structured data to a format.
usage: |
Translate structured data to a format.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_csv.md b/commands/docs/to_csv.md
index c675196c619..ce59e8a5376 100644
--- a/commands/docs/to_csv.md
+++ b/commands/docs/to_csv.md
@@ -2,11 +2,13 @@
title: to csv
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert table into .csv text .
usage: |
Convert table into .csv text .
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_html.md b/commands/docs/to_html.md
index 442b61155cc..7bbad8c227e 100644
--- a/commands/docs/to_html.md
+++ b/commands/docs/to_html.md
@@ -2,11 +2,13 @@
title: to html
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert table into simple HTML.
usage: |
Convert table into simple HTML.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_json.md b/commands/docs/to_json.md
index 0fd5c8c7fda..087ab0fbbdd 100644
--- a/commands/docs/to_json.md
+++ b/commands/docs/to_json.md
@@ -2,11 +2,13 @@
title: to json
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Converts table data into JSON text.
usage: |
Converts table data into JSON text.
+editLink: false
+contributors: false
---
@@ -23,6 +25,7 @@ usage: |
- `--raw, -r`: remove all of the whitespace
- `--indent, -i {number}`: specify indentation width
- `--tabs, -t {number}`: specify indentation tab quantity
+ - `--serialize, -s`: serialize nushell types that cannot be deserialized
## Input/output types:
diff --git a/commands/docs/to_md.md b/commands/docs/to_md.md
index 38b69d441ba..02d79dc41d2 100644
--- a/commands/docs/to_md.md
+++ b/commands/docs/to_md.md
@@ -2,11 +2,13 @@
title: to md
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert table into simple Markdown.
usage: |
Convert table into simple Markdown.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_msgpack.md b/commands/docs/to_msgpack.md
index 6ced502c8b4..85fbca3e494 100644
--- a/commands/docs/to_msgpack.md
+++ b/commands/docs/to_msgpack.md
@@ -2,11 +2,13 @@
title: to msgpack
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert Nu values into MessagePack.
usage: |
Convert Nu values into MessagePack.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_msgpackz.md b/commands/docs/to_msgpackz.md
index 57a48b7a541..294bd229d24 100644
--- a/commands/docs/to_msgpackz.md
+++ b/commands/docs/to_msgpackz.md
@@ -2,11 +2,13 @@
title: to msgpackz
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert Nu values into brotli-compressed MessagePack.
usage: |
Convert Nu values into brotli-compressed MessagePack.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_nuon.md b/commands/docs/to_nuon.md
index d3a549e6eeb..e00a11d619e 100644
--- a/commands/docs/to_nuon.md
+++ b/commands/docs/to_nuon.md
@@ -2,11 +2,13 @@
title: to nuon
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Converts table data into Nuon (Nushell Object Notation) text.
usage: |
Converts table data into Nuon (Nushell Object Notation) text.
+editLink: false
+contributors: false
---
@@ -23,6 +25,7 @@ usage: |
- `--raw, -r`: remove all of the whitespace (default behaviour and overwrites -i and -t)
- `--indent, -i {number}`: specify indentation width
- `--tabs, -t {number}`: specify indentation tab quantity
+ - `--serialize, -s`: serialize nushell types that cannot be deserialized
## Input/output types:
diff --git a/commands/docs/to_plist.md b/commands/docs/to_plist.md
index f9c936e1ed1..b8a98bcc4a4 100644
--- a/commands/docs/to_plist.md
+++ b/commands/docs/to_plist.md
@@ -2,11 +2,13 @@
title: to plist
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert Nu values into plist
usage: |
Convert Nu values into plist
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_text.md b/commands/docs/to_text.md
index 7f5cc40cf31..cc82fc22c60 100644
--- a/commands/docs/to_text.md
+++ b/commands/docs/to_text.md
@@ -2,11 +2,13 @@
title: to text
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Converts data into simple text.
usage: |
Converts data into simple text.
+editLink: false
+contributors: false
---
@@ -21,6 +23,7 @@ usage: |
## Flags
- `--no-newline, -n`: Do not append a newline to the end of the text
+ - `--serialize, -s`: serialize nushell types that cannot be deserialized
## Input/output types:
diff --git a/commands/docs/to_toml.md b/commands/docs/to_toml.md
index 6f8bbc02ec4..41215b3a00e 100644
--- a/commands/docs/to_toml.md
+++ b/commands/docs/to_toml.md
@@ -2,11 +2,13 @@
title: to toml
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert record into .toml text.
usage: |
Convert record into .toml text.
+editLink: false
+contributors: false
---
@@ -18,6 +20,10 @@ usage: |
```> to toml {flags} ```
+## Flags
+
+ - `--serialize, -s`: serialize nushell types that cannot be deserialized
+
## Input/output types:
diff --git a/commands/docs/to_tsv.md b/commands/docs/to_tsv.md
index 804d45d21c2..6137f0e31b7 100644
--- a/commands/docs/to_tsv.md
+++ b/commands/docs/to_tsv.md
@@ -2,11 +2,13 @@
title: to tsv
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert table into .tsv text.
usage: |
Convert table into .tsv text.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_xml.md b/commands/docs/to_xml.md
index 0aced66ded2..a09ed40a607 100644
--- a/commands/docs/to_xml.md
+++ b/commands/docs/to_xml.md
@@ -2,11 +2,13 @@
title: to xml
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert special record structure into .xml text.
usage: |
Convert special record structure into .xml text.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/to_yaml.md b/commands/docs/to_yaml.md
index 56eb7ad20f9..ad6e3447b2e 100644
--- a/commands/docs/to_yaml.md
+++ b/commands/docs/to_yaml.md
@@ -2,11 +2,13 @@
title: to yaml
categories: |
formats
-version: 0.101.0
+version: 0.102.0
formats: |
Convert table into .yaml/.yml text.
usage: |
Convert table into .yaml/.yml text.
+editLink: false
+contributors: false
---
@@ -18,6 +20,10 @@ usage: |
```> to yaml {flags} ```
+## Flags
+
+ - `--serialize, -s`: serialize nushell types that cannot be deserialized
+
## Input/output types:
diff --git a/commands/docs/touch.md b/commands/docs/touch.md
index 2f3dd7fc33d..8b12c325b54 100644
--- a/commands/docs/touch.md
+++ b/commands/docs/touch.md
@@ -2,11 +2,13 @@
title: touch
categories: |
filesystem
-version: 0.101.0
+version: 0.102.0
filesystem: |
Creates one or more files.
usage: |
Creates one or more files.
+editLink: false
+contributors: false
---
@@ -20,15 +22,17 @@ usage: |
## Flags
- - `--reference, -r {string}`: change the file or directory time to the time of the reference file/directory
- - `--modified, -m`: change the modification time of the file or directory. If no reference file/directory is given, the current time is used
- - `--access, -a`: change the access time of the file or directory. If no reference file/directory is given, the current time is used
- - `--no-create, -c`: do not create the file if it does not exist
- - `--no-deref, -s`: do not follow symlinks
+ - `--reference, -r {path}`: Use the access and modification times of the reference file/directory instead of the current time
+ - `--timestamp, -t {datetime}`: Use the given timestamp instead of the current time
+ - `--date, -d {string}`: Use the given time instead of the current time. This can be a full timestamp or it can be relative to either the current time or reference file time (if given). For more information, see https://www.gnu.org/software/coreutils/manual/html_node/touch-invocation.html
+ - `--modified, -m`: Change only the modification time (if used with -a, access time is changed too)
+ - `--access, -a`: Change only the access time (if used with -m, modification time is changed too)
+ - `--no-create, -c`: Don't create the file if it doesn't exist
+ - `--no-deref, -s`: Affect each symbolic link instead of any referenced file (only for systems that can change the timestamps of a symlink). Ignored if touching stdout
## Parameters
- - `...rest`: The file(s) to create.
+ - `...rest`: The file(s) to create. '-' is used to represent stdout.
## Input/output types:
@@ -57,8 +61,38 @@ Changes the last modified time of "fixture.json" to today's date
```
-Changes the last modified time of file d and e to "fixture.json"'s last modified time
+Changes the last modified and accessed time of all files with the .json extension to today's date
+```nu
+> touch *.json
+
+```
+
+Changes the last accessed and modified times of files a, b and c to the current time but yesterday
+```nu
+> touch -d "yesterday" a b c
+
+```
+
+Changes the last modified time of files d and e to "fixture.json"'s last modified time
```nu
> touch -m -r fixture.json d e
```
+
+Changes the last accessed time of "fixture.json" to a datetime
+```nu
+> touch -a -t 2019-08-24T12:30:30 fixture.json
+
+```
+
+Change the last accessed and modified times of stdout
+```nu
+> touch -
+
+```
+
+Changes the last accessed and modified times of file a to 1 month before "fixture.json"'s last modified time
+```nu
+> touch -r fixture.json -d "-1 month" a
+
+```
diff --git a/commands/docs/transpose.md b/commands/docs/transpose.md
index a08b070c887..fd4891263a7 100644
--- a/commands/docs/transpose.md
+++ b/commands/docs/transpose.md
@@ -2,11 +2,13 @@
title: transpose
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Transposes the table contents so rows become columns and columns become rows.
usage: |
Transposes the table contents so rows become columns and columns become rows.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/try.md b/commands/docs/try.md
index 49dc9849d15..d7018738a1d 100644
--- a/commands/docs/try.md
+++ b/commands/docs/try.md
@@ -2,11 +2,13 @@
title: try
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Try to run a block, if it fails optionally run a catch closure.
usage: |
Try to run a block, if it fails optionally run a catch closure.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/tutor.md b/commands/docs/tutor.md
index 47d854da971..560560e07c5 100644
--- a/commands/docs/tutor.md
+++ b/commands/docs/tutor.md
@@ -2,11 +2,13 @@
title: tutor
categories: |
misc
-version: 0.101.0
+version: 0.102.0
misc: |
Run the tutorial. To begin, run: tutor.
usage: |
Run the tutorial. To begin, run: tutor.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/ulimit.md b/commands/docs/ulimit.md
index 9a8d914d6b9..11ad8c050c2 100644
--- a/commands/docs/ulimit.md
+++ b/commands/docs/ulimit.md
@@ -2,11 +2,13 @@
title: ulimit
categories: |
platform
-version: 0.101.0
+version: 0.102.0
platform: |
Set or get resource usage limits.
usage: |
Set or get resource usage limits.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/uname.md b/commands/docs/uname.md
index bc84deeedb1..582b05885ff 100644
--- a/commands/docs/uname.md
+++ b/commands/docs/uname.md
@@ -2,11 +2,13 @@
title: uname
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
Print certain system information using uutils/coreutils uname.
usage: |
Print certain system information using uutils/coreutils uname.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/uniq-by.md b/commands/docs/uniq-by.md
index 9b5dc8a0834..e431f5adb38 100644
--- a/commands/docs/uniq-by.md
+++ b/commands/docs/uniq-by.md
@@ -2,11 +2,13 @@
title: uniq-by
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Return the distinct values in the input by the given column(s).
usage: |
Return the distinct values in the input by the given column(s).
+editLink: false
+contributors: false
---
diff --git a/commands/docs/uniq.md b/commands/docs/uniq.md
index 8626df5fffa..6a4e36c5515 100644
--- a/commands/docs/uniq.md
+++ b/commands/docs/uniq.md
@@ -2,11 +2,13 @@
title: uniq
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Return the distinct values in the input.
usage: |
Return the distinct values in the input.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/update.md b/commands/docs/update.md
index fc2d96702d0..1888097d49d 100644
--- a/commands/docs/update.md
+++ b/commands/docs/update.md
@@ -2,11 +2,13 @@
title: update
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Update an existing column to have a new value.
usage: |
Update an existing column to have a new value.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/update_cells.md b/commands/docs/update_cells.md
index d7e6d19eedd..e764f11c021 100644
--- a/commands/docs/update_cells.md
+++ b/commands/docs/update_cells.md
@@ -2,11 +2,13 @@
title: update cells
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Update the table cells.
usage: |
Update the table cells.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/upsert.md b/commands/docs/upsert.md
index 0034576266e..5be82a629f2 100644
--- a/commands/docs/upsert.md
+++ b/commands/docs/upsert.md
@@ -2,11 +2,13 @@
title: upsert
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Update an existing column to have a new value, or insert a new column.
usage: |
Update an existing column to have a new value, or insert a new column.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url.md b/commands/docs/url.md
index 1747d304916..15703e53ad8 100644
--- a/commands/docs/url.md
+++ b/commands/docs/url.md
@@ -2,11 +2,13 @@
title: url
categories: |
network
-version: 0.101.0
+version: 0.102.0
network: |
Various commands for working with URLs.
usage: |
Various commands for working with URLs.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_build-query.md b/commands/docs/url_build-query.md
index 10d87f4f761..f358d239980 100644
--- a/commands/docs/url_build-query.md
+++ b/commands/docs/url_build-query.md
@@ -2,11 +2,13 @@
title: url build-query
categories: |
network
-version: 0.101.0
+version: 0.102.0
network: |
Converts record or table into query string applying percent-encoding.
usage: |
Converts record or table into query string applying percent-encoding.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_decode.md b/commands/docs/url_decode.md
index 22422e54066..8741417531e 100644
--- a/commands/docs/url_decode.md
+++ b/commands/docs/url_decode.md
@@ -2,11 +2,13 @@
title: url decode
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Converts a percent-encoded web safe string to a string.
usage: |
Converts a percent-encoded web safe string to a string.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_encode.md b/commands/docs/url_encode.md
index 3ff1bd37c74..0cb53e2f528 100644
--- a/commands/docs/url_encode.md
+++ b/commands/docs/url_encode.md
@@ -2,11 +2,13 @@
title: url encode
categories: |
strings
-version: 0.101.0
+version: 0.102.0
strings: |
Converts a string to a percent encoded web safe string.
usage: |
Converts a string to a percent encoded web safe string.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_join.md b/commands/docs/url_join.md
index d9441be8753..8a0db28cc0c 100644
--- a/commands/docs/url_join.md
+++ b/commands/docs/url_join.md
@@ -2,11 +2,13 @@
title: url join
categories: |
network
-version: 0.101.0
+version: 0.102.0
network: |
Converts a record to url.
usage: |
Converts a record to url.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_parse.md b/commands/docs/url_parse.md
index a8d8570bf6f..2046382c1d9 100644
--- a/commands/docs/url_parse.md
+++ b/commands/docs/url_parse.md
@@ -2,11 +2,13 @@
title: url parse
categories: |
network
-version: 0.101.0
+version: 0.102.0
network: |
Parses a url.
usage: |
Parses a url.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/url_split-query.md b/commands/docs/url_split-query.md
index d2eced92988..b7fba043eb6 100644
--- a/commands/docs/url_split-query.md
+++ b/commands/docs/url_split-query.md
@@ -2,11 +2,13 @@
title: url split-query
categories: |
network
-version: 0.101.0
+version: 0.102.0
network: |
Converts query string into table applying percent-decoding.
usage: |
Converts query string into table applying percent-decoding.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/use.md b/commands/docs/use.md
index 97d89a269a6..68ac3f8dc9b 100644
--- a/commands/docs/use.md
+++ b/commands/docs/use.md
@@ -2,11 +2,13 @@
title: use
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Use definitions from a module, making them available in your shell.
usage: |
Use definitions from a module, making them available in your shell.
+editLink: false
+contributors: false
---
@@ -20,7 +22,7 @@ usage: |
## Parameters
- - `module`: Module or module file.
+ - `module`: Module or module file (`null` for no-op).
- `...rest`: Which members of the module to import.
diff --git a/commands/docs/utouch.md b/commands/docs/utouch.md
deleted file mode 100644
index b89ff9788bc..00000000000
--- a/commands/docs/utouch.md
+++ /dev/null
@@ -1,90 +0,0 @@
----
-title: utouch
-categories: |
- filesystem
-version: 0.101.0
-filesystem: |
- Creates one or more files.
-usage: |
- Creates one or more files.
----
-
-
-# `utouch` for [filesystem](/commands/categories/filesystem.md)
-
-Creates one or more files.
-
-## Signature
-
-```> utouch {flags} ...rest```
-
-## Flags
-
- - `--reference, -r {path}`: Use the access and modification times of the reference file/directory instead of the current time
- - `--timestamp, -t {datetime}`: Use the given timestamp instead of the current time
- - `--date, -d {string}`: Use the given time instead of the current time. This can be a full timestamp or it can be relative to either the current time or reference file time (if given). For more information, see https://www.gnu.org/software/coreutils/manual/html_node/touch-invocation.html
- - `--modified, -m`: Change only the modification time (if used with -a, access time is changed too)
- - `--access, -a`: Change only the access time (if used with -m, modification time is changed too)
- - `--no-create, -c`: Don't create the file if it doesn't exist
- - `--no-deref, -s`: Affect each symbolic link instead of any referenced file (only for systems that can change the timestamps of a symlink). Ignored if touching stdout
-
-## Parameters
-
- - `...rest`: The file(s) to create. '-' is used to represent stdout.
-
-
-## Input/output types:
-
-| input | output |
-| ------- | ------- |
-| nothing | nothing |
-
-## Examples
-
-Creates "fixture.json"
-```nu
-> utouch fixture.json
-
-```
-
-Creates files a, b and c
-```nu
-> utouch a b c
-
-```
-
-Changes the last modified time of "fixture.json" to today's date
-```nu
-> utouch -m fixture.json
-
-```
-
-Changes the last accessed and modified times of files a, b and c to the current time but yesterday
-```nu
-> utouch -d "yesterday" a b c
-
-```
-
-Changes the last modified time of files d and e to "fixture.json"'s last modified time
-```nu
-> utouch -m -r fixture.json d e
-
-```
-
-Changes the last accessed time of "fixture.json" to a datetime
-```nu
-> utouch -a -t 2019-08-24T12:30:30 fixture.json
-
-```
-
-Change the last accessed and modified times of stdout
-```nu
-> utouch -
-
-```
-
-Changes the last accessed and modified times of file a to 1 month before "fixture.json"'s last modified time
-```nu
-> utouch -r fixture.json -d "-1 month" a
-
-```
diff --git a/commands/docs/values.md b/commands/docs/values.md
index c198d208330..5e653fd39da 100644
--- a/commands/docs/values.md
+++ b/commands/docs/values.md
@@ -2,11 +2,13 @@
title: values
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Given a record or table, produce a list of its columns' values.
usage: |
Given a record or table, produce a list of its columns' values.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/version.md b/commands/docs/version.md
index 5cad03570ca..ac443dc56d6 100644
--- a/commands/docs/version.md
+++ b/commands/docs/version.md
@@ -2,11 +2,13 @@
title: version
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Display Nu version, and its build configuration.
usage: |
Display Nu version, and its build configuration.
+editLink: false
+contributors: false
---
@@ -32,3 +34,10 @@ Display Nu version
> version
```
+
+
+## Subcommands:
+
+| name | description | type |
+| -------------------------------------------------- | -------------------------------------------------------- | -------- |
+| [`version check`](/commands/docs/version_check.md) | Checks to see if you have the latest version of nushell. | built-in |
diff --git a/commands/docs/version_check.md b/commands/docs/version_check.md
new file mode 100644
index 00000000000..1ad4e2203fb
--- /dev/null
+++ b/commands/docs/version_check.md
@@ -0,0 +1,39 @@
+---
+title: version check
+categories: |
+ platform
+version: 0.102.0
+platform: |
+ Checks to see if you have the latest version of nushell.
+usage: |
+ Checks to see if you have the latest version of nushell.
+editLink: false
+contributors: false
+---
+
+
+# `version check` for [platform](/commands/categories/platform.md)
+
+Checks to see if you have the latest version of nushell.
+
+## Signature
+
+```> version check {flags} ```
+
+
+## Input/output types:
+
+| input | output |
+| ------- | ------ |
+| nothing | string |
+
+## Examples
+
+Check if you have the latest version of nushell
+```nu
+> version check
+
+```
+
+## Notes
+If you're running nushell nightly, `version check` will check to see if you are running the latest nightly version. If you are running the nushell release, `version check` will check to see if you're running the latest release version.
\ No newline at end of file
diff --git a/commands/docs/view.md b/commands/docs/view.md
index 5154a3c596c..23d9c5af5e4 100644
--- a/commands/docs/view.md
+++ b/commands/docs/view.md
@@ -2,11 +2,13 @@
title: view
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
Various commands for viewing debug information.
usage: |
Various commands for viewing debug information.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/view_blocks.md b/commands/docs/view_blocks.md
index 3dc9f43aea8..606fcb8ac63 100644
--- a/commands/docs/view_blocks.md
+++ b/commands/docs/view_blocks.md
@@ -2,11 +2,13 @@
title: view blocks
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
View the blocks registered in nushell's EngineState memory.
usage: |
View the blocks registered in nushell's EngineState memory.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/view_files.md b/commands/docs/view_files.md
index 0c9a140a711..a9f509d3725 100644
--- a/commands/docs/view_files.md
+++ b/commands/docs/view_files.md
@@ -2,11 +2,13 @@
title: view files
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
View the files registered in nushell's EngineState memory.
usage: |
View the files registered in nushell's EngineState memory.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/view_ir.md b/commands/docs/view_ir.md
index 18da54f57bb..eff15b6a55a 100644
--- a/commands/docs/view_ir.md
+++ b/commands/docs/view_ir.md
@@ -2,11 +2,13 @@
title: view ir
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
View the compiled IR code for a block of code.
usage: |
View the compiled IR code for a block of code.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/view_source.md b/commands/docs/view_source.md
index 160c9f2a4af..0867d2075ee 100644
--- a/commands/docs/view_source.md
+++ b/commands/docs/view_source.md
@@ -2,11 +2,13 @@
title: view source
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
View a block, module, or a definition.
usage: |
View a block, module, or a definition.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/view_span.md b/commands/docs/view_span.md
index ded3c0ec5e8..cf5ef01fd51 100644
--- a/commands/docs/view_span.md
+++ b/commands/docs/view_span.md
@@ -2,11 +2,13 @@
title: view span
categories: |
debug
-version: 0.101.0
+version: 0.102.0
debug: |
View the contents of a span.
usage: |
View the contents of a span.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/watch.md b/commands/docs/watch.md
index 70e5d1962a9..e9e73137a75 100644
--- a/commands/docs/watch.md
+++ b/commands/docs/watch.md
@@ -2,11 +2,13 @@
title: watch
categories: |
filesystem
-version: 0.101.0
+version: 0.102.0
filesystem: |
Watch for file changes and execute Nu code when they happen.
usage: |
Watch for file changes and execute Nu code when they happen.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/where.md b/commands/docs/where.md
index 39355daf8d0..d82c2e064f9 100644
--- a/commands/docs/where.md
+++ b/commands/docs/where.md
@@ -2,11 +2,13 @@
title: where
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Filter values based on a row condition.
usage: |
Filter values based on a row condition.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/which.md b/commands/docs/which.md
index adfd095dc12..54acb96b113 100644
--- a/commands/docs/which.md
+++ b/commands/docs/which.md
@@ -2,11 +2,13 @@
title: which
categories: |
system
-version: 0.101.0
+version: 0.102.0
system: |
Finds a program file, alias or custom command.
usage: |
Finds a program file, alias or custom command.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/while.md b/commands/docs/while.md
index 2e501d93a72..5ceedd8b076 100644
--- a/commands/docs/while.md
+++ b/commands/docs/while.md
@@ -2,11 +2,13 @@
title: while
categories: |
core
-version: 0.101.0
+version: 0.102.0
core: |
Conditionally run a block in a loop.
usage: |
Conditionally run a block in a loop.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/whoami.md b/commands/docs/whoami.md
index eed33f55387..be5a58a69b6 100644
--- a/commands/docs/whoami.md
+++ b/commands/docs/whoami.md
@@ -2,11 +2,13 @@
title: whoami
categories: |
platform
-version: 0.101.0
+version: 0.102.0
platform: |
Get the current username using uutils/coreutils whoami.
usage: |
Get the current username using uutils/coreutils whoami.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/window.md b/commands/docs/window.md
index af4e88beccc..f59e262fb39 100644
--- a/commands/docs/window.md
+++ b/commands/docs/window.md
@@ -2,11 +2,13 @@
title: window
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Creates a sliding window of `window_size` that slide by n rows/elements across input.
usage: |
Creates a sliding window of `window_size` that slide by n rows/elements across input.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/with-env.md b/commands/docs/with-env.md
index 963a4330152..6ea55e6ecfc 100644
--- a/commands/docs/with-env.md
+++ b/commands/docs/with-env.md
@@ -2,11 +2,13 @@
title: with-env
categories: |
env
-version: 0.101.0
+version: 0.102.0
env: |
Runs a block with an environment variable set.
usage: |
Runs a block with an environment variable set.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/wrap.md b/commands/docs/wrap.md
index 66674d0a7bf..06d10cfdf4d 100644
--- a/commands/docs/wrap.md
+++ b/commands/docs/wrap.md
@@ -2,11 +2,13 @@
title: wrap
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Wrap the value into a column.
usage: |
Wrap the value into a column.
+editLink: false
+contributors: false
---
diff --git a/commands/docs/zip.md b/commands/docs/zip.md
index 51abd93d2e6..86e6eb21038 100644
--- a/commands/docs/zip.md
+++ b/commands/docs/zip.md
@@ -2,11 +2,13 @@
title: zip
categories: |
filters
-version: 0.101.0
+version: 0.102.0
filters: |
Combine a stream with the input.
usage: |
Combine a stream with the input.
+editLink: false
+contributors: false
---