Re: [PATCH] lib: reword comment about XFOLDER: prefix
[notmuch-archives.git] / cc / 71ae363942c68084bf3f600be1ee64fa9fd00f
1 Return-Path: <tomi.ollila@iki.fi>\r
2 X-Original-To: notmuch@notmuchmail.org\r
3 Delivered-To: notmuch@notmuchmail.org\r
4 Received: from localhost (localhost [127.0.0.1])\r
5         by olra.theworths.org (Postfix) with ESMTP id 45829431FC2\r
6         for <notmuch@notmuchmail.org>; Wed, 19 Feb 2014 12:48:04 -0800 (PST)\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
8 X-Spam-Flag: NO\r
9 X-Spam-Score: 0\r
10 X-Spam-Level: \r
11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
12         autolearn=disabled\r
13 Received: from olra.theworths.org ([127.0.0.1])\r
14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
15         with ESMTP id joXR-w6iEAcP for <notmuch@notmuchmail.org>;\r
16         Wed, 19 Feb 2014 12:47:56 -0800 (PST)\r
17 Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
18         by olra.theworths.org (Postfix) with ESMTP id 764CA431FBF\r
19         for <notmuch@notmuchmail.org>; Wed, 19 Feb 2014 12:47:56 -0800 (PST)\r
20 Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
21         by guru.guru-group.fi (Postfix) with ESMTP id 1BD8010005E;\r
22         Wed, 19 Feb 2014 22:47:50 +0200 (EET)\r
23 From: Tomi Ollila <tomi.ollila@iki.fi>\r
24 To: Austin Clements <amdragon@MIT.EDU>\r
25 Subject: Re: [PATCH 1/1] emacs: always write emacs/.eldeps when the target is\r
26         remade\r
27 In-Reply-To: <20140219195457.GD13537@mit.edu>\r
28 References: <1390645309-2326-1-git-send-email-tomi.ollila@iki.fi>\r
29         <20140213071026.GX4375@mit.edu> <m2sirn1nik.fsf@guru.guru-group.fi>\r
30         <20140213074944.GY4375@mit.edu> <m2bny9ebvk.fsf@guru.guru-group.fi>\r
31         <20140214215736.GD4375@mit.edu> <20140219195457.GD13537@mit.edu>\r
32 User-Agent: Notmuch/0.17+69~g761b031 (http://notmuchmail.org) Emacs/24.3.1\r
33         (x86_64-unknown-linux-gnu)\r
34 X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
35         $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
36         !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
37 Date: Wed, 19 Feb 2014 22:47:49 +0200\r
38 Message-ID: <m2iosade2y.fsf@guru.guru-group.fi>\r
39 MIME-Version: 1.0\r
40 Content-Type: text/plain\r
41 Cc: notmuch@notmuchmail.org\r
42 X-BeenThere: notmuch@notmuchmail.org\r
43 X-Mailman-Version: 2.1.13\r
44 Precedence: list\r
45 List-Id: "Use and development of the notmuch mail system."\r
46         <notmuch.notmuchmail.org>\r
47 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
48         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
49 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
50 List-Post: <mailto:notmuch@notmuchmail.org>\r
51 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
52 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
53         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
54 X-List-Received-Date: Wed, 19 Feb 2014 20:48:04 -0000\r
55 \r
56 On Wed, Feb 19 2014, Austin Clements <amdragon@MIT.EDU> wrote:\r
57 \r
58 > Quoth myself on Feb 14 at  4:58 pm:\r
59 >> Quoth Tomi Ollila on Feb 14 at  9:24 pm:\r
60 >> > On Thu, Feb 13 2014, Austin Clements <amdragon@MIT.EDU> wrote:\r
61 >> > \r
62 >> > > Quoth Tomi Ollila on Feb 13 at  9:26 am:\r
63 >> > >> On Thu, Feb 13 2014, Austin Clements <amdragon@MIT.EDU> wrote:\r
64 >> > >> \r
65 >> > >> > Quoth Tomi Ollila on Jan 25 at 12:21 pm:\r
66 >> > >> >> So that the target is newer than its prerequisites.\r
67 >> > >> >> ---\r
68 >> > >> >>  emacs/Makefile.local | 3 +--\r
69 >> > >> >>  1 file changed, 1 insertion(+), 2 deletions(-)\r
70 >> > >> >> \r
71 >> > >> >> diff --git a/emacs/Makefile.local b/emacs/Makefile.local\r
72 >> > >> >> index 42bfbd9..d5d402e 100644\r
73 >> > >> >> --- a/emacs/Makefile.local\r
74 >> > >> >> +++ b/emacs/Makefile.local\r
75 >> > >> >> @@ -32,8 +32,7 @@ emacs_bytecode = $(emacs_sources:.el=.elc)\r
76 >> > >> >>  ifeq ($(HAVE_EMACS),1)\r
77 >> > >> >>  $(dir)/.eldeps: $(dir)/Makefile.local $(dir)/make-deps.el $(emacs_sources)\r
78 >> > >> >>      $(call quiet,EMACS) --directory emacs -batch -l make-deps.el \\r
79 >> > >> >> -            -f batch-make-deps $(emacs_sources) > $@.tmp && \\r
80 >> > >> >> -            (cmp -s $@.tmp $@ || mv $@.tmp $@)\r
81 >> > >> >> +            -f batch-make-deps $(emacs_sources) > $@.tmp && mv $@.tmp $@\r
82 >> > >> >>  -include $(dir)/.eldeps\r
83 >> > >> >>  endif\r
84 >> > >> >>  CLEAN+=$(dir)/.eldeps $(dir)/.eldeps.tmp\r
85 >> > >> >\r
86 >> > >> > Is this just so the rule doesn't get run again on the next make\r
87 >> > >> > invocation (unless, of course, a dependent changed)?\r
88 >> > >> \r
89 >> > >> Basically yes. I did multiple builds in rapid succession when developing\r
90 >> > >> something and this thing confused me quite a lot in the beginning...\r
91 >> > >> \r
92 >> > >> > Interestingly, if any of the dependents have changed, but in ways that\r
93 >> > >> > don't affect .eldeps, this change will make the build more expensive\r
94 >> > >> > because it will trigger a make restart after .eldeps is updated.\r
95 >> > >> \r
96 >> > >> I wondered what was the reason for the recipe you've chosen here, has\r
97 >> > >> it something to do with inodes or something ;) (and were going to ask\r
98 >> > >> an alternative to touch (or even : > $@) the target...\r
99 >> > >> \r
100 >> > >> ... but now I understand. E.g. change in notmuch-lib.el will cause *all* \r
101 >> > >> .el files to be re-bytecompiled after this change. \r
102 >> > >\r
103 >> > > This is unrelated to the cmp in the recipe.  A change in\r
104 >> > > notmuch-lib.el *must* cause almost all .el files to be recompiled\r
105 >> > > because they almost all require it and may use macros from it.  If you\r
106 >> > > touch, e.g., notmuch-hello.el, you'll see that very little is rebuilt\r
107 >> > > (with or without this patch).\r
108 >> > >\r
109 >> > >> An alternative to this patch would be adding a message to the rule\r
110 >> > >> which informs user to touch .eldeps to avoid re-doing .eldeps if\r
111 >> > >> that irritates one :D\r
112 >> > >> \r
113 >> > >> something like:\r
114 >> > >> \r
115 >> > >> (cmp -s $@.tmp $@ && \\r
116 >> > >>      echo "touch $@ to avoid redoing this target" || mv $@.tmp $@)\r
117 >> > >\r
118 >> > > I think this patch is good as it is; I was just pointing out that the\r
119 >> > > change also has a performance drawback in some situations.  (Knowing\r
120 >> > > make, there's probably *some* way to get the best of both worlds and\r
121 >> > > it's probably really ugly.)\r
122 >> > \r
123 >> > Ah, now I understand, because emacs/Makefile.local includes emacs/.eldeps\r
124 >> > when it notices mtime of emacs/.eldeps changes it restarts itself...\r
125 >> > \r
126 >> > ... to compare with current behaviour:\r
127 >> > \r
128 >> > $ make\r
129 >> > ...\r
130 >> > $ touch emacs/notmuch.el\r
131 >> > $ make\r
132 >> > ...\r
133 >> > $ make\r
134 >> > Use "make V=1" to see the verbose compile lines.\r
135 >> > EMACS emacs/.eldeps\r
136 >> > make: Nothing to be done for `all'.\r
137 >> > $ make\r
138 >> > Use "make V=1" to see the verbose compile lines.\r
139 >> > EMACS emacs/.eldeps\r
140 >> > make: Nothing to be done for `all'.\r
141 >> > $ make\r
142 >> > Use "make V=1" to see the verbose compile lines.\r
143 >> > EMACS emacs/.eldeps\r
144 >> > make: Nothing to be done for `all'.\r
145 >> > \r
146 >> > It will rerun emacs -L emacs -batch -l make-deps.el -f batch-make-deps ...\r
147 >> > over and over again...\r
148 >> > \r
149 >> > I thought I figured out a solution involving .eldeps.stamp file but\r
150 >> > that turned out to be no-go... (circular dependency netween .eldeps.stamp\r
151 >> > and Makefile.local).\r
152 >> > \r
153 >> > So, with this if one edits emacs/* files and keeps building byte-compiled\r
154 >> > versions often, make will both run EMACS emacs/.eldeps and restarting\r
155 >> > -- and when moving to edit other files both of the above stops. Without\r
156 >> > this change after editing emacs/* files EMACS emacs/.eldeps will be\r
157 >> > executed until it is touched or make clean executed (I wonder how make\r
158 >> > handles rebuilding emacs/.eldeps while doing make clean ;)\r
159 >> > \r
160 >> > \r
161 >> > Tomi\r
162 >> \r
163 >> Here's a way that works, but it's more complicated than your patch and\r
164 >> doesn't seem to perform any better:\r
165 >> \r
166 >> diff --git a/emacs/Makefile.local b/emacs/Makefile.local\r
167 >> index 42bfbd9..8a1f1c2 100644\r
168 >> --- a/emacs/Makefile.local\r
169 >> +++ b/emacs/Makefile.local\r
170 >> @@ -29,14 +29,28 @@ emacs_bytecode = $(emacs_sources:.el=.elc)\r
171 >>  # the byte compiler may load an old .elc file when processing a\r
172 >>  # "require" or we may fail to rebuild a .elc that depended on a macro\r
173 >>  # from an updated file.\r
174 >> +#\r
175 >> +# We do this in two rules.  .eldeps is the "real" dependencies file\r
176 >> +# and will be rebuilt if and only if a .el source file changes.  We\r
177 >> +# could include this directly, but then whenever a .el file changed\r
178 >> +# (and .eldeps's mtime changed), make would restart immediately after\r
179 >> +# the include below.  To avoid this, we create a second file,\r
180 >> +# .eldeps.x, that we only update when its *contents* differ from\r
181 >> +# .eldeps.  .eldeps will often have an mtime older than .eldeps.x (any\r
182 >> +# .el file change that does not change dependencies will cause this),\r
183 >> +# so the .eldeps.x rule will often run, but it executes quickly and\r
184 >> +# quietly and will not trigger a make restart unless the dependencies\r
185 >> +# actually change.\r
186 >\r
187 > Here's a version of this comment that gets to the point directly:\r
188 >\r
189 > # We could include .eldeps directly, but that would cause a make\r
190 > # restart whenever any .el file was modified, even if dependencies\r
191 > # didn't change, because the mtime of .eldeps will change.  Instead,\r
192 > # we include a second file, .eldeps.x, which we ensure always has the\r
193 > # same content as .eldeps, but its mtime only changes when dependency\r
194 > # information changes, in which case a make restart is necessary\r
195 > # anyway.\r
196 \r
197 I think this behaviour is tolerable: instead of verbosely re-run emacs to\r
198 re-create .eldeps every time just to see the new .eldeps is not going to be\r
199 used we just silently re-run only lightweight cmp.\r
200 \r
201 Tomi\r
202 \r
203 >\r
204 >>  ifeq ($(HAVE_EMACS),1)\r
205 >>  $(dir)/.eldeps: $(dir)/Makefile.local $(dir)/make-deps.el $(emacs_sources)\r
206 >>      $(call quiet,EMACS) --directory emacs -batch -l make-deps.el \\r
207 >>              -f batch-make-deps $(emacs_sources) > $@.tmp && \\r
208 >> -            (cmp -s $@.tmp $@ || mv $@.tmp $@)\r
209 >> --include $(dir)/.eldeps\r
210 >> +            mv $@.tmp $@\r
211 >> +$(dir)/.eldeps.x: $(dir)/.eldeps\r
212 >> +    @cmp -s $^ $@ || cp $^ $@\r
213 >> +-include $(dir)/.eldeps.x\r
214 >>  endif\r
215 >> -CLEAN+=$(dir)/.eldeps $(dir)/.eldeps.tmp\r
216 >> +CLEAN+=$(dir)/.eldeps $(dir)/.eldeps.tmp $(dir)/.eldeps.x\r
217 >>  \r
218 >>  ifeq ($(HAVE_EMACS),1)\r
219 >>  %.elc: %.el $(global_deps)\r
220 > _______________________________________________\r
221 > notmuch mailing list\r
222 > notmuch@notmuchmail.org\r
223 > http://notmuchmail.org/mailman/listinfo/notmuch\r