* [PATCH 8/9] doc/include.mk: remove git use and redundant declarations
2019-05-09 7:50 6% [PATCH 0/9] install updates Eric Wong
@ 2019-05-09 7:51 7% ` Eric Wong
0 siblings, 0 replies; 2+ results
From: Eric Wong @ 2019-05-09 7:51 UTC (permalink / raw)
To: meta
And document that we still have GNU-isms in that
include.mk Makefile (and may continue to do so).
Finally, take advantage of GNU-isms to warn users
to run "gmake" to build all manpages.
---
Documentation/include.mk | 26 +++++++++++++++++++-------
1 file changed, 19 insertions(+), 7 deletions(-)
diff --git a/Documentation/include.mk b/Documentation/include.mk
index 9089e06..2a02611 100644
--- a/Documentation/include.mk
+++ b/Documentation/include.mk
@@ -2,10 +2,18 @@
# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
all::
+# Note: some GNU-isms present and required to build docs
+# (including manpages), but at least this should not trigger
+# warnings with BSD make(1) when running "make check"
+# Maybe it's not worth it to support non-GNU make, though...
RSYNC = rsync
RSYNC_DEST = public-inbox.org:/srv/public-inbox/
-docs := README COPYING INSTALL TODO HACKING
-docs += $(shell git ls-files 'Documentation/*.txt')
+txt := INSTALL README COPYING TODO HACKING
+dtxt := design_notes.txt design_www.txt dc-dlvr-spam-flow.txt hosted.txt
+dtxt += standards.txt
+dtxt := $(addprefix Documentation/, $(dtxt))
+docs := $(txt) $(dtxt)
+
INSTALL = install
PODMAN = pod2man
PODMAN_OPTS = -v --stderr -d 1993-10-02 -c 'public-inbox user manual'
@@ -71,6 +79,7 @@ manuals += $(m8)
mantxt = $(addprefix Documentation/, $(addsuffix .txt, $(manuals)))
docs += $(mantxt)
+dtxt += $(mantxt)
all :: $(mantxt)
@@ -79,10 +88,6 @@ Documentation/%.txt : Documentation/%.pod
txt2pre = $(PERL) -I lib ./Documentation/txt2pre <$< >$@+ && \
touch -r $< $@+ && mv $@+ $@
-txt := INSTALL README COPYING TODO
-dtxt := design_notes.txt design_www.txt dc-dlvr-spam-flow.txt hosted.txt
-dtxt += standards.txt
-dtxt := $(addprefix Documentation/, $(dtxt)) $(mantxt)
Documentation/standards.txt : Documentation/standards.perl
$(PERL) $< >$@+ && mv $@+ $@
@@ -96,7 +101,10 @@ Documentation/%.html: Documentation/%.txt
docs_html := $(addsuffix .html, $(subst .txt,,$(dtxt)) $(txt))
html: $(docs_html)
gz_docs := $(addsuffix .gz, $(docs) $(docs_html))
-rsync_docs := $(gz_docs) $(docs) $(txt) $(docs_html) $(dtxt)
+rsync_docs := $(gz_docs) $(docs) $(docs_html)
+
+doc: $(docs)
+
%.gz: %
gzip -9 --rsyncable <$< >$@+
touch -r $< $@+
@@ -111,3 +119,7 @@ clean-doc:
$(RM) $(man1) $(man5) $(man7) $(gz_docs) $(docs_html) $(mantxt)
clean :: clean-doc
+
+pure_all ::
+ @if test x"$(addprefix g, make)" != xgmake; then \
+ echo W: gmake is currently required to build manpages; fi
--
EW
^ permalink raw reply related [relevance 7%]
* [PATCH 0/9] install updates
@ 2019-05-09 7:50 6% Eric Wong
2019-05-09 7:51 7% ` [PATCH 8/9] doc/include.mk: remove git use and redundant declarations Eric Wong
0 siblings, 1 reply; 2+ results
From: Eric Wong @ 2019-05-09 7:50 UTC (permalink / raw)
To: meta
A couple of build and installation related updates
to clarify package dependencies. The INSTALL document
is hopefully less intimidating, now.
I've found ci/deps.perl pretty useful; maybe even for
ordinary users on Debian and FreeBSD systems.
I still haven't tested on any RPM-based systems, yet;
but FreeBSD 11.2 and 12.0 on amd64 seem fine; along
with Debian sid.
Eric Wong (9):
INSTALL: update with FreeBSD pkg names and reorder
INSTALL: depend on Encode instead of Encode::MIME::Header
INSTALL: note xapian-compact(1) tool
t/purge.t: fix unreferenced variable
doc: use bullet list for wwwlisting options
doc: give txt files proper titles
Makefile.PL: improve make(1) portability
doc/include.mk: remove git use and redundant declarations
ci: include some scripts to make CI easier
Documentation/design_www.txt | 2 +
Documentation/hosted.txt | 2 +
Documentation/include.mk | 31 +++-
Documentation/public-inbox-config.pod | 16 +-
Documentation/txt2pre | 3 +-
INSTALL | 205 +++++++++++++--------
MANIFEST | 4 +
Makefile.PL | 17 +-
ci/README | 33 ++++
ci/deps.perl | 254 ++++++++++++++++++++++++++
ci/profiles.sh | 72 ++++++++
ci/run.sh | 21 +++
t/purge.t | 2 +-
13 files changed, 558 insertions(+), 104 deletions(-)
create mode 100644 ci/README
create mode 100755 ci/deps.perl
create mode 100755 ci/profiles.sh
create mode 100755 ci/run.sh
--
EW
^ permalink raw reply [relevance 6%]
Results 1-2 of 2 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2019-05-09 7:50 6% [PATCH 0/9] install updates Eric Wong
2019-05-09 7:51 7% ` [PATCH 8/9] doc/include.mk: remove git use and redundant declarations Eric Wong
Code repositories for project(s) associated with this public inbox
https://80x24.org/public-inbox.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).