RunPopUp

Package: WA2L/WinTools 1.2.10
Section: General Commands (1)
Updated: 12 July 2026
Index Return to Main Contents

 

NAME

RunPopUp - input dialog for the run command

 

SYNOPSIS

WA2LWinTools/bin/RunPopUp [ -h | -i | -u | -V ]

RunPopUp [ -l | -p ] [ -r ]

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

runpopup(1) graphical dialog to start an application thru run.

This command provides a fast access to all defined applications in run(1) without the need to start the console(1m).

When the RunPopUp command is started (thru a Desktop shortcut, in the Windows™ Start menu of WA2L/WinTools or a hotkey defined in pstart(1) or hotkeyp(1)) the application to be started can be entered in the input field provided.

When pressing the SHIFT key during the start of the RunPopUp command the application to be launched can be chosen from a pulldown list.

When the RunPopUp command is started, the following "internal" applications are accessible and have preference over definitions with the same name present in the run.cfg file (therefore list, input, runedit, runvi, man, manuals, help, shell and start should be avoided in run.cfg when planning to use RunPopUp. See also BUGS section for a workaround):

list
change to the RunPopUp mode where a list of defined applications is provided in a drop down list to be chosen from.

input
change to the RunPopUp mode where an input field is provided.

runedit
edit the etc/run.cfg file in vnp(1).

runvi
edit the etc/run.cfg file in vi(1).

man
start the WA2L/WinTools ASCII manual page display using the man(1) command.

manuals
start the WA2L/WinTools manual pages display in Windows™ Help.

help
show a dialog box with a short help.

shell
start the console(1m).

start
start the WA2L/WinTools startpopup(1).

The RunPopUp command can be installed on the Windows™ 'Desktop' for most convenient usage. To do so, invoke config(1m) and check the related option.

 

OPTIONS

-h
usage message.

-i
install the RunPopUp command on the Windows™ 'Desktop'.

-u
uninstall the RunPopUp shortcut from the Windows™ 'Desktop'.

-V
print program version.

-l
load the application list, as when the SHIFT key is pressed or the list internal application is invoked.

-p
print the application list to stdout as presented in the RunPopUp drop down list when the command is invoked using the -l option.

-r
force application list refresh in pulldown menu.

 

ENVIRONMENT

-

 

EXIT STATUS

0
no error.

4
usage message displayed.

5
program version printed.

6
program variant not known. This error occurs when the RunPopUp command is renamed.

 

FILES

etc/run.hostname.cfg
etc/run.domainname.cfg
etc/run.cfg
configuration file(s) for run(1).

var/cache/runpopup/
cached information for RunPopUp.

lib/RunPopUp.exc
list of applications to be excluded from the executable selection list in the GUI.

 

EXAMPLES

-

 

SEE ALSO

wintoolsintro(1), config(1m), console(1m), hotkeyp(1)) man(1), manuals(1), notepad2(1), run(1), run.cfg(4), startpopup(1), vnp(1)

 

NOTES

When starting RunPopUp from hotkeyp(1) specify:

  Command: %WA2L_INSTALLDIR%\lib\Run-PopUp.exe
  Window:  minimized

 

BUGS

As documented, the "internal" applications have preference over definitions in the run.cfg config files.

However, be aware that in general application names are not case sensitive, but the "internal" applications are and need to be specified in lower case.

Therefore, if an application defined in the run.cfg files has the same name, it can be started by entering it with upper/lower case in the input filed as a workaround (e.g. if an application shell is defined in run.cfg it can be started entering Shell).

 

AUTHOR

RunPopUp was developed by Christian Walther. Send suggestions and bug reports regarding the integration to wa2l@users.sourceforge.net .

 

COPYRIGHT

Copyright © 2022 Christian Walther

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 21:19:09 GMT, July 12, 2026