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"