bug-standards
[Top][All Lists]
Advanced

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

Re: Mention that .sig files are handled automatically


From: Paul Smith
Subject: Re: Mention that .sig files are handled automatically
Date: Wed, 20 Sep 2017 13:34:53 -0400

On Wed, 2017-09-20 at 19:24 +0200, John Darrington wrote:
> The text you proposed confused me when I read it without the context of your 
> email.
> I propose slightly different wording:
> 
>  The .sig file may not be explicitly mentioned in a directive.   When you 
>  specify a directive to operate on a file, its corresponding .sig file will
>  be handled automatically.
> 
> What do you think?

I don't like using "may not" here because it's ambiguous: depending on
how the reader interprets it, it might mean that you could if you wanted
to, but don't have to.  I think this should be "should not" to make
clear that you shouldn't do it at all.

Otherwise it's OK with em.

On Sun, Dec 11, 2016 at 10:31:48AM -0500, Paul Smith wrote:
     When using the extra directives for uploads to archive files, I included
     the .sig files as things to be archived which led to an error.
     
     I recommend a patch similar to below, to be clear that you only need to
     include the file or directory name to be managed and not the .sig file:
     
     
     cvs diff: Diffing .
     Index: maintain.texi
     ===================================================================
     RCS file: /sources/gnustandards/gnustandards/maintain.texi,v
     retrieving revision 1.257
     diff -u -r1.257 maintain.texi
     --- maintain.texi??????????????21 Jul 2016 20:17:35 -0000????????????1.257
     +++ maintain.texi??????????????11 Dec 2016 15:28:19 -0000
     @@ -5,7 +5,7 @@
     address@hidden For double-sided printing, uncomment:
     address@hidden @setchapternewpage odd
     address@hidden This date is automagically updated when you save this file:
     address@hidden lastupdate July 21, 2016
     address@hidden lastupdate December 11, 2016
     address@hidden %**end of header
     ??
     address@hidden GNU organization
     @@ -1882,6 +1882,10 @@
     ??directive remains optional, and the @code{filename} directive is not
     ??allowed.
     ??
     +You should include only the name of the file or directory to be
     +managed in these directives: the @file{.sig} companion signature files
     +will be handled automatically for you.
     +
     ??When uploaded by itself, the name of the directive file is not
     ??important.????But it must be still be signed, using @samp{gpg
     ??--clearsign}; the resulting @file{.asc} file is what should be




reply via email to

[Prev in Thread] Current Thread [Next in Thread]