Skip to content

Commit cebeb5c

Browse files
authored
Fix and extend CMD.EXE START docs (#1638)
The CMD.EXE `START` command does way more than open the file explorer on a directory path. That is only the case when passing a directory path as a parameter. * Split START reference into three cases: 1. Open path in default app 2. Execute internal command 3. Execute batch file * Add documentation about Nushell's own `start` command, which overlaps with CMD.exe START Although Nushell `start` can be used to execute bat files, doing so does not open a new console window like CMD.EXE START does. Hence, no such mapping is added.
1 parent 44c487c commit cebeb5c

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

book/coming_from_cmd.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,9 @@ This table was last updated for Nu 0.67.0.
4747
| `RD` or `RMDIR` | `rm` | Remove directory |
4848
| `SET <var>=<string>` | `$env.<var> = <string>` | Set environment variables |
4949
| `SETLOCAL` | (default behavior) | Localize environment changes to a script |
50-
| `START <path>` | `explorer <path>` | Open a file as if double-clicked in File Explorer |
50+
| `START <path>` | Partially covered by `start <path>` | Open the path in the system-configured default application |
51+
| `START <internal command>` | | Start a separate window to run a specified internal command |
52+
| `START <batch file>` | | Start a separate window to run a specified batch file |
5153
| `TIME /T` | `date now \| format date "%H:%M:%S"` | Get the current time |
5254
| `TIME` | | Set the current time |
5355
| `TITLE` | | Set the cmd.exe window name |
@@ -68,3 +70,6 @@ These internal commands take precedence over external commands.
6870
For example, with a `ver.bat` file in the current working directory, executing `^ver` executes CMD.EXE's internal `VER` command, *NOT* the `ver.bat` file.
6971

7072
Executing `./ver` or `ver.bat` *will* execute the local bat file though.
73+
74+
Note that Nushell has its own [`start` command](/commands/docs/start.md) which takes precedence.
75+
You can call the CMD.EXE's internal `START` command with the external command syntax `^start`.

0 commit comments

Comments
 (0)