From 2de764725d68fa0529e53847967435be79192697 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 10:20:54 +1100
Subject: [PATCH 1/6] Config: Rewrite docs

---
 config/config | 113 ++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 91 insertions(+), 22 deletions(-)

diff --git a/config/config b/config/config
index 4756ec90..1ea571a2 100644
--- a/config/config
+++ b/config/config
@@ -7,7 +7,6 @@
 export LC_ALL=C
 export LANG=C
 
-
 # See this wiki page for more info:
 # https://github.com/dylanaraps/neofetch/wiki/Customizing-Info
 print_info() {
@@ -51,8 +50,14 @@ print_info() {
 # Kernel
 
 
-# Shorten the output of the kernel function
-# --kernel_shorthand on, off
+# Shorten the output of the kernel function.
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --kernel_shorthand
+#
+# on:  '4.8.9-1-ARCH'
+# off: 'Linux; 4.8.9-1-ARCH'
 kernel_shorthand="on"
 
 
@@ -60,12 +65,22 @@ kernel_shorthand="on"
 
 
 # Shorten the output of the distro function
-# NOTE: This is only possible on Linux, macOS, and Solaris
-# --distro_shorthand on, off, tiny
+#
+# Default:  'off'
+# Values:   'on', 'off', 'tiny'
+# Flag:     --distro_shorthand
+# Supports: Linux, macOS, and Solaris.
 distro_shorthand="off"
 
-# Show 'x86_64' and 'x86' in 'Distro:' output.
-# --os_arch on, off
+# Show/Hide OS Architecture.
+# Show 'x86_64', 'x86' and etc in 'Distro:' output.
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --os_arch
+#
+# on:  'Arch Linux x86_64'
+# off: 'Arch Linux'
 os_arch="on"
 
 
@@ -73,7 +88,14 @@ os_arch="on"
 
 
 # Shorten the output of the uptime function
-# --uptime_shorthand tiny, on, off
+#
+# Default: 'off'
+# Values:  'on', 'off', 'tiny'
+# Flag:    --uptime_shorthand
+#
+# on:   '2 days, 10 hours, 3 mins'
+# off:  '2 days, 10 hours, 3 minutes'
+# tiny: '2d 10h 3m'
 uptime_shorthand="off"
 
 
@@ -81,11 +103,23 @@ uptime_shorthand="off"
 
 
 # Show the path to $SHELL
-# --shell_path on, off
+#
+# Default: 'off'
+# Values:  'on', 'off'
+# Flag:    --shell_path
+#
+# on:  '/bin/bash'
+# off: 'bash'
 shell_path="off"
 
 # Show $SHELL version
-# --shell_version on, off
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --shell_version
+#
+# on:  'bash 4.4.5'
+# off: 'bash'
 shell_version="on"
 
 
@@ -93,37 +127,72 @@ shell_version="on"
 
 
 # CPU speed type
-# Only works on Linux with cpufreq.
-# --speed_type current, min, max, bios,
-# scaling_current, scaling_min, scaling_max
+#
+# Default: 'max'
+# Values:  'current', 'min', 'max', 'bios',
+#          'scaling_current', 'scaling_min',
+#          'scaling_max'
+# Flag:    --speed_type
+# Supports: Linux with 'cpufreq'
 speed_type="max"
 
 # Shorten the output of the CPU function
-# --cpu_shorthand name, speed, tiny, on, off
+#
+# Default: 'off'
+# Values:  'on', 'off', 'tiny', 'name', 'speed'
+# Flag:    --cpu_shorthand
+#
+# on:    'i7-6500U (4) @ 3.1GHz'
+# off:   'Intel i7-6500U (4) @ 3.1GHz'
+# tiny:  'i7-6500U (4)'
+# name:  'Intel i7-6500U (4)'
+# speed: '3.1GHz'
 cpu_shorthand="off"
 
 # CPU Usage display
 # Set CPU usage display setting
-# --cpu_display bar, infobar, barinfo, off
+#
+# Default: 'off'
+# Values:  'bar', 'infobar', 'barinfo', 'off'
+# Flag:    --cpu_display
+#
+# bar:     '[---=======]'
+# infobar: '20% [---=======]'
+# barinfo: '[---=======] 20%'
+# off:     '20%'
 cpu_display="off"
 
 # CPU Speed
 # Hide/Show CPU speed.
-# --cpu_speed on, off
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --cpu_speed
+#
+# on:  'Intel i7-6500U (4) @ 3.1GHz'
+# off: 'Intel i7-6500U (4)'
 cpu_speed="on"
 
 # CPU Cores
 # Display CPU cores in output
-# Logical: All virtual cores
-# Physical: All physical cores
-# Note: 'physical' doesn't work on BSD.
-# --cpu_cores logical, physical, off
+#
+# Default: 'logical'
+# Values:  'logical', 'physical', 'off'
+# Flag:    --cpu_cores
+# Support: 'physical' doesn't work on BSD.
+#
+# logical:  'Intel i7-6500U (4) @ 3.1GHz' (All virtual cores)
+# physical: 'Intel i7-6500U (2) @ 3.1GHz' (All physical cores)
+# off:      'Intel i7-6500U @ 3.1GHz'
 cpu_cores="logical"
 
 # CPU Temperature
 # Hide/Show CPU temperature.
-# Note: Only works on Linux.
-# --cpu_temp on, off
+#
+# Default: 'off'
+# Values:  'on', 'off'
+# Flag:    --cpu_temp
+# Supports: Linux
 cpu_temp="off"
 
 

From 597a6a864189651c0775922c7046357367e942b0 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 10:36:35 +1100
Subject: [PATCH 2/6] Config: Rewrite docs

---
 config/config | 81 ++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 68 insertions(+), 13 deletions(-)

diff --git a/config/config b/config/config
index 1ea571a2..b8e56902 100644
--- a/config/config
+++ b/config/config
@@ -56,8 +56,9 @@ print_info() {
 # Values:  'on', 'off'
 # Flag:    --kernel_shorthand
 #
+# Example:
 # on:  '4.8.9-1-ARCH'
-# off: 'Linux; 4.8.9-1-ARCH'
+# off: 'Linux 4.8.9-1-ARCH'
 kernel_shorthand="on"
 
 
@@ -79,6 +80,7 @@ distro_shorthand="off"
 # Values:  'on', 'off'
 # Flag:    --os_arch
 #
+# Example:
 # on:  'Arch Linux x86_64'
 # off: 'Arch Linux'
 os_arch="on"
@@ -93,6 +95,7 @@ os_arch="on"
 # Values:  'on', 'off', 'tiny'
 # Flag:    --uptime_shorthand
 #
+# Example:
 # on:   '2 days, 10 hours, 3 mins'
 # off:  '2 days, 10 hours, 3 minutes'
 # tiny: '2d 10h 3m'
@@ -108,6 +111,7 @@ uptime_shorthand="off"
 # Values:  'on', 'off'
 # Flag:    --shell_path
 #
+# Example:
 # on:  '/bin/bash'
 # off: 'bash'
 shell_path="off"
@@ -118,6 +122,7 @@ shell_path="off"
 # Values:  'on', 'off'
 # Flag:    --shell_version
 #
+# Example:
 # on:  'bash 4.4.5'
 # off: 'bash'
 shell_version="on"
@@ -142,6 +147,7 @@ speed_type="max"
 # Values:  'on', 'off', 'tiny', 'name', 'speed'
 # Flag:    --cpu_shorthand
 #
+# Example:
 # on:    'i7-6500U (4) @ 3.1GHz'
 # off:   'Intel i7-6500U (4) @ 3.1GHz'
 # tiny:  'i7-6500U (4)'
@@ -156,6 +162,7 @@ cpu_shorthand="off"
 # Values:  'bar', 'infobar', 'barinfo', 'off'
 # Flag:    --cpu_display
 #
+# Example:
 # bar:     '[---=======]'
 # infobar: '20% [---=======]'
 # barinfo: '[---=======] 20%'
@@ -169,6 +176,7 @@ cpu_display="off"
 # Values:  'on', 'off'
 # Flag:    --cpu_speed
 #
+# Example:
 # on:  'Intel i7-6500U (4) @ 3.1GHz'
 # off: 'Intel i7-6500U (4)'
 cpu_speed="on"
@@ -181,6 +189,7 @@ cpu_speed="on"
 # Flag:    --cpu_cores
 # Support: 'physical' doesn't work on BSD.
 #
+# Example:
 # logical:  'Intel i7-6500U (4) @ 3.1GHz' (All virtual cores)
 # physical: 'Intel i7-6500U (2) @ 3.1GHz' (All physical cores)
 # off:      'Intel i7-6500U @ 3.1GHz'
@@ -200,7 +209,14 @@ cpu_temp="off"
 
 
 # Enable/Disable GPU Brand
-# --gpu_brand on, off
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --gpu_brand
+#
+# Example:
+# on:  'AMD HD 7950'
+# off: 'HD 7950'
 gpu_brand="on"
 
 
@@ -208,25 +224,52 @@ gpu_brand="on"
 
 
 # Display refresh rate next to each monitor
-# Unsupported on Windows
-# --refresh_rate on, off
+# Default: 'off'
+# Values:  'on', 'off'
+# Flag:    --refresh_rate
+# Supports: Doesn't work on Windows.
+#
+# Example:
+# on:  '1920x1080 @ 60Hz'
+# off: '1920x1080'
 refresh_rate="off"
 
 
-# Gtk Theme / Icons
+# Gtk Theme / Icons / Font
 
 
-# Shorten output (Hide [GTK2] etc)
-# --gtk_shorthand on, off
+# Shorten output of GTK Theme / Icons / Font
+#
+# Default: 'off'
+# Values:  'on', 'off'
+# Flag:    --gtk_shorthand
+#
+# Example:
+# on:  'Numix, Adwaita'
+# off: 'Numix [GTK2], Adwaita [GTK3]'
 gtk_shorthand="off"
 
 
-# Enable/Disable gtk2 theme/icons output
-# --gtk2 on, off
+# Enable/Disable gtk2 Theme / Icons / Font
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --gtk2
+#
+# Example:
+# on:  'Numix [GTK2], Adwaita [GTK3]'
+# off: 'Adwaita [GTK3]'
 gtk2="on"
 
-# Enable/Disable gtk3 theme/icons output
-# --gtk3 on, off
+# Enable/Disable gtk3 Theme / Icons / Font
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --gtk3
+#
+# Example:
+# on:  'Numix [GTK2], Adwaita [GTK3]'
+# off: 'Numix [GTK2]'
 gtk3="on"
 
 
@@ -234,7 +277,10 @@ gtk3="on"
 
 
 # Website to ping for the public IP
-# --ip_host url
+#
+# Default: 'http://ident.me'
+# Values:  'url'
+# Flag:    --ip_host
 public_ip_host="http://ident.me"
 
 
@@ -242,7 +288,16 @@ public_ip_host="http://ident.me"
 
 
 # Print the Artist and Title on seperate lines
-# --song_shorthand on, off
+#
+# Default: 'off'
+# Values:  'on', 'off'
+# Flag:    --song_shorthand
+#
+# Example:
+# on:  'Artist: The Fratellis'
+#      'Song: Chelsea Dagger'
+#
+# off: 'Song: The Fratellis - Chelsea Dagger'
 song_shorthand="off"
 
 

From 13e2d190e55888873d41ddc0dfa68fb4790f17ef Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 10:53:22 +1100
Subject: [PATCH 3/6] Config: Rewrite docs

---
 config/config | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/config/config b/config/config
index b8e56902..49b2fec4 100644
--- a/config/config
+++ b/config/config
@@ -304,18 +304,34 @@ song_shorthand="off"
 # Birthday
 
 
-# Whether to show a long pretty output
-# or a shortened one
-# NOTE: Long pretty output doesn't work on OpenBSD or NetBSD.
-# --birthday_shorthand on, off
+# Shorten the output of the Birthday functon.
+#
+# Default:  'off'
+# Values:   'on', 'off'
+# Flag:     --birthday_shorthand
+# Supports: 'off' doesn't work on OpenBSD and NetBSD.
+#
+# Example:
+# on:  'Thu 14 Apr 2016 11:50 PM'
+# off: '2016-04-14 23:50:55'
 birthday_shorthand="off"
 
 # Whether to show the time in the output
-# --birthday_time on, off
+#
+# Default:  'on'
+# Values:   'on', 'off'
+# Flag:     --birthday_time
+#
+# Example:
+# on:  'Thu 14 Apr 2016 11:50 PM'
+# off: 'Thu 14 Apr 2016'
 birthday_time="on"
 
 # Date format to use when printing birthday
-# --birthday_format "format"
+#
+# Default:  '+%a %d %b %Y %l:%M %p'
+# Values:   'date format'
+# Flag:     --birthday_format
 birthday_format="+%a %d %b %Y %l:%M %p"
 
 

From d75a5ec49646c3d714ba4b09058ad4782e2750a3 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 11:11:05 +1100
Subject: [PATCH 4/6] Config: Rewrite docs

---
 config/config | 137 ++++++++++++++++++++++++++++++++++----------------
 1 file changed, 93 insertions(+), 44 deletions(-)

diff --git a/config/config b/config/config
index 49b2fec4..7f2f97a6 100644
--- a/config/config
+++ b/config/config
@@ -155,20 +155,6 @@ speed_type="max"
 # speed: '3.1GHz'
 cpu_shorthand="off"
 
-# CPU Usage display
-# Set CPU usage display setting
-#
-# Default: 'off'
-# Values:  'bar', 'infobar', 'barinfo', 'off'
-# Flag:    --cpu_display
-#
-# Example:
-# bar:     '[---=======]'
-# infobar: '20% [---=======]'
-# barinfo: '[---=======] 20%'
-# off:     '20%'
-cpu_display="off"
-
 # CPU Speed
 # Hide/Show CPU speed.
 #
@@ -339,12 +325,17 @@ birthday_format="+%a %d %b %Y %l:%M %p"
 
 
 # Text Colors
-# Each number represents a different part of
-# the text in this order:
-# title, @, underline, subtitle, colon, info
-# colors=(4 6 1 8 8 6)
-# You can also specify:
-# fg (foreground color)
+#
+# Default:  'distro'
+# Values:   'distro', 'num' 'num' 'num' 'num' 'num' 'num'
+# Flag:     --colors
+#
+# Each number represents a different part of the text in
+# this order: 'title', '@', 'underline', 'subtitle', 'colon', 'info'
+#
+# Example:
+# colors=(distro)      - Text is colored based on Distro colors.
+# colors=(4 6 1 8 8 6) - Text is colored in the order above.
 colors=(distro)
 
 
@@ -352,15 +343,24 @@ colors=(distro)
 
 
 # Toggle bold text
-# --bold on, off
+#
+# Default:  'on'
+# Values:   'on', 'off'
+# Flag:     --bold
 bold="on"
 
 # Enable/Disable Underline
-# --underline on, off
+#
+# Default:  'on'
+# Values:   'on', 'off'
+# Flag:     --underline
 underline_enabled="on"
 
 # Underline character
-# --underline_char char
+#
+# Default:  '-'
+# Values:   'string'
+# Flag:     --underline_char
 underline_char="-"
 
 
@@ -368,56 +368,105 @@ underline_char="-"
 
 
 # Color block range
-# --block_range start end
+# Start/End refer to the range of colors
+# to print in the blocks.
+#
+# Default:  '0', '7'
+# Values:   'num'
+# Flag:     --block_range
+#
+# Example:
+#
+# Display colors 0-7 in the blocks.
+# neofetch --block_range 0 7
+#
+# Display colors 0-15 in the blocks.
+# neofetch --block_range 0 15
 start=0
 end=7
 
 # Toggle color blocks
-# --color_blocks on, off
+#
+# Default:  'on'
+# Values:   'on', 'off'
+# Flag:     --color_blocks
 color_blocks="on"
 
 # Color block width in spaces
-# --block_width num
+#
+# Default:  '3'
+# Values:   'num'
+# Flag:     --block_width
 block_width=3
 
 # Color block height in lines
-# --block_height num
+#
+# Default:  '1'
+# Values:   'num'
+# Flag:     --block_height
 block_height=1
 
 
 # Progress Bars
 
 
-# Progress bar character
-# --progress_char elapsed_char total_char
+# Bar characters
+#
+# Default:  '-', '='
+# Values:   'string', 'string'
+# Flag:     --bar_char
+#
+# Example:
+# neofetch --bar_char 'elapsed' 'total'
+# neofetch --bar_char '-' '='
 bar_char_elapsed="-"
 bar_char_total="="
 
-# Progress border
-# --progress_border on, off
+# Toggle Bar border
+#
+# Default:  'on'
+# Values:   'on', 'off'
+# Flag:     --bar_border
 bar_border="on"
 
 # Progress bar length in spaces
 # Number of chars long to make the progress bars.
-# --progress_length num
-bar_length="15"
+#
+# Default:  '15'
+# Values:   'num'
+# Flag:     --bar_length
+bar_length=15
 
 # Progress bar colors
-# When set to distro, uses your distro's logo colors
-# Takes: num, "distro"
-# --progress_colors col col
+# When set to distro, uses your distro's logo colors.
+#
+# Default:  'distro', 'distro'
+# Values:   'distro', 'num'
+# Flag:     --bar_colors
+#
+# Example:
+# neofetch --bar_colors 3 4
+# neofetch --bar_colors distro 5
 bar_color_elapsed="distro"
 bar_color_total="distro"
 
-# Customize how the info is displayed.
-# bar: Only the progress bar is displayed.
-# infobar: The bar is displayed after the info.
-# barinfo: The bar is displayed before the info.
-# off: Only the info is displayed.
+
+# Info display
+# Display a bar with the info.
 #
-# --memory_display bar, infobar, barinfo, off
-# --battery_display bar, infobar, barinfo, off
-# --disk_display bar, infobar, barinfo, off
+# Default: 'off'
+# Values:  'bar', 'infobar', 'barinfo', 'off'
+# Flags:   --cpu_display
+#          --memory_display
+#          --battery_display
+#          --disk_display
+#
+# Example:
+# bar:     '[---=======]'
+# infobar: 'info [---=======]'
+# barinfo: '[---=======] info'
+# off:     'info'
+cpu_display="off"
 memory_display="off"
 battery_display="off"
 disk_display="off"

From 7e098f4f0601ef609330c95587bca7e1da6558bc Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 11:23:41 +1100
Subject: [PATCH 5/6] Config: Rewrite docs

---
 config/config | 55 ++++++++++++++++++++++++++++++++++++++-------------
 1 file changed, 41 insertions(+), 14 deletions(-)

diff --git a/config/config b/config/config
index 7f2f97a6..eebc2322 100644
--- a/config/config
+++ b/config/config
@@ -476,16 +476,22 @@ disk_display="off"
 
 
 # Image Source
-# --image wallpaper, /path/to/img, /path/to/dir/, off
+#
+# Default:  'wallpaper'
+# Values:   'wallpaper', '/path/to/img', '/path/to/dir/', 'off'
+# Flag:     --image
 image_source="wallpaper"
 
 # Thumbnail directory
+#
+# Default: '~/.cache/thumbnails/neofetch'
+# Values:  'dir'
 thumbnail_dir="${XDG_CACHE_HOME:-${HOME}/.cache}/thumbnails/neofetch"
 
-# W3m-img path
+# w3m-img path
 # Only works with the w3m backend.
 #
-# NOTE: Only change this if "neofetch -v" says that it couldn't find w3m-img.
+# NOTE: Only change this if "neofetch -v" says that it "couldn't find w3m-img".
 # Neofetch has a function that automatically finds w3m-img for you. It looks
 # in the following directories:
 #    /usr/lib/w3m/w3mimgdisplay
@@ -499,35 +505,56 @@ thumbnail_dir="${XDG_CACHE_HOME:-${HOME}/.cache}/thumbnails/neofetch"
 w3m_img_path="/usr/lib/w3m/w3mimgdisplay"
 
 # Crop mode
-# --crop_mode normal, fit, fill
+#
+# Default:  'normal'
+# Values:   'normal', 'fit', 'fill'
+# Flag:     --crop_mode
+#
+# See this wiki page to learn about the fit and fill options.
+# https://github.com/dylanaraps/neofetch/wiki/What-is-Waifu-Crop%3F
 crop_mode="normal"
 
 # Crop offset
-# Only affects normal mode.
-# --crop_offset northwest, north, northeast, west, center
-#               east, southwest, south, southeast
+# Note: Only affects 'normal' crop mode.
+#
+# Default:  'center'
+# Values:   'northwest', 'north', 'northeast', 'west', 'center'
+#           'east', 'southwest', 'south', 'southeast'
+# Flag:     --crop_offset
 crop_offset="center"
 
 # Image size
 # The image is half the terminal width by default.
-# --size auto, 00px, 00%, none
+#
+# Default: 'auto'
+# Values:  'auto', '00px', '00%', 'none'
+# Flags:   --image_size
+#          --size
 image_size="auto"
 
-# Right gap between image and text
-# --gap num
+# Ggap between image and text
+#
+# Default: '3'
+# Values:  'num', '-num'
+# Flag:    --gap
 gap=3
 
 # Image offsets
 # Only works with the w3m backend.
-# --xoffset px
-# --yoffset px
+#
+# Default: '0'
+# Values:  'px'
+# Flags:   --xoffset
+#          --yoffset
 yoffset=0
 xoffset=0
 
 # Image background color
 # Only works with the w3m backend.
-# Unset by default.
-# --bg_color 'color', blue
+#
+# Default: ''
+# Values:  'color', 'blue'
+# Flag:    --bg_color
 background_color=
 
 

From bef015864901b78942800ba7d2815bce178c5b45 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Sat, 26 Nov 2016 11:34:45 +1100
Subject: [PATCH 6/6] Config: rewrite docs

---
 config/config | 82 +++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 66 insertions(+), 16 deletions(-)

diff --git a/config/config b/config/config
index eebc2322..8d3ee386 100644
--- a/config/config
+++ b/config/config
@@ -564,33 +564,47 @@ background_color=
 # Default ascii image to use
 # When this is set to distro it will use your
 # distro's logo as the ascii.
-# --ascii 'distro', path/to/ascii
+#
+# Default: 'distro'
+# Values:  'distro', '/path/to/ascii_file'
+# Flag:    --ascii
 ascii="distro"
 
 # Ascii distro
 # Which distro's ascii art to display.
-# --ascii_distro 'auto', 'distro_name'
+#
+# Default: 'auto'
+# Values:  'auto', 'distro_name'
+# Flag:    --ascii_distro
 ascii_distro="auto"
 
-# Ascii colors
-# When this is set to distro it will use your
-# ditro's colors to color the ascii.
-# NOTE: You can also set this to a range of colors
-# which will allow you to custom color distro logos
-# --ascii_colors distro
-# --ascii_colors 2 4 5 6
+# Ascii Colors
+#
+# Default:  'distro'
+# Values:   'distro', 'num' 'num' 'num' 'num' 'num' 'num'
+# Flag:     --ascii_colors
+#
+# Example:
+# ascii_colors=(distro)      - Ascii is colored based on Distro colors.
+# ascii_colors=(4 6 1 8 8 6) - Ascii is colored using these colors.
 ascii_colors=(distro)
 
 # Logo size
 # Arch, Crux and Gentoo have a smaller logo
 # variant. Changing the value below to small
 # will make neofetch use the small logo.
-# --ascii_logo_size small, normal
+#
+# Default: 'normal'
+# Values:  'normal', 'small'
+# Flag:    --ascii_logo_size
 ascii_logo_size="normal"
 
 # Bold ascii logo
 # Whether or not to bold the ascii logo.
-# --ascii_bold on, off
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --ascii_bold
 ascii_bold="on"
 
 
@@ -599,25 +613,46 @@ ascii_bold="on"
 
 # Whether or not to always take a screenshot
 # You can manually take a screenshot with "--scrot" or "-s"
+#
+# Default: 'off'
+# Values:  'on', 'off'
+# Flags:   --scrot
+#          -s
 scrot="off"
 
 # Screenshot program to launch
-# --scrot_cmd
+# If you're not using 'scrot' change this to your screenshot
+# program.
+#
+# Default: 'scrot -c -d 3'
+# Values:  'cmd -flags'
+# Flag:    --scrot_cmd
 scrot_cmd="scrot -c -d 3"
 
 # Scrot dir
 # Where to save the screenshots
-# --scrot_dir /path/to/screenshot/folder
+#
+# Default: '~/Pictures/'
+# Values:  'dir'
+# Flag:    --scrot_dir
+#
+# Note: Neofetch won't create the directory if it doesn't exist.
 scrot_dir="$HOME/Pictures/"
 
 # Scrot filename
 # What to name the screenshots
-# --scrot_name str
+#
+# Default: 'neofetch-$(date +%F-%I-%M-%S-${RANDOM}).png'
+# Values:  'string'
+# Flag:    --scrot_name
 scrot_name="neofetch-$(date +%F-%I-%M-%S-${RANDOM}).png"
 
 # Image upload host
 # Where to upload the image.
-# Possible values: imgur, teknik
+#
+# Default: 'imgur'
+# Values:  'imgur', 'teknik'
+# Flag:    --image_host
 image_host="imgur"
 
 
@@ -625,9 +660,24 @@ image_host="imgur"
 
 
 # Enable/Disable config file
+#
+# Default: 'on'
+# Values:  'on', 'off'
+# Flag:    --config
 # --config off, none
+#
+# Note: This option is only used when neofetch sources this config
+# as a default config and NOT as a user config. Changing this in
+# your user config won't actually do anything.
 config="on"
 
 # Path to custom config file location
-# --config path/to/config
+#
+# Default: '${XDG_CONFIG_HOME:-${HOME}/.config}/neofetch/config'
+# Values:  '/path/to/config'
+# Flag:    --config_file
+#
+# Note: This option is only used when neofetch sources this config
+# as a default config and NOT as a user config. Changing this in
+# your user config won't actually do anything.
 config_file="${XDG_CONFIG_HOME:-${HOME}/.config}/neofetch/config"