From da4cf989cca85022b1030e57838fa9041c2e7479 Mon Sep 17 00:00:00 2001
From: Illia Bobyr <illia.bobyr@gmail.com>
Date: Wed, 1 Oct 2025 15:51:08 -0700
Subject: [PATCH] stack.package: docs: flag enable/disable syntax

While the "List of cabal flags" implies that `+flag` and `-flag` syntax
can be used, it is somewhat subtle and requires knowledge of cabal flags
syntax.  Documenting it directly here would not hurt.
---
 extensions/stack_snapshot.bzl | 1 +
 1 file changed, 1 insertion(+)

diff --git a/extensions/stack_snapshot.bzl b/extensions/stack_snapshot.bzl
index 2dd2ace28..3e1221949 100644
--- a/extensions/stack_snapshot.bzl
+++ b/extensions/stack_snapshot.bzl
@@ -92,6 +92,7 @@ _package_tag = tag_class(
         "flags": attr.string_list(
             doc = """List of cabal flags to configure this package.
             Only usable by the root module (or rules_haskell itself).
+            For a flag called `flag1`, to enable say `flag1` or `+flag1`, to disable say `-flag1`.
             """,
         ),
         "extra_deps": attr.label_list(