nushell/docs/commands/touch.md
Nabil Abderrahaman 821d44af54
Docs autoview pwd touch (#2068)
* [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.
2020-06-28 14:22:26 +12:00

1.2 KiB

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.

> 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.

> mkdir dir
> touch dir/file.ext; ls dir
──────────┬───────────
 name     │ dir/file.ext
 type     │ File
 size     │ 0 B
 modified │ 0 secs ago
──────────┴───────────