refactor: reorganize cabal.project files

- Improve the consistency across the stage cabal.project files by using the same ordering and delimiter comments
- "package-dbs: clear, global" is the default so it's removed

Author: andreabedini

.gitignore

@@ -232,9 +232,6 @@ GIT_COMMIT_ID
 .bash_history
 .gitconfig
 
-# Should be equal to testdir_suffix from testsuite/driver/testlib.py.
-*.run
-
 # -----------------------------------------------------------------------------
 # ghc.nix
 ghc.nix/

cabal.project.rts

@@ -0,0 +1,51 @@
+-- NOTE: Yes. The strings have to be escaped like this.
+ 
+package rts
+  ghc-options: "-optc-DProjectVersion=\"914\""
+  ghc-options: "-optc-DBuildPlatform=\"FIXME\""
+  ghc-options: "-optc-DBuildArch=\"FIXME\""
+  ghc-options: "-optc-DBuildOS=\"FIXME\""
+  ghc-options: "-optc-DBuildVendor=\"FIXME\""
+  ghc-options: "-optc-DGhcUnregisterised=\"FIXME\""
+  ghc-options: "-optc-DTablesNextToCode=\"FIXME\""
+  ghc-options: "-optc-DFS_NAMESPACE=rts"
+  ghc-options: -no-rts
+  flags: +tables-next-to-code
+
+if os(linux)
+  package rts
+    ghc-options: "-optc-DHostArch=\"x86_64\""
+    ghc-options: "-optc-DHostOS=\"linux\""
+    ghc-options: "-optc-DHostPlatform=\"x86_64-unknown-linux\""
+    ghc-options: "-optc-DHostVendor=\"unknown\""
+
+if os(darwin)
+  package rts
+    ghc-options: "-optc-DHostArch=\"aarch64\""
+    ghc-options: "-optc-DHostOS=\"darwin\""
+    ghc-options: "-optc-DHostPlatform=\"aarch64-apple-darwin\""
+    ghc-options: "-optc-DHostVendor=\"unknown\""
+    flags: +leading-underscore
+
+if os(freebsd)
+  package rts
+    ghc-options: "-optc-DHostArch=\"x86_64\""
+    ghc-options: "-optc-DHostOS=\"freebsd\""
+    ghc-options: "-optc-DHostPlatform=\"x86_64-portbld-freebsd\""
+    ghc-options: "-optc-DHostVendor=\"unknown\""
+
+if os(wasi)
+  package rts
+    ghc-options: "-optc-DHostArch=\"wasm32\""
+    ghc-options: "-optc-DHostOS=\"unknown\""
+    ghc-options: "-optc-DHostPlatform=\"wasm32-wasi\""
+    ghc-options: "-optc-DHostVendor=\"unknown\""
+    ghc-options: -optl-Wl,--export-dynamic
+    ghc-options: -optc-fvisibility=default
+    ghc-options: -optc-fvisibility-inlines-hidden
+
+package rts-headers
+  ghc-options: -no-rts
+
+package rts-fs
+  ghc-options: -no-rts

cabal.project.stage1

@@ -1,4 +1,7 @@
 index-state: 2025-10-26T19:17:08Z
+allow-boot-library-installs: True
+benchmarks: False
+tests: False
 
 packages:
   -- NOTE: we need rts-headers, because the _newly_ built compiler depends
@@ -10,39 +13,51 @@ packages:
   rts-headers
   rts-fs
 
-  -- other packages.
+  -- Compiler
   ghc
   compiler
-  libraries/directory
-  libraries/file-io
-  libraries/filepath
-  libraries/ghc-platform
+
+  -- Internal libraries
   libraries/ghc-boot
   libraries/ghc-boot-th-next
   libraries/ghc-heap
+  libraries/ghc-platform
   libraries/ghci
   libraries/libffi-clib
+
+  -- Internal tools
+  utils/deriveConstants
+  utils/genapply
+  utils/genprimopcode
+  utils/ghc-pkg
+  utils/ghc-toolchain
+  utils/ghc-toolchain/exe
+  utils/unlit
+
+  -- The following are packages available on Hackage but included as submodules
+  libraries/Cabal/Cabal
+  libraries/Cabal/Cabal-syntax
+  libraries/directory
+  libraries/file-io
+  libraries/filepath
   libraries/os-string
   libraries/process
   libraries/semaphore-compat
---  libraries/time
   libraries/unix
   libraries/Win32
-  libraries/Cabal/Cabal-syntax
-  libraries/Cabal/Cabal
-  utils/ghc-pkg
   utils/hsc2hs
-  utils/unlit
-  utils/genprimopcode
-  utils/genapply
-  utils/deriveConstants
-  utils/ghc-toolchain
-  utils/ghc-toolchain/exe
 
 
-benchmarks: False
-tests: False
-allow-boot-library-installs: True
+--
+-- Constraints
+--
+
+constraints:
+  template-haskell <= 2.22
+
+--
+-- Package level configuration
+--
 
 package *
   library-vanilla: True
@@ -67,8 +82,9 @@ package ghc-boot-th-next
 package hsc2hs
   flags: +in-ghc-tree
 
-constraints:
-  template-haskell <= 2.22
+--
+-- Program options
+--
 
 program-options
   ghc-options: -fhide-source-paths -j