[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Hard to read new paragraph in man page deb-origin



Hello Guillem,
On Sat, Oct 08, 2022 at 06:42:46PM +0200, Guillem Jover wrote:
> Hi!
> 
> On Sat, 2022-10-08 at 18:14:38 +0200, Helge Kreutzmann wrote:
> > while updating the German man page translation I could not really 
> > understand one paragraph, could you explain it more verbosely?
> 
> Hmm, then that probably means the English text needs to be rewritten
> or improved. Ok let me try first to explain here somewhat, and then I
> can try to update the man page:
> 
> > "The file should be named according to the vendor name.  The usual convention "
> > "is to name the vendor file using the vendor name in all lowercase, but some "
> > "variation is permitted.  Namely, non-alphanumeric characters (‘B<[^A-Za-"
> > "z0-9]>’) are mapped to dashes (‘B<->’),
> 
> > and lower-cased, as-is, lower-cased "
> > "then capitalized and capitalized (since dpkg 1.21.10).
> 
> This means that the code will try the following combinations, after
> having remapped the non-alphanum chars:
> 
>   lower-cased:                  aA-bB%Some OS → aa-bb-some-os
>   as-is:                        aA-bB%Some OS → aA-bB-Some-OS
>   lower-cased and capitalized:  aA-bB%Some OS → Aa-bb-some-os
>   capitalized:                  aA-bB%Some OS → AA-bB-Some-OS

Ok, so I understand the 2nd sentence as follows (I write it verbose):
Namely, the following variations are accepted as well:
a) non-alphanumeric characters (‘B<[^A-Za-z0-9]>’) in the vendor name 
   are mapped to dashes (‘B<->’) and all letters are lower-cased
b) the vendor name is kept as it is
c) all letters in the vendor name are lower cased and then first letter 
   is capitalized
d) all letters (?) in the vendor name are capitalized 
(since dpkg 1.21.10). 

> > In addition, for "
> > "historical and backwards compatibility, the above casing attempts will be "
> > "tried first as-is with no remapping, and then by remapping spaces to dashes "
> > "(‘B<->’). But these will be removed during the dpkg 1.22.x release cycle."
> 
> This means they will be tried then first w/o remapping as follows:
> 
>   lower-cased:                  aA-bB%Some OS → aa-bb%some os
>   as-is:                        aA-bB%Some OS → aA-bB%Some OS
>   lower-cased and capitalized:  aA-bB%Some OS → Aa-bb%some os
>   capitalized:                  aA-bB%Some OS → AA-bB%Some OS
> 
> And subsequently by only remapping spaces to dashes:
> 
>   lower-cased:                  aA-bB%Some OS → aa-bb%some-os
>   as-is:                        aA-bB%Some OS → aA-bB%Some-OS
>   lower-cased and capitalized:  aA-bB%Some OS → Aa-bb%some-os
>   capitalized:                  aA-bB%Some OS → AA-bB%Some-OS
> 
> Was the problem with just the "as-is" or how the formulation of casing
> is listed?

Your wording is sometims very terse and assigning the virtual () (i.e. 
which ands and ors belong to each other) is sometime tricky, and yes, 
the "as is" made me wonder about "remapping". But of course, a 1:1
mapping is a mapping as well'. (and the case c) I could not see from
your text alone at all).

And the third sentence thus reads (verbosely):
In addition, for historical and backwards compatibility, the above casing 
attempts will be tried in the following order:
a) First no remapping (keeping the name as is)
b) Remapping spaces to dashes (‘B<->’).

But this does not match your examples, so I guess I still haven't
understood the third sentence.

Thanks for the explanations.

Greetings

         Helge


-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

Attachment: signature.asc
Description: PGP signature


Reply to: