7a/39be1a40272a29a8df05dc1951122779c1cc46

   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 151C3431FBF\r
   6         for <notmuch@notmuchmail.org>; Mon, 10 Mar 2014 15:41:05 -0700 (PDT)\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 nLxKSpB9EqdO for <notmuch@notmuchmail.org>;\r
  16         Mon, 10 Mar 2014 15:41:01 -0700 (PDT)\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 6EE9E431FBD\r
  19         for <notmuch@notmuchmail.org>; Mon, 10 Mar 2014 15:41:01 -0700 (PDT)\r
  20 Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
  21         by guru.guru-group.fi (Postfix) with ESMTP id F139810008C;\r
  22         Tue, 11 Mar 2014 00:40:56 +0200 (EET)\r
  23 From: Tomi Ollila <tomi.ollila@iki.fi>\r
  24 To: Jani Nikula <jani@nikula.org>, David Bremner <david@tethera.net>,\r
  25         notmuch@notmuchmail.org\r
  26 Subject: Re: [PATCH] doc: build man pages at build time, not install\r
  27 In-Reply-To: <87y50ij7y4.fsf@nikula.org>\r
  28 References: <1394449633-14737-1-git-send-email-david@tethera.net>\r
  29         <87y50ij7y4.fsf@nikula.org>\r
  30 User-Agent: Notmuch/0.17+112~g4e0c1d5 (http://notmuchmail.org) Emacs/24.3.1\r
  31         (x86_64-unknown-linux-gnu)\r
  32 X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
  33         $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
  34         !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
  35 Date: Tue, 11 Mar 2014 00:40:56 +0200\r
  36 Message-ID: <m2y50hisnb.fsf@guru.guru-group.fi>\r
  37 MIME-Version: 1.0\r
  38 Content-Type: text/plain\r
  39 X-BeenThere: notmuch@notmuchmail.org\r
  40 X-Mailman-Version: 2.1.13\r
  41 Precedence: list\r
  42 List-Id: "Use and development of the notmuch mail system."\r
  43         <notmuch.notmuchmail.org>\r
  44 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  45         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  46 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  47 List-Post: <mailto:notmuch@notmuchmail.org>\r
  48 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  49 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  50         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  51 X-List-Received-Date: Mon, 10 Mar 2014 22:41:05 -0000\r
  52 \r
  53 On Mon, Mar 10 2014, Jani Nikula <jani@nikula.org> wrote:\r
  54 \r
  55 >\r
  56 > Because build-man is a .PHONY target, it'll get done also on\r
  57 > install-man, and one still ends up with root owned files on 'sudo make\r
  58 > install'. The improvement to previous is that doc/_build/man directory\r
  59 > is now created in the build phase and the files can be removed by the\r
  60 > regular user.\r
  61 >\r
  62 > An actual non-phony dependency chain from .gz to man page to rst would\r
  63 > be awesome, but I don't know how hard it would be with the\r
  64 > sphinx/rst2man targets.\r
  65 \r
  66 instead of having the targets as .PHONY those should depend on all source\r
  67 files...\r
  68 \r
  69 ... perhaps better alternative is to have those still as .PHONY so those\r
  70 can be neat make targets, but greate new *.stamp targets that depend on\r
  71 the source files (and these *.stamp targets have the recipes)\r
  72 \r
  73 (actually, after I added the stuff below, sphinx-man doesn't need to be\r
  74 PHONY anymore).\r
  75 \r
  76 something like:\r
  77 \r
  78 sphinx-man: $(DOCBUILDDIR)/man.stamp\r
  79 \r
  80 $(DOCBUILDDIR)/man.stamp: $(MAN_SRC_FILES)\r
  81 ifeq($(HAVE_SPHINX), 1)\r
  82           $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(DOCBUILDDIR)/man\r
  83           touch $@\r
  84 else\r
  85 ifeq($(HAVE_RST2HTML), 1)\r
  86           $(prerst2man) $(DOCBUILDDIR)/.. $(DOCBUILDDIR)/man\r
  87           touch $@\r
  88 endif\r
  89 endif\r
  90 \r
  91 \r
  92 mkdocdeps.py could create $(MAN_SRC_FILES) and friends pretty easily.\r
  93 \r
  94 (sphinx-man could be changed to just 'man', and if anyone wanted to\r
  95 make manual pages from command line using rst2man that could\r
  96 work as `make man HAVE_SPHINX=0 HAVE_RST2HTML=1')\r
  97 \r
  98 \r
  99 > BR,\r
 100 > Jani.\r
 101 \r
 102 \r
 103 Tomi\r