man: updated 'mkwin' manual

This commit is contained in:
Valerie Wolfe 2024-07-22 13:37:57 -04:00
parent a156009442
commit a54e5422b4

View file

@ -6,11 +6,9 @@
.Nd generate bash scripts for running Windows programs from WSL .Nd generate bash scripts for running Windows programs from WSL
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm mkwin .Nm mkwin
.Op Fl hq .Op Fl heEq
.Op Fl -empty
.Op Fl -find Ar root .Op Fl -find Ar root
.Op Fl -pc Ar flags .Op Fl -pc Ar flags
.Op Fl -quiet
.Ar target .Ar target
.Op Ar --\ args .Op Ar --\ args
.Sh DESCRIPTION .Sh DESCRIPTION
@ -20,8 +18,12 @@ utility generates bash scripts for executing Windows executables from WSL, and p
.Bl -tag -width Ds .Bl -tag -width Ds
.It Ar --\ args .It Ar --\ args
The resulting script will forward the provided arguments. The resulting script will forward the provided arguments.
.It Fl -empty .It Fl e , Fl -empty
The resulting script will not pass arguments to the target binary. The resulting script will not pass arguments to the target binary.
.It Fl E , Fl -env-share
The resulting script will call the
.Xr env-share 1
utility.
.It Fl -find Ar root .It Fl -find Ar root
The resulting script will locate the target binary in the given directory using The resulting script will locate the target binary in the given directory using
.Xr find 1 . .Xr find 1 .
@ -53,7 +55,12 @@ Windows Terminal's executable moves when updated. To generate a script to launch
.Pp .Pp
.Dl $ mkwin --empty --find='/mnt/c/Program Files/WindowsApps/Microsoft.WindowsTerminal*' WindowsTerminal.exe > terminal.sh .Dl $ mkwin --empty --find='/mnt/c/Program Files/WindowsApps/Microsoft.WindowsTerminal*' WindowsTerminal.exe > terminal.sh
.Pp .Pp
PowerShell doesn't inherit environment variables from WSL. To generate a script to call PowerShell with shared variables:
.Pp
.Dl $ mkwin -E '/mnt/c/Program Files/PowerShell/7/pwsh.exe'
.Pp
.Sh SEE ALSO .Sh SEE ALSO
.Xr env-share 1 ,
.Xr find 1 , .Xr find 1 ,
.Xr path-convert 1 .Xr path-convert 1
.Sh AUTHORS .Sh AUTHORS