make 'ant example' more visible and self-explaining

git-svn-id: https://svn.apache.org/repos/asf/incubator/solr/trunk@483871 13f79535-47bb-0310-9956-ffa450edef68

build.xml

@@ -98,11 +98,12 @@
   <target name="usage"
           description="Prints out instructions">
     <echo message="Welcome to the Solr project!" />
+    <echo message="Use 'ant example' to create a runnable example configuration." />
+    <echo message="And for developers:"/>
+    <echo message="Use 'ant clean' to clean compiled files." />
     <echo message="Use 'ant compile' to compile the source code." />
     <echo message="Use 'ant dist' to build the project WAR and JAR files." />
     <echo message="Use 'ant package' to build a .zip and .tgz for distribution." />
-    <echo message="Use 'ant example' to install solr.war in ./example" />
-    <echo message="Use 'ant clean' to clean compiled files." />
     <echo message="Use 'ant test' to run unit tests." />
   </target>
 
@@ -370,6 +371,7 @@
       </fileset>
     </copy>
     <chmod dir="${example}/solr/bin" perm="755" includes="**"/>
+    <echo>See ${example}/README.txt for how to run the Solr example configuration.</echo>
   </target>
 
   <target name="dist-example" 

example/README.txt

@@ -0,0 +1,36 @@
+# 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.
+
+Solr example configuration
+--------------------------
+
+To run this example configuration, use 
+
+  java -jar start.jar
+
+in this directory, and when Solr is started connect to 
+
+  http://localhost:8983/solr/admin/
+
+To add documents to the index, use the post.sh script in
+the exampledocs subdirectory (while Solr is running),
+for example:
+
+  cd exampledocs
+  ./post.sh *.xml
+
+See also README.txt in the solr subdirectory, and check
+http://wiki.apache.org/solr/SolrResources for a list of
+tutorials and introductory articles.