forked from extern/nushell
821d44af54
* [ADD] Add draft documentation for autoview * [ADD] Add draft documentation for pwd * [ADD] Add draft documentation for touch * [MOD] Improve description and add examples Add the use of `textview` and `binaryview`. Add examples for single value, source file and binary file.
44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
# touch
|
|
|
|
Create a file 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.
|
|
|
|
`-h`, `--help`
|
|
Display help message.
|
|
|
|
## Examples
|
|
|
|
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.
|
|
|
|
```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
|
|
──────────┴───────────
|
|
```
|
|
|
|
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
|
|
──────────┴───────────
|
|
```
|