automake-patches
[Top][All Lists]
Advanced

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

[SIMPLE PATCH] {maint} Manual: be more agnostic w.r.t. version control s


From: Stefano Lattarini
Subject: [SIMPLE PATCH] {maint} Manual: be more agnostic w.r.t. version control system used.
Date: Wed, 22 Sep 2010 22:34:46 +0200
User-agent: KMail/1.13.3 (Linux/2.6.30-2-686; KDE/4.4.4; i686; ; )

* doc/automake.texi (Basics of Distribution): Also refer to `.svn'
directories as a type of probably-unwanted files that are copied
regardless when adding directories to EXTRA_DIST.
(The dist Hook): Show a dist-hook example which removes Subversion
`.svn' private directories from distdir, rather than CVS private
directories.
(missing and AM_MAINTAINER_MODE): Try to be more agnostic w.r.t.
the version control system used.
(Why doesn't Automake support wildcards): Use git rather than CVS
in the examples.
---
 ChangeLog         |   12 ++++++++++++
 doc/automake.texi |   25 +++++++++++++------------
 2 files changed, 25 insertions(+), 12 deletions(-)

From 29496b55ea862f056c61cc908971b2d2a71830e9 Mon Sep 17 00:00:00 2001
From: Stefano Lattarini <address@hidden>
Date: Wed, 22 Sep 2010 22:31:22 +0200
Subject: [PATCH] Manual: be more agnostic w.r.t. version control system used.

* doc/automake.texi (Basics of Distribution): Also refer to `.svn'
directories as a type of probably-unwanted files that are copied
regardless when adding directories to EXTRA_DIST.
(The dist Hook): Show a dist-hook example which removes Subversion
`.svn' private directories from distdir, rather than CVS private
directories.
(missing and AM_MAINTAINER_MODE): Try to be more agnostic w.r.t.
the version control system used.
(Why doesn't Automake support wildcards): Use git rather than CVS
in the examples.
---
 ChangeLog         |   12 ++++++++++++
 doc/automake.texi |   25 +++++++++++++------------
 2 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f6c7bff..6b24b7b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,17 @@
 2010-09-22  Stefano Lattarini  <address@hidden>
 
+       Manual: be more agnostic w.r.t. version control system used.
+       * doc/automake.texi (Basics of Distribution): Also refer to `.svn'
+       directories as a type of probably-unwanted files that are copied
+       regardless when adding directories to EXTRA_DIST.
+       (The dist Hook): Show a dist-hook example which removes Subversion
+       `.svn' private directories from distdir, rather than CVS private
+       directories.
+       (missing and AM_MAINTAINER_MODE): Try to be more agnostic w.r.t.
+       the version control system used.
+       (Why doesn't Automake support wildcards): Use git rather than CVS
+       in the examples.
+
        Manual: index refer to target "git-dist", not "cvs-dist".
        * doc/automake.texi (General Operation): Index the non-standard
        example about "git-dist" under the "git-dist" label, not under
diff --git a/doc/automake.texi b/doc/automake.texi
index e9b4214..9a436d8 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8246,8 +8246,8 @@ subdirectories in @code{EXTRA_DIST}.
 You can also mention a directory in @code{EXTRA_DIST}; in this case the
 entire directory will be recursively copied into the distribution.
 Please note that this will also copy @emph{everything} in the directory,
-including CVS/RCS version control files.  We recommend against using
-this feature.
+including e.g. Subversion's @file{.svn} private directories or CVS/RCS
+version control files.  We recommend against using this feature.
 
 @vindex SUBDIRS
 @vindex DIST_SUBDIRS
@@ -8308,7 +8308,7 @@ recursively included by specifying a directory in 
EXTRA_DIST:
 EXTRA_DIST = doc
 
 dist-hook:
-        rm -rf `find $(distdir)/doc -name CVS`
+        rm -rf `find $(distdir)/doc -type d -name .svn`
 @end example
 
 @vindex distdir
@@ -10534,9 +10534,10 @@ Besides the warning, when a tool is missing, 
@command{missing} will
 attempt to fix timestamps in a way that allows the build to continue.
 For instance, @command{missing} will touch @file{configure} if
 @command{autoconf} is not installed.  When all distributed files are
-kept under CVS, this feature of @command{missing} allows a user
address@hidden no maintainer tools} to build a package off CVS, bypassing
-any timestamp inconsistency implied by @samp{cvs update}.
+kept under version control, this feature of @command{missing} allows a
+user @emph{with no maintainer tools} to build a package off the version
+control repository, bypassing any timestamp inconsistency (implied by
+e.g. @samp{cvs update} or @samp{git clone}).
 
 If the required tool is installed, @command{missing} will run it and
 won't attempt to continue after failures.  This is correct during
@@ -10591,9 +10592,9 @@ swayed by Fran@,{c}ois's arguments, and got rid of
 @code{AM_MAINTAINER_MODE} in all of his packages.
 
 Still many people continue to use @code{AM_MAINTAINER_MODE}, because
-it helps them working on projects where all files are kept under CVS,
-and because @command{missing} isn't enough if you have the wrong
-version of the tools.
+it helps them working on projects where all files are kept under version
+control, and because @command{missing} isn't enough if you have the
+wrong version of the tools.
 
 
 @node Wildcards
@@ -10608,13 +10609,13 @@ a file.
 There are several objections to this:
 @itemize
 @item
-When using CVS (or similar) developers need to remember they have to
-run @samp{cvs add} or @samp{cvs rm} anyway.  Updating
+When using git (or similar) developers need to remember they have to
+run @samp{git add} or @samp{git rm} anyway.  Updating
 @file{Makefile.am} accordingly quickly becomes a reflex.
 
 Conversely, if your application doesn't compile
 because you forgot to add a file in @file{Makefile.am}, it will help
-you remember to @samp{cvs add} it.
+you remember to @samp{git add} it.
 
 @item
 Using wildcards makes it easy to distribute files by mistake.  For
-- 
1.7.1


reply via email to

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