* possible latex export bug
@ 2008-10-02 9:15 Austin Frank
2008-10-02 15:07 ` Manish
2008-10-10 21:13 ` Carsten Dominik
0 siblings, 2 replies; 7+ messages in thread
From: Austin Frank @ 2008-10-02 9:15 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 3304 bytes --]
Hello!
I'll start by confessing up front that I've been tinkering with
different exporting functions these past few weeks, so it's possible
that the bug I'm reporting here is of my own making. I can't track it
down, so here I am, hat in hand, to ask
a) is this reproducible? and,
b) if not, any idea which functions I should look at to chase it
down?
If I have the following org file
--8<---------------cut here---------------start------------->8---
* this is a test
#+begin_latex
\mu
#+end_latex
--8<---------------cut here---------------end--------------->8---
and run org-export-as-latex, I get the following output
--8<---------------cut here---------------start------------->8---
% normal preamble stuff
% ...
\begin{document}
\maketitle
\section*{this is a test}
\mu
\end{document}
--8<---------------cut here---------------end--------------->8---
That's the correct behavior. If I use this org file
--8<---------------cut here---------------start------------->8---
* this is a test
#+begin_latex
\begin{quote}
\mu
\end{quote}
#+end_latex
--8<---------------cut here---------------end--------------->8---
and run org-export-as-latex, I get
--8<---------------cut here---------------start------------->8---
% normal preamble stuff
% ...
\begin{document}
\maketitle
\section*{this is a test}
\begin{quote}
\mu
\end{quote}
#+end_latex
\end{document}
--8<---------------cut here---------------end--------------->8---
In the second example, the #+end_latex line is not removed during
org-export-to-latex.
Possibly related, possibly unrelated, I'm also seeing that file-local
variables defined at the end of a buffer are being exported verbatim
during org-export-as-latex. This only happens in cases where the
#+end_latex is also erroneously exported.
--8<---------------cut here---------------start------------->8---
* this is a test
#+begin_latex
\begin{quote}
\mu
\end{quote}
#+end_latex
#+ Local Variables:
#+ org-export-latex-append-header: "
#+ \\usepackage{graphicx}
#+ "
#+ End:
--8<---------------cut here---------------end--------------->8---
gives
--8<---------------cut here---------------start------------->8---
% normal preamble stuff
% ...
\begin{document}
\maketitle
\begin{quote}
\mu
\end{quote}
#+end_latex
#+ Local Variables:
#+ org-export-latex-append-header: "
#+ \\usepackage{graphicx}
#+ "
#+ End:
\end{document}
--8<---------------cut here---------------end--------------->8---
This doesn't just apply to the quote environment, I've reproduced it
with other #begin/end_latex blocks that contain latex environments.
That is to say
--8<---------------cut here---------------start------------->8---
* this is a test
#+begin_latex
\begin{verbatim}
\mu
\end{verbatim}
#+end_latex
--8<---------------cut here---------------end--------------->8---
has the same problem of including the #+end_latex tag after export.
This is with Org-mode version 6.08-pre01, GNU Emacs 23.0.60.1
(powerpc-apple-darwin8.11.0, *Step 9.0) of 2008-10-01.
Can anyone reproduce this? Any debugging tips?
Thanks,
/au
--
Austin Frank
http://aufrank.net
GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
[-- Attachment #1.2: Type: application/pgp-signature, Size: 193 bytes --]
[-- Attachment #2: Type: text/plain, Size: 204 bytes --]
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: possible latex export bug
2008-10-02 9:15 possible latex export bug Austin Frank
@ 2008-10-02 15:07 ` Manish
2008-10-10 21:13 ` Carsten Dominik
1 sibling, 0 replies; 7+ messages in thread
From: Manish @ 2008-10-02 15:07 UTC (permalink / raw)
To: Austin Frank; +Cc: emacs-orgmode
On Thu, Oct 2, 2008 at 2:45 PM, Austin Frank wrote:
> Hello!
>
> I'll start by confessing up front that I've been tinkering with
> different exporting functions these past few weeks, so it's possible
> that the bug I'm reporting here is of my own making. I can't track it
> down, so here I am, hat in hand, to ask
>
> a) is this reproducible? and,
> b) if not, any idea which functions I should look at to chase it
> down?
>
> If I have the following org file
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \mu
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
> and run org-export-as-latex, I get the following output
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
>
> \begin{document}
>
> \maketitle
>
>
> \section*{this is a test}
>
>
> \mu
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> That's the correct behavior. If I use this org file
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
>
> and run org-export-as-latex, I get
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
> \begin{document}
>
> \maketitle
>
>
> \section*{this is a test}
>
>
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> In the second example, the #+end_latex line is not removed during
> org-export-to-latex.
>
> Possibly related, possibly unrelated, I'm also seeing that file-local
> variables defined at the end of a buffer are being exported verbatim
> during org-export-as-latex. This only happens in cases where the
> #+end_latex is also erroneously exported.
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> #+ Local Variables:
> #+ org-export-latex-append-header: "
> #+ \\usepackage{graphicx}
> #+ "
> #+ End:
> --8<---------------cut here---------------end--------------->8---
>
> gives
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
>
> \begin{document}
>
> \maketitle
>
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> #+ Local Variables:
> #+ org-export-latex-append-header: "
> #+ \\usepackage{graphicx}
> #+ "
> #+ End:
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> This doesn't just apply to the quote environment, I've reproduced it
> with other #begin/end_latex blocks that contain latex environments.
> That is to say
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{verbatim}
> \mu
> \end{verbatim}
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
> has the same problem of including the #+end_latex tag after export.
>
> This is with Org-mode version 6.08-pre01, GNU Emacs 23.0.60.1
> (powerpc-apple-darwin8.11.0, *Step 9.0) of 2008-10-01.
>
>
> Can anyone reproduce this? Any debugging tips?
Yes, I can reproduce the issue in both the cases.
-- Manish
GNU Emacs 22.3.1 (i386-mingw-nt5.1.2600)
Org-mode version 6.08-pre01 (commit 0ec6021)
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: possible latex export bug
2008-10-02 9:15 possible latex export bug Austin Frank
2008-10-02 15:07 ` Manish
@ 2008-10-10 21:13 ` Carsten Dominik
2008-10-13 3:56 ` Austin Frank
1 sibling, 1 reply; 7+ messages in thread
From: Carsten Dominik @ 2008-10-10 21:13 UTC (permalink / raw)
To: Austin Frank; +Cc: emacs-orgmode
Hi Austin,
I believe this bug has been fixed recently by Bastien. Could you
please check and confirm that this is the case?
Thanks.
- Carsten
On Oct 2, 2008, at 11:15 AM, Austin Frank wrote:
> Hello!
>
> I'll start by confessing up front that I've been tinkering with
> different exporting functions these past few weeks, so it's possible
> that the bug I'm reporting here is of my own making. I can't track it
> down, so here I am, hat in hand, to ask
>
> a) is this reproducible? and,
> b) if not, any idea which functions I should look at to chase it
> down?
>
> If I have the following org file
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \mu
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
> and run org-export-as-latex, I get the following output
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
>
> \begin{document}
>
> \maketitle
>
>
> \section*{this is a test}
>
>
> \mu
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> That's the correct behavior. If I use this org file
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
>
> and run org-export-as-latex, I get
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
> \begin{document}
>
> \maketitle
>
>
> \section*{this is a test}
>
>
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> In the second example, the #+end_latex line is not removed during
> org-export-to-latex.
>
> Possibly related, possibly unrelated, I'm also seeing that file-local
> variables defined at the end of a buffer are being exported verbatim
> during org-export-as-latex. This only happens in cases where the
> #+end_latex is also erroneously exported.
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> #+ Local Variables:
> #+ org-export-latex-append-header: "
> #+ \\usepackage{graphicx}
> #+ "
> #+ End:
> --8<---------------cut here---------------end--------------->8---
>
> gives
>
> --8<---------------cut here---------------start------------->8---
> % normal preamble stuff
> % ...
>
> \begin{document}
>
> \maketitle
>
> \begin{quote}
> \mu
> \end{quote}
> #+end_latex
>
> #+ Local Variables:
> #+ org-export-latex-append-header: "
> #+ \\usepackage{graphicx}
> #+ "
> #+ End:
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
> This doesn't just apply to the quote environment, I've reproduced it
> with other #begin/end_latex blocks that contain latex environments.
> That is to say
>
> --8<---------------cut here---------------start------------->8---
> * this is a test
> #+begin_latex
> \begin{verbatim}
> \mu
> \end{verbatim}
> #+end_latex
> --8<---------------cut here---------------end--------------->8---
>
> has the same problem of including the #+end_latex tag after export.
>
> This is with Org-mode version 6.08-pre01, GNU Emacs 23.0.60.1
> (powerpc-apple-darwin8.11.0, *Step 9.0) of 2008-10-01.
>
>
> Can anyone reproduce this? Any debugging tips?
>
> Thanks,
> /au
>
> --
> Austin Frank
> http://aufrank.net
> GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: possible latex export bug
2008-10-10 21:13 ` Carsten Dominik
@ 2008-10-13 3:56 ` Austin Frank
2008-10-14 18:46 ` Carsten Dominik
0 siblings, 1 reply; 7+ messages in thread
From: Austin Frank @ 2008-10-13 3:56 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 1929 bytes --]
On Fri, Oct 10 2008, Carsten Dominik wrote:
> I believe this bug has been fixed recently by Bastien. Could you
> please check and confirm that this is the case?
Carsten and Bastien--
I still get this behavior. To reproduce
1. Start emacs with emacs -Q
2. Evaluate the line
(require 'org-install)
3. Open a new file, tesing.org. Execute M-x org-mode.
4. Put the following content in testing.org
--8<---------------cut here---------------start------------->8---
* test
#+BEGIN_LATEX
\begin{verbatim}
a <- 3
\end{verbatim}
#+END_LATEX
--8<---------------cut here---------------end--------------->8---
5. Execute org-export-as-latex by C-c C-e l
6. Output is
--8<---------------cut here---------------start------------->8---
% Created 2008-10-12 Sun 23:43
\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{hyperref}
\title{testing}
\author{Austin Frank}
\date{12 October 2008}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\section{test}
\label{sec-1}
\begin{verbatim}
a <- 3
\end{verbatim}
#+END_LATEX
\end{document}
--8<---------------cut here---------------end--------------->8---
I also am seeing that file-local variables at the bottom of the file are
still exported into the latex. For now I'm assuming that it's the same
bug, but if the #+END_LATEX bug gets fixed and the other persists, I'll
file another report :)
Org-mode version 6.09a
GNU Emacs 23.0.60.1 (powerpc-apple-darwin8.11.0, *Step 9.0) of
2008-10-12
Just to be sure, I also ran
git diff origin lisp/org-exp.el
git diff origin lisp/org-export.el
and found no differences between my local copy and the copy in the
origin repository. I think that's the right way to check, but feel free
to correct me if I'm comparing things incorrectly.
Thanks,
/au
--
Austin Frank
http://aufrank.net
GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
[-- Attachment #1.2: Type: application/pgp-signature, Size: 193 bytes --]
[-- Attachment #2: Type: text/plain, Size: 204 bytes --]
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: Re: possible latex export bug
2008-10-13 3:56 ` Austin Frank
@ 2008-10-14 18:46 ` Carsten Dominik
2008-10-15 2:54 ` Austin Frank
0 siblings, 1 reply; 7+ messages in thread
From: Carsten Dominik @ 2008-10-14 18:46 UTC (permalink / raw)
To: Austin Frank; +Cc: emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 2440 bytes --]
Hi Austin,
please give it another try, I think I have fixed this problem.
- Carsten
On Oct 13, 2008, at 5:56 AM, Austin Frank wrote:
> On Fri, Oct 10 2008, Carsten Dominik wrote:
>
>> I believe this bug has been fixed recently by Bastien. Could you
>> please check and confirm that this is the case?
>
> Carsten and Bastien--
>
> I still get this behavior. To reproduce
>
> 1. Start emacs with emacs -Q
> 2. Evaluate the line
>
> (require 'org-install)
>
> 3. Open a new file, tesing.org. Execute M-x org-mode.
> 4. Put the following content in testing.org
>
> --8<---------------cut here---------------start------------->8---
>
> * test
> #+BEGIN_LATEX
> \begin{verbatim}
> a <- 3
> \end{verbatim}
> #+END_LATEX
> --8<---------------cut here---------------end--------------->8---
>
> 5. Execute org-export-as-latex by C-c C-e l
> 6. Output is
>
> --8<---------------cut here---------------start------------->8---
> % Created 2008-10-12 Sun 23:43
> \documentclass[11pt,a4paper]{article}
> \usepackage[utf8]{inputenc}
> \usepackage[T1]{fontenc}
> \usepackage{hyperref}
>
>
> \title{testing}
> \author{Austin Frank}
> \date{12 October 2008}
>
> \begin{document}
>
> \maketitle
>
> \setcounter{tocdepth}{3}
> \tableofcontents
>
>
> \section{test}
> \label{sec-1}
>
> \begin{verbatim}
> a <- 3
> \end{verbatim}
> #+END_LATEX
>
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
>
> I also am seeing that file-local variables at the bottom of the file
> are
> still exported into the latex. For now I'm assuming that it's the
> same
> bug, but if the #+END_LATEX bug gets fixed and the other persists,
> I'll
> file another report :)
>
> Org-mode version 6.09a
> GNU Emacs 23.0.60.1 (powerpc-apple-darwin8.11.0, *Step 9.0) of
> 2008-10-12
>
> Just to be sure, I also ran
>
> git diff origin lisp/org-exp.el
> git diff origin lisp/org-export.el
>
> and found no differences between my local copy and the copy in the
> origin repository. I think that's the right way to check, but feel
> free
> to correct me if I'm comparing things incorrectly.
>
> Thanks,
> /au
>
> --
> Austin Frank
> http://aufrank.net
> GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
[-- Attachment #1.2: Type: text/html, Size: 3034 bytes --]
[-- Attachment #2: Type: text/plain, Size: 204 bytes --]
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: possible latex export bug
2008-10-14 18:46 ` Carsten Dominik
@ 2008-10-15 2:54 ` Austin Frank
2008-10-15 11:06 ` Carsten Dominik
0 siblings, 1 reply; 7+ messages in thread
From: Austin Frank @ 2008-10-15 2:54 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 1621 bytes --]
On Tue, Oct 14 2008, Carsten Dominik wrote:
> Hi Austin,
>
> please give it another try, I think I have fixed this problem.
>
> - Carsten
Carsten--
Very very close! As far as I can tell, there's just one bug left with
the ordering of export operations. The problem is that a line within a
#BEGIN/END_LATEX block that starts with a + is exported as belonging to
an itemized list. My expectation is that no org formatting should be
applied inside a block that's been declared with one of
org-additional-option-like-keywords or org-edit-src-region-extra.
Bug report follows.
Thanks!
/au
Start emacs with emacs -Q
evaluate (require 'org-install)
open a new file in org mode, testing.org
enter the following content:
--8<---------------cut here---------------start------------->8---
* test
#+BEGIN_LATEX
\begin{verbatim}
a <-
+ 3
\end{verbatim}
#+END_LATEX
--8<---------------cut here---------------end--------------->8---
execute org-export-as-latex
get the following output
--8<---------------cut here---------------start------------->8---
% Created 2008-10-14 Tue 22:46
\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{hyperref}
\title{testing}
\author{Austin Frank}
\date{14 October 2008}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\section{test}
\label{sec-1}
\begin{verbatim}
a <-
\begin{itemize}
\item 3
\end{itemize}
\end{verbatim}
\end{document}
--8<---------------cut here---------------end--------------->8---
--
Austin Frank
http://aufrank.net
GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
[-- Attachment #1.2: Type: application/pgp-signature, Size: 193 bytes --]
[-- Attachment #2: Type: text/plain, Size: 204 bytes --]
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread* Re: Re: possible latex export bug
2008-10-15 2:54 ` Austin Frank
@ 2008-10-15 11:06 ` Carsten Dominik
0 siblings, 0 replies; 7+ messages in thread
From: Carsten Dominik @ 2008-10-15 11:06 UTC (permalink / raw)
To: Austin Frank; +Cc: emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 2107 bytes --]
Hi Austin,
this is now fixed as well.
Thanks for the report.
- Carsten
On Oct 15, 2008, at 4:54 AM, Austin Frank wrote:
> On Tue, Oct 14 2008, Carsten Dominik wrote:
>
>> Hi Austin,
>>
>> please give it another try, I think I have fixed this problem.
>>
>> - Carsten
>
> Carsten--
>
> Very very close! As far as I can tell, there's just one bug left with
> the ordering of export operations. The problem is that a line
> within a
> #BEGIN/END_LATEX block that starts with a + is exported as belonging
> to
> an itemized list. My expectation is that no org formatting should be
> applied inside a block that's been declared with one of
> org-additional-option-like-keywords or org-edit-src-region-extra.
>
> Bug report follows.
>
> Thanks!
> /au
>
> Start emacs with emacs -Q
>
> evaluate (require 'org-install)
>
> open a new file in org mode, testing.org
>
> enter the following content:
>
> --8<---------------cut here---------------start------------->8---
>
> * test
> #+BEGIN_LATEX
> \begin{verbatim}
> a <-
> + 3
> \end{verbatim}
> #+END_LATEX
> --8<---------------cut here---------------end--------------->8---
>
> execute org-export-as-latex
>
> get the following output
>
> --8<---------------cut here---------------start------------->8---
> % Created 2008-10-14 Tue 22:46
> \documentclass[11pt,a4paper]{article}
> \usepackage[utf8]{inputenc}
> \usepackage[T1]{fontenc}
> \usepackage{hyperref}
>
>
> \title{testing}
> \author{Austin Frank}
> \date{14 October 2008}
>
> \begin{document}
>
> \maketitle
>
> \setcounter{tocdepth}{3}
> \tableofcontents
>
>
> \section{test}
> \label{sec-1}
>
> \begin{verbatim}
> a <-
> \begin{itemize}
> \item 3
> \end{itemize}
>
> \end{verbatim}
>
>
> \end{document}
> --8<---------------cut here---------------end--------------->8---
>
>
> --
> Austin Frank
> http://aufrank.net
> GPG Public Key (D7398C2F): http://aufrank.net/personal.asc
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
[-- Attachment #1.2: Type: text/html, Size: 2781 bytes --]
[-- Attachment #2: Type: text/plain, Size: 204 bytes --]
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2008-10-15 11:06 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-10-02 9:15 possible latex export bug Austin Frank
2008-10-02 15:07 ` Manish
2008-10-10 21:13 ` Carsten Dominik
2008-10-13 3:56 ` Austin Frank
2008-10-14 18:46 ` Carsten Dominik
2008-10-15 2:54 ` Austin Frank
2008-10-15 11:06 ` Carsten Dominik
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).