Improve Layout::extend docs

diff --git a/src/libcore/alloc/layout.rs b/src/libcore/alloc/layout.rs
index 3881f0685d4ca28a9ee273b0eaf79b633100da0a..6200cd242667f13f3cc09e6ff31ea9f6a4276972 100644 (file)
--- a/src/libcore/alloc/layout.rs
+++ b/src/libcore/alloc/layout.rs
@@ -258,9 +258,10 @@ pub fn repeat(&self, n: usize) -> Result<(Self, usize), LayoutErr> {
 
     /// Creates a layout describing the record for `self` followed by
     /// `next`, including any necessary padding to ensure that `next`
-    /// will be properly aligned, but *no trailing padding*. In order
-    /// to match C representation layout `repr(C)`, you should call
-    /// `pad_to_align` after extending the layout with all fields.
+    /// will be properly aligned, but *no trailing padding*.
+    ///
+    /// In order to match C representation layout `repr(C)`, you should
+    /// call `pad_to_align` after extending the layout with all fields.
     /// (There is no way to match the default Rust representation
     /// layout `repr(Rust)`, as it is unspecified.)
     ///