From: Eric Wong <e@80x24.org>
Date: Tue, 7 May 2019 20:40:28 +0000 (+0000)
Subject: doc: give txt files proper titles
X-Git-Tag: v1.2.0~290
X-Git-Url: http://www.git.stargrave.org/?p=public-inbox.git;a=commitdiff_plain;h=e50b4ffa4ac7ac07cd4922459b292734b0e370bd

doc: give txt files proper titles

We can fix the redundant rule in include.mk which causes
make(1) on FreeBSD to complain; but HTML docs will likely
still require GNU make.
---

diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt
index cd715b2a..f15a5562 100644
--- a/Documentation/design_www.txt
+++ b/Documentation/design_www.txt
@@ -1,3 +1,5 @@
+PublicInbox::WWW (PSGI interface) design notes
+
 URL and anchor naming
 ---------------------
 
diff --git a/Documentation/hosted.txt b/Documentation/hosted.txt
index 42926d25..0b1fb92a 100644
--- a/Documentation/hosted.txt
+++ b/Documentation/hosted.txt
@@ -1,3 +1,5 @@
+unofficially hosted mirrors at public-inbox.org
+
 In addition to eating our own dogfood at <https://public-inbox.org/meta/>,
 public-inbox.org hosts unofficial archives for several other projects
 as a service to their users and to further test our own software.
diff --git a/Documentation/include.mk b/Documentation/include.mk
index 02cbef30..9089e062 100644
--- a/Documentation/include.mk
+++ b/Documentation/include.mk
@@ -87,8 +87,9 @@ dtxt := $(addprefix Documentation/, $(dtxt)) $(mantxt)
 Documentation/standards.txt : Documentation/standards.perl
 	$(PERL) $< >$@+ && mv $@+ $@
 
-%.html: %.txt
-	TITLE="$(basename $(<F))" $(txt2pre)
+Documentation/%.html: Documentation/%.txt
+	$(txt2pre)
+
 %.html: %
 	$(txt2pre)
 
diff --git a/Documentation/txt2pre b/Documentation/txt2pre
index 4c4b2ca2..9a81a24a 100755
--- a/Documentation/txt2pre
+++ b/Documentation/txt2pre
@@ -11,8 +11,7 @@ use PublicInbox::Linkify;
 use PublicInbox::Hval qw(ascii_html);
 
 my $str = eval { local $/; <> };
-my $title = $ENV{TITLE};
-($title) = ($str =~ /\A([^\n]+)/) unless $title;
+my ($title) = ($str =~ /\A([^\n]+)/);
 $title = ascii_html($title);
 my $l = PublicInbox::Linkify->new;
 $str = $l->linkify_1($str);