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 (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 616B715806E for ; Mon, 5 Jun 2023 18:45:24 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 56114E0866; Mon, 5 Jun 2023 18:45:23 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 3B56AE0866 for ; Mon, 5 Jun 2023 18:45:23 +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) server-digest SHA256) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 3445F335D8D for ; Mon, 5 Jun 2023 18:45:22 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 911878DC for ; Mon, 5 Jun 2023 18:45:20 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1685365678.8db624245bc7ac34712017a70c056abe9d4a60cf.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: appendices.tex pms.bib tree-layout.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 8db624245bc7ac34712017a70c056abe9d4a60cf X-VCS-Branch: master Date: Mon, 5 Jun 2023 18:45:20 +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: 6e448a9b-0fe8-4de3-9591-2f9de40ea71d X-Archives-Hash: 8b4bb644ed890b34b7c677ffaa522028 commit: 8db624245bc7ac34712017a70c056abe9d4a60cf Author: Ulrich Müller gentoo org> AuthorDate: Mon May 29 13:07:58 2023 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Mon May 29 13:07:58 2023 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=8db62424 pms.bib: Use @techreport entry type for GLEPs This is a slightly better fit than @manual. Also, change citation keys to lowercase. Signed-off-by: Ulrich Müller gentoo.org> appendices.tex | 6 +++--- pms.bib | 35 +++++++++++++++++++++++++---------- tree-layout.tex | 2 +- 3 files changed, 29 insertions(+), 14 deletions(-) diff --git a/appendices.tex b/appendices.tex index 7a2c70b..daf9b01 100644 --- a/appendices.tex +++ b/appendices.tex @@ -3,7 +3,7 @@ The \t{metadata.xml} file is used to contain extra package- or category-level information beyond what is stored in ebuild metadata. Its exact format is strictly beyond the scope of this document, -and is described in GLEP~68~\cite{Glep68}. +and is described in GLEP~68~\cite{glep68}. \chapter{Unspecified Items} @@ -76,7 +76,7 @@ the \t{PROVIDE} metadata that it supplied certain virtuals, and the package mana in mind when handling dependencies. Old-style virtuals were supported by EAPIs 0, 1, 2, 3 and~4. They were phased out via -GLEP~37~\cite{Glep37} and finally removed in 2011. +GLEP~37~\cite{glep37} and finally removed in 2011. \note{A `new-style virtual' is a normal package that installs no files and uses its dependency requirements to pull in a `provider'. This does not require any special handling from the package @@ -87,7 +87,7 @@ The method to specify the EAPI of an ebuild used to be a shell variable assignme manager had to source the ebuild in order to determine the EAPI\@. Therefore any ebuild using a future EAPI would still have to be sourceable by old package managers, which imposed restrictions e.\,g.\ on updating the Bash version or on possible changes of global scope functions. Several -approaches to overcome this limitation were discussed, notably GLEP~55~\cite{Glep55}, which was +approaches to overcome this limitation were discussed, notably GLEP~55~\cite{glep55}, which was rejected though. The current syntax of the \t{EAPI} assignment statement (see section~\ref{sec:eapi}), allowing diff --git a/pms.bib b/pms.bib index 014b643..bef07c1 100644 --- a/pms.bib +++ b/pms.bib @@ -1,38 +1,53 @@ -@manual{Glep37, +@techreport{glep37, author = {Jason Stubbs}, - title = {{GLEP} 37: Virtuals deprecation}, + title = {Virtuals deprecation}, + type = {GLEP}, + number = 37, + institution = {Gentoo Linux}, year = 2006, month = Sep, url = {https://www.gentoo.org/glep/glep-0037.html} } -@manual{Glep44, +@techreport{glep44, author = {Marius Mauch}, - title = {{GLEP} 44: Manifest2 format}, + title = {{Manifest2} format}, + type = {GLEP}, + number = 44, + institution = {Gentoo Linux}, year = 2006, month = Sep, url = {https://www.gentoo.org/glep/glep-0044.html} } -@manual{Glep55, +@techreport{glep55, author = {Piotr Jaroszyński}, - title = {{GLEP} 55: Use {EAPI}-suffixed ebuilds}, + title = {Use {EAPI}-suffixed ebuilds}, + type = {GLEP}, + number = 55, + institution = {Gentoo Linux}, year = 2009, month = May, url = {https://www.gentoo.org/glep/glep-0055.html} } -@manual{Glep68, +@techreport{glep68, author = {Michał Górny}, - title = {{GLEP} 68: Package and category metadata}, + title = {Package and category metadata}, + type = {GLEP}, + number = 68, + institution = {Gentoo Linux}, year = 2022, month = Oct, url = {https://www.gentoo.org/glep/glep-0068.html} } -@manual{Glep74, +@techreport{glep74, author = {Michał Górny and Robin Hugh Johnson and Ulrich Müller}, - title = {{GLEP} 74: Full-tree verification using Manifest files}, + title = {Full-tree verification using {Manifest} files}, + type = {GLEP}, + number = 74, + institution = {Gentoo Linux}, year = 2022, month = Oct, url = {https://www.gentoo.org/glep/glep-0074.html} diff --git a/tree-layout.tex b/tree-layout.tex index da01ff8..99fc46a 100644 --- a/tree-layout.tex +++ b/tree-layout.tex @@ -54,7 +54,7 @@ A package directory contains the following: \item A \t{metadata.xml} file, as described in appendix~\ref{app:metadata-xml}\@. Optional only for legacy support. \item A \t{ChangeLog}, in a format determined by the provider of the repository. Optional. -\item A \t{Manifest} file, whose format is described in~\cite{Glep74}. Can be omitted if the file +\item A \t{Manifest} file, whose format is described in~\cite{glep74}. Can be omitted if the file would be empty. \item A \t{files} directory, containing any support files needed by the ebuilds. Optional. \end{compactitem} 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 (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id F2C2E1581D3 for ; Sun, 2 Jun 2024 09:57:36 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2A479E2AF0; Sun, 2 Jun 2024 09:57:36 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (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 1047BE2AEF for ; Sun, 2 Jun 2024 09:57:36 +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 3F56B340775 for ; Sun, 2 Jun 2024 09:57:35 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id A9D1D1A8D for ; Sun, 2 Jun 2024 09:57:33 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1685365678.8db624245bc7ac34712017a70c056abe9d4a60cf.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-9 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: appendices.tex pms.bib tree-layout.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 8db624245bc7ac34712017a70c056abe9d4a60cf X-VCS-Branch: eapi-9 Date: Sun, 2 Jun 2024 09:57:33 +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: cde5c5e7-9b63-4f1d-8e6e-a54d14e51837 X-Archives-Hash: f987a09465388b7377415152661c54ba Message-ID: <20240602095733.AMtLflr7KGJQTwUlQeVyTWMynSWHvzp9UVpiNM7qD1s@z> commit: 8db624245bc7ac34712017a70c056abe9d4a60cf Author: Ulrich Müller gentoo org> AuthorDate: Mon May 29 13:07:58 2023 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Mon May 29 13:07:58 2023 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=8db62424 pms.bib: Use @techreport entry type for GLEPs This is a slightly better fit than @manual. Also, change citation keys to lowercase. Signed-off-by: Ulrich Müller gentoo.org> appendices.tex | 6 +++--- pms.bib | 35 +++++++++++++++++++++++++---------- tree-layout.tex | 2 +- 3 files changed, 29 insertions(+), 14 deletions(-) diff --git a/appendices.tex b/appendices.tex index 7a2c70b..daf9b01 100644 --- a/appendices.tex +++ b/appendices.tex @@ -3,7 +3,7 @@ The \t{metadata.xml} file is used to contain extra package- or category-level information beyond what is stored in ebuild metadata. Its exact format is strictly beyond the scope of this document, -and is described in GLEP~68~\cite{Glep68}. +and is described in GLEP~68~\cite{glep68}. \chapter{Unspecified Items} @@ -76,7 +76,7 @@ the \t{PROVIDE} metadata that it supplied certain virtuals, and the package mana in mind when handling dependencies. Old-style virtuals were supported by EAPIs 0, 1, 2, 3 and~4. They were phased out via -GLEP~37~\cite{Glep37} and finally removed in 2011. +GLEP~37~\cite{glep37} and finally removed in 2011. \note{A `new-style virtual' is a normal package that installs no files and uses its dependency requirements to pull in a `provider'. This does not require any special handling from the package @@ -87,7 +87,7 @@ The method to specify the EAPI of an ebuild used to be a shell variable assignme manager had to source the ebuild in order to determine the EAPI\@. Therefore any ebuild using a future EAPI would still have to be sourceable by old package managers, which imposed restrictions e.\,g.\ on updating the Bash version or on possible changes of global scope functions. Several -approaches to overcome this limitation were discussed, notably GLEP~55~\cite{Glep55}, which was +approaches to overcome this limitation were discussed, notably GLEP~55~\cite{glep55}, which was rejected though. The current syntax of the \t{EAPI} assignment statement (see section~\ref{sec:eapi}), allowing diff --git a/pms.bib b/pms.bib index 014b643..bef07c1 100644 --- a/pms.bib +++ b/pms.bib @@ -1,38 +1,53 @@ -@manual{Glep37, +@techreport{glep37, author = {Jason Stubbs}, - title = {{GLEP} 37: Virtuals deprecation}, + title = {Virtuals deprecation}, + type = {GLEP}, + number = 37, + institution = {Gentoo Linux}, year = 2006, month = Sep, url = {https://www.gentoo.org/glep/glep-0037.html} } -@manual{Glep44, +@techreport{glep44, author = {Marius Mauch}, - title = {{GLEP} 44: Manifest2 format}, + title = {{Manifest2} format}, + type = {GLEP}, + number = 44, + institution = {Gentoo Linux}, year = 2006, month = Sep, url = {https://www.gentoo.org/glep/glep-0044.html} } -@manual{Glep55, +@techreport{glep55, author = {Piotr Jaroszyński}, - title = {{GLEP} 55: Use {EAPI}-suffixed ebuilds}, + title = {Use {EAPI}-suffixed ebuilds}, + type = {GLEP}, + number = 55, + institution = {Gentoo Linux}, year = 2009, month = May, url = {https://www.gentoo.org/glep/glep-0055.html} } -@manual{Glep68, +@techreport{glep68, author = {Michał Górny}, - title = {{GLEP} 68: Package and category metadata}, + title = {Package and category metadata}, + type = {GLEP}, + number = 68, + institution = {Gentoo Linux}, year = 2022, month = Oct, url = {https://www.gentoo.org/glep/glep-0068.html} } -@manual{Glep74, +@techreport{glep74, author = {Michał Górny and Robin Hugh Johnson and Ulrich Müller}, - title = {{GLEP} 74: Full-tree verification using Manifest files}, + title = {Full-tree verification using {Manifest} files}, + type = {GLEP}, + number = 74, + institution = {Gentoo Linux}, year = 2022, month = Oct, url = {https://www.gentoo.org/glep/glep-0074.html} diff --git a/tree-layout.tex b/tree-layout.tex index da01ff8..99fc46a 100644 --- a/tree-layout.tex +++ b/tree-layout.tex @@ -54,7 +54,7 @@ A package directory contains the following: \item A \t{metadata.xml} file, as described in appendix~\ref{app:metadata-xml}\@. Optional only for legacy support. \item A \t{ChangeLog}, in a format determined by the provider of the repository. Optional. -\item A \t{Manifest} file, whose format is described in~\cite{Glep74}. Can be omitted if the file +\item A \t{Manifest} file, whose format is described in~\cite{glep74}. Can be omitted if the file would be empty. \item A \t{files} directory, containing any support files needed by the ebuilds. Optional. \end{compactitem}