dexed/docs/features_symbolic_strings.md

title	header-includes
Symbolic strings	<script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/4.2.2/anchor.min.js"></script>

The symbolic strings represent variables defined by the software. They are used by several widgets:

• the runnable modules shebang line.
• the native project confirguration widget: many fields accept symbols.
• the custom tools: parameters, working directory.
• the process input: the input field can include a symbol.
• the GDB commander custom commands.

Possible symbols, by context, include:

Application:

• <AF>: Expanded to the application (Dexed) filename.
• <AP>: Expanded to the application (Dexed) path.
• <MEP>: Expanded to the path of the folder selected in the mini-explorer.

Environment:

• <ENV_HOME>: Expanded to the user home directory. This is the equivalent of HOME (on a Posix system) or USERHOME (on a Windows system).
• <ENV_TEMP>: Expanded to the user temporary directory.
• <ENV_USER>: Expanded to the user name.

Current file:

• <CFF>: also <CurrentFileFile>. Expanded to the current file filename.
• <CFP>: also <CurrentFilePath>. Expanded to the current file path.
• <CFR>: also <CurrentFileRunnable>. Expanded to the runnable produced for the current file. The OutputFolder option is not handled.
• <CI>: also <CurrentIdentifier>. Expanded to the identifier located at the caret position.
• <CL>: also <CurrentLine>. Expanded to the current line of code.
• <CS>: also <CurrentSelection>. Expanded to the current selection.

Current project:

• <CPF>: also <CurrentProjectFile>. Expanded to the project filename.
• <CPFS>: also <CurrentProjectFiles>. Expanded to a list that contains each D source of the project. Each item is separated by a line ending.
• <CPN>: also <CurrentProjectName>. Expanded to the project name (it's filename minus its path and extension)
• <CPO>: also <CurrentProjectOutput>. Expanded to the project output filename (a static library filename, a program name, etc.)
• <CPOP>: also <CurrentProjectOutputPath>. Expanded to the project output parent directory.
• <CPP>: also <CurrentProjectPath>. Expanded to the project path.
• <CPR>: also <CurrentProjectRoot>. Expanded to the field RootFolder of a CE project (n/a if the current project is for DUB).
• <CPCD>: also <CurrentProjectCommonFilesDirectory>. Expanded to the sources common directory.
• <CPV>: also <CurrentProjectVersion>. Expanded to the value of the version field of a CE project.

The expanded form of a symbol is never empty. When a symbol expands to nothing it's set to a pair of back quotes, e.g `** for a **` when no project is opened.

The slices located before and after the symbols are passed in their original form, e.g:

http://www.google.com/search?q="dlang.org"<CI>&btnI=Im+Feeling+Lucky

is expanded to:

http://www.google.com/search?q="dlang.org"indexOf&btnI=Im+Feeling+Lucky if indexOf is the current identifier.