public inbox for gcc-cvs@sourceware.org
help / color / mirror / Atom feed
* [gcc/devel/rust/master] Add feature gate for "rustc_attri".
@ 2023-02-22 7:22 Thomas Schwinge
0 siblings, 0 replies; only message in thread
From: Thomas Schwinge @ 2023-02-22 7:22 UTC (permalink / raw)
To: gcc-cvs
https://gcc.gnu.org/g:773d3c6477d7075ceeb01e4c910be24361ff6dcf
commit 773d3c6477d7075ceeb01e4c910be24361ff6dcf
Author: mxlol233 <mxlol233@outlook.com>
Date: Thu Feb 16 19:38:42 2023 +0800
Add feature gate for "rustc_attri".
This commit implemented a basic feature gate to check some attributes
for `rustc_attri`.
gcc/rust/ChangeLog:
* checks/errors/rust-feature-gate.cc: Add implementations
for `rustc_attri`.
* checks/errors/rust-feature-gate.h: Likewise.
gcc/testsuite/ChangeLog:
* rust/compile/builtin_macro_compile_error.rs: Add
crate feature `rustc_attri`.
* rust/compile/builtin_macro_concat.rs: Likewise.
* rust/compile/builtin_macro_eager1.rs: Likewise.
* rust/compile/builtin_macro_eager2.rs: Likewise.
* rust/compile/builtin_macro_env.rs: Likewise.
* rust/compile/builtin_macro_include_bytes.rs:
Likewise.
* rust/compile/builtin_macro_include_str.rs:
Likewise.
* rust/compile/builtin_macro_not_found.rs:
Likewise.
* rust/compile/builtin_macro_recurse2.rs:
Likewise.
* rust/compile/feature_rust_attri0.rs:New file.
* rust/compile/feature_rust_attri1.rs:New file.
* rust/compile/include_empty.rs:Add crate feature
`rustc_attri`.
* rust/compile/issue-1830_bytes.rs:Likewise.
* rust/compile/issue-1830_str.rs:Likewise.
* rust/compile/macro42.rs:Likewise.
* rust/execute/torture/builtin_macro_cfg.rs:
Likewise.
* rust/execute/torture/builtin_macro_concat.rs:
Likewise.
* rust/execute/torture/builtin_macro_env.rs:
Likewise.
* rust/execute/torture/builtin_macro_include_bytes.rs:
Likewise.
* rust/execute/torture/builtin_macro_include_str.rs:
Likewise.
* rust/execute/torture/builtin_macro_line.rs:
Likewise.
* rust/execute/torture/builtin_macros1.rs:
Likewise.
* rust/execute/torture/builtin_macros3.rs:
Likewise.
* rust/execute/torture/macros29.rs:Likewise.
* rust/execute/torture/macros30.rs:Likewise.
* rust/execute/torture/macros31.rs:Likewise.
Signed-off-by: Xiao Ma <mxlol233@outlook.com>
Diff:
---
gcc/rust/checks/errors/rust-feature-gate.cc | 50 ++++++++++++++++++++++
gcc/rust/checks/errors/rust-feature-gate.h | 13 +++---
.../rust/compile/builtin_macro_compile_error.rs | 2 +
gcc/testsuite/rust/compile/builtin_macro_concat.rs | 2 +
gcc/testsuite/rust/compile/builtin_macro_eager1.rs | 1 +
gcc/testsuite/rust/compile/builtin_macro_eager2.rs | 2 +
gcc/testsuite/rust/compile/builtin_macro_env.rs | 2 +
.../rust/compile/builtin_macro_include_bytes.rs | 2 +
.../rust/compile/builtin_macro_include_str.rs | 2 +
.../rust/compile/builtin_macro_not_found.rs | 2 +
.../rust/compile/builtin_macro_recurse2.rs | 1 +
gcc/testsuite/rust/compile/feature_rust_attri0.rs | 11 +++++
gcc/testsuite/rust/compile/feature_rust_attri1.rs | 13 ++++++
gcc/testsuite/rust/compile/include_empty.rs | 2 +
gcc/testsuite/rust/compile/issue-1830_bytes.rs | 2 +
gcc/testsuite/rust/compile/issue-1830_str.rs | 2 +
gcc/testsuite/rust/compile/macro42.rs | 2 +
.../rust/execute/torture/builtin_macro_cfg.rs | 2 +
.../rust/execute/torture/builtin_macro_concat.rs | 2 +
.../rust/execute/torture/builtin_macro_env.rs | 2 +
.../execute/torture/builtin_macro_include_bytes.rs | 2 +
.../execute/torture/builtin_macro_include_str.rs | 2 +
.../rust/execute/torture/builtin_macro_line.rs | 4 +-
.../rust/execute/torture/builtin_macros1.rs | 2 +
.../rust/execute/torture/builtin_macros3.rs | 2 +
gcc/testsuite/rust/execute/torture/macros29.rs | 2 +
gcc/testsuite/rust/execute/torture/macros30.rs | 2 +
gcc/testsuite/rust/execute/torture/macros31.rs | 2 +
28 files changed, 127 insertions(+), 8 deletions(-)
diff --git a/gcc/rust/checks/errors/rust-feature-gate.cc b/gcc/rust/checks/errors/rust-feature-gate.cc
index bd01b52c7ff..9b2f025689f 100644
--- a/gcc/rust/checks/errors/rust-feature-gate.cc
+++ b/gcc/rust/checks/errors/rust-feature-gate.cc
@@ -105,4 +105,54 @@ FeatureGate::visit (AST::ExternBlock &block)
}
}
+void
+FeatureGate::check_rustc_attri (const std::vector<AST::Attribute> &attributes)
+{
+ for (const AST::Attribute &attr : attributes)
+ {
+ auto name = attr.get_path ().as_string ();
+ if (name.rfind ("rustc_", 0) == 0)
+ {
+ gate (Feature::Name::RUSTC_ATTRS, attr.get_locus (),
+ "internal implementation detail");
+ }
+ }
+}
+
+void
+FeatureGate::visit (AST::MacroRulesDefinition &rules_def)
+{
+ check_rustc_attri (rules_def.get_outer_attrs ());
+}
+
+void
+FeatureGate::visit (AST::InherentImpl &impl)
+{
+ for (const auto &item : impl.get_impl_items ())
+ {
+ item->accept_vis (*this);
+ }
+}
+
+void
+FeatureGate::visit (AST::TraitImpl &impl)
+{
+ for (const auto &item : impl.get_impl_items ())
+ {
+ item->accept_vis (*this);
+ }
+}
+
+void
+FeatureGate::visit (AST::Method &method)
+{
+ check_rustc_attri (method.get_outer_attrs ());
+}
+
+void
+FeatureGate::visit (AST::Function &function)
+{
+ check_rustc_attri (function.get_outer_attrs ());
+}
+
} // namespace Rust
\ No newline at end of file
diff --git a/gcc/rust/checks/errors/rust-feature-gate.h b/gcc/rust/checks/errors/rust-feature-gate.h
index 20af14719bb..2bdf4196a37 100644
--- a/gcc/rust/checks/errors/rust-feature-gate.h
+++ b/gcc/rust/checks/errors/rust-feature-gate.h
@@ -25,8 +25,6 @@
namespace Rust {
-struct Feature;
-
class FeatureGate : public AST::ASTVisitor
{
public:
@@ -109,14 +107,14 @@ public:
void visit (AST::TypeParam ¶m) override {}
void visit (AST::LifetimeWhereClauseItem &item) override {}
void visit (AST::TypeBoundWhereClauseItem &item) override {}
- void visit (AST::Method &method) override {}
+ void visit (AST::Method &method) override;
void visit (AST::Module &module) override {}
void visit (AST::ExternCrate &crate) override {}
void visit (AST::UseTreeGlob &use_tree) override {}
void visit (AST::UseTreeList &use_tree) override {}
void visit (AST::UseTreeRebind &use_tree) override {}
void visit (AST::UseDeclaration &use_decl) override {}
- void visit (AST::Function &function) override {}
+ void visit (AST::Function &function) override;
void visit (AST::TypeAlias &type_alias) override {}
void visit (AST::StructStruct &struct_item) override {}
void visit (AST::TupleStruct &tuple_struct) override {}
@@ -133,15 +131,15 @@ public:
void visit (AST::TraitItemConst &item) override {}
void visit (AST::TraitItemType &item) override {}
void visit (AST::Trait &trait) override {}
- void visit (AST::InherentImpl &impl) override {}
- void visit (AST::TraitImpl &impl) override {}
+ void visit (AST::InherentImpl &impl) override;
+ void visit (AST::TraitImpl &impl) override;
void visit (AST::ExternalStaticItem &item) override {}
void visit (AST::ExternalFunctionItem &item) override {}
void visit (AST::ExternBlock &block) override;
void visit (AST::MacroMatchFragment &match) override {}
void visit (AST::MacroMatchRepetition &match) override {}
void visit (AST::MacroMatcher &matcher) override {}
- void visit (AST::MacroRulesDefinition &rules_def) override {}
+ void visit (AST::MacroRulesDefinition &rules_def) override;
void visit (AST::MacroInvocation ¯o_invoc) override {}
void visit (AST::MetaItemPath &meta_item) override {}
void visit (AST::MetaItemSeq &meta_item) override {}
@@ -191,6 +189,7 @@ public:
private:
void gate (Feature::Name name, Location loc, const std::string &error_msg);
+ void check_rustc_attri (const std::vector<AST::Attribute> &attributes);
std::set<Feature::Name> valid_features;
};
} // namespace Rust
diff --git a/gcc/testsuite/rust/compile/builtin_macro_compile_error.rs b/gcc/testsuite/rust/compile/builtin_macro_compile_error.rs
index 9d224406a3e..b08f67f4fe6 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_compile_error.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_compile_error.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! compile_error {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_concat.rs b/gcc/testsuite/rust/compile/builtin_macro_concat.rs
index 3b8eb2dcda7..28c84241129 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_concat.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_concat.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! concat {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_eager1.rs b/gcc/testsuite/rust/compile/builtin_macro_eager1.rs
index 0b516fd93a9..65a80fda62e 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_eager1.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_eager1.rs
@@ -1,4 +1,5 @@
// { dg-additional-options "-fdump-tree-gimple" }
+#![feature(rustc_attrs)]
#[rustc_builtin_macro]
macro_rules! concat {
diff --git a/gcc/testsuite/rust/compile/builtin_macro_eager2.rs b/gcc/testsuite/rust/compile/builtin_macro_eager2.rs
index 21bf95c7829..70a92d5b041 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_eager2.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_eager2.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! env {
() => {};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_env.rs b/gcc/testsuite/rust/compile/builtin_macro_env.rs
index 337f0ae4316..83d3c2d6b28 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_env.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_env.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! env {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_include_bytes.rs b/gcc/testsuite/rust/compile/builtin_macro_include_bytes.rs
index 38716d33bcd..9972c10b49a 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_include_bytes.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_include_bytes.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_bytes {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_include_str.rs b/gcc/testsuite/rust/compile/builtin_macro_include_str.rs
index 8092193195d..d6d7a76856f 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_include_str.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_include_str.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_str {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_not_found.rs b/gcc/testsuite/rust/compile/builtin_macro_not_found.rs
index 1a3228b9284..5ba7fc08a18 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_not_found.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_not_found.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! crabby_crab_carb { // { dg-error "cannot find a built-in macro with name .crabby_crab_carb." }
() => {{}};
diff --git a/gcc/testsuite/rust/compile/builtin_macro_recurse2.rs b/gcc/testsuite/rust/compile/builtin_macro_recurse2.rs
index d8599208624..2e73ab54fb6 100644
--- a/gcc/testsuite/rust/compile/builtin_macro_recurse2.rs
+++ b/gcc/testsuite/rust/compile/builtin_macro_recurse2.rs
@@ -1,4 +1,5 @@
// { dg-additional-options "-fdump-tree-gimple" }
+#![feature(rustc_attrs)]
#[rustc_builtin_macro]
macro_rules! concat {
diff --git a/gcc/testsuite/rust/compile/feature_rust_attri0.rs b/gcc/testsuite/rust/compile/feature_rust_attri0.rs
new file mode 100644
index 00000000000..9c11f561b5b
--- /dev/null
+++ b/gcc/testsuite/rust/compile/feature_rust_attri0.rs
@@ -0,0 +1,11 @@
+#[rustc_builtin_macro] //{ dg-error "internal implementation detail. " "" { target *-*-* } }
+macro_rules! line {
+ () => {{}};
+}
+
+fn main() -> i32 {
+ let a = line!();
+ print(a);
+
+ 0
+}
diff --git a/gcc/testsuite/rust/compile/feature_rust_attri1.rs b/gcc/testsuite/rust/compile/feature_rust_attri1.rs
new file mode 100644
index 00000000000..ec4e7d5be54
--- /dev/null
+++ b/gcc/testsuite/rust/compile/feature_rust_attri1.rs
@@ -0,0 +1,13 @@
+
+pub struct NotI8(i8);
+
+impl NotI8 {
+ #[rustc_inherit_overflow_checks] //{ dg-error "internal implementation detail" "" { target *-*-* } }
+ pub fn add(self, other: NotI8) -> NotI8 {
+ NotI8(self.0 + other.0)
+ }
+}
+
+fn main() -> i32 {
+ 0
+}
diff --git a/gcc/testsuite/rust/compile/include_empty.rs b/gcc/testsuite/rust/compile/include_empty.rs
index 28e940fa0ac..02c2d2e1855 100644
--- a/gcc/testsuite/rust/compile/include_empty.rs
+++ b/gcc/testsuite/rust/compile/include_empty.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include {
() => {};
diff --git a/gcc/testsuite/rust/compile/issue-1830_bytes.rs b/gcc/testsuite/rust/compile/issue-1830_bytes.rs
index 997d4ca0cdc..24b69334dee 100644
--- a/gcc/testsuite/rust/compile/issue-1830_bytes.rs
+++ b/gcc/testsuite/rust/compile/issue-1830_bytes.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_bytes {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/issue-1830_str.rs b/gcc/testsuite/rust/compile/issue-1830_str.rs
index fcf2dc988d3..ce4a6a94118 100644
--- a/gcc/testsuite/rust/compile/issue-1830_str.rs
+++ b/gcc/testsuite/rust/compile/issue-1830_str.rs
@@ -1,3 +1,5 @@
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_str {
() => {{}};
diff --git a/gcc/testsuite/rust/compile/macro42.rs b/gcc/testsuite/rust/compile/macro42.rs
index 52d150b82ba..b3fbf6d6eb9 100644
--- a/gcc/testsuite/rust/compile/macro42.rs
+++ b/gcc/testsuite/rust/compile/macro42.rs
@@ -1,4 +1,6 @@
// { dg-additional-options "-w -frust-cfg=A" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! cfg {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_cfg.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_cfg.rs
index a8d6ae0f7ca..92343e56612 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_cfg.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_cfg.rs
@@ -1,5 +1,7 @@
// { dg-additional-options "-w -frust-cfg=A" }
// { dg-output "A\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! cfg {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_concat.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_concat.rs
index a9d68e0cd35..2470b7559cb 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_concat.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_concat.rs
@@ -1,4 +1,6 @@
// { dg-output "\r*\ntest10btrue2.15\r*\ntest10bfalse2.151\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! concat {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_env.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_env.rs
index d64e2a00097..5bad4dee63c 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_env.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_env.rs
@@ -1,5 +1,7 @@
// { dg-output "VALUE\r*\nVALUE\r*\n" }
// { dg-set-compiler-env-var ENV_MACRO_TEST "VALUE" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! env {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_include_bytes.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_include_bytes.rs
index 8be55773036..19a1faff11c 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_include_bytes.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_include_bytes.rs
@@ -1,4 +1,6 @@
// { dg-output "104\r*\n33\r*\n1\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_bytes {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_include_str.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_include_str.rs
index 43d40c9c0df..a65639dcba1 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_include_str.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_include_str.rs
@@ -1,4 +1,6 @@
// { dg-output "hello, include!\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! include_str {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macro_line.rs b/gcc/testsuite/rust/execute/torture/builtin_macro_line.rs
index 9998de1402d..dd7dd4e5f5b 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macro_line.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macro_line.rs
@@ -1,4 +1,6 @@
-// { dg-output "18\r*\n21\r*\n" }
+// { dg-output "20\r*\n23\r*\n" }
+#![feature(rustc_attrs)]
+
extern "C" {
fn printf(fmt: *const i8, ...);
}
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macros1.rs b/gcc/testsuite/rust/execute/torture/builtin_macros1.rs
index 5bccb16e0f9..f5dcbd6423c 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macros1.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macros1.rs
@@ -1,4 +1,6 @@
// { dg-output "rust/execute/torture/builtin_macros1.rs\r*" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! file {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/builtin_macros3.rs b/gcc/testsuite/rust/execute/torture/builtin_macros3.rs
index 5a024fa0e24..85a0c6db705 100644
--- a/gcc/testsuite/rust/execute/torture/builtin_macros3.rs
+++ b/gcc/testsuite/rust/execute/torture/builtin_macros3.rs
@@ -1,4 +1,6 @@
// { dg-output "14\r*\n42\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! column {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/macros29.rs b/gcc/testsuite/rust/execute/torture/macros29.rs
index 9c2cc0e6a1b..817ac67e675 100644
--- a/gcc/testsuite/rust/execute/torture/macros29.rs
+++ b/gcc/testsuite/rust/execute/torture/macros29.rs
@@ -1,4 +1,6 @@
// { dg-output "1\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! concat {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/macros30.rs b/gcc/testsuite/rust/execute/torture/macros30.rs
index 7ec77d06982..4dd0a5531d4 100644
--- a/gcc/testsuite/rust/execute/torture/macros30.rs
+++ b/gcc/testsuite/rust/execute/torture/macros30.rs
@@ -1,4 +1,6 @@
// { dg-output "1\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! concat {
() => {{}};
diff --git a/gcc/testsuite/rust/execute/torture/macros31.rs b/gcc/testsuite/rust/execute/torture/macros31.rs
index 4c6378a68c2..0a256c36a4f 100644
--- a/gcc/testsuite/rust/execute/torture/macros31.rs
+++ b/gcc/testsuite/rust/execute/torture/macros31.rs
@@ -1,5 +1,7 @@
// { dg-additional-options "-w -frust-cfg=A" }
// { dg-output "A\r*\nB\r*\n" }
+#![feature(rustc_attrs)]
+
#[rustc_builtin_macro]
macro_rules! cfg {
() => {{}};
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2023-02-22 7:22 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-02-22 7:22 [gcc/devel/rust/master] Add feature gate for "rustc_attri" Thomas Schwinge
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).