commit:     19097e3b12aef083f542c88bafe01303f5d61fbf
Author:     Maciej Barć <xgqt <AT> gentoo <DOT> org>
AuthorDate: Wed Nov 20 21:43:10 2024 +0000
Commit:     Maciej Barć <xgqt <AT> gentoo <DOT> org>
CommitDate: Tue Nov 26 01:44:57 2024 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=19097e3b

eclass/nuget: add eclassdoc that describes how to generate the NUGETS list

Some users asked for it. Also add a link to the Gentoo Wiki with more
specific examples.

Signed-off-by: Maciej Barć <xgqt <AT> gentoo.org>

 eclass/nuget.eclass | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/eclass/nuget.eclass b/eclass/nuget.eclass
index 4efbeb909f43..3fa732e79b5f 100644
--- a/eclass/nuget.eclass
+++ b/eclass/nuget.eclass
@@ -71,6 +71,21 @@ export NUGET_PACKAGES
 # @DESCRIPTION:
 # String containing all NuGet packages that need to be downloaded.
 #
+# To generate the "NUGETS" list use the "gdmt restore" tool from the
+# "dev-dotnet/gentoo-dotnet-maintainer-tools" package. To see all "gdmt 
restore"
+# options invoke it with the "--help" flag. The Gentoo Wiki page
+# Dotnet/Devguide (https://wiki.gentoo.org/wiki/Dotnet/Devguide) contains some
+# examples and special cases to be beware of.
+#
+# Generally you will want to invoke "gdmt restore" form within a (clean) tagged
+# checkout of a given .NET-based project. The invocation will look something
+# like this: gdmt restore --sdk-ver SDK-VER --cache "$(pwd)/.cache" --project 
PROJECT
+# Where:
+#   * "SDK-VER" is a .NET version (6.0, 8.0), mind the full version, "8" is 
not allowed,
+#   * "PROJECT" is a given project file (.csproj or .fsproj) or a directory 
containing it.
+# So, for example:
+# gdmt restore --sdk-ver 8.0 --cache "$(pwd)/.cache" --project 
src/App/App.csproj
+#
 # Used by "_nuget_uris".
 #
 # Example:

Reply via email to