Add docs

[ci skip]

Author: typedrat

Cabal/doc/nix-local-build-overview.rst

@@ -8,7 +8,11 @@ names are only temporary until Nix-style local builds become the default.
 This is expected to happen soon. For those who do not wish to use the new
 functionality, the classic project style will not be removed immediately,
 but these legacy commands will require the usage of the ``v1-`` prefix as of
-Cabal 3.0 and will be removed in a future release.
+Cabal 3.0 and will be removed in a future release. For a future-proof
+way to use these commands in a script or tutorial that anticipates the
+possibility of another UI paradigm being devised in the future, there
+are also ``v2-`` prefixed versions that will reference the same functionality
+until such a point as it is completely removed from Cabal.
 
 Nix-style local builds combine the best of non-sandboxed and sandboxed Cabal:
 

cabal-install/changelog

@@ -1,9 +1,12 @@
 -*-change-log-*-
 
 2.4.0.0 (current development version)
-        * 'outdated' now accepts '--project-file FILE', which will look for bounds
-          from the new-style freeze file named FILE.freeze. This is only
-          available when `--new-freeze-file` has been passed.
+	* Add aliases for the "new-" commands that won't change when they
+	  lose their prefix or are eventually replaced by a third UI
+	  paradigm in the future. (#5429)
+	* 'outdated' now accepts '--project-file FILE', which will look for bounds
+	  from the new-style freeze file named FILE.freeze. This is only
+	  available when `--new-freeze-file` has been passed.
 	* 'new-repl' now accepts a '--build-depends' flag which accepts the
 	  same syntax as is used in .cabal files to add additional dependencies
 	  to the environment when developing in the REPL. It is now usable outside