nerd-fonts/src/readme-per-directory-addendum.md


## Which font?

### TL;DR

* Pick your font family and then select from the `'complete'` directory.
  * If you are on Windows pick a font with the `'Windows Compatible'` suffix.
    * This includes specific tweaks to ensure the font works on Windows, in particular monospace identification and font name length limitations
  * If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with the `'Mono'` suffix.
    * This denotes that the Nerd Font glyphs will be monospaced not necessarily that the entire font will be monospaced

### Explanation

Once you narrow down your font choice of family (`Droid Sans`, `Inconsolata`, etc) and style (`bold`, `italic`, etc) you have 2 main choices:

#### `Option 1: Download already patched font`

 * download an already patched font from the `complete` folder
   * This is most likely the one you want. It includes **all** of the glyphs from all of the glyph sets. Only caution here is that some fonts have glyphs in the _same_ code point so to include everything some had to be moved to alternate code points.

#### `Option 2: Patch your own font`

 * patch your own variations with the various options provided by the font patcher (see each font's readme for full list of combinations available)
   * This is the option you want if the font you use is _not_ already included or you want maximum control of what's included
   * This contains a list of _all permutations_ of the various glyphs. E.g. You want the font with only [Octicons][octicons] or you want the font with just [Font Awesome][font-awesome] and [Devicons][vorillaz-devicons]. The goal is to provide every combination possible in this folder.


For more information see: [The FAQ](https://github.com/ryanoasis/nerd-fonts/wiki/FAQ#which-font)


[vim-devicons]:https://github.com/ryanoasis/vim-devicons
[vorillaz-devicons]:http://vorillaz.github.io/devicons/
[font-awesome]:https://github.com/FortAwesome/Font-Awesome
[octicons]:https://github.com/github/octicons
[gabrielelana-pomicons]:https://github.com/gabrielelana/pomicons
[Seti-UI]:https://atom.io/themes/seti-ui
[ryanoasis-powerline-extra-symbols]:https://github.com/ryanoasis/powerline-extra-symbols
[SIL-RFN]:http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web_fonts_and_RFNs#14cbfd4a
Moves build related helper md and un-patched fonts to 'src' 2016-10-29 16:48:12 -04:00
			`## Which font?`

			`### TL;DR`

Updates TL;DR section 2017-07-16 17:01:13 -04:00			* Pick your font family and then select from the `'complete'` directory.
			* If you are on Windows pick a font with the `'Windows Compatible'` suffix.
			`* This includes specific tweaks to ensure the font works on Windows, in particular monospace identification and font name length limitations`
Adds and updates configuration files to support RFN identifiers (fixes #136) 2017-07-23 17:38:55 -04:00			* If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with the `'Mono'` suffix.
Updates TL;DR section 2017-07-16 17:01:13 -04:00			`* This denotes that the Nerd Font glyphs will be monospaced not necessarily that the entire font will be monospaced`
Moves build related helper md and un-patched fonts to 'src' 2016-10-29 16:48:12 -04:00
			`### Explanation`

Updates Explanation options sections 2017-07-16 16:38:13 -04:00			Once you narrow down your font choice of family (`Droid Sans`, `Inconsolata`, etc) and style (`bold`, `italic`, etc) you have 2 main choices:

			#### `Option 1: Download already patched font`

Moves build related helper md and un-patched fonts to 'src' 2016-10-29 16:48:12 -04:00			* download an already patched font from the `complete` folder
Updates Explanation options sections 2017-07-16 16:38:13 -04:00			`* This is most likely the one you want. It includes all of the glyphs from all of the glyph sets. Only caution here is that some fonts have glyphs in the _same_ code point so to include everything some had to be moved to alternate code points.`

			#### `Option 2: Patch your own font`

Moves build related helper md and un-patched fonts to 'src' 2016-10-29 16:48:12 -04:00			`* patch your own variations with the various options provided by the font patcher (see each font's readme for full list of combinations available)`
Updates Explanation options sections 2017-07-16 16:38:13 -04:00			`* This is the option you want if the font you use is _not_ already included or you want maximum control of what's included`
			`* This contains a list of _all permutations_ of the various glyphs. E.g. You want the font with only [Octicons][octicons] or you want the font with just [Font Awesome][font-awesome] and [Devicons][vorillaz-devicons]. The goal is to provide every combination possible in this folder.`
Moves build related helper md and un-patched fonts to 'src' 2016-10-29 16:48:12 -04:00

			`For more information see: [The FAQ](https://github.com/ryanoasis/nerd-fonts/wiki/FAQ#which-font)`


			`[vim-devicons]:https://github.com/ryanoasis/vim-devicons`
			`[vorillaz-devicons]:http://vorillaz.github.io/devicons/`
			`[font-awesome]:https://github.com/FortAwesome/Font-Awesome`
			`[octicons]:https://github.com/github/octicons`
			`[gabrielelana-pomicons]:https://github.com/gabrielelana/pomicons`
			`[Seti-UI]:https://atom.io/themes/seti-ui`
			`[ryanoasis-powerline-extra-symbols]:https://github.com/ryanoasis/powerline-extra-symbols`
Adds and updates configuration files to support RFN identifiers (fixes #136) 2017-07-23 17:38:55 -04:00			`[SIL-RFN]:http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web_fonts_and_RFNs#14cbfd4a`