From ca97136c7f7a8b64fd532dec667780dda4c3e491 Mon Sep 17 00:00:00 2001
From: Etienne Perot <eperot@google.com>
Date: Mon, 26 Jan 2026 11:15:55 -0800
Subject: [PATCH] Document `hostlayout` argument in `go_library` wrapper rule.

PiperOrigin-RevId: 861276126
---
 tools/defs.bzl | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tools/defs.bzl b/tools/defs.bzl
index 6e7bd75f33..49d7038c66 100644
--- a/tools/defs.bzl
+++ b/tools/defs.bzl
@@ -164,6 +164,9 @@ def go_library(name, srcs, deps = [], imports = [], stateify = True, force_add_s
       marshal: whether marshal is enabled (default: false).
       marshal_debug: whether the gomarshal tools emits debugging output (default: false).
       nogo: enable nogo analysis.
+      hostlayout: Enforce that all exported structs have
+        `structs.HostLayout` annotations (default: false).
+        Useful for ABI-type structs where bit layout matters.
       **kwargs: standard go_library arguments.
     """
     all_srcs = srcs