From 1eaa3ccd370bbded53f1b036632444a210ceed34 Mon Sep 17 00:00:00 2001
From: Fabien Chouteau <Fabien-Chouteau@users.noreply.github.com>
Date: Wed, 15 Jan 2025 17:26:16 +0100
Subject: [PATCH] win32ada 23.0.0 description (#1361)

---
 index/wi/win32ada/win32ada-23.0.0.toml | 40 ++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/index/wi/win32ada/win32ada-23.0.0.toml b/index/wi/win32ada/win32ada-23.0.0.toml
index 46b51327..0f2f09d8 100644
--- a/index/wi/win32ada/win32ada-23.0.0.toml
+++ b/index/wi/win32ada/win32ada-23.0.0.toml
@@ -1,6 +1,46 @@
 name = "win32ada"
 version = "23.0.0"
 description = "Ada API to the Windows library"
+long-description = """\
+Due to a subpar integration of Win32Ada in Alire, any project using Win32Ada
+specs must also have the Win32Ada pre-processing switches. 
+
+Do this edit your GPR project file to:
+1. With the "shared" project from Win32Ada: `with "shared.gpr";`
+2. Add the following switches for Ada: `(Shared.Prep, "-gnateG");`
+
+Here's what it looks like in an example project:
+```ada
+with "config/test_win32_config.gpr";
+
+with "shared.gpr";
+
+project Test_Win32 is
+
+   for Source_Dirs use ("src/", "config/");
+   for Object_Dir use "obj/" & Test_Win32_Config.Build_Profile;
+   for Create_Missing_Dirs use "True";
+   for Exec_Dir use "bin";
+   for Main use ("test_win32.adb");
+
+   package Compiler is
+      for Default_Switches ("Ada") use
+        Test_Win32_Config.Ada_Compiler_Switches &
+        (Shared.Prep, "-gnateG"); -- See this line here
+   end Compiler;
+
+   package Binder is
+      for Switches ("Ada") use ("-Es");
+   end Binder;
+
+   package Install is
+      for Artifacts (".") use ("share");
+   end Install;
+
+end Test_Win32;
+```
+
+"""
 website = "https://github.com/adacore/win32ada"
 authors = ["Intermetrics", "AdaCore"]
 maintainers = ["chouteau@adacore.com"]