:lang: en

= Adding Configuration Selection Items

Example Configurations can be added to the Configuration Selector by two methods:

* Auxiliary applications -- Applications installed independently with a deb package can place configuration subdirectories in a specified system directory.
  The directory name is specified using the shell linuxcnc_var script:
+
----
$ linuxcnc_var LINUXCNC_AUX_EXAMPLES
/usr/share/linuxcnc/aux_examples
----

* Runtime settings -- the configuration selector can also offer configuration subdirectories specified at runtime using an exported environamental variable (LINUXCNC_AUX_CONFIGS).
  This variable should be a path list of one or more configuration directories separated by a (:).
  Typically, this variable would be set in a shell starting `linuxcnc` or in a user's `~/.profile` startup script.
  Example:
+
----
export LINUXCNC_AUX_CONFIGS=~/myconfigs:/opt/otherconfigs
----

// vim: set syntax=asciidoc:
