CUSTOMIZE.md love

1 files changed, 12 insertions, 13 deletions

diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md
index f60e0c1b..14e646b0 100644
--- a/CUSTOMIZE.md
+++ b/CUSTOMIZE.md
@@ -172,18 +172,18 @@ The default is 256, which will be scaled down depending on how many colours
 your terminal supports.
 
 The interface will theme its widgets according to the palette defined in
-section `[MODEc-theme]` where `MODE` denotes the integer indicating your mode.
+section `[MODEc-theme]` where `MODE` is the integer indicating the colour mode.
 Have a look at the default config (`alot/defaults/alot.rc`) for a complete list
 of interpreted widget settings; the keys in this section should be self-explanatory.
 
-Values can be colour names ('light red', 'dark green'..), RGB colour codes (e.g. '#868'),
-font attributes ('bold', 'underline', 'blink', 'standout') or a comma separated combination of
+Values can be colour names (`light red`, `dark green`..), RGB colour codes (e.g. `#868`),
+font attributes (`bold`, `underline`, `blink`, `standout`) or a comma separated combination of
 colour and font attributes.
 In sections `[16c-theme]` and `[256c-theme]` you can define Y_fg and
 Y_bg for the foreground and background of each widget keyword Y, whereas the monochromatic
 (`[1c-theme]`) palette can only interpret font attributes for key Y without the suffix.
-As an example, check the setting below, that makes the footer line appear as
-underlined, bold red text on a bright green background:
+As an example, check the setting below that makes the footer line appear as
+underlined bold red text on a bright green background:
 
     [256c-theme]
     global_footer_bg = #8f6
@@ -199,19 +199,18 @@ Urwid provides a [neat colour picker script][urwid_colour_pick] that makes choos
 
 Custom Tagstring Formating
 --------------------------
-Keywords in the theme sections that start with "tag_" will be used to display specific tags.
-For instance, you can use the following to always display the "todo" tag in white on red,
-when in 256c-mode.
+In theme sections you can use keys with prefix "tag_" to format specific tagstrings. For instance,
+the following will make alot display the "todo" tag in white on red when in 256c-mode.
 
     [256c-theme]
     tag_todo_bg = #d66
     tag_todo_fg = white
 
-You can translate tag strings before displaying them using the [tag-translate] section.
-A key=value statement in this section is interpreted as:
-Always display the tag `key` as string `value`. Utf-8 symbols are welcome here.
-See e.g. http://panmental.de/symbols/info.htm
-I personally display my maildir flags like this:
+You can translate tag strings before displaying them using the `[tag-translate]` section. A
+key=value statement in this section is interpreted as:
+Always display the tag `key` as string `value`. Utf-8 symbols are welcome here, see e.g.
+http://panmental.de/symbols/info.htm for some fancy symbols. I personally display my maildir flags
+like this:
 
     [tag-translate]
     flagged = ⚑