From faf11bcd2fe15ff0ee9e7ebea876cd54cf9eb421 Mon Sep 17 00:00:00 2001
From: smithty <smithty@ONOTTRA696862XL.agr.gc.ca>
Date: Thu, 12 Nov 2020 09:18:18 -0500
Subject: [PATCH 1/2] Added notes about iCalendar integration to manual

---
 mu4e/mu4e.texi | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index a234318c..e7bd8f96 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -3208,6 +3208,7 @@ with other tools.
 * Speedbar::A special frame with your folders
 * Dired:: Attaching files using @t{dired}
 * Hydra:: Custom shortcut menus
+* iCal integration:: Enabling iCalendar invite processing in mu4e
 @end menu
 
 @node Emacs default
@@ -3494,6 +3495,61 @@ With Hydra installed, we can add multi-character shortcuts, for instance:
 Now, you can bind a convenient key to my-mu4e-bookmarks/body.
 @end lisp
 
+@node iCalendar Integration, , Hydra, Other Tools
+@section iCalendar
+
+By default, mu4e presents iCalendar invitations as .vcs file
+attachments. Experimental support is available to parse these
+attachments in order to add the expected ``Accept'', ``Reject'', ``Add
+to Calendar'' buttons. This requires using Gnus' article view, instead
+of mu4e's internal viewer. We do this by setting the value of
+mu4e-view-use-gnus:
+
+@lisp
+(setq mu4e-view-use-gnus t)
+@end lisp
+
+The minimal setup is:
+
+@lisp
+(require 'mu4e-icalendar)
+(mu4e-icalendar-setup)
+@end
+
+To add the event to a diary file of your choice:
+
+@lisp
+(setq mu4e-icalendar-diary-file "/path/to/your/diary")
+@end
+
+To enable optional functionality to capture iCalendar events to your org files:
+
+@lisp
+(require 'org-agenda)
+(setq gnus-icalendar-org-capture-file "~/org/notes.org")
+(setq gnus-icalendar-org-capture-headline '("Calendar"))
+(gnus-icalendar-org-setup)
+@end
+
+NOTE: both the capture file and the headline(s) inside must already
+exist.
+
+These features require the Gnus article viewer. This is currently
+experimental, and doesn't yet support all the features available with
+mu4e's internal viewer. Consequently, you may want a way to toggle
+between the two modes. You can do this with the following:
+
+@lisp
+(defun mu4e-toggle-gnus-view ()
+  (interactive)
+  (mu4e~view-quit-buffer)
+  (setq mu4e-view-use-gnus
+        (not mu4e-view-use-gnus))
+  (mu4e-headers-view-message))
+
+(define-key mu4e-view-mode-map "i" 'mu4e-toggle-gnus-view)
+@end
+
 @node Example configs
 @appendix Example configs
 

From d54729290d1cd9f603b9d55d11c3b3ce73c3a0d4 Mon Sep 17 00:00:00 2001
From: smithty <smithty@ONOTTRA696862XL.agr.gc.ca>
Date: Thu, 12 Nov 2020 09:24:24 -0500
Subject: [PATCH 2/2] Fixing syntax errors in mu4e.texi

---
 mu4e/mu4e.texi | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index e7bd8f96..8e2c3db8 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -3208,7 +3208,7 @@ with other tools.
 * Speedbar::A special frame with your folders
 * Dired:: Attaching files using @t{dired}
 * Hydra:: Custom shortcut menus
-* iCal integration:: Enabling iCalendar invite processing in mu4e
+* iCalendar Integration:: Enabling iCalendar invite processing in mu4e
 @end menu
 
 @node Emacs default
@@ -3495,8 +3495,8 @@ With Hydra installed, we can add multi-character shortcuts, for instance:
 Now, you can bind a convenient key to my-mu4e-bookmarks/body.
 @end lisp
 
-@node iCalendar Integration, , Hydra, Other Tools
-@section iCalendar
+@node iCalendar Integration
+@section iCalendar Integration
 
 By default, mu4e presents iCalendar invitations as .vcs file
 attachments. Experimental support is available to parse these
@@ -3514,13 +3514,13 @@ The minimal setup is:
 @lisp
 (require 'mu4e-icalendar)
 (mu4e-icalendar-setup)
-@end
+@end lisp
 
 To add the event to a diary file of your choice:
 
 @lisp
 (setq mu4e-icalendar-diary-file "/path/to/your/diary")
-@end
+@end lisp
 
 To enable optional functionality to capture iCalendar events to your org files:
 
@@ -3529,7 +3529,7 @@ To enable optional functionality to capture iCalendar events to your org files:
 (setq gnus-icalendar-org-capture-file "~/org/notes.org")
 (setq gnus-icalendar-org-capture-headline '("Calendar"))
 (gnus-icalendar-org-setup)
-@end
+@end lisp
 
 NOTE: both the capture file and the headline(s) inside must already
 exist.
@@ -3548,7 +3548,7 @@ between the two modes. You can do this with the following:
   (mu4e-headers-view-message))
 
 (define-key mu4e-view-mode-map "i" 'mu4e-toggle-gnus-view)
-@end
+@end lisp
 
 @node Example configs
 @appendix Example configs