Re: [gentoo-dev] [PATCH 2/3] glep-0074: Specify the format of size and checksum fields

2022-09-25 Thread Michał Górny
On Sat, 2022-09-24 at 18:09 -0500, John Helmert III wrote:
> On Fri, Sep 23, 2022 at 04:03:54PM +0200, Michał Górny wrote:
> > Signed-off-by: Michał Górny 
> > ---
> >  glep-0074.rst | 13 +
> >  1 file changed, 13 insertions(+)
> > 
> > diff --git a/glep-0074.rst b/glep-0074.rst
> > index 54bf216..bfbe092 100644
> > --- a/glep-0074.rst
> > +++ b/glep-0074.rst
> > @@ -191,6 +191,19 @@ The encoding can be used for other characters as well. 
> > In particular,
> >  escaping non-printable characters might be desirable.
> >  
> >  
> > +Size and checksum fields
> > +
> > +
> > +The Manifest entries used to describe files list the file size and one
> > +or more checksums. The size is expressed as an unsigned decimal integer.
> 
> "an unsigned decimal integer" representing the file's size in bytes
> (rather than bits, or nibbles, or $UNIT), right?
> 

Very well.  I'm afraid this is going to break some existing
implementations that preferred to measure in inches but gotta live with
it.

-- 
Best regards,
Michał Górny




Re: [gentoo-dev] [PATCH 2/3] glep-0074: Specify the format of size and checksum fields

2022-09-24 Thread John Helmert III
On Fri, Sep 23, 2022 at 04:03:54PM +0200, Michał Górny wrote:
> Signed-off-by: Michał Górny 
> ---
>  glep-0074.rst | 13 +
>  1 file changed, 13 insertions(+)
> 
> diff --git a/glep-0074.rst b/glep-0074.rst
> index 54bf216..bfbe092 100644
> --- a/glep-0074.rst
> +++ b/glep-0074.rst
> @@ -191,6 +191,19 @@ The encoding can be used for other characters as well. 
> In particular,
>  escaping non-printable characters might be desirable.
>  
>  
> +Size and checksum fields
> +
> +
> +The Manifest entries used to describe files list the file size and one
> +or more checksums. The size is expressed as an unsigned decimal integer.

"an unsigned decimal integer" representing the file's size in bytes
(rather than bits, or nibbles, or $UNIT), right?

> +The checksums are expressed using pairs of fields, with the first field
> +in every pair specifying the hash name and the second field its value.
> +The names of hashes and the encoding of their values are specified
> +in the `checksum algorithms`_ section.
> +
> +It is invalid to specify a hash name without a value.
> +
> +
>  File verification
>  -
>  
> -- 
> 2.37.3
> 
> 


signature.asc
Description: PGP signature


[gentoo-dev] [PATCH 2/3] glep-0074: Specify the format of size and checksum fields

2022-09-23 Thread Michał Górny
Signed-off-by: Michał Górny 
---
 glep-0074.rst | 13 +
 1 file changed, 13 insertions(+)

diff --git a/glep-0074.rst b/glep-0074.rst
index 54bf216..bfbe092 100644
--- a/glep-0074.rst
+++ b/glep-0074.rst
@@ -191,6 +191,19 @@ The encoding can be used for other characters as well. In 
particular,
 escaping non-printable characters might be desirable.
 
 
+Size and checksum fields
+
+
+The Manifest entries used to describe files list the file size and one
+or more checksums. The size is expressed as an unsigned decimal integer.
+The checksums are expressed using pairs of fields, with the first field
+in every pair specifying the hash name and the second field its value.
+The names of hashes and the encoding of their values are specified
+in the `checksum algorithms`_ section.
+
+It is invalid to specify a hash name without a value.
+
+
 File verification
 -
 
-- 
2.37.3