Next: Prompt Hooks, Previous: Custom Prompt Builder, Up: BashStyle-NG Documentation  

---

20 Configuration Files ¶

While BashStyle-NG is able to auto-generate the configuration files based on your choices in the UI, you might want to do manual additions as well.

Main Configuration Files ¶

• Factory Configuration: $INSTALL_PREFIX/share/bashstyle-ng/bashstyle-ng.ini
• Vendor Configuration: /etc/bashstyle-ng_vendor.ini
• User Configuration: ~/.bashstyle-ng.ini
• User Backup Configuration: ~/.bashstyle-ng.ini.save

Configuration File Handling ¶

• Configuration Files are versioned using the ini_version parameter, which ensures your User or Vendor configuration is up to date.
• If no User Configuration exists, BashStyle-NG will create the default one using
  • Vendor Configuration (if it exists and has the latest ini_version)
  • Factory Configuration
• If the User Configuation is outdated, BashStyle-NG will update it using
  • Vendor Configuration (if it exists and has the latest ini_version)
  • Factory Configuration
• If the User Configuation is malformed, BashStyle-NG will try to restore it using
  • User Backup Configuration (if it exists and has the latest ini_version)
• If that is not possible, it will create the default one using
  • Vendor Configuration (if it exists and has the latest ini_version)
  • Factory Configuration

Additional Configuration Files ¶

• ~/.inputrc.custom: custom non-managed readline settings, loaded after ~/.inputrc
• ~/.vimrc.custom: custom non-managed vim settings, loaded after ~/.vimrc
• ~/.bashstyle.custom: custom non-managed bash settings, always loaded after BashStyle-NG start so variables and functions provided by BashStyle-NG can reliably be used

Configuration File handling in User Interface ¶

In the BashStyle-NG Configuration Files section you are able to

• view versions of the configuration files
• backup your User configuration
• restore User Backup configuration
• restore Vendor configuration (if it exists and has the lastest ini_version), else Factory configuration
• edit ~/.bashrc (uses xdg-open)
• edit ~/.bashstyle.custom (uses xdg-open)
• edit ~/.inputrc.custom (uses xdg-open, file is created if it doesn’t exist)
• edit ~/.vimrc.custom (uses xdg-open, file is created if it doesn’t exist)

Using Restart BashStyle-NG you can reload the whole UI, this allows you to refresh the UI when you fully reverted to a backup or vendor/factory config.

Setting: debug_verbose Verbose output on start ¶

BashStyle-NG does intensive logging upon Bash session start. If you want visible logging enable this option. Usually you don’t need this and thus it’s disabled by default.