emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* More flyspell-overlays removed
@ 2012-07-20 20:14 Bjarte Johansen
  2012-07-28  9:27 ` Bastien
  0 siblings, 1 reply; 17+ messages in thread
From: Bjarte Johansen @ 2012-07-20 20:14 UTC (permalink / raw)
  To: emacs-orgmode

Hi -

I made a patch to remove some more flyspell-overlays in #-blocks. The reason for no : in the latex_header is that for some reason the : does not get captured in dc1. flyspell is also removed for the full verbatim, lstlisting and src blocks.

I hope you guys can use the patch.

Regards,
Bjarte

--------------------------------------------------------------------------------
diff --git a/lisp/org.el b/lisp/org.el
index 4241168..80fbdd0 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -5465,7 +5465,8 @@ by a #."
	      (dc3 (downcase (match-string 3)))
	      end end1 quoting block-type ovl)
	  (cond
-	   ((member dc1 '("html:" "ascii:" "latex:" "docbook:"))
+	   ((member dc1 '("html:" "ascii:" "latex:" "docbook:" "startup:"
+			  "options:" "latex_header"))
	    ;; a single line of backend-specific content
	    (org-remove-flyspell-overlays-in (match-beginning 0) (match-end 0))
	    (remove-text-properties (match-beginning 0) (match-end 0)
@@ -5478,6 +5479,7 @@ by a #."
	    t)
	   ((and (match-end 4) (equal dc3 "begin"))
	    ;; Truly a block
+	    (org-remove-flyspell-overlays-in (match-beginning 0) (match-end 0))
	    (setq block-type (downcase (match-string 5))
		  quoting (member block-type org-protecting-blocks))
	    (when (re-search-forward
@@ -5486,6 +5488,9 @@ by a #."
	      (setq end (min (point-max) (match-end 0))
		    end1 (min (point-max) (1- (match-beginning 0))))
	      (setq block-end (match-beginning 0))
+	      (when (member block-type '("lstlisting" "verbatim" "src"))
+                (org-remove-flyspell-overlays-in block-start block-end))
+              (org-remove-flyspell-overlays-in (match-beginning 0) (match-end 0))
	      (when quoting
		(remove-text-properties beg end
					'(display t invisible t intangible t)))
@@ -5540,6 +5545,7 @@ by a #."
			      "orgtbl:" "tblfm:" "tblname:" "results:"
			      "call:" "header:" "headers:" "name:"))
		(and (match-end 4) (equal dc3 "attr")))
+	    (org-remove-flyspell-overlays-in (match-beginning 0) (match-end 0))
	    (add-text-properties
	     beg (match-end 0)
	     '(font-lock-fontified t face org-meta-line))

^ permalink raw reply related	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-20 20:14 More flyspell-overlays removed Bjarte Johansen
@ 2012-07-28  9:27 ` Bastien
  2012-07-28 22:38   ` Bjarte Johansen
  0 siblings, 1 reply; 17+ messages in thread
From: Bastien @ 2012-07-28  9:27 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: emacs-orgmode

Hi Bjarte,

Bjarte Johansen <bjo013@student.uib.no> writes:

> I made a patch to remove some more flyspell-overlays in #-blocks. The
> reason for no : in the latex_header is that for some reason the : does
> not get captured in dc1. flyspell is also removed for the full
> verbatim, lstlisting and src blocks.
>
> I hope you guys can use the patch.

I cannot apply it because it adds keywords at the wrong place.  
For example you cannot add "startup:" in the first (cond ((...)))
because "startup:" is not a "backend specific content."  And some
other discrepencies.

I'd welcome a patch for removing more flyspell overlays, but it
has to be rewritten.  I'm not using flyspell so someone else will
have to do roll his sleeves.

Thanks anyway for the patch!

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-28  9:27 ` Bastien
@ 2012-07-28 22:38   ` Bjarte Johansen
  2012-07-29  8:35     ` Jeffrey Spencer
  0 siblings, 1 reply; 17+ messages in thread
From: Bjarte Johansen @ 2012-07-28 22:38 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1007 bytes --]

On 28 Jul, 2012, at 11:27 , Bastien <bzg@gnu.org> wrote:

> I cannot apply it because it adds keywords at the wrong place.  
> For example you cannot add "startup:" in the first (cond ((...)))
> because "startup:" is not a "backend specific content."  And some
> other discrepencies.

OK, I understand. I should have spent some more time trying to 
understand the code. 

> I'd welcome a patch for removing more flyspell overlays, but it
> has to be rewritten.  I'm not using flyspell so someone else will
> have to do roll his sleeves.

I'd be willing to put in the effort to make a proper patch, but I need some 
help to understand what is going on in this function. It is not obvious to 
me.

The places flyspell-overlays needs to be removed are in the startup, 
options, latex_header.  Some of structures that might be used in latex like 
lstlisting and verbatim where the text also should not have flyspell-overlays.

There are also some other places like label, caption and attr.

[-- Attachment #2: Type: text/html, Size: 1323 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-28 22:38   ` Bjarte Johansen
@ 2012-07-29  8:35     ` Jeffrey Spencer
  2012-07-29 14:47       ` Bjarte Johansen
  0 siblings, 1 reply; 17+ messages in thread
From: Jeffrey Spencer @ 2012-07-29  8:35 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1564 bytes --]

I was also thinking about this recently but hadn't gotten as far as writing
a patch.

I was thinking some tags you know you want to remove the fly-spell overlays
but for example caption you might or might not want the flyspell overlays
removed. If there was a variable that could be set to choose some that
might or might not want the overlays to remove. Not sure if this is
possible but what I was originally looking at doing but hadn't gotten time.

Cheers,
Jeff

On Sun, Jul 29, 2012 at 8:38 AM, Bjarte Johansen <bjo013@student.uib.no>wrote:

> On 28 Jul, 2012, at 11:27 , Bastien <bzg@gnu.org> wrote:
>
> I cannot apply it because it adds keywords at the wrong place.
> For example you cannot add "startup:" in the first (cond ((...)))
> because "startup:" is not a "backend specific content."  And some
> other discrepencies.
>
>
> OK, I understand. I should have spent some more time trying to
> understand the code.
>
>
> I'd welcome a patch for removing more flyspell overlays, but it
> has to be rewritten.  I'm not using flyspell so someone else will
> have to do roll his sleeves.
>
>
> I'd be willing to put in the effort to make a proper patch, but I need
> some
> help to understand what is going on in this function. It is not obvious to
> me.
>
> The places flyspell-overlays needs to be removed are in the startup,
> options, latex_header.  Some of structures that might be used in latex
> like
> lstlisting and verbatim where the text also should not have
> flyspell-overlays.
>
> There are also some other places like label, caption and attr.
>

[-- Attachment #2: Type: text/html, Size: 2189 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-29  8:35     ` Jeffrey Spencer
@ 2012-07-29 14:47       ` Bjarte Johansen
  2012-07-30 11:03         ` Bastien
  2012-07-31 15:10         ` Sebastien Vauban
  0 siblings, 2 replies; 17+ messages in thread
From: Bjarte Johansen @ 2012-07-29 14:47 UTC (permalink / raw)
  To: Jeffrey Spencer; +Cc: emacs-orgmode


On 29 Jul, 2012, at 10:35 , Jeffrey Spencer <jeffspencerd@gmail.com> wrote:

> I was also thinking about this recently but hadn't gotten as far as writing a patch.
> 
> I was thinking some tags you know you want to remove the fly-spell overlays but for example caption you might or might not want the flyspell overlays removed. If there was a variable that could be set to choose some that might or might not want the overlays to remove. Not sure if this is possible but what I was originally looking at doing but hadn't gotten time.

So I won't be able to work on this before next weekend, but in the mean time (unless someone else has the time) I suggest that we make a list of places where we would like to remove flyspell overlays from. I'll start.

#+STARTUP
#+OPTIONS
#+LATEX_CLASS
#+LATEX_CLASS_OPTIONS
#+LATEX_HEADER
#+BEGIN_lstlisting
#+END_lstlisting
Body of lstlisting
#+BEGIN_verbatim
#+END_verbatim
body of verbatim
#+LABEL

These are for the #+ blocks I can think of now. I would also like to remove them from \nocite{} \cite{} and \ref{} commands or make a way to cite without using latex commands. 

What could perhaps be done is remove every \command but not the body except in the cases of \nocite{} cite and ref (and maybe others?).

Maybe these commands should go into a hook or var? That would make it easier on users that need to remove commands from obscure latex packages. 

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-29 14:47       ` Bjarte Johansen
@ 2012-07-30 11:03         ` Bastien
  2012-07-30 11:13           ` Jeffrey Spencer
  2012-07-30 11:44           ` Bjarte Johansen
  2012-07-31 15:10         ` Sebastien Vauban
  1 sibling, 2 replies; 17+ messages in thread
From: Bastien @ 2012-07-30 11:03 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: emacs-orgmode

I've pushed a fix which should let flyspell ignore more commonly 
used Org keywords.  Please test it.

Thanks!

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-30 11:03         ` Bastien
@ 2012-07-30 11:13           ` Jeffrey Spencer
  2012-07-30 11:44           ` Bjarte Johansen
  1 sibling, 0 replies; 17+ messages in thread
From: Jeffrey Spencer @ 2012-07-30 11:13 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode, Bjarte Johansen

[-- Attachment #1: Type: text/plain, Size: 1025 bytes --]

Will give it a test later in the week and let you know.

Also you can add this hook to make it act like the fly-spell mode in auctex
(if familiar with that) which skips most tex based commands (trips up
though if you have only one $ because assumes another $ sign later so won't
check spelling in that block. I would just do \$ if you need a single
dollar sign. This is the only really limitation I have found to adding this
that I have noticed thus far.
(add-hook 'org-mode-hook (lambda () (setq ispell-parser 'tex)))

I would prefer instead of having this an all org-mode-hook to initiate only
in documents that have a #+LATEX in the document once opened to set the
parcer but wasn't sure how to do this.

Also I would add:
#+BEGIN_equation
body as well
#+END_equation
#+begin_align
body as well
#+end_align

Cheers,
jeff

On Mon, Jul 30, 2012 at 9:03 PM, Bastien <bzg@gnu.org> wrote:

> I've pushed a fix which should let flyspell ignore more commonly
> used Org keywords.  Please test it.
>
> Thanks!
>
> --
>  Bastien
>

[-- Attachment #2: Type: text/html, Size: 1564 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-30 11:03         ` Bastien
  2012-07-30 11:13           ` Jeffrey Spencer
@ 2012-07-30 11:44           ` Bjarte Johansen
  2012-07-31 13:56             ` Jeffrey Spencer
  2012-07-31 15:32             ` Bastien
  1 sibling, 2 replies; 17+ messages in thread
From: Bjarte Johansen @ 2012-07-30 11:44 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode


On 30 Jul, 2012, at 13:03 , Bastien <bzg@gnu.org> wrote:

> I've pushed a fix which should let flyspell ignore more commonly 
> used Org keywords.  Please test it.

This works great. You forgot #+LATEX_CLASS_OPTIONS: though.


On 30 Jul, 2012, at 13:13 , Jeffrey Spencer <jeffspencerd@gmail.com> wrote:

> Will give it a test later in the week and let you know.
> 
> Also you can add this hook to make it act like the fly-spell mode in auctex (if familiar with that) which skips most tex based commands (trips up though if you have only one $ because assumes another $ sign later so won't check spelling in that block. I would just do \$ if you need a single dollar sign. This is the only really limitation I have found to adding this that I have noticed thus far.
> (add-hook 'org-mode-hook (lambda () (setq ispell-parser 'tex)))

I tried this and it does work for most things, but for some reason it doesn't like the natbib \cite commands.

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-30 11:44           ` Bjarte Johansen
@ 2012-07-31 13:56             ` Jeffrey Spencer
  2012-07-31 15:32             ` Bastien
  1 sibling, 0 replies; 17+ messages in thread
From: Jeffrey Spencer @ 2012-07-31 13:56 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: Bastien, emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1394 bytes --]

I don't have any problem with natbib cite commands including \ref, \cite,
\citet, \citep, etc....

Maybe your version of flyspell?? But it should act exactly as it does in
auctex or your latex mode of emacs. I would check in there if it works
properly because should parse the same way if not maybe debug from there.

Cheers,
Jeff

On Mon, Jul 30, 2012 at 9:44 PM, Bjarte Johansen <bjo013@student.uib.no>wrote:

>
> On 30 Jul, 2012, at 13:03 , Bastien <bzg@gnu.org> wrote:
>
> > I've pushed a fix which should let flyspell ignore more commonly
> > used Org keywords.  Please test it.
>
> This works great. You forgot #+LATEX_CLASS_OPTIONS: though.
>
>
> On 30 Jul, 2012, at 13:13 , Jeffrey Spencer <jeffspencerd@gmail.com>
> wrote:
>
> > Will give it a test later in the week and let you know.
> >
> > Also you can add this hook to make it act like the fly-spell mode in
> auctex (if familiar with that) which skips most tex based commands (trips
> up though if you have only one $ because assumes another $ sign later so
> won't check spelling in that block. I would just do \$ if you need a single
> dollar sign. This is the only really limitation I have found to adding this
> that I have noticed thus far.
> > (add-hook 'org-mode-hook (lambda () (setq ispell-parser 'tex)))
>
> I tried this and it does work for most things, but for some reason it
> doesn't like the natbib \cite commands.

[-- Attachment #2: Type: text/html, Size: 1926 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-29 14:47       ` Bjarte Johansen
  2012-07-30 11:03         ` Bastien
@ 2012-07-31 15:10         ` Sebastien Vauban
  2012-07-31 15:32           ` Bastien
  1 sibling, 1 reply; 17+ messages in thread
From: Sebastien Vauban @ 2012-07-31 15:10 UTC (permalink / raw)
  To: emacs-orgmode-mXXj517/zsQ

Hi Bjarte,

Bjarte Johansen wrote:
> So I won't be able to work on this before next weekend, but in the mean time
> (unless someone else has the time) I suggest that we make a list of places
> where we would like to remove flyspell overlays from. I'll start.
>
> #+STARTUP
> #+OPTIONS
> #+LATEX_CLASS
> #+LATEX_CLASS_OPTIONS
> #+LATEX_HEADER
> #+BEGIN_lstlisting
> #+END_lstlisting
> Body of lstlisting
> #+BEGIN_verbatim
> #+END_verbatim
> body of verbatim
> #+LABEL
>
> These are for the #+ blocks I can think of now. I would also like to remove
> them from \nocite{} \cite{} and \ref{} commands or make a way to cite
> without using latex commands.

I would allow fly-prog-mode in the listins, as one normally does for plain
code, no?

Best regards,
  Seb

--
Sebastien Vauban

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-30 11:44           ` Bjarte Johansen
  2012-07-31 13:56             ` Jeffrey Spencer
@ 2012-07-31 15:32             ` Bastien
  2012-07-31 15:38               ` Bjarte Johansen
  1 sibling, 1 reply; 17+ messages in thread
From: Bastien @ 2012-07-31 15:32 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: emacs-orgmode

Bjarte Johansen <bjo013@student.uib.no> writes:

> On 30 Jul, 2012, at 13:03 , Bastien <bzg@gnu.org> wrote:
>
>> I've pushed a fix which should let flyspell ignore more commonly 
>> used Org keywords.  Please test it.
>
> This works great. You forgot #+LATEX_CLASS_OPTIONS: though.

Nope.  

`org-additional-option-like-keywords-for-flyspell' contains instances
of LATEX, CLASS and OPTIONS, and those words are ont flagged by flyspell.

Can you check this?

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-31 15:10         ` Sebastien Vauban
@ 2012-07-31 15:32           ` Bastien
  2012-08-07  3:57             ` Jeffrey Spencer
  0 siblings, 1 reply; 17+ messages in thread
From: Bastien @ 2012-07-31 15:32 UTC (permalink / raw)
  To: Sebastien Vauban; +Cc: public-emacs-orgmode-mXXj517/zsQ



"Sebastien Vauban"
<wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@public.gmane.org> writes:

> I would allow fly-prog-mode in the listins, as one normally does for plain
> code, no?

This is indeed the case right now.

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-31 15:32             ` Bastien
@ 2012-07-31 15:38               ` Bjarte Johansen
  2012-07-31 16:33                 ` Bastien
  0 siblings, 1 reply; 17+ messages in thread
From: Bjarte Johansen @ 2012-07-31 15:38 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode@gnu.org


On 31 Jul, 2012, at 17:32 , Bastien <bzg@gnu.org> wrote:

> Bjarte Johansen <bjo013@student.uib.no> writes:
> 
>> On 30 Jul, 2012, at 13:03 , Bastien <bzg@gnu.org> wrote:
>> 
>>> I've pushed a fix which should let flyspell ignore more commonly 
>>> used Org keywords.  Please test it.
>> 
>> This works great. You forgot #+LATEX_CLASS_OPTIONS: though.
> 
> Nope.  
> 
> `org-additional-option-like-keywords-for-flyspell' contains instances
> of LATEX, CLASS and OPTIONS, and those words are ont flagged by flyspell.
> 
> Can you check this?
> 
> -- 
> Bastien

It seems to not work for #+LATEX_CLASS_OPTIONS, maybe because of the two _ ?

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-31 15:38               ` Bjarte Johansen
@ 2012-07-31 16:33                 ` Bastien
  0 siblings, 0 replies; 17+ messages in thread
From: Bastien @ 2012-07-31 16:33 UTC (permalink / raw)
  To: Bjarte Johansen; +Cc: emacs-orgmode@gnu.org

Bjarte Johansen <bjo013@student.uib.no> writes:

> It seems to not work for #+LATEX_CLASS_OPTIONS, maybe because of the
> two _ ?

It works for me when I use M-x flyspell-mode RET.

Can you provide a step-by-step way of reproducing the problem?

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-07-31 15:32           ` Bastien
@ 2012-08-07  3:57             ` Jeffrey Spencer
  2012-08-07  9:18               ` Bastien
  0 siblings, 1 reply; 17+ messages in thread
From: Jeffrey Spencer @ 2012-08-07  3:57 UTC (permalink / raw)
  To: Bastien; +Cc: public-emacs-orgmode-mXXj517/zsQ, Sebastien Vauban

[-- Attachment #1: Type: text/plain, Size: 430 bytes --]

Just gave this a go and seems to work well but still forgot to add I
believe:

TYP_TODO
and
ATTR_LATEX

Cheers,
Jeff

On Wed, Aug 1, 2012 at 1:32 AM, Bastien <bzg@gnu.org> wrote:

>
>
> "Sebastien Vauban"
> <wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@public.gmane.org> writes:
>
> > I would allow fly-prog-mode in the listins, as one normally does for
> plain
> > code, no?
>
> This is indeed the case right now.
>
> --
>  Bastien
>
>
>

[-- Attachment #2: Type: text/html, Size: 956 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-08-07  3:57             ` Jeffrey Spencer
@ 2012-08-07  9:18               ` Bastien
  2012-08-07 11:40                 ` Jeffrey Spencer
  0 siblings, 1 reply; 17+ messages in thread
From: Bastien @ 2012-08-07  9:18 UTC (permalink / raw)
  To: Jeffrey Spencer; +Cc: public-emacs-orgmode-mXXj517/zsQ, Sebastien Vauban



Hi Jeffrey,

Jeffrey Spencer <jeffspencerd@gmail.com> writes:

> Just gave this a go and seems to work well but still forgot to add I
> believe:
>
> TYP_TODO
> and
> ATTR_LATEX

The two words above are already skipped for me.

-- 
 Bastien

^ permalink raw reply	[flat|nested] 17+ messages in thread

* Re: More flyspell-overlays removed
  2012-08-07  9:18               ` Bastien
@ 2012-08-07 11:40                 ` Jeffrey Spencer
  0 siblings, 0 replies; 17+ messages in thread
From: Jeffrey Spencer @ 2012-08-07 11:40 UTC (permalink / raw)
  To: Bastien; +Cc: public-emacs-orgmode-mXXj517/zsQ, Sebastien Vauban

[-- Attachment #1: Type: text/plain, Size: 373 bytes --]

Re-dl'ed and works fine. Sorry about that.

On Tue, Aug 7, 2012 at 7:18 PM, Bastien <bzg@gnu.org> wrote:

> Hi Jeffrey,
>
> Jeffrey Spencer <jeffspencerd@gmail.com> writes:
>
> > Just gave this a go and seems to work well but still forgot to add I
> > believe:
> >
> > TYP_TODO
> > and
> > ATTR_LATEX
>
> The two words above are already skipped for me.
>
> --
>  Bastien
>

[-- Attachment #2: Type: text/html, Size: 813 bytes --]

^ permalink raw reply	[flat|nested] 17+ messages in thread

end of thread, other threads:[~2012-08-07 11:41 UTC | newest]

Thread overview: 17+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-07-20 20:14 More flyspell-overlays removed Bjarte Johansen
2012-07-28  9:27 ` Bastien
2012-07-28 22:38   ` Bjarte Johansen
2012-07-29  8:35     ` Jeffrey Spencer
2012-07-29 14:47       ` Bjarte Johansen
2012-07-30 11:03         ` Bastien
2012-07-30 11:13           ` Jeffrey Spencer
2012-07-30 11:44           ` Bjarte Johansen
2012-07-31 13:56             ` Jeffrey Spencer
2012-07-31 15:32             ` Bastien
2012-07-31 15:38               ` Bjarte Johansen
2012-07-31 16:33                 ` Bastien
2012-07-31 15:10         ` Sebastien Vauban
2012-07-31 15:32           ` Bastien
2012-08-07  3:57             ` Jeffrey Spencer
2012-08-07  9:18               ` Bastien
2012-08-07 11:40                 ` Jeffrey Spencer

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).