From 601ad98818f3b966686181445339c52f74f75979 Mon Sep 17 00:00:00 2001
From: bptato <nincsnevem662@gmail.com>
Date: Fri, 26 Apr 2024 19:35:21 +0200
Subject: doc: include auto-generated manpages in repository

The 100kb or so doesn't hurt as much as not having manual pages at all
without pandoc (+ not auto-updating them through make all) does.
---
 doc/cha-mime.types.5 | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 doc/cha-mime.types.5

(limited to 'doc/cha-mime.types.5')

diff --git a/doc/cha-mime.types.5 b/doc/cha-mime.types.5
new file mode 100644
index 00000000..c0f9aa14
--- /dev/null
+++ b/doc/cha-mime.types.5
@@ -0,0 +1,72 @@
+.\" Automatically generated by Pandoc 2.17.1.1
+.\"
+.\" Define V font for inline verbatim, using C font in formats
+.\" that render this, and otherwise B font.
+.ie "\f[CB]x\f[]"x" \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
+.TH "cha-config" "5" "" "" "MIME type detection in Chawan"
+.hy
+.SH mime.types
+.PP
+Chawan uses the mime.types file to recognize certain file extensions for
+matching mailcap entries.
+See the \f[B]cha-mailcap\f[R](5) documentation for a description of
+mailcap.
+.SS Search path
+.PP
+Chawan parses all mime.types files defined in
+\f[V]external.mime-types\f[R].
+If no mime.types file was found, the built-in mime type associations are
+used.
+.PP
+The default search path for mime.types files is:
+.IP
+.nf
+\f[C]
+$HOME/.mime.types:/etc/mime.types:/usr/etc/mime.types:/usr/local/etc/mime.types
+\f[R]
+.fi
+.SS Format
+.PP
+The mime.types file is a list of whitespace-separated columns.
+The first column represents the mime type, all following columns are
+file extensions.
+.PP
+Lines starting with a hash character (#) are recognized as comments, and
+are ignored.
+.PP
+Example:
+.IP
+.nf
+\f[C]
+# comment
+application/x-example   exmpl   ex
+\f[R]
+.fi
+.PP
+This mime.types file would register the file extensions \[lq]exmpl\[rq]
+and \[lq]ex\[rq] to be recognized as the mime type
+\f[V]application/x-example\f[R].
+.SS Note
+.PP
+Chawan only uses mime.types files for finding mailcap entries; buffers
+use an internal mime.types file for content type detection instead.
+.PP
+The default mime.types file only includes file formats that buffers can
+handle, which is rather limited (at the time of writing, 7 file
+formats).
+Therefore it is highly recommended to configure at least one external
+mime.types file if you use mailcap.
+.SS See also
+.PP
+\f[B]cha\f[R](1)
-- 
cgit 1.4.1-2-gfad0