CVS commit: pkgsrc/lang/rust

["Greg Troxel" <gdt%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   gdt
Date:           Mon Oct 23 17:10:23 UTC 2023

Added Files:
        pkgsrc/lang/rust: README.md

Log Message:
lang/rust: Document maintenance plan

as floated on tech-pkg without objections.


To generate a diff of this commit:
cvs rdiff -u -r0 -r1.1 pkgsrc/lang/rust/README.md

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Added files:

Index: pkgsrc/lang/rust/README.md
diff -u /dev/null pkgsrc/lang/rust/README.md:1.1
--- /dev/null   Mon Oct 23 17:10:23 2023
+++ pkgsrc/lang/rust/README.md  Mon Oct 23 17:10:23 2023
@@ -0,0 +1,38 @@
+# Rust Maintenance Plan
+
+$NetBSD: README.md,v 1.1 2023/10/23 17:10:23 gdt Exp $
+
+This file describes a plan for maintaining rust.  It's logically like
+comments in the Makefile.
+
+# Plan
+
+Generally, pkgsrc will update to each minor version (1.x) of rust in
+sequence, to enable people to bisect if they have to, and to reduce
+pain towards a future, even if theoretical, get-well plan for perhaps
+reproducible and from-source build chains.  (It might be that a
+version is only in for a few days.)
+
+pkgsrc will in general update rust and rust-bin at the same time.
+
+There will be platforms where rust or rust-bin won't work, because
+forward progress and no lossage are obviously incompatible in
+practice, at least for now.  We (currently, will evolve) insist on
+x86, i386, aarch64, earmv7hf-el working, would really like to see
+sparc64 and earmv7hf-el, and hope for powerpc, riscv64, mipsel.  See
+https://cdn.netbsd.org/pub/pkgsrc/distfiles/LOCAL_PORTS/rust/
+for status.
+
+We will try to stage each update in wip, so that people can test
+before it is committed.  These will be wip/rust1NN and wip/rust1NN-bin,
+so that N and N+1 can coexist if the 2nd version is being packaged
+before pkgsrc is updated to the first.
+
+
+# Goals
+
+We will attempt to document the bootstrap process such that people who
+are not rust experts but have the hardware (or have set up an
+
+Document the testing plan.  Attempt to minimize work while maximizing
+safety.