9a/e15d133f8e7331c7caec921bcbae81bf20b209

   1 Return-Path: <jani@nikula.org>\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 256BB431FBD\r
   6         for <notmuch@notmuchmail.org>; Mon, 10 Mar 2014 10:10:41 -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.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] 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 amRXs8506vUa for <notmuch@notmuchmail.org>;\r
  16         Mon, 10 Mar 2014 10:10:33 -0700 (PDT)\r
  17 Received: from mail-lb0-f172.google.com (mail-lb0-f172.google.com\r
  18         [209.85.217.172]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 978E3431FBC\r
  21         for <notmuch@notmuchmail.org>; Mon, 10 Mar 2014 10:10:33 -0700 (PDT)\r
  22 Received: by mail-lb0-f172.google.com with SMTP id c11so4810706lbj.17\r
  23         for <notmuch@notmuchmail.org>; Mon, 10 Mar 2014 10:10:30 -0700 (PDT)\r
  24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25         d=1e100.net; s=20130820;\r
  26         h=x-gm-message-state:from:to:subject:in-reply-to:references\r
  27         :user-agent:date:message-id:mime-version:content-type;\r
  28         bh=uBwF8psJMzb++wBQm+RbXUQ3UE3C3d7VNgxd3fySjHc=;\r
  29         b=Koxfij0XilP42yruAIMZ0dJ0eUcm+bxb0rRE25KiIaQEUGCKZXPrlhNLmojgmyRuSt\r
  30         2UkoPiRzxRFGYI7meeVMVUwf/B39dUWu/YIF/i6olPwpVtxrdMQvEXwhHADf6eaeETMf\r
  31         g2sxtB4E1cErWOxgQGMQ6v5GcUiIgogscek34DfC+0e/hp9dTxASB2x0XPLC3G+bYK+x\r
  32         1x5dycnWrU3rmPO3Rp+O2zVMILkFMFPDNlntxQQIbbJD1Cd9LJRW094RnWIGwrPcAyh/\r
  33         v7X2yMYdpRL9Nlcn4LK6a02Yx0Kt8eqjnqnSLjn1nEz7T4CqbUdVcEqbn92pnHjeqShn\r
  34         1S/w==\r
  35 X-Gm-Message-State:\r
  36  ALoCoQnim7MPKRClk6en73Yv7iih/GiA1Le8detWg8WDSQ61pwCFE7zVH0hcBImBQjL9IZytCgv4\r
  37 X-Received: by 10.112.22.196 with SMTP id g4mr2289865lbf.47.1394471430686;\r
  38         Mon, 10 Mar 2014 10:10:30 -0700 (PDT)\r
  39 Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.\r
  40         [88.195.111.91])\r
  41         by mx.google.com with ESMTPSA id qx7sm22246001lbb.9.2014.03.10.10.10.28\r
  42         for <multiple recipients>\r
  43         (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
  44         Mon, 10 Mar 2014 10:10:29 -0700 (PDT)\r
  45 From: Jani Nikula <jani@nikula.org>\r
  46 To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org\r
  47 Subject: Re: [PATCH] doc: build man pages at build time, not install\r
  48 In-Reply-To: <1394449633-14737-1-git-send-email-david@tethera.net>\r
  49 References: <1394449633-14737-1-git-send-email-david@tethera.net>\r
  50 User-Agent: Notmuch/0.17+120~gb12e1244e14f (http://notmuchmail.org)\r
  51         Emacs/24.3.1 (x86_64-pc-linux-gnu)\r
  52 Date: Mon, 10 Mar 2014 19:10:27 +0200\r
  53 Message-ID: <87y50ij7y4.fsf@nikula.org>\r
  54 MIME-Version: 1.0\r
  55 Content-Type: text/plain\r
  56 X-BeenThere: notmuch@notmuchmail.org\r
  57 X-Mailman-Version: 2.1.13\r
  58 Precedence: list\r
  59 List-Id: "Use and development of the notmuch mail system."\r
  60         <notmuch.notmuchmail.org>\r
  61 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  62         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  63 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  64 List-Post: <mailto:notmuch@notmuchmail.org>\r
  65 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  66 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  67         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  68 X-List-Received-Date: Mon, 10 Mar 2014 17:10:41 -0000\r
  69 \r
  70 On Mon, 10 Mar 2014, David Bremner <david@tethera.net> wrote:\r
  71 > This helps avoid build artifacts (namely, nroff and gzipped-nroff man\r
  72 > pages) owned by root.\r
  73 > ---\r
  74 >  Makefile.local     | 2 +-\r
  75 >  doc/Makefile.local | 6 ++++--\r
  76 >  2 files changed, 5 insertions(+), 3 deletions(-)\r
  77 >\r
  78 > diff --git a/Makefile.local b/Makefile.local\r
  79 > index 5f797ad..cb7b106 100644\r
  80 > --- a/Makefile.local\r
  81 > +++ b/Makefile.local\r
  82 > @@ -53,7 +53,7 @@ endif\r
  83 >  FINAL_LIBNOTMUCH_LDFLAGS = $(LDFLAGS) $(AS_NEEDED_LDFLAGS) $(CONFIGURE_LDFLAGS)\r
  84 >  \r
  85 >  .PHONY: all\r
  86 > -all: notmuch notmuch-shared\r
  87 > +all: notmuch notmuch-shared build-man\r
  88 >  ifeq ($(MAKECMDGOALS),)\r
  89 >  ifeq ($(shell cat .first-build-message 2>/dev/null),)\r
  90 >       @NOTMUCH_FIRST_BUILD=1 $(MAKE) --no-print-directory all\r
  91 > diff --git a/doc/Makefile.local b/doc/Makefile.local\r
  92 > index fd64f70..5be49dc 100644\r
  93 > --- a/doc/Makefile.local\r
  94 > +++ b/doc/Makefile.local\r
  95 > @@ -16,7 +16,7 @@ ALLSPHINXOPTS   := -d $(DOCBUILDDIR)/doctrees $(SPHINXOPTS) $(dir)\r
  96 >  .PHONY: sphinx-html sphinx-man sphinx-texinfo sphinx-info\r
  97 >  .PHONY: rst2man\r
  98 >  \r
  99 > -.PHONY: install-man\r
 100 > +.PHONY: install-man build-man\r
 101 >  \r
 102 >  %.gz: %\r
 103 >       rm -f $@ && gzip --stdout $^ > $@\r
 104 > @@ -43,7 +43,9 @@ MAN_GZIP_FILES := $(addsuffix .gz,${MAN_ROFF_FILES})\r
 105 >  \r
 106 >  ${MAN_ROFF_FILES} : sphinx-man\r
 107 >  \r
 108 > -install-man: ${MAN_GZIP_FILES}\r
 109 > +build-man: ${MAN_GZIP_FILES}\r
 110 > +\r
 111 > +install-man: build-man\r
 112 \r
 113 Because build-man is a .PHONY target, it'll get done also on\r
 114 install-man, and one still ends up with root owned files on 'sudo make\r
 115 install'. The improvement to previous is that doc/_build/man directory\r
 116 is now created in the build phase and the files can be removed by the\r
 117 regular user.\r
 118 \r
 119 An actual non-phony dependency chain from .gz to man page to rst would\r
 120 be awesome, but I don't know how hard it would be with the\r
 121 sphinx/rst2man targets.\r
 122 \r
 123 BR,\r
 124 Jani.\r
 125 \r
 126 \r
 127 >       mkdir -p "$(DESTDIR)$(mandir)/man1"\r
 128 >       mkdir -p "$(DESTDIR)$(mandir)/man5"\r
 129 >       mkdir -p "$(DESTDIR)$(mandir)/man7"\r
 130 > -- \r
 131 > 1.8.5.3\r
 132 >\r
 133 > _______________________________________________\r
 134 > notmuch mailing list\r
 135 > notmuch@notmuchmail.org\r
 136 > http://notmuchmail.org/mailman/listinfo/notmuch\r