You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

804 lines
18 KiB

3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
  1. .\" meli - meli.conf.5
  2. .\"
  3. .\" Copyright 2017-2019 Manos Pitsidianakis
  4. .\"
  5. .\" This file is part of meli.
  6. .\"
  7. .\" meli is free software: you can redistribute it and/or modify
  8. .\" it under the terms of the GNU General Public License as published by
  9. .\" the Free Software Foundation, either version 3 of the License, or
  10. .\" (at your option) any later version.
  11. .\"
  12. .\" meli is distributed in the hope that it will be useful,
  13. .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. .\" GNU General Public License for more details.
  16. .\"
  17. .\" You should have received a copy of the GNU General Public License
  18. .\" along with meli. If not, see <http://www.gnu.org/licenses/>.
  19. .\"
  20. .Dd September 16, 2019
  21. .Dt MELI.CONF 5
  22. .Os
  23. .Sh NAME
  24. .Nm meli.conf
  25. .Nd configuration file for the Meli Mail User Agent
  26. .Sh SYNOPSIS
  27. .Pa $XDG_CONFIG_HOME/meli/config.toml
  28. .Sh DESCRIPTION
  29. Configuration for meli is written in TOML.
  30. Few things to consider before writing TOML (quoting the spec):
  31. .Pp
  32. .Bl -bullet -compact
  33. .It
  34. TOML is case sensitive.
  35. .It
  36. A TOML file must be a valid UTF-8 encoded Unicode document.
  37. .It
  38. Whitespace means tab (0x09) or space (0x20).
  39. .It
  40. Newline means LF (0x0A) or CRLF (0x0D 0x0A).
  41. .El
  42. .Pp
  43. Refer to TOML documentation for valid TOML syntax.
  44. .sp
  45. Though not part of TOML syntax,
  46. .Nm
  47. can have nested configuration files by using the following
  48. .Xr m4 1
  49. include macro:
  50. .Dl include(\&"/path/to/file\&")
  51. .Sh SECTIONS
  52. The top level sections of the config are:
  53. .Bl -bullet -compact
  54. .It
  55. accounts
  56. .It
  57. shortcuts
  58. .It
  59. notifications
  60. .It
  61. pager
  62. .It
  63. listing
  64. .It
  65. composing
  66. .It
  67. pgp
  68. .It
  69. terminal
  70. .It
  71. log
  72. .El
  73. .Sh EXAMPLES
  74. example configuration
  75. .sp
  76. .Bd -literal
  77. # Setting up a Maildir account
  78. [accounts.account-name]
  79. root_mailbox = "/path/to/root/folder"
  80. format = "Maildir"
  81. index_style = "Compact"
  82. identity="email@address.tld"
  83. subscribed_mailboxes = ["folder", "folder/Sent"] # or [ "*", ] for all mailboxes
  84. display_name = "Name"
  85. # Set mailbox-specific settings
  86. [accounts.account-name.mailboxes]
  87. "INBOX" = { alias="Inbox" } #inline table
  88. "drafts" = { alias="Drafts" } #inline table
  89. [accounts.account-name.mailboxes."foobar-devel"] # or a regular table
  90. ignore = true # don't show notifications for this mailbox
  91. # Setting up an mbox account
  92. [accounts.mbox]
  93. root_mailbox = "/var/mail/username"
  94. format = "mbox"
  95. index_style = "Compact"
  96. identity="username@hostname.local"
  97. [pager]
  98. filter = "COLUMNS=72 /usr/local/bin/pygmentize -l email"
  99. html_filter = "w3m -I utf-8 -T text/html"
  100. [notifications]
  101. script = "notify-send"
  102. [composing]
  103. # required for sending e-mail
  104. mailer_cmd = 'msmtp --read-recipients --read-envelope-from'
  105. editor_cmd = 'vim +/^$'
  106. [shortcuts]
  107. [shortcuts.composing]
  108. edit_mail = 'e'
  109. [shortcuts.listing]
  110. new_mail = 'm'
  111. set_seen = 'n'
  112. [terminal]
  113. theme = "light"
  114. .Ed
  115. .Pp
  116. available options are listed below.
  117. .Sy default values are shown in parentheses.
  118. .Sh ACCOUNTS
  119. .Bl -tag -width 36n
  120. .It Ic root_mailbox Ar String
  121. the backend-specific path of the root_mailbox, usually INBOX.
  122. .It Ic format Ar String Op maildir mbox imap notmuch jmap
  123. the format of the mail backend.
  124. .It Ic subscribed_mailboxes Ar [String,]
  125. an array of mailbox paths to display in the UI.
  126. Paths are relative to the root mailbox (eg "INBOX/Sent", not "Sent").
  127. The glob wildcard
  128. .Em \&*
  129. can be used to match every mailbox name and path.
  130. .It Ic identity Ar String
  131. your e-mail address that is inserted in the From: headers of outgoing mail
  132. .It Ic index_style Ar String
  133. set the way mailboxes are displayed
  134. .El
  135. .TS
  136. allbox tab(:);
  137. lb l.
  138. conversations:shows one entry per thread
  139. compact:shows one row per thread
  140. threaded:shows threads as a tree structure
  141. plain:shows one row per mail, regardless of threading
  142. .TE
  143. .Bl -tag -width 36n
  144. .It Ic display_name Ar String
  145. (optional) a name which can be combined with your address:
  146. "Name <email@address.tld>"
  147. .It Ic read_only Ar boolean
  148. attempt to not make any changes to this account.
  149. .Pq Em false
  150. .It Ic manual_refresh Ar boolean
  151. (optional) if true, do not monitor account for changes (you can use shortcut listing.refresh)
  152. .Pq Em false
  153. .It Ic refresh_command Ar String
  154. (optional) command to execute when manually refreshing (shortcut listing.refresh)
  155. .Pq Em None
  156. .It Ic cache_type Ar String
  157. (optional) choose which cache backend to use.
  158. Available options are 'none' and 'sqlite3'
  159. .Pq Em "sqlite3"
  160. .It Ic vcard_folder Ar String
  161. (optional) Folder that contains .vcf files.
  162. They are parsed and imported read-only.
  163. .It Ic mailboxes Ar mailbox
  164. (optional) configuration for each mailbox.
  165. Its format is described below in
  166. .Sx mailboxes Ns
  167. \&.
  168. .El
  169. .Sh notmuch only
  170. .Ic root_mailbox
  171. points to the directory which contains the
  172. .Pa .notmuch/
  173. subdirectory.
  174. notmuch mailboxes are virtual, since they are defined by user-given notmuch queries.
  175. Thus you have to explicitly state the mailboxes you want in the
  176. .Ic mailboxes
  177. field and set the
  178. .Ar query
  179. property to each of them.
  180. Example:
  181. .Bd -literal
  182. [accounts.notmuch]
  183. format = "notmuch"
  184. \&...
  185. [accounts.notmuch.mailboxes]
  186. "INBOX" = { query="tag:inbox", subscribe = true }
  187. "Drafts" = { query="tag:draft", subscribe = true }
  188. "Sent" = { query="from:username@server.tld from:username2@server.tld", subscribe = true }
  189. .Ed
  190. .Sh IMAP only
  191. IMAP specific options are:
  192. .Bl -tag -width 36n
  193. .It Ic server_hostname Ar String
  194. example:
  195. .Qq mail.example.tld
  196. .It Ic server_username Ar String
  197. .It Ic server_password Ar String
  198. .It Ic server_password_command Ar String
  199. (optional) Use instead of
  200. .Ic server_password
  201. .It Ic server_port Ar number
  202. (optional)
  203. .\" default value
  204. .Pq Em 143
  205. .It Ic use_starttls Ar boolean
  206. (optional) if port is 993 and use_starttls is unspecified, it becomes false by default.
  207. .\" default value
  208. .Pq Em true
  209. .It Ic danger_accept_invalid_certs Ar boolean
  210. (optional) do not validate TLS certificates.
  211. .\" default value
  212. .Pq Em false
  213. .El
  214. .Sh JMAP only
  215. JMAP specific options are:
  216. .Bl -tag -width 36n
  217. .It Ic server_hostname Ar String
  218. example:
  219. .Qq mail.example.tld
  220. .It Ic server_username Ar String
  221. .It Ic server_password Ar String
  222. .It Ic server_port Ar number
  223. (optional)
  224. .\" default value
  225. .Pq Em 443
  226. .It Ic danger_accept_invalid_certs Ar boolean
  227. (optional) do not validate TLS certificates.
  228. .\" default value
  229. .Pq Em false
  230. .El
  231. .Sh mbox only
  232. mbox specific options are:
  233. .Bl -tag -width 36n
  234. .It Ic prefer_mbox_type Ar String
  235. (optional) prefer specific mbox format reader for each message. Default is mboxcl2 format. If the preferred format fails, the message is retried with mboxrd and then if it fails again there's a recover attempt, which discards the invalid message.
  236. Valid values are:
  237. .Bl -bullet -compact
  238. .It
  239. .Ar auto
  240. .It
  241. .Ar mboxo
  242. .It
  243. .Ar mboxrd
  244. .It
  245. .Ar mboxcl
  246. .It
  247. .Ar mboxcl2
  248. .El
  249. .\" default value
  250. .Pq Em auto
  251. .El
  252. to set multiple mailboxes, you have to explicitly state the mailboxes you want in the
  253. .Ic mailboxes
  254. field and set the
  255. .Ar path
  256. property to each of them.
  257. Example:
  258. .Bd -literal
  259. [accounts.mbox]
  260. format = "mbox"
  261. mailboxes."Python mailing list" = { path = "~/.mail/python.mbox", subscribe = true, autoload = true }
  262. .Ed
  263. .Sh mailboxes
  264. .Bl -tag -width 36n
  265. .It Ic alias Ar String
  266. (optional) show a different name for this mailbox in the UI
  267. .It Ic autoload Ar boolean
  268. (optional) load this mailbox on startup
  269. .\" default value
  270. .Pq Em true
  271. .It Ic subscribe Ar boolean
  272. (optional) watch this mailbox for updates
  273. .\" default value
  274. .Pq Em true
  275. .It Ic ignore Ar boolean
  276. (optional) silently insert updates for this mailbox, if any
  277. .\" default value
  278. .Pq Em false
  279. .It Ic usage Ar boolean
  280. (optional) special usage of this mailbox.
  281. Valid values are:
  282. .Bl -bullet -compact
  283. .It
  284. .Ar Normal
  285. .It
  286. .Ar Inbox
  287. .It
  288. .Ar Archive
  289. .It
  290. .Ar Drafts
  291. .It
  292. .Ar Flagged
  293. .It
  294. .Ar Junk
  295. .It
  296. .Ar Sent
  297. .It
  298. .Ar Trash
  299. .El
  300. otherwise usage is inferred from the mailbox title.
  301. .It Ic conf_override Ar boolean
  302. (optional) override global settings for this mailbox.
  303. Available sections to override are
  304. .Em pager, notifications, shortcuts, composing
  305. and the account options
  306. .Em identity and index_style Ns
  307. \&.
  308. Example:
  309. .Bd -literal
  310. [accounts."imap.domain.tld".mailboxes."INBOX"]
  311. index_style = "plain"
  312. [accounts."imap.domain.tld".mailboxes."INBOX".pager]
  313. filter = ""
  314. .Ed
  315. .El
  316. .Sh COMPOSING
  317. .Bl -tag -width 36n
  318. .It Ic mailer_cmd Ar String
  319. command to pipe new mail to, exit code must be 0 for success.
  320. .It Ic editor_cmd Ar String
  321. command to launch editor.
  322. Can have arguments.
  323. Draft filename is given as the last argument.
  324. If it's missing, the environment variable $EDITOR is looked up.
  325. .It Ic embed Ar boolean
  326. (optional) embed editor within meli
  327. .\" default value
  328. .Pq Em false
  329. .It Ic format_flowed Ar boolean
  330. (optional) set format=flowed [RFC3676] in text/plain attachments.
  331. .\" default value
  332. .Pq Em true
  333. .It Ic default_header_values Ar hash table String[String]
  334. Default header values used when creating a new draft.
  335. .El
  336. .Sh SHORTCUTS
  337. Shortcuts can take the following values:
  338. .Qq Em Backspace
  339. .Qq Em Left
  340. .Qq Em Right
  341. .Qq Em Up
  342. .Qq Em Down
  343. .Qq Em Home
  344. .Qq Em End
  345. .Qq Em PageUp
  346. .Qq Em PageDown
  347. .Qq Em Delete
  348. .Qq Em Insert
  349. .Qq Em Enter
  350. .Qq Em Tab
  351. .Qq Em Esc
  352. .Qq Em F1..F12
  353. .Qq Em M-char
  354. .Qq Em C-char
  355. and
  356. .Qq Em char Ns
  357. , where char is a single character string.
  358. .sp
  359. The headings before each list indicate the map key of the shortcut list.
  360. For example for the first list titled
  361. .Em general
  362. the configuration is typed as follows:
  363. .Bd -literal
  364. [shortcuts.general]
  365. next_tab = 'T'
  366. .Ed
  367. .sp
  368. and for
  369. .Em compact-listing Ns
  370. :
  371. .Bd -literal
  372. [shortcuts.compact-listing]
  373. open_thread = "Enter"
  374. exit_thread = 'i'
  375. .Ed
  376. .sp
  377. .Pp
  378. .Em general
  379. .Bl -tag -width 36n
  380. .It Ic next_tab
  381. Go to next tab.
  382. .\" default value
  383. .Pq Em T
  384. .It Ic go_to_tab
  385. Go to the
  386. .Em n Ns
  387. th tab
  388. .Pq Em cannot be redefined
  389. .El
  390. .sp
  391. .Em listing
  392. .Bl -tag -width 36n
  393. .It Ic prev_page
  394. Go to previous page.
  395. .\" default value
  396. .Pq Em PageUp
  397. .It Ic next_page
  398. Go to next page.
  399. .\" default value
  400. .Pq Em PageDown
  401. .It Ic prev_mailbox
  402. Go to previous mailbox.
  403. .\" default value
  404. .Pq Em K
  405. .It Ic next_mailbox
  406. Go to next mailbox.
  407. .\" default value
  408. .Pq Em J
  409. .It Ic prev_account
  410. Go to previous account.
  411. .\" default value
  412. .Pq Em l
  413. .It Ic next_account
  414. Go to next account.
  415. .\" default value
  416. .Pq Em h
  417. .It Ic new_mail
  418. Start new mail draft in new tab
  419. .\" default value
  420. .Pq Em m
  421. .It Ic set_seen
  422. Set thread as seen.
  423. .\" default value
  424. .Pq Em n
  425. .It Ic refresh
  426. Manually request a mailbox refresh.
  427. .\" default value
  428. .Pq Em F5
  429. .It Ic search
  430. Search within list of e-mails.
  431. .\" default value
  432. .Pq Em /
  433. .It Ic toggle_menu_visibility
  434. Toggle visibility of side menu in mail list.
  435. .\" default value
  436. .Pq Em `
  437. .El
  438. .sp
  439. .Em compact-listing
  440. .Bl -tag -width 36n
  441. .It Ic exit_thread
  442. Exit thread view
  443. .\" default value
  444. .Pq Em i
  445. .It Ic open_thread
  446. Open thread.
  447. .\" default value
  448. .Pq Em Enter
  449. .It Ic select_entry
  450. Select thread entry.
  451. .\" default value
  452. .Pq Em v
  453. .El
  454. .sp
  455. .Em pager
  456. .Bl -tag -width 36n
  457. .It Ic scroll_up
  458. Scroll up pager.
  459. .\" default value
  460. .Pq Em k
  461. .It Ic scroll_down
  462. Scroll down pager.
  463. .\" default value
  464. .Pq Em j
  465. .It Ic page_up
  466. Go to previous pager page
  467. .\" default value
  468. .Pq Em PageUp
  469. .It Ic page_down
  470. Go to next pager pag
  471. .\" default value
  472. .Pq Em PageDown
  473. .El
  474. .sp
  475. .Em contact-list
  476. .Bl -tag -width 36n
  477. .It Ic create_contact
  478. Create new contact.
  479. .\" default value
  480. .Pq Em c
  481. .It Ic edit_contact
  482. Edit contact under cursor
  483. .\" default value
  484. .Pq Em e
  485. .It Ic mail_contact
  486. Mail contact under cursor
  487. .\" default value
  488. .Pq Em m
  489. .It Ic toggle_menu_visibility
  490. Toggle visibility of side menu in mail list.
  491. .\" default value
  492. .Pq Em `
  493. .El
  494. .sp
  495. .sp
  496. .Em composing
  497. .Bl -tag -width 36n
  498. .It Ic send_mail
  499. Deliver draft to mailer
  500. .\" default value
  501. .Pq Em s
  502. .It Ic edit_mail
  503. Edit mail.
  504. .\" default value
  505. .Pq Em e
  506. .El
  507. .sp
  508. .Em envelope-view
  509. .Pp
  510. To "select" an attachment, type its index (you will see the typed result in the command buffer on your bottom right of the status line) and then issue the corresponding command.
  511. .Bl -tag -width 36n
  512. .It Ic add_addresses_to_contacts Ns
  513. Select addresses from envelope to add to contacts.
  514. .\" default value
  515. .Pq Em c
  516. .It Ic view_raw_source
  517. View raw envelope source in a pager.
  518. .\" default value
  519. .Pq Em M-r
  520. .It Ic reply
  521. Reply to envelope.
  522. .\" default value
  523. .Pq Em R
  524. .It Ic edit
  525. Open envelope in composer.
  526. .\" default value
  527. .Pq Em e
  528. .It Ic return_to_normal_view
  529. Return to envelope if viewing raw source or attachment.
  530. .\" default value
  531. .Pq Em r
  532. .It Ic open_attachment
  533. Opens selected attachment with
  534. .Cm xdg-open
  535. .\" default value
  536. .Pq Em a
  537. .It Ic open_mailcap
  538. Opens selected attachment according to its mailcap entry.
  539. See
  540. .Xr meli.1 FILES
  541. for the mailcap file locations.
  542. .\" default value
  543. .Pq Em m
  544. .It Ic go_to_url
  545. Go to url of given index
  546. .\" default value
  547. .Pq Em g
  548. .It Ic toggle_url_mode
  549. Toggles url open mode.
  550. When active, it prepends an index next to each url that you can select by typing and open by issuing
  551. .Ic go_to_url
  552. .\" default value
  553. .Pq Em u
  554. .It Ic toggle_expand_headers
  555. Expand extra headers (References and others)
  556. .\" default value
  557. .Pq Em h
  558. .El
  559. .sp
  560. .Em thread-view
  561. .Bl -tag -width 36n
  562. .It Ic reverse_thread_order
  563. Reverse thread order.
  564. .\" default value
  565. .Pq Em r
  566. .It Ic toggle_mailview
  567. Toggle mail view visibility.
  568. .\" default value
  569. .Pq Em p
  570. .It Ic toggle_threadview
  571. Toggle thread view visibility.
  572. .\" default value
  573. .Pq Em t
  574. .It Ic collapse_subtree
  575. Collapse thread branches.
  576. .\" default value
  577. .Pq Em h
  578. .It Ic prev_page
  579. Go to previous page.
  580. .\" default value
  581. .Pq Em PageUp
  582. .It Ic next_page
  583. Go to next page.
  584. .\" default value
  585. .Pq Em PageDown
  586. .El
  587. .sp
  588. .Sh NOTIFICATIONS
  589. .Bl -tag -width 36n
  590. .It Ic enable Ar boolean
  591. enable freedesktop-spec notifications.
  592. this is usually what you want
  593. .\" default value
  594. .Pq Em true
  595. .It Ic script Ar String
  596. (optional) script to pass notifications to, with title as 1st arg and body as 2nd
  597. .\" default value
  598. .Pq Em none
  599. .It Ic xbiff_file_path Ar String
  600. (optional) file that gets its size updated when new mail arrives
  601. .Pq Em none
  602. .\" default value
  603. .It Ic play_sound Ar boolean
  604. (optional) play theme sound in notifications if possible
  605. .Pq Em false
  606. .\" default value
  607. .It Ic sound_file Ar String
  608. (optional) play sound file in notifications if possible
  609. .\" default value
  610. .Pq Em none
  611. .El
  612. .Sh PAGER
  613. .Bl -tag -width 36n
  614. .It Ic pager_context Ar num
  615. (optional) number of context lines when going to next page.
  616. (Unimplemented)
  617. .\" default value
  618. .Pq Em 0
  619. .It Ic headers_sticky Ar boolean
  620. (optional) always show headers when scrolling.
  621. .\" default value
  622. .Pq Em true
  623. .It Ic html_filter Ar String
  624. (optional) pipe html attachments through this filter before display
  625. .\" default value
  626. .Pq Em none
  627. .It Ic filter Ar String
  628. (optional) a command to pipe mail output through for viewing in pager.
  629. .\" default value
  630. .Pq Em none
  631. .It Ic format_flowed Ar bool
  632. (optional) respect format=flowed
  633. .\" default value
  634. .Pq Em true
  635. .It Ic split_long_lines Ar bool
  636. (optional) Split long lines that would overflow on the x axis.
  637. .\" default value
  638. .Pq Em true
  639. .It Ic minimum_width Ar num
  640. (optional) Minimum text width in columns.
  641. .\" default value
  642. .Pq Em 80
  643. .It Ic auto_choose_multipart_alternative Ar boolean,
  644. (optional) Choose `text/html` alternative if `text/plain` is empty in `multipart/alternative` attachments.
  645. .\" default value
  646. .Pq Em true
  647. .El
  648. .Sh LISTING
  649. .Bl -tag -width 36n
  650. .It Ic context_lines Ar num
  651. (optional) number of context lines when going to next page.
  652. (Unimplemented)
  653. .\" default value
  654. .Pq Em 0
  655. .It Ic datetime_fmt Ar String
  656. (optional) datetime formatting passed verbatim to strftime(3).
  657. .\" default value
  658. .Pq Em \&%Y-\&%m-\&%d \&%T
  659. .It Ic recent_dates Ar Boolean
  660. (optional) Show recent dates as `X {minutes,hours,days} ago`, up to 7 days.
  661. .\" default value
  662. .Pq Em true
  663. .It Ic filter Ar Query
  664. (optional) Show only envelopes matching this query (for query syntax see
  665. .Xr meli 1 )
  666. .\" default value
  667. .Pq Em None
  668. .Pp
  669. Example:
  670. .Bd -literal
  671. filter = "not flags:seen" # show only unseen messages
  672. .Ed
  673. .El
  674. .Sh TAGS
  675. .Bl -tag -width 36n
  676. .It Ic colours Ar hash table String[Color]
  677. (optional) set UI colors for tags
  678. .It Ic ignore_tags Ar Array String
  679. (optional) hide tags (not the tagged messages themselves)
  680. .El
  681. .sp
  682. example configuration:
  683. .sp
  684. .Bd -literal
  685. [tags]
  686. # valid inputs: #HHHHHH, #ABC -> #AABBCC, XTERM_NAME, 0-255 byte
  687. colors = { signed="#Ff6600", replied="DeepSkyBlue4", draft="#f00", replied="8" }
  688. [accounts.dummy]
  689. \&...
  690. [accounts.dummy.mailboxes]
  691. # per mailbox override:
  692. "INBOX" = { tags.ignore_tags=["inbox", ] }
  693. .Ed
  694. .Sh PGP
  695. .Bl -tag -width 36n
  696. .It Ic auto_verify_signatures Ar boolean
  697. auto verify signed e-mail according to RFC3156
  698. .\" default value
  699. .Pq Em true
  700. .It Ic auto_sign Ar boolean
  701. (optional) always sign sent messages
  702. .\" default value
  703. .Pq Em false
  704. .It Ic key Ar String
  705. (optional) key to be used when signing/encrypting (not functional yet)
  706. .\" default value
  707. .Pq Em none
  708. .It Ic gpg_binary Ar String
  709. (optional) gpg binary name or file location to use
  710. .\" default value
  711. .Pq Em "gpg2"
  712. .El
  713. .Sh TERMINAL
  714. .Bl -tag -width 36n
  715. .It Ic theme Ar String
  716. (optional) select between these themes: light / dark
  717. .\" default value
  718. .Pq Em dark
  719. .It Ic ascii_drawing Ar boolean
  720. (optional) if true, box drawing will be done with ascii characters.
  721. .\" default value
  722. .Pq Em false
  723. .It Ic use_color Ar boolean
  724. (optional) if false, no ANSI colors are used
  725. .\" default value
  726. .Pq Em true
  727. .It Ic window_title Ar String
  728. (optional) set window title in xterm compatible terminals (empty string means no window title is set)
  729. .\" default value
  730. .Pq Em "meli"
  731. .It Ic themes Ar hash table String[String[Attribute]]
  732. define UI themes.
  733. See
  734. .Xr meli-themes 5
  735. for details.
  736. .Bd -literal
  737. [terminal]
  738. theme = "themeB"
  739. [terminal.themes.themeA]
  740. "mail.view.body" = {fg = "HotPink3", bg = "LightSalmon1"}
  741. \&...
  742. [terminal.themes.themeB]
  743. "mail.view.body" = {fg = "CadetBlue", bg = "White"}
  744. \&...
  745. [terminal.themes.themeC]
  746. \&...
  747. .Ed
  748. .El
  749. .Sh LOG
  750. .Bl -tag -width 36n
  751. .It Ic log_file Ar String
  752. (optional) path of the log file
  753. .\" default value
  754. .Pq Pa $XDG_DATA_HOME/meli/meli.log
  755. .It Ic maximum_level Ar String
  756. (optional) maximum level of messages to log. All levels less or equal to the
  757. .Ic maximum_level
  758. will be appended to the log file. Available levels are, in partial order:
  759. .Bl -bullet -compact
  760. .It
  761. .Em OFF
  762. .It
  763. .Em FATAL
  764. .It
  765. .Em ERROR
  766. .It
  767. .Em WARN
  768. .It
  769. .Em INFO
  770. .It
  771. .Em DEBUG
  772. .It
  773. .Em TRACE
  774. .El
  775. This means that to turn logging off, set
  776. .Ic maximum_level
  777. to
  778. .Em OFF Ns
  779. \&.
  780. .\" default value
  781. .Pq Em INFO
  782. .El
  783. .Sh SEE ALSO
  784. .Xr meli 1 ,
  785. .Xr meli-themes 5
  786. .Sh CONFORMING TO
  787. TOML Standard v.0.5.0 https://github.com/toml-lang/toml/blob/master/versions/en/toml-v0.5.0.md
  788. .Sh AUTHORS
  789. Copyright 2017-2019
  790. .An Manos Pitsidianakis Aq epilys@nessuent.xyz
  791. Released under the GPL, version 3 or greater.
  792. This software carries no warranty of any kind.
  793. (See COPYING for full copyright and warranty notices.)
  794. .Pp
  795. .Aq https://meli.delivery