From 2a0dd9ec097fff01c765d6f02c40f7dc08e2653e Mon Sep 17 00:00:00 2001
From: Allan McRae <allan@archlinux.org>
Date: Sat, 24 Feb 2024 20:00:58 +1000
Subject: [PATCH] makepkg: move rust related documentation into the
 configuration file

Adding more and more languages will make the man page become increasingly
difficult to navigate.  Move documentation into the configuration file
where variables are defined.

Signed-off-by: Allan McRae <allan@archlinux.org>
---
 doc/makepkg.conf.5.asciidoc     |  9 ---------
 etc/makepkg.conf.d/rust.conf.in | 10 ++++++++--
 2 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/doc/makepkg.conf.5.asciidoc b/doc/makepkg.conf.5.asciidoc
index 7adf0162..a7c6f7b1 100644
--- a/doc/makepkg.conf.5.asciidoc
+++ b/doc/makepkg.conf.5.asciidoc
@@ -72,10 +72,6 @@ Options
 **CXXFLAGS=**"cxxflags"::
 	Flags used for the C++ compiler; see CFLAGS for more info.
 
-**RUSTFLAGS=**"rustflags"::
-	Flags used for the Rust compiler, similar in spirit to CFLAGS. Read
-	linkman:rustc[1] for more details on the available flags.
-
 **LDFLAGS=**"ldflags"::
 	Flags used for the linker. Several options may be specified with common
 	usage resembling ``-Wl,--hash-style=gnu''. Read ld(1) for more details on
@@ -98,11 +94,6 @@ Options
 **DEBUG_CXXFLAGS=**"debug_cxxflags"::
 	Debug flags used for the C++ compiler; see DEBUG_CFLAGS for more info.
 
-**DEBUG_RUSTFLAGS=**"debug_rustflags"::
-	Additional compiler flags appended to `RUSTFLAGS` for use in debugging.
-	Usually this would include: ``-C debuginfo=2''. Read linkman:rustc[1] for
-	more details on the available flags.
-
 **BUILDENV=(**!distcc !color !ccache check !sign**)**::
 	This array contains options that affect the build environment; the defaults
 	are shown here. All options should always be left in the array; to enable
diff --git a/etc/makepkg.conf.d/rust.conf.in b/etc/makepkg.conf.d/rust.conf.in
index 003be6a9..0b1cc6d9 100644
--- a/etc/makepkg.conf.d/rust.conf.in
+++ b/etc/makepkg.conf.d/rust.conf.in
@@ -6,6 +6,12 @@
 #########################################################################
 # RUST LANGUAGE SUPPORT
 #########################################################################
-#
-#RUSTFLAGS="-C opt-level=2"
+
+# Flags used for the Rust compiler, similar in spirit to CFLAGS. Read
+# linkman:rustc[1] for more details on the available flags.
+#RUSTFLAGS="-C opt-level=3"
+
+# Additional compiler flags appended to `RUSTFLAGS` for use in debugging.
+# Usually this would include: ``-C debuginfo=2''. Read linkman:rustc[1] for
+# more details on the available flags.
 #DEBUG_RUSTFLAGS="-C debuginfo=2"