Documentation for BashStyle-NG 7.0a1


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
  make

 Install BashStyle-NG:
   sudo make install [ or ] su -c "make install"

1) Style-Page:



Enable Bashstyle:

 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



Color Style:

 Choose the way colors are drawn

 Possibilities:
 Normal - Bright (aka. Bold)- Dimmed - Inverted - Underlined

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



Grep Color:

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

Change Color from / to:

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

Random Theme:

 Choose this to let BashStyle-NG randomly choose a
 theme during bash-startup [needs /dev/random]

Style:

 Choose what style to use for your Bashprompt

 Availabe Styles:

  Separator [This Style has Options @ the Extras Page]



  Vector



  Floating Clock



  Clock-Advanced



  Dash



  Job



  Elite



  Poweruser



  Dirks



  Minimal



  Dot.Prompt



  Bracket



  Sepa-NG



  Quirk



  Sputnik

0

2) Aliases-page



Aliases

 Aliases allow you to run commands by typing aliases. eg: Alias #1 set to ..=cd ../
 then .. would execute cd ../ and so on.

 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 History

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



number of files:

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

Uptime:

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

size of files:

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

number of TTY:

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

Number of Running Jobs:

 When using the Separator Style, display the number of running jobs [processes] or not

System Load:

 When using the Separator Style, display the System Load [1 min] or not

Battery Load:

 When using the Separator Style, display the Battery Load [using apm] or not

Memory:

 Display the Memory.
 Free Memory or Used Memory [in MB]. Or both

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

TAB-Rotation

 Enable this to use TAB to rotate between possible completions

Histappend:

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

CD-Spell:

 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:

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

CheckHash:

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

CMDHist:

 Save Multi-line commands in a single history-line

Force Fignore:

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

Histreedit:

 Allow reediting of wrong history substitutions

No Empty CMD Comp.:

 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

Support Scripts

BS-NG-Parse-Echo

 This script will "parse" the Colorcodes, to make them useable with "echo"
 try this: "echo -e $usercolor hello"
 and then this: "echo -e $(bs-ng-parse-echo $usercolor) hello"
 as you can see, the later one works correctly.

BS-NG-Profiler

 This script will import or export your current configuration
 use: "bs-ng-profiler export" to export your configuration in
  ~/bashstyle/profile-[DATE]
 use: "bs-ng-profiler import /path/to/profile" to import a configuration
  only one of import/export can be done at a time

FDNL

 This script will show how many files/folders are in the current directory
 "fdnl +h" counts files, folders and hidden files/folders
 "fdnl -h" counts files and folders (no hidden files/folders)
 "fdnl +d" counts folders (no hidden folders)
 "fdnl +hd" counts folders and hidden folders
 "fdnl +f" counts files (no hidden files)
 "fdnl +hf" counts files and hidden files
 only one of those options is possible at once

Proc-Count

 This script counts all running processes
 "proccount" (no options)

Show-Battery-Load

 This script will show your lappy's battery load, using APM
  "showbatteryload" (no options)

Show-CPU-Load

 This script will show your CPU Load
 "showcpuload" (no options)

Show-Load

 This script will show your system load
 "showload" or "showload 1" -> load average for 1 minute
 "showload 2" or "showload 10" -> load average for 10 minutes
 "showload 3" or "showload 15" -> load average for 15 minutes

Show-MEM

 This script will show your memory load
 "showmem --used" shows used memory in mb
 "showmem --used-percent" shows used memory in percent
 "showmem --free" shows free memory in mb
 "showmem --free-percent" shows free memory in percent

Show-Size

 This script will show the size of all files in the current directory
 "showsize" (no options)

Show-Space

 This script will show your disk space
 "showspace --used mountpoint" shows the used space in GB of mountpoint
 "showspace --used-percent mountpoint" shows the used space in percent of mountpoint
 "showspace --free mountpoint" shows the free space in GB of mountpoint
 "showspace --free-percent mountpoint" shows the free space in percent of mountpoint

Show-TTY

 This scripts shows the current TTY (Terminal Device)
 "showtty" (no options)

Show-Uptime

 This script will show your system's uptime
 "showuptime" (no options)

TruncPWD

 This script will modify the apperance of $PWD

Help

 You're already here

Info

 This opens the About-Dialog