summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..88fdbec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# amt - accumulate mail trailers
+
+`amt` is a helper for accumulating git trailers from email threads.
+
+## Workflow
+
+It can be used to accumulate git-trailers on a per-patch basis. The suggested
+workflow is:
+
+* Save all mails of a mail thread into a new maildir.
+* Run `amt /path/to/maildir "<message.id.of.toplevel@mail>"`
+* `amt` outputs each mail subject with all trailers in the following format:
+ '{mail subject, prefix stripped} - {trailer}'.
+ For example:
+
+ Fix Typo - Suggested-by: Heinz Dieter <heinz@dieter.mail>
+ Fix Typo - Signed-off-by: Main Tainer <main@tainer.bdfl>
+ Implement feature - Reviewed-By: R. Viewer <re@view.er>
+ Implement feature - Suggested-By: R. Viewer <re@view.er>
+ Implement feature - Signed-off-by: Main Tainer <main@tainer.bdlf>
+
+
+## Dependencies
+
+`amt` uses `git-interpret-trailers` for interpreting trailers. It expects it
+to be in `$PATH`.
+
+Dependencies are therefor rust and cargo for building and git for runtime.
+
+
+## License
+
+GNU GPLv2.0