1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
| | .. _notmuch-git(1):
============
notmuch-git
============
SYNOPSIS
========
**notmuch** **git** [-h] [-C REPO] [-p PREFIX] [-v] [-l *log level*] *subcommand*
DESCRIPTION
===========
Manage notmuch tags with Git.
Options
-------
Supported options for **notmuch-git** include
.. program:: notmuch-git
.. option:: -h, --help
show help message and exit
.. option:: -C repo, --git-dir repo
Operate on git repository *repo*
.. option:: -p prefix, --tag-prefix prefix
Operate only on tags with prefix *prefix*
.. option:: -v, --version
show notmuch-git's version number and exit
.. option:: -l *level*, --log-level *level* {critical,error,warning,info,debug}
Log verbosity. Defaults to 'warning'.
Subcommands
-----------
For help on a particular subcommand, run: 'notmuch-git ... <command> --help'.
.. option:: archive [TREE-ISH] [ARG ...]
Dump a tar archive of the current nmbug tag set using 'git archive'.
For each tag *tag* for message with Message-Id *id* an empty file
tags/encode(*id*)/encode(*tag*)
is written to the output.
The encoding preserves alphanumerics, and the characters
"+-_@=.:," (not the quotes). All other octets are replaced with
'%%' followed by a two digit hex number.
positional arguments:
TREE-ISH The tree or commit to produce an archive for. Defaults to
'HEAD'.
ARG Argument passed through to 'git archive'. Set anything before
<tree-ish>, see any:`git-archive(1)` for details.
.. option:: checkout
Update the notmuch database from Git.
This is mainly useful to discard your changes in notmuch relative
to Git.
Create a local nmbug repository from a remote source.
.. option:: clone repository
This wraps 'git clone', adding some options to avoid creating a
working tree while preserving remote-tracking branches and
upstreams.
positional arguments:
repository The (possibly remote) repository to clone from. See the URLS section of git-clone(1) for more information on specifying repositories.
clone Create a local nmbug repository from a remote source.
commit Commit prefix-matching tags from the notmuch database to Git.
fetch Fetch changes from the remote repository.
help Show help for an nmbug command.
init Create an empty nmbug repository.
log A simple wrapper for 'git log'.
merge Merge changes from 'reference' into HEAD and load the result into notmuch.
pull Pull (merge) remote repository changes to notmuch.
push Push the local nmbug Git state to a remote repository.
status Show pending updates in notmuch or git repo.
SEE ALSO
========
:any:`notmuch(1)`,
:any:`notmuch-dump(1)`,
:any:`notmuch-restore(1)`,
:any:`notmuch-tag(1)`
|