61 lines
1.8 KiB
Groff
61 lines
1.8 KiB
Groff
.Dd $Mdocdate$
|
|
.Dt MKWIN 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm mkwin
|
|
.Nd generate bash scripts for running Windows programs from WSL
|
|
.Sh SYNOPSIS
|
|
.Nm mkwin
|
|
.Op Fl hq
|
|
.Op Fl -empty
|
|
.Op Fl -find Ar root
|
|
.Op Fl -pc Ar flags
|
|
.Op Fl -quiet
|
|
.Ar target
|
|
.Op Ar --\ args
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility generates bash scripts for executing Windows executables from WSL, and prints them to the standard output. The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Ar --\ args
|
|
The resulting script will forward the provided arguments.
|
|
.It Fl -empty
|
|
The resulting script will not pass arguments to the target binary.
|
|
.It Fl -find Ar root
|
|
The resulting script will locate the target binary in the given directory using
|
|
.Xr find 1 .
|
|
.It Fl h , Fl -help
|
|
Print a short help message.
|
|
.It Fl -pc Ar flags
|
|
The resulting script will pass the arguments converted with
|
|
.Xr path-convert 1 . path-convert will be invoked with the provided flags forwarded (use 'x' to forward no flags).
|
|
.It Fl q , Fl -quiet
|
|
The resulting script will redirect output to /dev/null and send the target to the background.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Bl -tag -width Ds
|
|
.It 1
|
|
No
|
|
.Ar target
|
|
was provided.
|
|
.It 2
|
|
Path canonicalization failed; this typically indicates the
|
|
.Ar target
|
|
points to a file or directory that does not exist.
|
|
.El
|
|
.Sh EXAMPLES
|
|
Windows Explorer does not accept paths with spaces when executed from WSL. To generate a script to launch Windows Explorer:
|
|
.Pp
|
|
.Dl $ mkwin --pc=sqq /mnt/c/Windows/System32/explorer.exe > explorer.sh
|
|
.Pp
|
|
Windows Terminal's executable moves when updated. To generate a script to launch Windows Terminal:
|
|
.Pp
|
|
.Dl $ mkwin --empty --find='/mnt/c/Program Files/WindowsApps/Microsoft.WindowsTerminal*' WindowsTerminal.exe > terminal.sh
|
|
.Pp
|
|
.Sh SEE ALSO
|
|
.Xr find 1 ,
|
|
.Xr path-convert 1
|
|
.Sh AUTHORS
|
|
.An -nosplit
|
|
.An Valerie Wolfe Aq Mt sleeplessval@gmail.com .
|