public-inbox.git  about / heads / tags
an "archives first" approach to mailing lists
blob 3a6617c474304ab598ac85964be00f27861aeef3 1899 bytes (raw)
$ git show HEAD:Documentation/common.perl	# shows this blob on the CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
#!perl -w
# Copyright (C) all contributors <meta@public-inbox.org>
# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
use strict;
use Fcntl qw(SEEK_SET);
my $have_search = eval { require PublicInbox::Search; 1 };
my $addr = 'meta@public-inbox.org';
for my $pod (@ARGV) {
	open my $fh, '+<', $pod or die "open($pod): $!";
	my $s = do { local $/; <$fh> } // die "read $!";
	my $orig = $s;
	$s =~ s!^=head1 COPYRIGHT\n.+?^=head1([^\n]+)\n!=head1 COPYRIGHT

Copyright all contributors L<mailto:$addr>

License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>

=head1$1
		!ms;

	$s =~ s!^=head1 CONTACT\n.+?^=head1([^\n]+)\n!=head1 CONTACT

Feedback welcome via plain-text mail to L<mailto:$addr>

The mail archives are hosted at L<https://public-inbox.org/meta/> and
L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

=head1$1
		!ms;
	$have_search and $s =~ s!^=for\scomment\n
			^AUTO-GENERATED-SEARCH-TERMS-BEGIN\n
			.+?
			^=for\scomment\n
			^AUTO-GENERATED-SEARCH-TERMS-END\n
			!search_terms()!emsx;
	$s =~ s/[ \t]+$//sgm;
	if ($s eq $orig) {
		my $t = time;
		utime($t, $t, $fh);
	} else {
		seek($fh, 0, SEEK_SET) or die "seek: $!";
		truncate($fh, 0) or die "truncate: $!";
		print $fh $s or die "print: $!";
		close $fh or die "close: $!";
	}
}

sub search_terms {
	my $help = eval('\@PublicInbox::Search::HELP');
	my $s = '';
	my $pad = 0;
	my $i;
	for ($i = 0; $i < @$help; $i += 2) {
		my $pfx = $help->[$i];
		my $n = length($pfx);
		$pad = $n if $n > $pad;
		$s .= $pfx . "\0";
		$s .= $help->[$i + 1];
		$s .= "\f\n";
	}
	$pad += 2;
	my $padding = ' ' x ($pad + 4);
	$s =~ s/^/$padding/gms;
	$s =~ s/^$padding(\S+)\0/"    $1".(' ' x ($pad - length($1)))/egms;
	$s =~ s/\f\n/\n/gs;
	$s =~ s/^  //gms;
	substr($s, 0, 0, "=for comment\nAUTO-GENERATED-SEARCH-TERMS-BEGIN\n\n");
	$s .= "\n=for comment\nAUTO-GENERATED-SEARCH-TERMS-END\n";
}

git clone https://public-inbox.org/public-inbox.git
git clone http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/public-inbox.git