Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 21 Apr 2004 10:43:05 +0000
From:      Eivind Eklund <eivind@FreeBSD.org>
To:        Alexey Dokuchaev <danfe@nsu.ru>
Cc:        ports-committers@FreeBSD.org
Subject:   Re: files/patch-* pathname separators (was Re: cvs commit: ports/games Makefile ...)
Message-ID:  <20040421104305.GB5052@FreeBSD.org>
In-Reply-To: <20040421095427.GA82398@regency.nsu.ru>
References:  <200404181922.i3IJMkTf044706@repoman.freebsd.org> <20040419032304.GA61048@regency.nsu.ru> <20040419103101.GB26102@dragon.nuxi.com> <20040419110810.GA24385@regency.nsu.ru> <20040420200903.GA6174@dragon.nuxi.com> <20040421094050.GA5052@FreeBSD.org> <20040421095427.GA82398@regency.nsu.ru>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Apr 21, 2004 at 04:54:27PM +0700, Alexey Dokuchaev wrote:
> On Wed, Apr 21, 2004 at 09:40:50AM +0000, Eivind Eklund wrote:
> > On Tue, Apr 20, 2004 at 01:09:03PM -0700, David O'Brien wrote:
> > > On Mon, Apr 19, 2004 at 06:08:10PM +0700, Alexey Dokuchaev wrote:
> > > > While particular choice for a separator is arguable, the general scheme
> > > > for patch-files is not, right?  FWIW, that was my point, not `::' vs.
> > > > whatever.
> > > > 
> > > > As a side note, I don't really see any problem with `::' or `-'.
> > > 
> > > 1. Bash escapes it so it actually becomes 4 characters.
> > >    This should not be takeing lightly -- people bitched about '%' in
> > >    patch names and they were all changed because its a magic charter for
> > >    Perforce and Perforce users could be bothered to escape it.
> > > 
> > > 2. With the file name lenths of some of our patches (greater than 80
> > >    chars) two characters, when one will do, is annoying.
> > 
> > If nobody objects, I'll add the following patch to the porters handbook
> > to avoid profileration.
> 
> Good idea.  Please suggest some evil-less chars (like `+') for
> separators, and (*begging*) discourage porters from using ``patch-xx''
> scheme, and commit your patch!

New patch suggestion:

Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.400
diff -u -r1.400 book.sgml
--- book.sgml	16 Apr 2004 15:05:32 -0000	1.400
+++ book.sgml	21 Apr 2004 10:31:08 -0000
@@ -614,10 +614,15 @@
 	  <replaceable>*</replaceable> denotes the sequence in which the
 	  patches will be applied &mdash; these are done in
 	  <emphasis>alphabetical order</emphasis>, thus <literal>aa</literal>
-	  first, <literal>ab</literal> second and so on.  If you wish,
-	  you can use names that indicate the pathnames of the files that
+	  first, <literal>ab</literal> second and so on.  If you do not need
+	  this explicit ordering, you can use names that indicate the
+	  pathnames of the files that
 	  are patched, such as <filename>patch-Imakefile</filename> or
-	  <filename>patch-src-config.h</filename>.  These files should
+	  <filename>patch-src+config.h</filename>.  These filenames are
+	  preferred when possible.  Due to issues with escaping in
+	  <command>bash</command> and <command>Perforce</command>, you should
+	  avoid using :: or % as separator in the patch filename.  The
+	  preferred separator is +.  The files should
 	  be stored in <makevar>PATCHDIR</makevar>, from where they will be
 	  automatically applied.  All patches should be relative to
 	  <makevar>WRKSRC</makevar> (generally the directory your port's

Eivind.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040421104305.GB5052>