381 Commits

Author SHA1 Message Date
ac52584562 build: modernize meson usage
Since we require meson 1.3(.2), we can modernize the usage a bit,
as well as improve some logic

- use / instead of join_paths
- use option.allowed() instead of !option.disable()
- use cxx.get_supported_arguments
- use fs.copyfile instead of configure_file
- show a summary at the end of the configuration
2026-08-20 15:05:32 -07:00
0b725f6c81 man: fix typos / omissions
Update the man-pages for various small error / inconsistencies / typos
etc.
2026-08-20 15:05:31 -07:00
6b1358ea48 mu: tidy up commands
Fix some typos, small errors, debug leftovers. Removed unused
mu-cmd-count.cc. Improve test-coverage. Fix manpage.

Make the errors for unknown commands a little friendlier.
2026-08-20 15:05:31 -07:00
fee6d28fe8 Remove stray #+end_example
This is seems misplaced and there's no matching #+begin_example.
2026-08-20 15:05:29 -07:00
ed77e49e25 fix typo 'we mu uses....'
fix type in man page. 

it said 'we mu uses...' I presume it meant just "mu uses"
2026-08-20 15:05:29 -07:00
2a3f9a1399 improve documentation 2026-08-20 15:05:29 -07:00
4ed2663117 Fix typo in man page for mu-move
fix typo on man page see

#2915
2026-08-20 15:05:29 -07:00
6dca68b989 scm: support --eval
With the ~--eval~ option you can evaluate an expression in mu/scm
environment. For example:

$ mu scm --eval \
  '(format #t "found ~d match(es)\n" (length (mfind "hello")))'
found 7173 match(es)

Add command-line parameter and implement.
2026-08-20 15:05:28 -07:00
037e62a58c man: mu-scm.1: fix formatting of NAME section
Format it consistently with the other man-pages and replace space in "mu scm"
with hyphen to fix mandb(8) handling.

Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
2026-08-20 15:04:27 -07:00
36e4316870 man: mu-query.7: correct typo
"and and extra" -> "and an extra"

Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
2026-08-20 15:04:27 -07:00
d76180a0e0 man: mu-labels.1: replace single quote at the beginning of line
Troff interprets single quotes at the beginning of lines as control characters.
There is one in the source for mu-labels.1, which results in that line's being
omitted from the output:

	The export command takes the labels in the store and the messages they
	apply to, and writes this information to a file. You can import this
	file later, to restore the labels. The command takes a path to a file or
	a directory (ending in

Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
2026-08-20 15:04:27 -07:00
a803eb77fd man/labels: update manpage
Small fixes, some clarifications.
2026-08-20 15:04:27 -07:00
fa6b26c366 man/labels: improve man-page
Improve text, fix some inaccuracies.
2026-08-20 15:04:27 -07:00
e3ec84386c Mainly typo and grammar fixes. 2026-08-20 15:04:27 -07:00
652b5ccbea labels: tighten labels regexp 2026-08-20 15:04:26 -07:00
656aa41ada rename 'mu label' -> 'mu labels'
Update names, docs etc.
2026-08-20 15:04:26 -07:00
124b371850 labels: allow restoring cache-map
E.g. with unexpected termination for mu it is possible that the
labels-cache (i.e., the one that is used for auto-completion) gets disconnected
from reality.

Add a --restore option to `mu label list` to restore the actual labels from the
labels seen in the store.
2026-08-20 15:04:26 -07:00
5ba4791add mu-label: no counts in list unless verbose 2026-08-20 15:04:26 -07:00
71b5f31f99 man: update label manpage 2026-08-20 15:04:26 -07:00
2fa973ec90 mu-label: allow more characters
reduce the number of "taboo" characters in labels.

update docs.
2026-08-20 15:04:26 -07:00
543c43f078 Replace "the the " with "the " 2026-08-20 15:04:26 -07:00
65816093c4 docs: Fix typo 2026-08-20 15:04:26 -07:00
9a2d481fc3 mu: add --listen option for server
Add a --listen option for the server

Rework the option code to share the --listen / socket-path code between scm and
server subcommands.

Move option off the stack in mu.cc, seems it's too big, at least when using gdb.
2025-08-24 11:54:08 +03:00
b52920bfcf scm: update documentation
Describe the new --listen flag, and give some example of its usage, including
some snippet for using it with Emacs/Geiser.
2025-08-17 12:02:34 +03:00
8c706a77db mu-init: automatic export labels with --reinit
When re-initializing the store, automatically write the labels to a file in mu's
cache, so user can later import them.
2025-08-16 16:20:33 +03:00
d843c9eb8e man: update man-pages (label / typos) 2025-08-15 21:03:19 +03:00
46fa4f2aa2 mu: add 'label' command + manpage + tests
Add a label command and document it.
2025-08-15 21:03:19 +03:00
812d78be49 mu-scm: add options, some tweaks
Add the (options) procedure + docs.

Some internal tweaks / clean-ups.
2025-06-30 21:57:29 +03:00
24a6d7725e mu-scm: add man-page
Not much yet.
2025-06-19 14:58:03 +03:00
cc10fbd22a man: update mu-index manpage
Make it a bit more explicit what we ignore.
2025-05-31 08:40:53 +03:00
f75e1203d4 mu: rename --my-address into --personal-address
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-05-24 17:17:00 +03:00
3a506f4065 Merge pull request #2828 from a3a3el/bugfix/man-page-quoting-fixes/v1
man: fix some single-quoted strings
2025-05-04 16:23:53 +03:00
44ba631a34 mu-find: implement format=json2
Implement a new experimental json2 format for mu-find, which gets rid of
the ":" prefixes for fields, i.e., "subject" instead of ":subject".
Document it as well.
2025-03-23 19:47:09 +02:00
3dd922ff6c man: escape a couple of back-slashes
Otherwise:

    (with the \040 specifying a space in the regular expression, and and extra '\' to escape it)

is rendered as:

    (with the $ 40 specifying a space in the regular expression, and and extra `$´ to escape it)

Fixes: 5e2b7d52b2 ("mu-query.7: update documentation")
Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
2025-03-10 21:44:28 +00:00
9364d25af7 man: fix some single-quoted strings
Commit 721aadc140 ("man: change quoting style") replaced single-quoted strings
of the form:

    'lorem ipsum'

with:

    `lorem ipsum'

to prevent the possibility of single quotes appearing at the beginning of lines,
because these will be misinterpreted by troff.  However, changes to the man-page
sources in 1.12.9 reintroduced some of these, including one which does appear at
the beginning of a line in mu-query(7):

    '"', '*', '(' and ')'. The details are shell-specific. In case of doubt, the

which results in the following warning:

    troff:<standard input>:25: warning: macro '"',' not defined

and the omission of that line from the rendered paragraph:

    NOTE:  if  you  use  queries on the command-line (say, for mu find), you
    need to quote any characters that would otherwise be interpreted by  the
    shell, such as *--analyze option can be useful.

Use back-ticks for the opening quotes.

Fixes: 5e2b7d52b2 ("mu-query.7: update documentation")
Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
2025-03-10 21:23:11 +00:00
3dbd8b9763 mu4e: handle conversion from pcre regexps
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.
2025-02-16 18:47:49 +02:00
a33530e917 mu.1.org: update COLOR information 2025-01-26 18:56:38 +02:00
5e2b7d52b2 mu-query.7: update documentation
In particular, regex searches.
2025-01-08 22:12:47 +02:00
1b2d9d3847 mu-find: insist on --linksdir for links
Fixes #2790.
2024-12-04 23:18:15 +02:00
8fefc52eee query: add related: combi-field + test
Add a new combination (pseudo) field "related:", which combines
"message-id" and "references"
2024-12-02 11:43:14 +02:00
05be072676 man: improve mu-query manpage 2024-12-01 23:45:28 +02:00
b0d8d42dd2 indexer: make lazy check even lazier
In lazy-mode, we were skipping directories that did not change; however,
this didn't help for the case were users received new messages in big
maildirs.

So, add another check where we compare the ctime of message files with
the time of the last indexing operation. If it's smaller, ignore the
message-file. This is faster than having to consult the Xapian database
for each message.

Note that this requires in mu4e:
      (setq mu4e-index-lazy-check t)
or
   --lazy-check
as a parameter for 'mu index'.
2024-11-10 13:47:54 +02:00
27ba0a0d02 Merge pull request #2760 from markk/mk/query-man-page
Correct mu-query man page
2024-09-25 19:32:56 +03:00
9e0d0b8355 mu-init: fix typo in manpage, improve 2024-09-25 19:27:14 +03:00
23b39759e0 man: update description of logging
Fixes #2762.
2024-09-24 23:33:00 +03:00
6426363e01 Correct mu-query man page
Update mu-query man page to point to the mu info fields command.
2024-09-15 09:46:34 +01:00
61ba9296b2 man: attempt to avoid \u escape in man building
This may help for #2756
2024-09-15 10:59:44 +03:00
QP
0282c8551d Replace zero-width spaces in man pages with an empty string.
The zero-width spaces are added by the `man-link` macro to ensure bold text
formatting when exporting from org, but they interfere with man page
functionality in Emacs.
2024-09-04 12:34:53 +02:00
547cc4ce74 mu-man: typeset option values differently
Use underlining only, do not use <>, as it is the most often done.
2024-07-22 16:09:17 +09:00
cee4823f33 mu-man: typeset file names using underlining
Make the emphasis more consistent, and do it using underscores in
Org documents, since verbatim is rendered as underlined anyway.
2024-07-22 15:40:57 +09:00