Shortcuts.def.cfg

Package: WA2L/WinTools 1.2.08
Section: File Formats (4)
Updated: 14 April 2021
Index Return to Main Contents

 

NAME

Shortcuts.def.cfg - shortcuts definition file

 

SYNOPSIS

etc/Shortcuts.definition.cfg

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

This is the shortcuts definition file for the Shortcuts command.

 

FILEFORMAT

Rows starting with a # are considered as comments.

 

DESKTOPAPP

Definitions of shortcuts that will be created on the users 'Desktop' as using the run -i App_n command:

DESKTOPAPP;App_1 App_2 App_n;

Where:

DESKTOPAPP
keyword for a record of shortcut definitions based on run(1).

App_n
Space separated list of applications as defined in the APPLICATION field of the etc/run.cfg configuration file. See run.cfg(4) for more information.

Example:

  Excel GIMP Firefox Gnuplot Writer

 

SHORTCUT

Definitions of shortcuts where more freedom of definition is needed. Basically the shortcuts can be defined at any place you have permission to and all settings as if you do it manually can be done:

SHORTCUT;LINK;SOURCE;OPTIONS;STARTMODE;ICON;WORKINGDIR;

Where:

SHORTCUT
keyword for a record of general shortcut definitions.

LINK
shortcut location definition where to create a shortcut.

Example:

  %DESKTOP%\DVLP

SOURCE
source location (often this will be an executable) of the shortcut to be created.

Example:

  %WA2L_INSTALLDIR%\bin\Qsel.exe

OPTIONS
optional: options for the command defined in SOURCE.

Example:

  DVLP

STARTMODE
optional: startmode of the command defined in SOURCE.

Possible start modes are: 1 = Normal (default), 3 = Maximized, 7 = Minimized.

Example:

  7

ICON
optional: icon for the shortcut. This has only to be defined, if the icon of the command defined in SOURCE does not fit to the needs.

Example:

  %ICONS%\DVLP.ico

WORKINGDIR
optional: working directory of the command defined in SOURCE.

Example:

  %WA2L_INSTALLDRIVE%:\tmp

 

QUICKACCESS

Definitions of entries in the Windows™ file Explorer 'Quick Access' section.

QUICKACCESS;SOURCE;

Where:

QUICKACCESS
keyword for a record of quick access entry definitions.

SOURCE
source location of the 'Quick Access' entry to be created. The SOURCE entry must be a directory.

HINT: An entry in 'Quick Access' is of special nature, it is not a shortcut per se; if an entry in this section is renamed by hand (e.g. from within the Explorer) the source directory is also renamed.

Example:

  %WA2L_INSTALLDIR%\data\Projects

 

JUNCTION

Definitions of directory junctions.

JUNCTION;LINK;SOURCE;

Where:

JUNCTION
keyword for a record of junction entry definitions.

LINK
link (=directory junction) to point to the defined SOURCE location.

Example:

  %WA2L_INSTALLDRIVE%:\bin\FirefoxPortable\Data\profile

SOURCE
source location of the junction entry to be created. The SOURCE entry must be a directory.

Example:

  %WA2L_INSTALLDRIVE%:\var\Browser\Firefox\%USERNAME%

 

ENVIRONMENT

The Shortcuts application understands environment variables in the configuration.

Additionally to the standard Windows™ environment variables, the following ones are available:

(The date used in the examples is February 26th, 1986)

%YEAR%
four digit year of today (e.g.: 1986).

%MONTH%
two digit month of today (e.g.: 02).

%DAY%
two digit day of month of today (e.g.: 26).

%YDAY%
three digit day number of the year (e.g.: 057).

%WDAY%
one digit day of week number, 0 represents Sunday (e.g.: 3).

%WA2L_INSTALLDIR%
installation directory of the WA2L/WinTools package.
Example: D:\programs\WA2LWinTools

%WA2L_INSTALLDRIVE%
installation drive letter (without :) of the WA2L/WinTools package.
Example: D

%DESKTOP%
directory of the users 'Desktop'.

Use cddesktop in she shell to go to the 'Desktop' directory

%START%
directory of the users 'Start Menu'.

Use cdstart in she shell to go to the 'Start Menu' .

%STARTUP%
directory of the users 'Autostart' directory.

Use cdstartup in she shell to go to the 'Autostart' directory.

%SENDTO%
directory of the users 'SendTo' context menu in 'Windows™ Explorer'.

Use cdsendto in she shell to go to the 'SendTo' directory.

%ICONS%
path to the icons located in the var/icons/ directory.

%LINKS%
path to the 'Links' location of explorer, where the shortcuts are saved.

This directory was used by the Windows™ 7 file explorer explorer.exe to save the shortcuts. In Windows™ 10 the directory still exists, but the links (shortcuts) therein are no longer showed in the file explorer.

 

EXAMPLES

#
# Shortcuts.Home.cfg - Home configuration file for Shortcuts.exe 
#
# [00] 19.06.2020 CWa Initial Version
#
DESKTOPAPP;Excel GIMP Firefox Gnuplot Writer;

SHORTCUT;%DESKTOP%\DVLP;%WA2L_INSTALLDIR%\bin\Qsel.exe;DVLP;7;%ICONS%\DVLP.ico;%WA2L_INSTALLDRIVE%:\tmp;
SHORTCUT;%DESKTOP%\RadioSure;%WA2L_INSTALLDIR%\bin\RadioSure.exe;

QUICKACCESS;%WA2L_INSTALLDRIVE%:\data\Fotos;

 

SEE ALSO

wintoolsintro(1), run(1), shortcuts(1)

 

NOTES

When using (environment) variables you can check your definitions using the command

  [ h:\bin\WA2LWinTools\bin ]
  [ fred@ACME007 ][*wtshell*/cmd]: Shortcuts -p Home

to see the expanded variables.

 

BUGS

-

 

AUTHOR

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

 

COPYRIGHT

Copyright © 2021 Christian Walther

This is free software; see WA2LWinTools/doc/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
DESKTOPAPP
SHORTCUT
QUICKACCESS
JUNCTION
ENVIRONMENT
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:33:00 GMT, September 14, 2024