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 cd715b2a3f50abd10d3b644628114b0dd3fd296c..f15a55629745869ab34f4d0735c337d5b5035b31 100644 (file)
--- 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 42926d252e4284871577f9cdfe1b6ef71826654a..0b1fb92a6459cd9cf7014a127e0ee2253e953d32 100644 (file)
--- 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 02cbef302af798b1888c0246268adcfbdb6f07b9..9089e0620373473ac42ee42d107b1347843eb2f8 100644 (file)
--- 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 4c4b2ca2f77b6189b6a72f5f27623a89d5558ef4..9a81a24a007a5e861bbd59d33a46876476e76384 100755 (executable)
--- 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);