40:48d26a4c35ba
Anton Shestakov <engored@ya.ru>, Thu, 28 Aug 2014 17:59:32 +0900
Ahead/behind commit count.

next change 52:17b5c2356d70
previous change 36:f3863be24d18

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.
Virtualenv
----------
.. image:: https://bitbucket.org/engored/dotfiles/raw/tip/docs/prompt-venv.png
Exit codes
----------
.. image:: https://bitbucket.org/engored/dotfiles/raw/tip/docs/prompt-exit.png
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``. In short, it's an alternative to
``sockstat`` from FreeBSD. 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.