[lucene] branch main updated: LUCENE-9954: README for Luke (#135)

[to...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

tomoko pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/lucene.git


The following commit(s) were added to refs/heads/main by this push:
     new a9522c7  LUCENE-9954: README for Luke (#135)
a9522c7 is described below

commit a9522c717912b5ad248195347d7e595df39533e5
Author: Michael Wechner <mi...@wyona.com>
AuthorDate: Wed May 12 17:53:53 2021 +0200

    LUCENE-9954: README for Luke (#135)
---
 lucene/luke/README.md      |  39 +++++++++++++++++++++++++++++++++++++++
 lucene/luke/luke-swing.png | Bin 0 -> 125710 bytes
 2 files changed, 39 insertions(+)

diff --git a/lucene/luke/README.md b/lucene/luke/README.md
new file mode 100644
index 0000000..335b232
--- /dev/null
+++ b/lucene/luke/README.md
@@ -0,0 +1,39 @@
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+ -->
+
+# Luke
+
+## Introduction
+
+Luke (atop Swing) is the GUI tool for introspecting your Lucene index. It allows:
+
+* Browsing your documents, indexed terms and posting lists
+* Searching in the index
+* Performing index maintenance: index health checking, index optimization (take a backup before running this!)
+* Testing your custom Lucene analyzer (Tokenizer/CharFilter/TokenFilter)
+
+![Swing Luke](luke-swing.png)
+
+## Launching Luke
+
+Using a binary release
+
+The [Lucene Downloads](https://lucene.apache.org/core/downloads.html) page contains stable releases of Lucene including Luke. Download the respective release, unpack and run a shell or batch scripts inside the folder 'luke' (or directly with java -jar if you prefer it that way).
+
+## Older releases
+
+Older releases of Luke (prior to 8.1) can be found at https://github.com/DmitryKey/luke
diff --git a/lucene/luke/luke-swing.png b/lucene/luke/luke-swing.png
new file mode 100644
index 0000000..4aa8203
Binary files /dev/null and b/lucene/luke/luke-swing.png differ