darcs

Issue 102 darcs makefile builds documentation too much

Title darcs makefile builds documentation too much
Priority wishlist Status wont-fix
Milestone Resolved in
Superseder Nosy List darcs-devel, dmitry.kurochkin, ijones, kowey, markstos, thorkilnaur, tommy
Assigned To
Topics Documentation

Created on 2006-01-19.05:07:39 by ijones, last changed 2009-08-27.14:23:09 by admin.

Messages
msg391 (view) Author: ijones Date: 2006-01-19.05:07:37
See this Debian bug (resolved, but not nicely):
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=347564

And especially this exchange:
From: David Roundy
To: Isaac Jones
...
Date: Sat, 14 Jan 2006 16:26:25 -0500

On Sat, Jan 14, 2006 at 12:47:02PM -0800, Isaac Jones wrote:
> On 1/12/06, David Roundy <droundy@darcs.net> wrote:
> > When building darcs from a tarball, the documentation shouldn't be
> > built, since it's built during the make dist that generates the
> > tarball...
> 
> From what I can tell, the makefiles are set up such that it's impossible
> not to rebuild the documentation. I'll work on it, though.

Hmmm.  In that case the makefile is being silly, since we ship pre-built
docs in the tarball...

It looks like if you don't have hevea, htlatex or latex2html installed,
darcs just won't rebuild the html docs, so changing the build-deps to not
include any of these programs may solve the immediate problem (albeit in a
hokey manner).

> Since darcs_print.ps ultimately depends on the preproc executable,
> and since that binary is (presumably) not included in the tarball,
> when that gets rebuilt the dependencies of darcs_print.ps are
> modified and make is forced to rebuild them.

> That might not be the exact reason that the docs get rebuilt, but to
> verify the problem, just unpack the tarball, configure, and make
> darcs_print.ps... it goes through and builds everything.

Indeed, that's pretty silly.

> David, let me know if you can solve this in short order, otherwise
> I'll dig into it.

I'm afraid I won't have time for this.  There are some clever folks on
darcs-devel who might be able to work out a nice solution...
msg2357 (view) Author: markstos Date: 2008-01-07.05:26:52
ijones, 

Do you find that this still an issue for you?  I haven't noticed an annoyance
like this when building darcs myself.
msg2358 (view) Author: kowey Date: 2008-01-07.08:19:45
> Do you find that this still an issue for you?  I haven't noticed an annoyance
> like this when building darcs myself.

I believe this issue is for the packaged-up and released darcs, which
comes with documentation.  The issue would be that the makefile does
not detect this comes-with-documentation status and builds it anyway.
So it would be useful to check by doing a darcs dist and then playing
with the producted tarball.
msg8099 (view) Author: kowey Date: 2009-08-11.17:58:47
Moot now that we've switched to Cabal.
History
Date User Action Args
2006-01-19 05:07:39ijonescreate
2008-01-07 05:26:54markstossetstatus: unread -> unknown
nosy: + markstos, kowey, beschmi
messages: + msg2357
2008-01-07 05:27:05markstossetpriority: bug -> wishlist
2008-01-07 08:19:47koweysetmessages: + msg2358
2008-02-11 01:14:36markstossetstatus: unknown -> deferred
nosy: droundy, tommy, beschmi, kowey, markstos, ijones
2009-08-06 17:41:08adminsetnosy: + jast, Serware, dmitry.kurochkin, darcs-devel, zooko, dagit, mornfall, simon, thorkilnaur, - droundy, ijones
2009-08-06 20:38:20adminsetnosy: - beschmi
2009-08-10 21:42:36adminsetnosy: + ijones, - darcs-devel, zooko, jast, dagit, Serware, mornfall
2009-08-11 17:58:53koweysetstatus: deferred -> wont-fix
nosy: tommy, kowey, markstos, ijones, simon, thorkilnaur, dmitry.kurochkin
topic: + Documentation
messages: + msg8099
2009-08-25 17:54:42adminsetnosy: + darcs-devel, - simon
2009-08-27 14:23:09adminsetnosy: tommy, kowey, markstos, darcs-devel, ijones, thorkilnaur, dmitry.kurochkin