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