appstart.cfg

Package: WA2L/WinTools 1.2.08
Section: Configuration Files (4)
Updated: 22 January 2025
Index Return to Main Contents

 

NAME

appstart.cfg - configuration file for appstart and run

 

SYNOPSIS

WA2LWinTools/etc/appstart.hostname.cfg

WA2LWinTools/etc/appstart.domainname.cfg

WA2LWinTools/etc/appstart.cfg

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

This is the optional configuration file for the appstart (1) and run (1) command.

The first configuration file in the sequence: appstart.hostname.cfg -> appstart.domainname.cfg -> appstart.cfg is read when existing.

The hostname is replaced by the %COMPUTERNAME% and domainname is replaced by the %USERDOMAIN% environment variable.

 

FILEFORMAT

Rows starting with a # are considered as comments.

The file format is OPTION=VALUE

Between the OPTION, the = and the VALUE are no spaces.

 

OPTIONS

SEARCHPATH
base path where the executable that is started by appstart is searched, where the executable is normally specified as "subdirectory\aProgram.exe".

You can use the same additional (environment)variables as in the EXECUTABLE and OPTIONS column in run.cfg(4).

To identify a drive you can also use labels what makes the configuration file settings more independent from the actual drive letters.

See appstart(1) and lpath(3) for a description of labels.

See run.cfg(4) for a description of the environment variables.

Example: SEARCHPATH=USB-DISK:\programs;%INSTALLDRIVE%:\bin

Example: SEARCHPATH=%USERPROFILE%\Documents\programs;%INSTALLDRIVE%:\bin

Example: SEARCHPATH=%USERPROFILE%\Documents\programs;%INSTALLDRIVE%:\programs

Default: SEARCHPATH=%USERPROFILE%\Documents\bin;%ProgramFiles(x86)%;%SystemDrive%\Program Files;%INSTALLDIR%;%INSTALLDRIVE%:\bin;%INSTALLDIR%\bin

PATH_PRE
semicolon separated path prepended to the %PATH% environment variable.

You can use the same additional (environment)variables as in the EXECUTABLE and OPTIONS column in run.cfg(4).

To identify a drive you can also use labels what makes the configuration file settings more independent from the actual drive letters.

See appstart(1) and lpath(3) for a description of labels.

See run.cfg(4) for a description of the environment variables.

Example: PATH_PRE=USB-DISK:\bin\OpenJDK64Portable\17.0.9+9\bin

Example: PATH_PRE=d:\bin\OpenJDK\bin;h:\binOpenJRE\bin

Default: PATH_PRE=

VARIABLE
Additional VARIABLEs that can be used in the OPTIONS column as %VARIABLE% of the run.cfg(4) config files.

Allowed variable definitions are ^[A-Z][0-9A-Z_]*=value whereas the value can be a label (see: lpath(3)) and can contain the same additional (environment)variables as in the EXECUTABLE and OPTIONS column in run.cfg(4).

Example: DATA=USB-DISK:

Default:

DEBUG
more verbose output.

Example: DEBUG=True

Default: DEBUG=False

 

EXAMPLES

-

 

SEE ALSO

wintoolsintro(1), appstart(1), hotkeyp(1), lpath(3), pstart(1), run(1), run.cfg(4)

 

NOTES

-

 

BUGS

-

 

AUTHOR

appstart.cfg was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

 

COPYRIGHT

Copyright © 2024 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
FILEFORMAT
OPTIONS
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 18:56:06 GMT, January 23, 2025