Auto-generate markdown command docs (#4451)

* Finish updating

* a couple improvements

* Update renames

* cleanup examples
This commit is contained in:
JT
2022-02-13 21:22:51 -05:00
committed by GitHub
parent 06f5affc0b
commit 8c0a2d3c15
478 changed files with 7676 additions and 8045 deletions

View File

@ -1,17 +1,34 @@
# rename
---
title: rename
layout: command
version: 0.59.0
---
Use `rename` to give columns more appropriate names.
Creates a new table with columns renamed.
## Signature
```> rename ...rest --column```
## Parameters
- `...rest`: the new names for the columns
- `--column {list<string>}`: column name to be changed
## Examples
Rename a column
```shell
> open /etc/passwd | lines | split column ":" | rename user password uid gid gecos home shell
────┬────────┬──────────┬──────┬──────┬────────┬─────────────────┬──────────────────
# │ user │ password │ uid │ gid │ gecos │ home │ shell
────┼────────┼──────────┼──────┼──────┼────────┼─────────────────┼──────────────────
0 │ root │ x │ 00 │ root │ /root │ /bin/bash
1 │ bin │ x │ 11 │ bin │ /bin │ /usr/bin/nologin
2 │ daemon │ x │ 22 │ daemon │ / │ /usr/bin/nologin
3 │ mail │ x │ 812 │ mail │ /var/spool/mail │ /usr/bin/nologin
────┴────────┴──────────┴──────┴──────┴────────┴─────────────────┴──────────────────
> [[a, b]; [1, 2]] | rename my_column
```
Rename many columns
```shell
> [[a, b, c]; [1, 2, 3]] | rename eggs ham bacon
```
Rename a specific column
```shell
> [[a, b, c]; [1, 2, 3]] | rename -c [a ham]
```