From a01b00faf877deab0ef3896ce655351398fe4a47 Mon Sep 17 00:00:00 2001 From: CAD97 Date: Fri, 17 Apr 2020 18:59:36 -0400 Subject: [PATCH] Clarify layout information in Layout::extend --- src/libcore/alloc/layout.rs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/libcore/alloc/layout.rs b/src/libcore/alloc/layout.rs index be62671f59f4..b2a109d1cd1d 100644 --- a/src/libcore/alloc/layout.rs +++ b/src/libcore/alloc/layout.rs @@ -258,9 +258,11 @@ impl Layout { /// 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, 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.) /// /// Note that the resulting layout will satisfy the alignment properties /// of both `self` and `next`, in order to ensure alignment of both parts.