From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 504851581F3 for ; Tue, 26 Nov 2024 01:45:07 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EC356E085A; Tue, 26 Nov 2024 01:45:05 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id C5F63E0858 for ; Tue, 26 Nov 2024 01:45:05 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id A0041343003 for ; Tue, 26 Nov 2024 01:45:04 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id E4D8A1F64 for ; Tue, 26 Nov 2024 01:45:01 +0000 (UTC) From: "Maciej Barć" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Maciej Barć" Message-ID: <1732585497.19097e3b12aef083f542c88bafe01303f5d61fbf.xgqt@gentoo> Subject: [gentoo-commits] repo/gentoo:master commit in: eclass/ X-VCS-Repository: repo/gentoo X-VCS-Files: eclass/nuget.eclass X-VCS-Directories: eclass/ X-VCS-Committer: xgqt X-VCS-Committer-Name: Maciej Barć X-VCS-Revision: 19097e3b12aef083f542c88bafe01303f5d61fbf X-VCS-Branch: master Date: Tue, 26 Nov 2024 01:45:01 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 4d0b9f01-0064-4d4a-ba29-b0f496aacadc X-Archives-Hash: 476e232e4a4338459ae22ac6258cbc23 commit: 19097e3b12aef083f542c88bafe01303f5d61fbf Author: Maciej Barć gentoo org> AuthorDate: Wed Nov 20 21:43:10 2024 +0000 Commit: Maciej Barć gentoo 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ć 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: