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,55 +1,17 @@
# touch
---
title: touch
layout: command
version: 0.59.0
---
Create one or more files in the current or an already existent directory.
It has no effect on existing files.
Unlike GNU touch, the access time and the modified time are not updated.
Creates one or more files.
`-h`, `--help`
Display help message.
## Signature
## Examples
```> touch (filename) ...rest```
Create a file in an empty folder. Then touch the file and list files again to observe that the modified time has not been updated.
## Parameters
```shell
> ls
> touch file.ext; ls
──────────┬─────────────
name │ file.ext
type │ File
size │ 0 B
modified │ 0 secs ago
──────────┴─────────────
> touch file.ext; ls
──────────┬───────────
name │ file.ext
type │ File
size │ 0 B
modified │ 10 secs ago
──────────┴───────────
```
- `filename`: the path of the file you want to create
- `...rest`: additional files to create
Create a file within an already existent folder.
```shell
> mkdir dir
> touch dir/file.ext; ls dir
──────────┬───────────
name │ dir/file.ext
type │ File
size │ 0 B
modified │ 0 secs ago
──────────┴───────────
```
Create three files at once
```shell
> touch a b c
> ls
────┬────────────────────┬──────┬──────────┬──────────────
# │ name │ type │ size │ modified
────┼────────────────────┼──────┼──────────┼──────────────
0 │ a │ File │ 0 B │ 0 sec ago
1 │ b │ File │ 0 B │ 0 sec ago
2 │ c │ File │ 0 B │ 0 sec ago
────┴────────────────────┴──────┴──────────┴──────────────