[gentoo-pms] Added explicit optional star in atoms

[gentoo-pms] Added explicit optional star in atoms

[Michael Lienhardt]

[-- Attachment #1: Type: text/plain, Size: 45 bytes --]

Dear all,

As we discussed :)

Best,
Michael

[-- Attachment #2: 0001-Added-optional-at-the-end-of-an-atom-version.patch --]
[-- Type: text/x-patch, Size: 1056 bytes --]

From 93742a696cd52d3fff5e10d4f56d9c869cbe4314 Mon Sep 17 00:00:00 2001
From: gzoumix <michael.lienhardt@laposte.net>
Date: Fri, 9 Mar 2018 01:06:44 +0100
Subject: [PATCH] Added optional '*' at the end of an atom version

---
 6/pms.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/6/pms.html b/6/pms.html
index 243a4cb..f3b23bc 100644
--- a/6/pms.html
+++ b/6/pms.html
@@ -3483,7 +3483,7 @@ class="ectt-1000">category/package </span>name.
      in section&#x00A0;<a 
 href="#x1-860008.2.6.1">8.2.6.1<!--tex4ht:ref: sec:dep-operator --></a>, followed immediately by <span 
 class="ectt-1000">category/package</span>, followed by a hyphen,
-     followed by a version specification.</li></ul>
+     followed by a version specification and optionally followed by a star symbol.</li></ul>
 <!--l. 174--><p class="noindent" >In EAPIs shown in table&#x00A0;<a 
 href="#x1-85001r4">8.4<!--tex4ht:ref: tab:slot-deps-table --></a> as supporting <span 
 class="ectt-1000">SLOT </span>dependencies, either of the above formats may
-- 
2.16.1

Re: [gentoo-pms] Added explicit optional star in atoms

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 463 bytes --]

>>>>> On Fri, 9 Mar 2018, Michael Lienhardt wrote:

> -     followed by a version specification.</li></ul>
> +     followed by a version specification and optionally followed by a star symbol.</li></ul>

That's not accurate. The asterisk is only allowed with the = operator,
but not as a general option. In fact, that exception is already
explained below in section 8.2.6.1.

Also, please apply any patches to the LaTeX source, and git
format-patch them.

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-pms] Added explicit optional star in atoms

[Michael Lienhardt]

On 09/03/2018 07:36, Ulrich Mueller wrote:
>>>>>> On Fri, 9 Mar 2018, Michael Lienhardt wrote:
> 
>> -     followed by a version specification.</li></ul>
>> +     followed by a version specification and optionally followed by a star symbol.</li></ul>
> 
> That's not accurate. The asterisk is only allowed with the = operator,
> but not as a general option. In fact, that exception is already
> explained below in section 8.2.6.1.

You are right, sorry.
However, for me, not stating that an atom can have an asterisk when describing their syntax is confusing.
If you agree, I will rephrase my patch.

> Also, please apply any patches to the LaTeX source, and git
> format-patch them.

Where is the latex source file?
I cloned git.gentoo.org/sites/projects/pms.git (as described in https://wiki.gentoo.org/wiki/Project:Infrastructure/Project_File_Hosting), and I don't see any .tex file there.
I also looked at https://dev.gentoo.org/~ulm/pms, which is different from the git repository, but I didn't see any .tex file there either.

Then, I created the patch with
$ git format-patch master -1 @
after commiting. Should I have done things differently?

Best,
Michael

Re: [gentoo-pms] Added explicit optional star in atoms

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 142 bytes --]

>>>>> On Fri, 9 Mar 2018, Michael Lienhardt wrote:

> Where is the latex source file?

https://gitweb.gentoo.org/proj/pms.git (master branch)

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-pms] Added explicit optional star in atoms

[Michael Lienhardt]

[-- Attachment #1: Type: text/plain, Size: 220 bytes --]

On 09/03/2018 11:35, Ulrich Mueller wrote:
>>>>>> On Fri, 9 Mar 2018, Michael Lienhardt wrote:
> 
>> Where is the latex source file?
> 
> https://gitweb.gentoo.org/proj/pms.git (master branch)

Thank you.

Best,
Michael

[-- Attachment #2: 0001-Added-in-main-description-of-Package-dependency-spec.patch --]
[-- Type: text/x-patch, Size: 1784 bytes --]

From ebf7fbdb62a6ade4a8a3b82394468913466afc96 Mon Sep 17 00:00:00 2001
From: gzoumix <michael.lienhardt@laposte.net>
Date: Fri, 9 Mar 2018 14:32:56 +0100
Subject: [PATCH] Added: in main description of "Package dependency
 specifications": optional asterisk at the end of an atom version

---
 dependencies.tex | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dependencies.tex b/dependencies.tex
index 093a30b..833e1f9 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -170,7 +170,7 @@ error on non-compliant input.
 \begin{compactitem}
 \item A simple \t{category/package} name.
 \item An operator, as described in section~\ref{sec:dep-operator}, followed immediately by
-    \t{category/package}, followed by a hyphen, followed by a version specification.
+    \t{category/package}, followed by a hyphen, followed by a version specification, optionally followed by an asterisk in one special case described in section~\ref{sec:dep-operator}.
 \end{compactitem}
 
 In EAPIs shown in table~\ref{tab:slot-deps-table} as supporting \t{SLOT} dependencies, either of the
@@ -224,7 +224,7 @@ The following operators are available:
 \begin{description}
 \item[\t{<}] Strictly less than the specified version.
 \item[\t{<=}] Less than or equal to the specified version.
-\item[\t{=}] Exactly equal to the specified version. Special exception: if the version specified
+\item[\t{=}] Exactly equal to the specified version. Special case: if the version specified
     has an asterisk immediately following it, then only the given number of version components
     is used for comparison, i.\,e.\ the asterisk acts as a wildcard for any further components.
     When an asterisk is used, the specification must remain valid if the asterisk were removed.
-- 
2.16.1