X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Finclude.mk;h=5f3ffcc56937962f4cfd434d95e4bbb9417b909f;hb=69b5ab18a594fa434d79cacee35c4d9a0df7b55c;hp=f2605346ad495b9fb16d8f7799da007ef80a4ad8;hpb=73fe3421f1ecbdc83600d5acfc643c33dbb9a0f2;p=public-inbox.git
diff --git a/Documentation/include.mk b/Documentation/include.mk
index f2605346..5f3ffcc5 100644
--- a/Documentation/include.mk
+++ b/Documentation/include.mk
@@ -1,4 +1,4 @@
-# Copyright (C) 2013-2019 all contributors
+# Copyright (C) 2013-2021 all contributors
# License: AGPL-3.0+
all::
@@ -6,10 +6,14 @@ RSYNC = rsync
RSYNC_DEST = public-inbox.org:/srv/public-inbox/
AWK = awk
MAN = man
+LEXGROG = lexgrog
# this is "xml" on FreeBSD and maybe some other distros:
XMLSTARLET = xmlstarlet
+# libgraph-easy-perl from Debian, Graph::Easy from CPAN
+GRAPH_EASY = graph-easy
+
# same as pod2text
COLUMNS = 76
@@ -48,11 +52,14 @@ install-man: man
doc_install :: install-man
check :: check-man
-check_man = $(AWK) '{gsub(/\b./,"")}length>80{print;err=1}END{exit(err)}'\
- >&2 && >$@
+check_man = $(AWK) \
+ '{gsub(/\b./,"")}$$0 !~ /\.onion/&&length>80{print;e=1}END{exit(e)}' \
+ >&2
check-man :: $(check_80)
+check-lexgrog :: $(check_lexgrog)
+
all :: $(docs)
txt2pre = $(PERL) -I lib ./Documentation/txt2pre >$@
@@ -62,12 +69,18 @@ Documentation/standards.txt : Documentation/standards.perl
touch -r Documentation/standards.perl $@+
mv $@+ $@
-RELEASES =
-RELEASES += v1.2.0
-RELEASES += v1.1.0-pre1
-RELEASES += v1.0.0
+# flow.txt is checked into git since Graph::Easy isn't in many distros
+Documentation/flow.txt : Documentation/flow.ge
+ (sed -ne '1,/^$$/p' $@+
+ touch -r Documentation/flow.ge $@+
+ mv $@+ $@
-NEWS NEWS.atom NEWS.html : Documentation/include.mk
+NEWS NEWS.atom NEWS.html : $(news_deps)
$(PERL) -I lib -w Documentation/mknews.perl $@ $(RELEASES)
# check for internal API changes:
@@ -80,9 +93,6 @@ check :: NEWS .NEWS.atom.check NEWS.html
html: $(docs_html)
-Documentation/.x:
- mkdir -p $@
-
doc: $(docs)
%.gz: %
@@ -104,20 +114,21 @@ rsync-doc: NEWS.atom.gz
clean-doc:
$(RM_F) $(man1) $(man5) $(man7) $(man8) $(gz_docs) $(docs_html) \
$(mantxt) $(rsync_xdocs) \
- NEWS NEWS.atom NEWS.html Documentation/standards.txt
+ NEWS NEWS.atom NEWS.html Documentation/standards.txt \
+ Documentation/flow.html Documentation/flow.html.gz \
+ Documentation/flow.txt.gz
clean :: clean-doc
# No camel-cased tarballs or pathnames which MakeMaker creates,
-# this may not always be a Perl project.
-git-dist :: ver = $(shell git describe |sed -ne 's/v//p')
-git-dist :: pkgpfx := public-inbox-$(ver)
-git-dist :: NEWS
- git archive --prefix=$(pkgpfx)/ --format=tar HEAD^{tree} >$(pkgpfx).tar
- mkdir -p $(pkgpfx)
- cp NEWS $(pkgpfx)/NEWS
- $(TAR) rf $(pkgpfx).tar $(pkgpfx)/NEWS
- $(RM) $(pkgpfx)/NEWS
- rmdir $(pkgpfx)
- gzip -9 $(pkgpfx).tar
- @echo $(pkgpfx).tar.gz created
+# this may not always be a Perl project. This should match what
+# cgit generate, since git maintainers ensure git-archive has
+# stable tar output
+DIST_TREE = HEAD^{tree}
+DIST_VER =
+git-dist :
+ ver=$$(git describe $(DIST_VER) | sed -ne s/v//p); \
+ pkgpfx=public-inbox-$$ver; \
+ git archive --prefix=$$pkgpfx/ --format=tar $(DIST_TREE) \
+ | gzip -n >$$pkgpfx.tar.gz; \
+ echo $$pkgpfx.tar.gz created