lei: rename "extinbox" => "external"

The words "extinbox" and "extindex" are too close and easy to
confuse with the other.  Rename "extinbox" to "external", since
these could be IMAP, JMAP or other non-public-inbox search APIs.

Link: https://public-inbox.org/meta/20201226112649.GB6226@dcvr/

3 files changed, 16 insertions, 16 deletions

diff --git a/lib/PublicInbox/LEI.pm b/lib/PublicInbox/LEI.pm
index 9aa4d95a..f960aa72 100644
--- a/lib/PublicInbox/LEI.pm
+++ b/lib/PublicInbox/LEI.pm
@@ -8,7 +8,7 @@
 package PublicInbox::LEI;
 use strict;
 use v5.10.1;
-use parent qw(PublicInbox::DS PublicInbox::LeiExtinbox);
+use parent qw(PublicInbox::DS PublicInbox::LeiExternal);
 use Getopt::Long ();
 use Socket qw(AF_UNIX SOCK_STREAM pack_sockaddr_un);
 use Errno qw(EAGAIN ECONNREFUSED ENOENT);
@@ -70,19 +70,19 @@ sub _config_path ($) {
 our %CMD = ( # sorted in order of importance/use:
 'q' => [ 'SEARCH_TERMS...', 'search for messages matching terms', qw(
         save-as=s output|o=s format|f=s dedupe|d=s thread|t augment|a
-        sort|s=s@ reverse|r offset=i remote local! extinbox!
+        sort|s=s@ reverse|r offset=i remote local! external!
         since|after=s until|before=s), opt_dash('limit|n=i', '[0-9]+') ],
 
 'show' => [ 'MID|OID', 'show a given object (Message-ID or object ID)',
         qw(type=s solve! format|f=s dedupe|d=s thread|t remote local!),
         pass_through('git show') ],
 
-'add-extinbox' => [ 'URL_OR_PATHNAME',
+'add-external' => [ 'URL_OR_PATHNAME',
         'add/set priority of a publicinbox|extindex for extra matches',
         qw(boost=i quiet|q) ],
-'ls-extinbox' => [ '[FILTER...]', 'list publicinbox|extindex locations',
+'ls-external' => [ '[FILTER...]', 'list publicinbox|extindex locations',
         qw(format|f=s z|0 local remote quiet|q) ],
-'forget-extinbox' => [ '{URL_OR_PATHNAME|--prune}',
+'forget-external' => [ '{URL_OR_PATHNAME|--prune}',
         'exclude further results from a publicinbox|extindex',
         qw(prune quiet|q) ],
 
@@ -189,7 +189,7 @@ my %OPTDESC = (
 'q        format|f=s' => [ 'OUT|maildir|mboxrd|mboxcl2|mboxcl|html|oid|json',
                 'specify output format, default depends on --output'],
 'ls-query        format|f=s' => $ls_format,
-'ls-extinbox        format|f=s' => $ls_format,
+'ls-external        format|f=s' => $ls_format,
 
 'limit|n=i@' => ['NUM', 'limit on number of matches (default: 10000)' ],
 'offset=i' => ['OFF', 'search result offset (default: 0)'],
diff --git a/lib/PublicInbox/LeiExtinbox.pm b/lib/PublicInbox/LeiExternal.pm
index c2de7735..0378551a 100644
--- a/lib/PublicInbox/LeiExtinbox.pm
+++ b/lib/PublicInbox/LeiExternal.pm
@@ -1,22 +1,22 @@
 # Copyright (C) 2020 all contributors <meta@public-inbox.org>
 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
 
-# *-extinbox commands of lei
-package PublicInbox::LeiExtinbox;
+# *-external commands of lei
+package PublicInbox::LeiExternal;
 use strict;
 use v5.10.1;
 use parent qw(Exporter);
-our @EXPORT = qw(lei_ls_extinbox lei_add_extinbox lei_forget_extinbox);
+our @EXPORT = qw(lei_ls_external lei_add_external lei_forget_external);
 
-sub lei_ls_extinbox {
+sub lei_ls_external {
         my ($self, @argv) = @_;
         my $stor = $self->_lei_store(0);
         my $cfg = $self->_lei_cfg(0);
         my $out = $self->{1};
         my ($OFS, $ORS) = $self->{opt}->{z} ? ("\0", "\0\0") : (" ", "\n");
         my (%boost, @loc);
-        for my $sec (grep(/\Aextinbox\./, @{$cfg->{-section_order}})) {
-                my $loc = substr($sec, length('extinbox.'));
+        for my $sec (grep(/\Aexternal\./, @{$cfg->{-section_order}})) {
+                my $loc = substr($sec, length('external.'));
                 $boost{$loc} = $cfg->{"$sec.boost"};
                 push @loc, $loc;
         }
@@ -28,14 +28,14 @@ sub lei_ls_extinbox {
         }
 }
 
-sub lei_add_extinbox {
+sub lei_add_external {
         my ($self, $url_or_dir) = @_;
         my $cfg = $self->_lei_cfg(1);
         if ($url_or_dir !~ m!\Ahttps?://!) {
                 $url_or_dir = File::Spec->canonpath($url_or_dir);
         }
         my $new_boost = $self->{opt}->{boost} // 0;
-        my $key = "extinbox.$url_or_dir.boost";
+        my $key = "external.$url_or_dir.boost";
         my $cur_boost = $cfg->{$key};
         return if defined($cur_boost) && $cur_boost == $new_boost; # idempotent
         $self->lei_config($key, $new_boost);
@@ -44,7 +44,7 @@ sub lei_add_extinbox {
         $stor->done;
 }
 
-sub lei_forget_extinbox {
+sub lei_forget_external {
         # TODO
 }
 
diff --git a/lib/PublicInbox/LeiXSearch.pm b/lib/PublicInbox/LeiXSearch.pm
index 1a81b14a..7d251afd 100644
--- a/lib/PublicInbox/LeiXSearch.pm
+++ b/lib/PublicInbox/LeiXSearch.pm
@@ -18,7 +18,7 @@ sub new {
         }, $class
 }
 
-sub attach_extinbox {
+sub attach_external {
         my ($self, $ibxish) = @_; # ibxish = ExtSearch or Inbox
         if (!$ibxish->can('over')) {
                 push @{$self->{remotes}}, $ibxish