From a21828dbffe74bcf8357248bc8b9ba7675da923d Mon Sep 17 00:00:00 2001 From: Mats Wichmann Date: Sun, 21 Feb 2021 11:07:08 -0700 Subject: Tweaks to Packaging docs [skip appveyor] [skip travis] Fixed the pointer to opensource.org to actually be a live link. Many construction vars didn't really have context - most notably the LICENSING one. It's hard to remember that while there's plenty of context in the packaging.xml doc, the consvars will be sorted separately from the builder and tool definitions, and will be sorted alphabetically. Addressed by adding reference to the Package builder, as being a cheaper fix than figuring out rewording. Where there were large sequences of cvars, added to the first one (X_RPM and X_IPK), they'll Signed-off-by: Mats Wichmann --- SCons/Tool/packaging/packaging.xml | 36 +++++++++++++++++++++++++++--------- 1 file changed, 27 insertions(+), 9 deletions(-) diff --git a/SCons/Tool/packaging/packaging.xml b/SCons/Tool/packaging/packaging.xml index 8c22503..59eb52f 100644 --- a/SCons/Tool/packaging/packaging.xml +++ b/SCons/Tool/packaging/packaging.xml @@ -26,7 +26,7 @@ See its __doc__ string for a discussion of the format. -Sets construction variables for the &b-Package; Builder. +Sets construction variables for the &b-link-Package; Builder. If this tool is enabled, the command-line option is also enabled. @@ -131,7 +131,7 @@ env.Package( SUMMARY="balalalalal", DESCRIPTION="this should be really really long", X_RPM_GROUP="Application/fu", - SOURCE_URL="http://foo.org/foo-1.2.3.tar.gz", + SOURCE_URL="https://foo.org/foo-1.2.3.tar.gz", ) @@ -142,7 +142,7 @@ since it is not under the project top directory. However, since no source is specified to the &b-Package; builder, it is selected for packaging by the default sources rule. -Since packaging is done using &cv-PACKAGEROOT;, no write is +Since packaging is done using &cv-link-PACKAGEROOT;, no write is actually done to the system's /bin directory, and the target will be selected since after rebasing to underneath &cv-PACKAGEROOT; it is now under @@ -167,6 +167,7 @@ and the BuildArch: field in the RPM .spec file, as well as forming part of the name of a generated RPM package file. +See the &b-link-Package; builder. @@ -180,6 +181,7 @@ the .wxs for MSI). If set, the function will be called after the SCons template for the file has been written. +See the &b-link-Package; builder. @@ -193,6 +195,7 @@ This is included as the section of the RPM .spec file. +See the &b-link-Package; builder. @@ -203,6 +206,7 @@ A long description of the project being packaged. This is included in the relevant section of the file that controls the packaging build. +See the &b-link-Package; builder. @@ -216,6 +220,7 @@ This is used to populate a section of an RPM .spec file. +See the &b-link-Package; builder. @@ -224,9 +229,12 @@ section of an RPM The abbreviated name, preferably the SPDX code, of the license under which this project is released (GPL-3.0, LGPL-2.1, BSD-2-Clause etc.). -See http://www.opensource.org/licenses/alphabetical +See + +http://www.opensource.org/licenses/alphabetical for a list of license names and SPDX codes. +See the &b-link-Package; builder. @@ -235,6 +243,7 @@ for a list of license names and SPDX codes. Specfies the name of the project to package. +See the &b-link-Package; builder. @@ -242,8 +251,9 @@ Specfies the name of the project to package. Specifies the directory where all files in resulting archive will be -placed if applicable. The default value is "$NAME-$VERSION". +placed if applicable. The default value is &cv-NAME;-&cv-VERSION;. +See the &b-link-Package; builder. @@ -259,6 +269,7 @@ for the builder for the currently supported types. &cv-PACKAGETYPE; may be overridden with the command line option. +See the &b-link-Package; builder. @@ -270,6 +281,7 @@ This is currently only used by the rpm packager and should reflect changes in the packaging, not the underlying project code itself. +See the &b-link-Package; builder. @@ -283,6 +295,7 @@ This is used to fill in the Source: field in the controlling information for Ipkg and RPM packages. +See the &b-link-Package; builder. @@ -297,6 +310,7 @@ and as the Description: field in MSI packages. +See the &b-link-Package; builder. @@ -311,6 +325,7 @@ and the Manufacturer: field in the controlling information for MSI packages. +See the &b-link-Package; builder. @@ -319,6 +334,7 @@ field in the controlling information for MSI packages. The version of the project, specified as a string. +See the &b-link-Package; builder. @@ -330,6 +346,7 @@ This is used to fill in the Depends: field in the controlling information for Ipkg packages. +See the &b-link-Package; builder. @@ -340,7 +357,7 @@ This is used to fill in the Description: field in the controlling information for Ipkg packages. The default value is -$SUMMARY\n$DESCRIPTION +&cv-SUMMARY;\n&cv-DESCRIPTION; @@ -375,8 +392,6 @@ field in the controlling information for Ipkg packages. - - @@ -384,6 +399,7 @@ This is used to fill in the Language: attribute in the controlling information for MSI packages. +See the &b-link-Package; builder. @@ -394,6 +410,7 @@ The text of the software license in RTF format. Carriage return characters will be replaced with the RTF equivalent \\par. +See the &b-link-Package; builder. @@ -414,6 +431,7 @@ This is used to fill in the field in the RPM .spec file. +See the &b-link-Package; builder. @@ -470,7 +488,7 @@ field in the RPM This value is used as the default attributes for the files in the RPM package. The default value is -(-,root,root). +(-,root,root). -- cgit v0.12