summaryrefslogtreecommitdiff
path: root/man/mu-init.1.org
AgeCommit message (Collapse)Author
2026-04-12improve documentationDirk-Jan C. Binnema
2025-09-08rename 'mu label' -> 'mu labels'Dirk-Jan C. Binnema
Update names, docs etc.
2025-08-16mu-init: automatic export labels with --reinitDirk-Jan C. Binnema
When re-initializing the store, automatically write the labels to a file in mu's cache, so user can later import them.
2025-05-24mu: rename --my-address into --personal-addressDirk-Jan C. Binnema
This makes things a bit more uniform with all the places where we use "personal". --my-address remains as an alias for the command-line option. Add unit test. Resolves #2806.
2025-02-16mu4e: handle conversion from pcre regexpsDirk-Jan C. Binnema
mu server uses PCRE-compatible regular expressions, but mu4e needs Emacs-style. In simple cases, the two are the same, but when it gets slightly more complicated they do not. E.g., (foo|bar) => \(foo\|bar\) Mu4e can do the conversion automatically, but for this the pcre2el package (available in MELPA) is required, and is used if user installs is. Anyway, this code implements the automatic conversion and adds some documentation. Fixes #2816.
2024-09-25mu-init: fix typo in manpage, improveDirk-Jan C. Binnema
2024-07-22mu-man: typeset option values differentlyTristan Riehs
Use underlining only, do not use <>, as it is the most often done.
2024-07-22mu-man: typeset file names using underliningTristan Riehs
Make the emphasis more consistent, and do it using underscores in Org documents, since verbatim is rendered as underlined anyway.
2024-07-22mu-man: improve typesetting of referencesTristan Riehs
Try to stick to the man-pages(7) standard.
2024-07-18mu-man: use more bold textTristan Riehs
Make occurences of "mu", small commands such as "mu init", and command-line arguments bold.
2024-07-17mu-man: improve typesetting of synopsesTristan Riehs
2024-03-06man: change quoting styleJeremy Sowden
The man-page sources use single quotes to quote text. However, this can be problematic in man-pages because if a single quote appears at the beginning of a line the following word is interpreted by troff as a macro. For example, this paragraph in mu-easy.7: What if we want to see some of the body of the message? You can get a 'summary' of the first lines of the message using the \fI\-\-summary\-len\fP option, which will 'summarize' the first \fIn\fP lines of the message: elicits this warning: $ man --warnings obj-x86_64-linux-gnu/man/mu-easy.7 >/dev/null troff:<standard input>:166: warning: macro 'summarize'' not defined and gets truncated: What if we want to see some of the body of the message? You can get a 'summary' of the first lines of the message using the --summary-len op‐ tion, which will One could adjust the line-wrapping to move the quoted text away from the beginning of the line, but that is fragile. Another possibility would be to use the troff escape-sequences for open and close quotes (`\(oq` and `\(cq` respectively), but ox-man is being used precisely to avoid having to handle troff directly. Instead use back-ticks for left quotes. Thus: What if we want to see some of the body of the message? You can get a `summary' of the first lines of the message using the \fI\-\-summary\-len\fP option, which will `summarize' the first \fIn\fP lines of the message: which is rendered correctly: What if we want to see some of the body of the message? You can get a `summary' of the first lines of the message using the --summary-len op- tion, which will `summarize' the first n lines of the message: Signed-off-by: Jeremy Sowden <azazel@debian.org>
2024-03-06man: fix formatting of `NAME` sectionsJeremy Sowden
The command names are formatted inconsistently, e.g.: * NAME ~mu add~ - add one or more messages to the database versus: * NAME *mu cfind* is the *mu* command to find contacts in the *mu* database and export them versus: * NAME mu server - the mu backend for the mu4e e-mail client and the format, with a space between "mu" and the subcommand, is not compatible with mandb(8). Use formatting which is consistent and replace the spaces with hyphens. Signed-off-by: Jeremy Sowden <azazel@debian.org>
2024-02-26mu-init: insist that --maildir is absoluteDirk-Jan C. Binnema
2024-01-01mu-init: guess maildir when --maildir is missingDirk-Jan C. Binnema
Re-instate the guessing that's in the manpage. Add unit tests. Update documentation. Fixes #2616.
2023-12-29init: interpret batch-size 0 as 'default'Dirk-Jan C. Binnema
This makes writing tests easier.
2023-09-09support xapian ngramsDirk-Jan C. Binnema
Xapian supports an "ngrams" option to help with languages/scripts without explicit wordbreaks, such as Chinese / Japanese / Korean. Add some plumbing for supporting this in mu as well. Experimental for now.
2023-07-16man: mu-init: document --max-message-size and --batch-sizeDirk-Jan C. Binnema
They were missing.
2023-07-02man: small improvementsDirk-Jan C. Binnema
2023-07-02cli: support --ignored-address for init commandDirk-Jan C. Binnema
Allow for skipping unwanted addresses (such as 'noreply') from the contacts cache.
2023-01-29man: improve exit code descriptionsDirk-Jan C. Binnema
2023-01-29mu init: implement --reinit optionDirk-Jan C. Binnema
Create new mu database from an existing one.
2022-12-31Update mu-init.1.orgStephen Eglen
Typo: b -> be
2022-12-30man: update man pagesDirk-Jan C. Binnema
Explicitly mention PCRE where appropriate. Include section headers (through MAN_CLASS_OPTIONS) Fix mu-easy manpage Make date dynamic
2022-12-29man: generate manpages from .org filesDirk-Jan C. Binnema
Generate the manpages from org-documents which makes it a bit easier to keep them update to date since I find org-syntax easier than troff, and we can use include files.