@@ -176,3 +176,39 @@ is dependent on your operating system. To get the default path for your system,
176176
177177Alternatively, you can use the BAT_CONFIG_PATH environment variable to point bat to a non-default
178178location of the configuration file.
179+.SH "ADDING CUSTOM LANGUAGES"
180+{{PROJECT_EXECUTABLE}} supports Sublime Text \fB.sublime-syntax\fR language files, and can be
181+customized to add additional languages to your local installation. To do this, add the \fB.sublime-snytax\fR language
182+files to `\fB$({{PROJECT_EXECUTABLE}} --config-dir)/syntaxes\fR` and run `\fBbat cache --build\fR`.
183+
184+\fBExample:\fR
185+
186+.RS 0.5i
187+mkdir -p "$({{PROJECT_EXECUTABLE}} --config-dir)/syntaxes"
188+.br
189+cd "$({{PROJECT_EXECUTABLE}} --config-dir)/syntaxes"
190+
191+# Put new '.sublime-syntax' language definition files
192+.br
193+# in this folder (or its subdirectories), for example:
194+.br
195+git clone https://github.com/tellnobody1/sublime-purescript-syntax
196+
197+# And then build the cache.
198+.br
199+{{PROJECT_EXECUTABLE}} cache --build
200+.RE
201+
202+Once the cache is built, the new language will be visible in `\fBbat --list-languages\fR`.
203+.br
204+If you ever want to remove the custom languages, you can clear the cache with `\fBbat cache --clear\fR`.
205+
206+.SH "ADDING CUSTOM THEMES"
207+Similarly to custom languages, {{PROJECT_EXECUTABLE}} supports Sublime Text \fB.tmTheme\fR themes.
208+These can be installed to `\fB$({{PROJECT_EXECUTABLE}} --config-dir)/themes\fR`, and are added to the cache with
209+`\fB{{PROJECT_EXECUTABLE}} cache --build`.
210+.SH "MORE INFORMATION"
211+
212+For more information and up-to-date documentation, visit the {{PROJECT_EXECUTABLE}} repo:
213+.br
214+\fBhttps://github.com/sharkdp/bat\fR