10:233c3d76cc7d
Anton Shestakov <engored@ya.ru>, Fri, 01 Jun 2012 20:27:08 +0900
Added git branch name; bash-fu.

next change 11:2439664df022
previous change 8:86f2ec90bb93

README.rst

Permissions: -rw-r--r--

Other formats: Feeds:
Stuff worth explaining
======================
.bash_prompt
~~~~~~~~~~~~
This file provides ``prompt_command`` function that is executed by the
shell just before displaying ``PS1``. This way user can redefine ``PS1`` (or any of
``PS{1,4}``, for that matter) to fit his/her needs. That's what I did exactly.
Regular prompt
--------------
.. image:: https://bitbucket.org/engored/dotfiles/raw/tip/docs/prompt.png
Note that the clock is not real-time. It updates after your shell command
finishes (e.g. after you press enter). That's sufficient if you want to
know how long your db backup took, for example.
Mercurial and Git support is disabled for root, thus two colored dashes.
Mercurial prompt
----------------
.. image:: https://bitbucket.org/engored/dotfiles/raw/tip/docs/prompt-hg.png
It can be clearer, sure. But I'm used to this and I like it because it's
taking so little space.
Git prompt
----------
No screenshot yet.
.bash_aliases
~~~~~~~~~~~~~
This file contains aliases. Currently, the only alias that is not exactly
self-explanatory is ``whatsopen``. It shows listening (TCP) applications,
like ``netstat -ntlp``, but with a handy difference. It additionally shows
users, so instead of this::
Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name
tcp 0 0 127.0.0.1:5984 0.0.0.0:* LISTEN 30617/beam.smp
you get this::
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
beam.smp 30617 couchdb 16u IPv4 7652760 0t0 TCP 127.0.0.1:5984 (LISTEN)
See? It's much easier to guess what beam.smp is when you know couchdb owns
it. And it's much, much easier to understand what python2 is doing there
when its owner is my-django-site-user or something.
.bash_dconf2env
~~~~~~~~~~~~~~~
If you're using dconf (if you have Gnome 3 or some GTK+3 apps, you are) and
want your system to use HTTP proxy server, put it in one place — your Gnome
control center. Then just use this file and it'll set ``HTTP_PROXY`` and
``NO_PROXY`` for you.