From: "Ionen Wolkens" <ionen@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] repo/gentoo:master commit in: x11-terms/kitty/
Date: Fri, 28 Jul 2023 01:23:52 +0000 (UTC) [thread overview]
Message-ID: <1690507407.d35084b14e388e444a473629bc040d415da8842a.ionen@gentoo> (raw)
commit: d35084b14e388e444a473629bc040d415da8842a
Author: Ionen Wolkens <ionen <AT> gentoo <DOT> org>
AuthorDate: Fri Jul 28 01:23:27 2023 +0000
Commit: Ionen Wolkens <ionen <AT> gentoo <DOT> org>
CommitDate: Fri Jul 28 01:23:27 2023 +0000
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=d35084b1
x11-terms/kitty: add 0.29.2
Signed-off-by: Ionen Wolkens <ionen <AT> gentoo.org>
x11-terms/kitty/Manifest | 3 +
x11-terms/kitty/kitty-0.29.2.ebuild | 165 ++++++++++++++++++++++++++++++++++++
2 files changed, 168 insertions(+)
diff --git a/x11-terms/kitty/Manifest b/x11-terms/kitty/Manifest
index 9c5350852e26..2d9ea594436e 100644
--- a/x11-terms/kitty/Manifest
+++ b/x11-terms/kitty/Manifest
@@ -4,3 +4,6 @@ DIST kitty-0.27.1.tar.xz.sig 566 BLAKE2B 49cb96d99c48cfe74a50191687fac269cdc3314
DIST kitty-0.29.1-vendor.tar.xz 1376632 BLAKE2B 7ac778f1687f3fcf0803ae5b993306c72797b900203609bc1f96a3a624d1b8ea3d4f8a63b4930d64e4c720b3da932daf19d03928f7233402ac3fe63576abfeab SHA512 f4bc8a3e9d23824e428beb02a09e34565d89cda4d277b0599a08a2491bc4960d4fe5fd6a4d70e3360ea88c28b786699381404629b0bf27a6190b4ef0cae81a74
DIST kitty-0.29.1.tar.xz 7809084 BLAKE2B eba6bbe0fc69184a2b73088fff2859d49d06f030128306e761c16142872ceb280b3f034e86190614e68dd0703e8e0506ad5a1d4c4dd9fa64f22c9274d45952e2 SHA512 ce09342ed3cbb0a518dde8d33606468ee5a2a164f18ff4c8addbd33b05459407d4a935b93acb0e98df8d618aa832c93f91e9ac060e7f87c1e4567484adc46c9c
DIST kitty-0.29.1.tar.xz.sig 566 BLAKE2B e7430db16603233faff10f92599962fd095ca8d5bbcf573e3fa600ec73cce7f23b9f12a299228ea53c1a04fd2f430ebc546b088f7e1b0504c44021f9fbe0ad0d SHA512 e661c1c0aba0bc0c4cde2458b27fe8aa591bd6f5510ba4fbbe881d3ea6e60c2f94bf3b2974f4f385b96d31668850eca274aadc98e96690b51e41ceddf3acad50
+DIST kitty-0.29.2-vendor.tar.xz 1377044 BLAKE2B f342c7be9bec556b9b16b0e2032ac1ec80296f791a0c55d8b0831d8e148f05e2a7e1ae7c30090c70e7da7e6ca489e5b9b013f59d35af708eff073899f345b7ac SHA512 c0e2c55b0c7ca6ad435092c1267ed1164e042cc61ebf80b298477703607ac7611170cac1918d3703669e2363756e2d805d490018e66cc5b97efecbd0e516298e
+DIST kitty-0.29.2.tar.xz 7809388 BLAKE2B 6928d79a6cc0eaac4d92ce3babbeb0a42bf1dbc92b775386b521c8399352ba77ab9828f8cfd9f40c3e4f29ae98852b6f3cb9ee1f412474ba2ef655c18d2c294d SHA512 a34d8b5bc817dd9d27f1afa190856d916576f52458ede2253655b294358b6b89b1f103acb90d8d66a494b346420ddedc9fcf1a3399f561268ded82e7b1954b06
+DIST kitty-0.29.2.tar.xz.sig 566 BLAKE2B 52fe246f3c4a74dfb62ed34b12b639858eb91aef02c872e472e1a1272268f6da2027b325dc29e260346c76bfbaa206486c6ce2f44f259d33f1ca3a0fd82150ff SHA512 ffcc63904a09148ddbf2eb761686942d1de3ce2c8c7c93b8a1c59ef704e0886bce972dd162e88de65912682233b21398970685cebbda785f7c4215f02ddbf9fd
diff --git a/x11-terms/kitty/kitty-0.29.2.ebuild b/x11-terms/kitty/kitty-0.29.2.ebuild
new file mode 100644
index 000000000000..ca29cc5189de
--- /dev/null
+++ b/x11-terms/kitty/kitty-0.29.2.ebuild
@@ -0,0 +1,165 @@
+# Copyright 1999-2023 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+PYTHON_COMPAT=( python3_{10..12} )
+inherit edo optfeature multiprocessing python-single-r1 toolchain-funcs xdg
+
+if [[ ${PV} == 9999 ]]; then
+ inherit git-r3
+ EGIT_REPO_URI="https://github.com/kovidgoyal/kitty.git"
+else
+ inherit verify-sig
+ SRC_URI="
+ https://github.com/kovidgoyal/kitty/releases/download/v${PV}/${P}.tar.xz
+ https://dev.gentoo.org/~ionen/distfiles/${P}-vendor.tar.xz
+ verify-sig? ( https://github.com/kovidgoyal/kitty/releases/download/v${PV}/${P}.tar.xz.sig )"
+ VERIFY_SIG_OPENPGP_KEY_PATH="${BROOT}/usr/share/openpgp-keys/kovidgoyal.gpg"
+ KEYWORDS="~amd64 ~arm64 ~ppc64 ~riscv ~x86"
+fi
+
+DESCRIPTION="Fast, feature-rich, GPU-based terminal"
+HOMEPAGE="https://sw.kovidgoyal.net/kitty/"
+
+LICENSE="GPL-3 ZLIB"
+LICENSE+=" Apache-2.0 BSD MIT MPL-2.0" # go
+SLOT="0"
+IUSE="+X test wayland"
+REQUIRED_USE="
+ ${PYTHON_REQUIRED_USE}
+ || ( X wayland )
+ test? ( X wayland )"
+RESTRICT="!test? ( test )"
+
+# dlopen: fontconfig,libglvnd
+RDEPEND="
+ ${PYTHON_DEPS}
+ dev-libs/openssl:=
+ media-libs/fontconfig
+ media-libs/harfbuzz:=
+ media-libs/lcms:2
+ media-libs/libglvnd[X?]
+ media-libs/libpng:=
+ net-libs/librsync:=
+ sys-apps/dbus
+ sys-libs/zlib:=
+ x11-libs/libxkbcommon[X?]
+ x11-misc/xkeyboard-config
+ ~x11-terms/kitty-shell-integration-${PV}
+ ~x11-terms/kitty-terminfo-${PV}
+ X? ( x11-libs/libX11 )
+ wayland? ( dev-libs/wayland )
+ !sci-mathematics/kissat"
+DEPEND="
+ ${RDEPEND}
+ X? (
+ x11-base/xorg-proto
+ x11-libs/libXcursor
+ x11-libs/libXi
+ x11-libs/libXinerama
+ x11-libs/libXrandr
+ )
+ wayland? ( dev-libs/wayland-protocols )"
+BDEPEND="
+ ${PYTHON_DEPS}
+ >=dev-lang/go-1.20
+ sys-libs/ncurses
+ virtual/pkgconfig
+ test? ( $(python_gen_cond_dep 'dev-python/pillow[${PYTHON_USEDEP}]') )
+ wayland? ( dev-util/wayland-scanner )"
+[[ ${PV} == 9999 ]] || BDEPEND+=" verify-sig? ( sec-keys/openpgp-keys-kovidgoyal )"
+
+QA_FLAGS_IGNORED="usr/bin/kitten" # written in Go
+
+src_unpack() {
+ if [[ ${PV} == 9999 ]]; then
+ git-r3_src_unpack
+ cd "${S}" || die
+ edo go mod vendor
+ else
+ use verify-sig &&
+ verify-sig_verify_detached "${DISTDIR}"/${P}.tar.xz{,.sig}
+ default
+ fi
+}
+
+src_prepare() {
+ default
+
+ # sed unfortunately feels easier on maintenance than patches here
+ local sedargs=(
+ -e "/num_workers =/s/=.*/= $(makeopts_jobs)/"
+ -e "s/cflags.append.*-O3.*/pass/" -e 's/-O3//'
+ -e "s/ld_flags.append('-[sw]')/pass/"
+ )
+
+ # kitty is often popular on wayland-only setups, try to allow this
+ use !X && sedargs+=( -e '/gl_libs =/s/=.*/= []/' ) #857918
+ use !X || use !wayland &&
+ sedargs+=( -e "s/'x11 wayland'/'$(usex X x11 wayland)'/" )
+
+ # skip docs for live version, missing dependencies
+ [[ ${PV} == 9999 ]] && sedargs+=( -e '/exists.*_build/,/docs(ddir)/d' )
+
+ sed -i setup.py "${sedargs[@]}" || die
+
+ local skiptests=(
+ # relies on 'who' command which doesn't detect users with pid-sandbox
+ kitty_tests/utmp.py
+ # may fail/hang depending on environment and shell initialization
+ kitty_tests/{shell_integration,ssh}.py
+ # relies on /proc/self/fd and gets confused when ran from here
+ tools/utils/tpmfile_test.go
+ )
+ use !test || rm "${skiptests[@]}" || die
+}
+
+src_compile() {
+ tc-export CC
+ local -x GOFLAGS="-p=$(makeopts_jobs) -v -x"
+ use ppc64 && [[ $(tc-endian) == big ]] || GOFLAGS+=" -buildmode=pie"
+ local -x PKGCONFIG_EXE=$(tc-getPKG_CONFIG)
+
+ local conf=(
+ --disable-link-time-optimization
+ --ignore-compiler-warnings
+ --libdir-name=$(get_libdir)
+ --shell-integration="enabled no-rc"
+ --update-check-interval=0
+ --verbose
+ )
+
+ edo "${EPYTHON}" setup.py linux-package "${conf[@]}"
+ use test && edo "${EPYTHON}" setup.py build-launcher "${conf[@]}"
+
+ rm -r linux-package/share/terminfo || die # provided by kitty-terminfo
+
+ if [[ ${PV} == 9999 ]]; then
+ mkdir -p linux-package/share/doc/${PF} || die
+ else
+ mv linux-package/share/doc/{${PN},${PF}} || die
+ fi
+
+ # generate default config as reference, command taken from docs/conf.rst
+ if ! tc-is-cross-compiler; then
+ linux-package/bin/kitty +runpy \
+ 'from kitty.config import *; print(commented_out_default_config())' \
+ > linux-package/share/doc/${PF}/kitty.conf || die
+ fi
+}
+
+src_test() {
+ KITTY_CONFIG_DIRECTORY=${T} ./test.py || die # shebang is kitty
+}
+
+src_install() {
+ edo mv linux-package "${ED}"/usr
+}
+
+pkg_postinst() {
+ xdg_pkg_postinst
+
+ optfeature "audio-based terminal bell support" media-libs/libcanberra
+ optfeature "opening links from the terminal" x11-misc/xdg-utils
+}
next reply other threads:[~2023-07-28 1:23 UTC|newest]
Thread overview: 244+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-07-28 1:23 Ionen Wolkens [this message]
-- strict thread matches above, loose matches on Subject: below --
2025-03-08 6:35 [gentoo-commits] repo/gentoo:master commit in: x11-terms/kitty/ Ionen Wolkens
2025-02-27 12:30 Ionen Wolkens
2025-02-26 20:31 Arthur Zamarin
2025-02-26 8:47 Ionen Wolkens
2025-02-13 7:14 Joonas Niilola
2025-02-13 7:14 Joonas Niilola
2025-02-10 6:30 Ionen Wolkens
2025-02-04 12:22 Ionen Wolkens
2025-02-01 9:55 Ionen Wolkens
2025-01-16 5:18 Ionen Wolkens
2025-01-16 5:18 Ionen Wolkens
2025-01-13 6:54 Joonas Niilola
2025-01-06 6:54 Joonas Niilola
2025-01-05 10:22 Ionen Wolkens
2024-12-26 5:13 Ionen Wolkens
2024-12-16 7:06 Ionen Wolkens
2024-10-30 20:00 Ionen Wolkens
2024-10-30 20:00 Ionen Wolkens
2024-10-03 16:12 Arthur Zamarin
2024-10-03 16:11 Arthur Zamarin
2024-09-27 5:33 Ionen Wolkens
2024-09-25 11:55 Joonas Niilola
2024-09-25 11:55 Joonas Niilola
2024-09-25 5:03 Ionen Wolkens
2024-09-11 10:16 Ionen Wolkens
2024-09-06 5:45 Ionen Wolkens
2024-09-06 5:45 Ionen Wolkens
2024-09-03 12:31 Ionen Wolkens
2024-08-30 14:59 Ionen Wolkens
2024-08-24 8:54 Ionen Wolkens
2024-08-17 11:25 Ionen Wolkens
2024-08-16 0:05 Ionen Wolkens
2024-07-03 6:22 Ionen Wolkens
2024-06-29 6:22 Joonas Niilola
2024-06-29 6:22 Joonas Niilola
2024-06-28 14:45 Ionen Wolkens
2024-06-22 6:04 Ionen Wolkens
2024-06-22 6:04 Ionen Wolkens
2024-06-06 13:20 Ionen Wolkens
2024-06-03 6:40 Ionen Wolkens
2024-05-31 12:16 Ionen Wolkens
2024-05-28 22:28 Ionen Wolkens
2024-05-25 11:21 Ionen Wolkens
2024-05-13 5:49 Ionen Wolkens
2024-05-12 20:25 Ionen Wolkens
2024-05-06 5:08 Joonas Niilola
2024-05-06 4:58 Joonas Niilola
2024-05-03 15:57 Ionen Wolkens
2024-05-01 23:18 Ionen Wolkens
2024-04-27 12:11 Ionen Wolkens
2024-04-19 6:49 Ionen Wolkens
2024-04-15 2:40 Ionen Wolkens
2024-04-12 7:53 Joonas Niilola
2024-04-12 7:53 Joonas Niilola
2024-04-05 11:37 Ionen Wolkens
2024-03-25 13:00 Ionen Wolkens
2024-03-25 13:00 Ionen Wolkens
2024-03-21 5:26 Ionen Wolkens
2024-03-21 5:26 Ionen Wolkens
2024-03-14 10:00 Ionen Wolkens
2024-03-14 4:35 Ionen Wolkens
2024-03-12 17:33 Ionen Wolkens
2024-03-12 17:33 Ionen Wolkens
2024-03-12 15:07 Arthur Zamarin
2024-03-04 6:56 Joonas Niilola
2024-03-04 6:45 Joonas Niilola
2024-02-25 11:32 Ionen Wolkens
2024-02-22 20:33 Arthur Zamarin
2024-02-22 6:16 Ionen Wolkens
2024-02-13 18:43 Ionen Wolkens
2024-02-13 8:05 Joonas Niilola
2024-02-13 8:05 Joonas Niilola
2024-02-12 9:15 Ionen Wolkens
2024-01-26 4:29 Ionen Wolkens
2024-01-19 6:40 Ionen Wolkens
2024-01-13 13:11 Ionen Wolkens
2023-12-05 6:52 Joonas Niilola
2023-12-05 6:52 Joonas Niilola
2023-11-21 6:35 Ionen Wolkens
2023-11-08 10:33 Ionen Wolkens
2023-11-08 10:33 Ionen Wolkens
2023-11-01 14:03 Ionen Wolkens
2023-10-25 7:58 Ionen Wolkens
2023-10-18 6:29 Joonas Niilola
2023-10-18 6:29 Joonas Niilola
2023-10-10 20:20 Ionen Wolkens
2023-10-10 20:20 Ionen Wolkens
2023-10-05 15:23 Ionen Wolkens
2023-09-18 3:51 Ionen Wolkens
2023-09-18 3:41 Ionen Wolkens
2023-08-28 11:31 Ionen Wolkens
2023-08-11 4:59 Ionen Wolkens
2023-08-10 6:23 Joonas Niilola
2023-08-10 6:23 Joonas Niilola
2023-07-30 18:05 Ionen Wolkens
2023-07-28 1:23 Ionen Wolkens
2023-07-25 5:26 Joonas Niilola
2023-07-25 5:16 Joonas Niilola
2023-07-17 7:09 Ionen Wolkens
2023-07-10 9:16 Ionen Wolkens
2023-06-16 15:35 Ionen Wolkens
2023-04-24 3:43 Ionen Wolkens
2023-04-21 10:27 Ionen Wolkens
2023-04-21 10:27 Ionen Wolkens
2023-04-16 4:08 Ionen Wolkens
2023-04-15 9:12 Ionen Wolkens
2023-04-15 9:12 Ionen Wolkens
2023-03-28 20:13 Ionen Wolkens
2023-03-25 3:19 Ionen Wolkens
2023-03-25 1:20 Ionen Wolkens
2023-03-01 15:20 Joonas Niilola
2023-02-15 6:25 Ionen Wolkens
2023-02-13 11:46 Ionen Wolkens
2023-02-08 12:32 Ionen Wolkens
2023-02-07 11:48 Ionen Wolkens
2023-02-04 1:06 Ionen Wolkens
2023-02-04 0:16 Ionen Wolkens
2023-02-03 6:15 Ionen Wolkens
2023-02-02 18:42 Ionen Wolkens
2023-01-31 13:46 Ionen Wolkens
2023-01-31 13:46 Ionen Wolkens
2023-01-20 22:48 Ionen Wolkens
2023-01-15 5:06 Ionen Wolkens
2022-11-22 20:41 Ionen Wolkens
2022-11-22 15:41 Ionen Wolkens
2022-11-22 14:39 Ionen Wolkens
2022-11-22 14:39 Ionen Wolkens
2022-11-22 14:39 Ionen Wolkens
2022-11-22 13:00 Ionen Wolkens
2022-11-19 6:36 Ionen Wolkens
2022-11-17 14:58 Ionen Wolkens
2022-11-15 3:51 Ionen Wolkens
2022-11-15 3:12 Ionen Wolkens
2022-11-07 15:59 Ionen Wolkens
2022-11-07 15:59 Ionen Wolkens
2022-11-03 22:46 Ionen Wolkens
2022-11-01 20:39 Ionen Wolkens
2022-10-27 22:19 Ionen Wolkens
2022-10-27 22:19 Ionen Wolkens
2022-10-17 8:42 Ionen Wolkens
2022-10-15 6:47 Jakov Smolić
2022-10-09 0:29 Ionen Wolkens
2022-10-07 4:38 Ionen Wolkens
2022-09-22 9:22 Ionen Wolkens
2022-09-08 18:23 Ionen Wolkens
2022-09-05 6:59 Ionen Wolkens
2022-08-29 20:26 Ionen Wolkens
2022-08-29 5:09 Ionen Wolkens
2022-08-29 5:09 Ionen Wolkens
2022-07-14 6:36 Ionen Wolkens
2022-07-11 6:33 Ionen Wolkens
2022-06-18 9:31 Ionen Wolkens
2022-06-16 13:16 Ionen Wolkens
2022-06-07 9:50 Ionen Wolkens
2022-06-07 9:50 Ionen Wolkens
2022-06-02 15:07 Ionen Wolkens
2022-05-26 6:07 Ionen Wolkens
2022-05-26 6:07 Ionen Wolkens
2022-05-26 6:07 Ionen Wolkens
2022-05-26 6:07 Ionen Wolkens
2022-05-18 15:30 Ionen Wolkens
2022-05-13 14:51 Ionen Wolkens
2022-04-11 23:20 Ionen Wolkens
2022-04-11 23:20 Ionen Wolkens
2022-04-11 23:20 Ionen Wolkens
2022-03-14 11:43 Ionen Wolkens
2022-03-14 11:43 Ionen Wolkens
2022-03-03 11:59 Ionen Wolkens
2022-03-02 10:07 Ionen Wolkens
2022-02-28 11:28 Ionen Wolkens
2022-02-28 8:27 Ionen Wolkens
2022-02-05 23:39 Ionen Wolkens
2022-02-03 11:31 Ionen Wolkens
2022-01-22 3:55 Ionen Wolkens
2022-01-13 8:06 Ionen Wolkens
2022-01-12 7:50 Georgy Yakovlev
2022-01-12 7:50 Georgy Yakovlev
2022-01-06 10:51 Ionen Wolkens
2022-01-06 9:10 Ionen Wolkens
2022-01-06 9:10 Ionen Wolkens
2022-01-06 0:10 Ionen Wolkens
2022-01-04 21:47 Ionen Wolkens
2022-01-04 18:50 Ionen Wolkens
2022-01-04 7:51 Ionen Wolkens
2022-01-04 7:51 Ionen Wolkens
2021-12-30 10:32 Ionen Wolkens
2021-11-09 13:48 Jakov Smolić
2021-11-03 6:41 Ionen Wolkens
2021-11-03 6:41 Ionen Wolkens
2021-11-03 6:41 Ionen Wolkens
2021-09-02 6:53 Joonas Niilola
2021-09-02 6:53 Joonas Niilola
2021-07-17 18:18 David Seifert
2021-07-14 6:25 Joonas Niilola
2021-03-20 8:25 Joonas Niilola
2021-02-02 13:08 Joonas Niilola
2021-01-24 1:48 Sam James
2020-12-17 17:43 Joonas Niilola
2020-11-25 7:50 Joonas Niilola
2020-09-07 8:55 David Seifert
2020-08-15 9:30 Joonas Niilola
2020-08-12 7:59 Joonas Niilola
2020-06-28 10:41 Joonas Niilola
2020-05-17 8:40 Joonas Niilola
2020-04-26 13:37 Joonas Niilola
2020-04-13 8:31 Joonas Niilola
2020-04-10 7:10 Joonas Niilola
2020-03-26 7:22 Joonas Niilola
2020-03-21 8:59 Joonas Niilola
2020-02-21 6:08 Joonas Niilola
2020-02-21 6:08 Joonas Niilola
2020-02-05 9:09 Tim Harder
2020-01-09 6:01 Joonas Niilola
2019-12-03 13:13 Joonas Niilola
2019-12-03 13:13 Joonas Niilola
2019-11-18 22:01 Tim Harder
2019-11-18 22:01 Tim Harder
2019-11-18 22:01 Tim Harder
2019-09-27 3:21 Tim Harder
2019-09-27 3:21 Tim Harder
2019-06-15 21:27 Tim Harder
2019-01-23 7:18 Tim Harder
2019-01-06 2:56 Tim Harder
2018-12-16 8:13 Tim Harder
2018-12-12 3:58 Tim Harder
2018-09-30 23:47 Tim Harder
2018-09-30 23:47 Tim Harder
2018-09-19 5:17 Tim Harder
2018-07-01 4:45 Tim Harder
2018-06-21 18:02 Tim Harder
2018-06-20 21:19 Tim Harder
2018-06-05 4:31 Tim Harder
2018-04-01 19:49 Tim Harder
2018-03-31 4:38 Tim Harder
2018-03-18 6:31 Tim Harder
2018-03-18 6:02 Tim Harder
2018-03-18 6:02 Tim Harder
2018-03-01 19:35 Tim Harder
2018-02-09 3:25 Tim Harder
2018-02-07 7:33 Tim Harder
2018-02-06 21:20 Tim Harder
2018-02-06 21:12 Tim Harder
2018-02-05 22:27 Tim Harder
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1690507407.d35084b14e388e444a473629bc040d415da8842a.ionen@gentoo \
--to=ionen@gentoo.org \
--cc=gentoo-commits@lists.gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox