> On 2018 Mar 22 , at 1:40 a, Sivaram Neelakantan <[email protected]>
> wrote:
>
> I just realised that I can't make sense of the .tmux.conf file because
> I can't remember what setw, -n, #P and other options stand for. Is there
> a single location where all the config options are documented?
> including the variables and flags?
>
I'm not aware of anything other than the man page, which is pretty complete.
> And this is deja vu of looking at gnuplot scripts; when I wrote it, it
> made perfect sense and a year later I can't for the life of me
> remember what a particular plotting shortcut stands for, with ls and
> numbers all over the place.
>
> help!
I do have a few tips for managing your configuration file:
1. Don't use the abbreviations. `setw` is nice for when you want to change
something
from the tmux command line, but in your file and scripts, use the long form
`set-window-option`.
You only have to type it once, and it's far more self-descriptive. I sometimes
take this to extremes;
while I'll always use `tmux a` at the command line, I'll use either `attach` or
`attach-session`
in a script or configuration file, depending on how verbose I'm feeling.
2. Use copious comments. If I set something like
set-window-option -g window-status-current-format '#F:#W'
I'll add a comment to the effect of "show flags and name" as well.
Further, I'll comment not just *what* a particular setting does, but *why* I'm
using it.
I have an entire paragraph on why I use Control-a instead of Control-b or a
backtick (I use
both too often in vim). I even have a commented-out section on using | and -
for split-window,
in case I ever decide to try them despite my ingrained muscle memory for the
defaults % and ".
I also have a section with
# The default coloring for each window
#set-window-option -g window-status-bg "#ffffff"
#set-window-option -g window-status-fg "#ffffff"
#set-window-option -g window-status-attr bold
# The default coloring for the currently active window
#set-window-option -g window-status-current-bg "#ffffff"
#set-window-option -g window-status-current-fg "#ffffff"
#set-window-option -g window-status-current-attr bold
which serves as a reminder for how to override these settings for a particular
window should the need arise.
Clint
--
You received this message because you are subscribed to the Google Groups
"tmux-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send an email to [email protected].
For more options, visit https://groups.google.com/d/optout.
