From 242e5ba87e43ace2529bd3573a693fdda9f1cb2a Mon Sep 17 00:00:00 2001
From: Taimoor Zaeem <taimoorzaeem@gmail.com>
Date: Wed, 17 Jun 2026 21:14:18 +0500
Subject: [PATCH] chore(cabal): explain performance related build flags

These flags were added in 9f97147cc3dd0052613476bce248846aeb84ecc0. Adding
a comment to clarify the use.

Signed-off-by: Taimoor Zaeem <taimoorzaeem@gmail.com>
---
 postgrest.cabal | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/postgrest.cabal b/postgrest.cabal
index f77507272..c9beb8ee2 100644
--- a/postgrest.cabal
+++ b/postgrest.cabal
@@ -179,6 +179,9 @@ library
   else
     ghc-options: -O2  
     if impl(ghc >= 9.12)
+      -- Makes GHC consider cross-module specialization for polymorphic functions
+      -- without explicitly needing to add INLINE, INLINABLE or SPECIALIZE pragmas.
+      -- Slightly increases the binary size but improves performance considerably.
       ghc-options: -fexpose-overloaded-unfoldings -fspecialise-aggressively
 
   if !os(windows)