From 90b6eab05a15f134a492ecebfc53a5c5e4442d8a Mon Sep 17 00:00:00 2001
From: Andrew Kelley <andrew@ziglang.org>
Date: Thu, 4 Apr 2019 01:23:41 -0400
Subject: [PATCH] docs: complete the documentation for extern struct

closes #1522
---
 doc/langref.html.in | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/langref.html.in b/doc/langref.html.in
index 4dd058c37c..091ba8ad27 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -2127,6 +2127,8 @@ test "linked list" {
       {#header_open|extern struct#}
       <p>An {#syntax#}extern struct{#endsyntax#} has in-memory layout guaranteed to match the
       C ABI for the target.</p>
+      <p>This kind of struct should only be used for compatibility with the C ABI. Every other
+      use case should be solved with {#link|packed struct#} or normal {#link|struct#}.</p>
       {#see_also|extern union|extern enum#}
       {#header_close#}