* [PATCH 2/3] build: check with lexgrog(1) if available
2021-01-25 4:53 5% [PATCH 0/3] doc: some extindex updates Eric Wong
@ 2021-01-25 4:53 7% ` Eric Wong
0 siblings, 0 replies; 2+ results
From: Eric Wong @ 2021-01-25 4:53 UTC (permalink / raw)
To: meta
This will make life easier for Debian package maintainers
running lintian.
cf. commit 1350f5ab09f72c75ac2cd6c88f6a2b9e198fef55
("public-inbox-v[12]-format.pod: make lexgrog happy")
---
.gitignore | 1 +
Documentation/include.mk | 3 +++
Makefile.PL | 8 +++++++-
3 files changed, 11 insertions(+), 1 deletion(-)
diff --git a/.gitignore b/.gitignore
index 7f4142ba..f7e4c595 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@
*.gz
.*.cols
.*.check
+.*.lexgrog
/NEWS.html
/NEWS.atom
/NEWS
diff --git a/Documentation/include.mk b/Documentation/include.mk
index df6c17e0..79bf460d 100644
--- a/Documentation/include.mk
+++ b/Documentation/include.mk
@@ -6,6 +6,7 @@ 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
@@ -56,6 +57,8 @@ check_man = $(AWK) '{gsub(/\b./,"")}length>80{print;err=1}END{exit(err)}'\
check-man :: $(check_80)
+check-lexgrog :: $(check_lexgrog)
+
all :: $(docs)
txt2pre = $(PERL) -I lib ./Documentation/txt2pre >$@
diff --git a/Makefile.PL b/Makefile.PL
index 613a72ae..c57491eb 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -65,8 +65,12 @@ for my $i (@sections) {
$t->{".$m.cols : $m.$i"} = [
"\@echo CHECK80 $m.$i;".
"COLUMNS=80 \$(MAN) ./$m.$i | \$(check_man)" ];
+ $t->{".$m.lexgrog: $m.$i"} = [
+ "\@echo LEXGROG $m.$i;" .
+ "\$(LEXGROG) ./$m.$i >\$\@+ && mv \$\@+ \$@" ];
}
push @{$v->{check_80}}, map { ".$_.cols" } @$ary;
+ push @{$v->{check_lexgrog}}, map { ".$_.lexgrog" } @$ary;
my $manuals = $v->{"man$i"} = [ map { "$_.$i" } @$ary ];
push @{$v->{manuals}}, @$manuals;
push @{$v->{mantxt}}, map { "Documentation/$_.txt" } @$ary;
@@ -121,6 +125,8 @@ my %man3 = map {; # semi-colon tells Perl this is a BLOCK (and not EXPR)
"lib/PublicInbox/$_" => "blib/man3/PublicInbox::$mod.\$(MAN3EXT)"
} qw(Git.pm Import.pm WWW.pod SaPlugin/ListMirror.pod);
my $warn_no_pod = @no_pod ? "\n\t\@echo W: missing .pod: @no_pod\n" : '';
+chomp(my $lexgrog = `which lexgrog 2>/dev/null`);
+my $check_lexgrog = $lexgrog ? 'check-lexgrog' : '';
WriteMakefile(
NAME => 'PublicInbox', # n.b. camel-case is not our choice
@@ -184,7 +190,7 @@ $VARS
-include Documentation/include.mk
$TGTS
-check-man ::$warn_no_pod
+check-man :: $check_lexgrog$warn_no_pod
# syntax checks are currently GNU make only:
%.syntax :: %
^ permalink raw reply related [relevance 7%]
* [PATCH 0/3] doc: some extindex updates
@ 2021-01-25 4:53 5% Eric Wong
2021-01-25 4:53 7% ` [PATCH 2/3] build: check with lexgrog(1) if available Eric Wong
0 siblings, 1 reply; 2+ results
From: Eric Wong @ 2021-01-25 4:53 UTC (permalink / raw)
To: meta
1-2/3 should make life easier for lintian users (Debian
developers).
3/3 - I'm still uncertain about some behavior of the command
w.r.t. config file updating and hoping they'll be fleshed out
as I start (ab)using it during lei(1) development
Eric Wong (3):
doc: extindex-format: make lexgrog happy
build: check with lexgrog(1) if available
doc: start working on public-inbox-extindex(1) manpage
.gitignore | 1 +
Documentation/include.mk | 3 +
.../public-inbox-extindex-format.pod | 2 +-
Documentation/public-inbox-extindex.pod | 84 +++++++++++++++++++
MANIFEST | 1 +
Makefile.PL | 8 +-
6 files changed, 97 insertions(+), 2 deletions(-)
create mode 100644 Documentation/public-inbox-extindex.pod
^ permalink raw reply [relevance 5%]
Results 1-2 of 2 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2021-01-25 4:53 5% [PATCH 0/3] doc: some extindex updates Eric Wong
2021-01-25 4:53 7% ` [PATCH 2/3] build: check with lexgrog(1) if available 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).