# Documentation for BashStyle-NG 6.7

## 0) Installation

Requirements:
bash 3.0+
gconf2
python 2.4+
python-gtk 2.4+
python-glade 2.4+
python-gconf 2.4+
sed
grep
tic
psyco (optional)
bc (optional, but needed by some styles)
/dev/random (optional, but needed by the random style option)
less (optional, but needed for colored manpages)
Check dependencies:
./configure
Install BashStyle-NG:
sudo make install or su -c "make install"

## 1) Style-Page:

### BashStyle is Enabled:

This Option enables or disabled BashStyle-NG

### Colored Prompts:

Decide wether to have colorfull or monochrome prompts

### Colored output from ls:

Decide wether to get colorfull or monochrome output from ls

### Change Color Style:

Choose the way colors are drawn

### Colored Manpages:

This enables the use of a special terminfo file, which will give you colored manpages

### Terminfo for Manpages:

Choose which Terminfo file to use for coloring Manpages
Terminfo: Mostlike
Terminfo: Mostlike-Bold

### Colored output from grep:

Decide wether to get colorfull or monochrome output from grep

### Choose Grep Color:

Decide what color to use for matching words in grep's output

### Choose Color to Change / Change Color to:

Choose a part of the prompt and change it's color

### Use random Theme:

Choose this to let BashStyle-NG randomly choose a theme during bash-startup

### Choose Style:

Choose what style to use for your Bashprompt
Availabe Styles:
Separator
Vector
Floating Clock
Clock-Advanced
Dash
Job
Elite
Poweruser
Dirks
Minimal
Dot.Prompt
Bracket
Sepa-NG

## 2) Aliases-page

### Aliases

Aliases allow you to run commands by typing aliases. eg: Alias #1 set to ..=cd ../
then would .. execute cd ../
Note: Define Aliases _without_ ' or " characters!

## 3) Advanced-page

### Reset Bash's History:

Reset History completly

### History Control Type:

Choose the type of history controlling
Available Types:
Erasedups: Remove all previous entries of a command and keep the newest
Ignoredups: Save command only ones and ignore all newer runnings
Ignorespace: Ignore all commands with a leading space
Ignoreboth: Ignoredups and Ignorespace together

### History Blacklist:

List commands, which shouldn't be logged by the Bash, here
Separate entries with a :

### History Size:

The Maximum number of commands/lines in the historyfile

### Separator:

When using the Separator Style, this will be used as the separator

### PS2 PS3 and PS4:

This will be used for PS2 PS3 and PS4, affects all Styles

### PWD cut char:

The char that signalizes, that the current workdir is truncated
eg: if set to * truncated PWDs look like this: *e/chris/Desktop/gnome-pkg

### Max PWD Length

Set the maximum length of the current workdir, if longer it will be truncated
eg: if set to 25 a /home/chris/Desktop/gnome-pkg will become «e/chris/Desktop/gnome-pkg

### Change CDPATH:

Set redirections for cd. eg: if this is set to .:/usr/share, a "cd icons" will run "cd /usr/share/icons"
Separate directories with a :
Don't forget to add . to CDPATH, else you get unwanted results!

### Change Completion Blacklist:

Choose which file of which suffixes will be ignored, then pressing [TAB] for completing the filename
Separate entries with a :

### Set Timeout (in seconds):

Set how many seconds of inactivity Bash shall wait, before logging out automatically. 0 to disable.
Change editor for fc: Choose which editor to run, when running "fc"

### Welcome Message:

A Welcome Message (only if style is not Clock-Advanced or Clock)
eg: fortune or echo Welcome Back

### Path:

An Application which is inside PATH can be run without the full path
eg: if /usr/bin is in PATH, then /usr/bin/foo can be run via foo

## 4) Readline-page

### Use ReadlineCFG:

Enable Custom Readline Configuration

### Enable Completion:

Enable Filename/Pathcompletion by pressing TAB

### Change Bellstyle:

Change the Bellstyle to audible (beep), visible (blink) or none

### Choose Editing Mode:

### Show results immediately:

Instead of ringing the bell, immediately show all posibilies for completion

### Also match hidden files:

Include hidden files in completion

### Ignore Completioncase:

When completing filenames, ignore upper and lowercase

### Visible Stats:

When completing filenames display stats. @ = link ; / = folder ; * = executable

### Horizontal Completions:

Align Completion posibilities Horizontally rather than vertically

### Mark Directories:

Mark Directories with a / when completing filenames, saves up one time pressing TAB

### Mark Symbolic Directories:

Same as Mark Directories, but for directory-links instead of real directories

### Scroll Horizontally:

Instead of going into a new line, scroll horizontally, if a single-line command is too long
Note: this may not work on every system!

## 5) Extras-page

### Show/Hide number of files:

When using the Separator Style, display the amount of files in the current directory or not

### Show/Hide Uptime:

When using the Separator Style, display the System's uptime or not

### Show/Hide size of files:

When using the Separator Style, display the size of the files in the current directory or not

### Show/Hide current TTY:

When using the Separator Style, display the current TTY's number or not

### Directory Indicator:

When using truncpwd for displaying the workdir this char is used as directory indicator
eg. if set to > it will look like: >home>chris>Desktop instead of /home/chris/Desktop

### Histappend Enabled/Disabled

Append new content of the History to it, instead of overwriting
[if HISTCONTROL is not erasedups]

### CD-Spell Enabled/Disabled

Workaround misstyped paths
eg: cd /usr/sarhe will still cd into /usr/share
as long as the first and the last letter are correct
and no other directories are possibilities, too

### CDable Vars Enabled/Disabled

If the pathname doesn't exist, treat it as a variable
cd HOME would when be the same than cd $HOME

### CheckHash Enabled/Disabled

Check if hash is up-to-date, else perform a normal path search

### CMDHist Enabled/Disabled

Save Multi-line commands in a single history-line

### Force Fignore Enabled/Disabled

Hide results masked by fignore, even if there's no other result

### Histreedit Enabled/Disabled

Allow reediting of wrong history substitutions

### No Empty CMD Comp. Enabled/Disabled

Don't list all possible commands then pressing tab on an empty command line

## 6) Profiles-Page

### Profiles

### Here you can save and load your current configuration

## 7) Custom Page

### Use a Custom Prompt

Wether to use a custom prompt or not

### Choose Style to Modify

Choose one of the Internal styles to modify it

### Insert Symbolic Color

BashStyle-NG uses "symbolic colors", which you can adjust. eg Username.
Use this to put some in your prompt. Unless like adding color-codes
directly, this gives you the opportunity to change the colors via BS-NG

### PS1

Put your prompt here.

### PROMPT_COMMAND

Put your PROMPT_COMMAND [anything to be done before PS1] here.
Note1: If you need a new line, insert \n [nessacary!]
Note2: You can't use symbolic colors directly with echo!
You have to use bs-ng-parse-echo and the symbolic color
Like: echo -e $(bs-ng-parse-echo $usercolor) "xyz"

### Standard Stuff

Put Bash builtin Stuff into your prompt

### BashStyle-NG Stuff

Put Stuff provided by BashStyle-NG into your prompt

## Help

You're already here

## Info

This opens the About-Dialog