From 8a82e8e89f6eec3744f12d45c12ce05d48233d8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= <sebastian@centricular.com>
Date: Tue, 9 Jan 2018 22:58:41 +0200
Subject: [PATCH] Mention in the exact_chunks docs that this can often be
 optimized better by the compiler

And also link from the normal chunks iterator to the exact_chunks one.
---
 src/liballoc/slice.rs | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/liballoc/slice.rs b/src/liballoc/slice.rs
index 182e9b0a00ed..f8980b8777e9 100644
--- a/src/liballoc/slice.rs
+++ b/src/liballoc/slice.rs
@@ -613,6 +613,9 @@ impl<T> [T] {
     /// not divide the length of the slice, then the last chunk will
     /// not have length `chunk_size`.
     ///
+    /// See [`exact_chunks`] for a variant of this iterator that returns chunks
+    /// of always exactly `chunk_size` elements.
+    ///
     /// # Panics
     ///
     /// Panics if `chunk_size` is 0.
@@ -638,6 +641,10 @@ impl<T> [T] {
     /// not divide the length of the slice, then the last up to `chunk_size-1`
     /// elements will be omitted.
     ///
+    /// Due to each chunk having exactly `chunk_size` elements, the compiler
+    /// can often optimize the resulting code better than in the case of
+    /// [`chunks`].
+    ///
     /// # Panics
     ///
     /// Panics if `chunk_size` is 0.
@@ -664,6 +671,9 @@ impl<T> [T] {
     /// not divide the length of the slice, then the last chunk will not
     /// have length `chunk_size`.
     ///
+    /// See [`exact_chunks_mut`] for a variant of this iterator that returns chunks
+    /// of always exactly `chunk_size` elements.
+    ///
     /// # Panics
     ///
     /// Panics if `chunk_size` is 0.
@@ -693,6 +703,11 @@ impl<T> [T] {
     /// not divide the length of the slice, then the last up to `chunk_size-1`
     /// elements will be omitted.
     ///
+    ///
+    /// Due to each chunk having exactly `chunk_size` elements, the compiler
+    /// can often optimize the resulting code better than in the case of
+    /// [`chunks_mut`].
+    ///
     /// # Panics
     ///
     /// Panics if `chunk_size` is 0.