Author: yonik
Date: Sun Feb 26 20:15:15 2006
New Revision: 381252
URL: http://svn.apache.org/viewcvs?rev=381252&view=rev
Log:
little changes & typos
Modified:
incubator/solr/trunk/src/site/src/documentation/content/xdocs/tutorial.xml
Modified:
incubator/solr/trunk/src/site/src/documentation/content/xdocs/tutorial.xml
URL:
http://svn.apache.org/viewcvs/incubator/solr/trunk/src/site/src/documentation/content/xdocs/tutorial.xml?rev=381252&r1=381251&r2=381252&view=diff
==============================================================================
--- incubator/solr/trunk/src/site/src/documentation/content/xdocs/tutorial.xml
(original)
+++ incubator/solr/trunk/src/site/src/documentation/content/xdocs/tutorial.xml
Sun Feb 26 20:15:15 2006
@@ -40,7 +40,7 @@
shell support. (If you plan to use Subversion on Win32, be
sure to select the subversion package when you install, in the
"Devel" category.) This tutorial will assume that "<code>sh</code>"
- is in your PATH.
+ is in your PATH, and that you have "curl" installed from the "Web"
category.
</li>
</ol>
</section>
@@ -61,10 +61,10 @@
<p>
Solr can run in any Java Servlet Container of your choice, but to simplify
-this tutorial, the example index includes a copy of getty.
+this tutorial, the example index includes a small installation of Jetty.
</p>
<p>
-To launch getty with the Solr WAR, and the example configs, just run the
<code>start.jar</code> ...
+To launch Jetty with the Solr WAR, and the example configs, just run the
<code>start.jar</code> ...
</p>
<source>
@@ -81,7 +81,7 @@
1656 [main] INFO org.mortbay.log - Started SelectChannelConnector @
0.0.0.0:8983
</source>
<p>
-This will start up the getty application server on port 8983, and use your
terminal to display the logging information from Solr.
+This will start up the Jetty application server on port 8983, and use your
terminal to display the logging information from Solr.
</p>
<p>
You can see that the Solr is running by loading <a
href="http://localhost:8983/solr/admin/";>http://localhost:8983/solr/admin/</a>
in your web browser. This is the main starting point for Administering Solr.
@@ -110,7 +110,7 @@
</source>
<p>
-You have now indexed one document about Solr, and commited and commited that
document. You can now search for "solr" using the "Make a Query" interface on
the Admin screen, and you should get one result. Clicking the "Search" button
should take you to the following URL...
+You have now indexed one document about Solr, and committed that change. You
can now search for "solr" using the "Make a Query" interface on the Admin
screen, and you should get one result. Clicking the "Search" button should
take you to the following URL...
</p>
<p>
<a
href="http://localhost:8983/solr/select/?stylesheet=&q=solr&version=2.1&start=0&rows=10&indent=on";>http://localhost:8983/solr/select/?stylesheet=&q=solr&version=2.1&start=0&rows=10&indent=on</a>
@@ -146,7 +146,7 @@
</source>
<p>
-...and now you can search for all sorts of things using the default Lucene
QueryParser syntax...
+ ...and now you can search for all sorts of things using the default <a
href="http://lucene.apache.org/java/docs/queryparsersyntax.html";>Lucene
QueryParser syntax</a>...
</p>
<ul>
<li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video";>video</a></li>
@@ -163,17 +163,25 @@
<title>Updating Data</title>
<p>
-You may have noticed that even though the file <code>solr.xml</code> has now
been POSTed to the server twice, you still only get 1 result when searching for
"solr". This is because the example schema.xml specifies a "uniqueKey" field
called "<code>id</code>". Whenever you POST instructions to Solr to add a
document with the same value for the uniqueKey as an existing document, it
automaticaly replaces it for you. You can see that that has happened by
looking at the values for <code>numDocs</code> and <code>maxDoc</code> in the
"CORE" section of the statistics page...
-</p>
+You may have noticed that even though the file <code>solr.xml</code> has now
+been POSTed to the server twice, you still only get 1 result when searching for
+"solr". This is because the example schema.xml specifies a "uniqueKey" field
+called "<code>id</code>". Whenever you POST instructions to Solr to add a
+document with the same value for the uniqueKey as an existing document, it
+automaticaly replaces it for you. You can see that that has happened by
+looking at the values for <code>numDocs</code> and <code>maxDoc</code> in the
+"CORE" section of the statistics page... </p>
<p>
<a
href="http://localhost:8983/solr/admin/stats.jsp";>http://localhost:8983/solr/admin/stats.jsp</a>
</p>
<p>
-maxDoc should be 16, but numDoc is only 15. You can re-post the sample XML
files over and over again as much as you want and numDocs will never increase,
because the new documents will constantly be replacing the old.
+numDoc should be 15, but maxDoc may be larger (the maxDoc count includes
logically deleted documents that have not yet been removed from the index).
You can re-post the sample XML
+files over and over again as much as you want and numDocs will never increase,
+because the new documents will constantly be replacing the old.
</p>
<p>
-Go ahead and edit the XML files to change some of the data, and re-run the
post.sh command, you'll see your changes reflected in subsequent searches.
+Go ahead and edit the existing XML files to change some of the data, and
re-run the post.sh command, you'll see your changes reflected in subsequent
searches.
</p>
</section>
@@ -190,7 +198,7 @@
<ul>
<li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+price+desc";>video;
price desc</a></li>
<li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+price+asc";>video;
price asc</a></li>
- <li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+inStock+asc+price+desc";>video;
inStock asc price desc</a></li>
+ <li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+inStock+asc+price+desc";>video;
inStock asc, price desc</a></li>
</ul>
<p>
@@ -199,7 +207,7 @@
<ul>
<li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+score+desc";>video;
score desc</a></li>
<li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+score+asc";>video;
score asc</a></li>
- <li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+inStock+asc+score+desc";>video;
inStock asc score desc</a></li>
+ <li><a
href="http://localhost:8983/solr/select/?version=2.1&indent=on&q=video%3B+inStock+asc+score+desc";>video;
inStock asc, score desc</a></li>
</ul>
@@ -214,7 +222,7 @@
<li>screenshots?</li>
<li>talk about hte advanced search screen: fl, debug, etc...</li>
<li>talk about the analysis tools</li>
- <li>talk about on deck searchers and pending commits .. change post.sh so
there is an option to not commit and walk through an example where changes are
POSTed but not commited, and show how searches don't show them</li>
+ <li>talk about on deck searchers and pending commits .. change post.sh so
there is an option to not commit and walk through an example where changes are
POSTed but not committed, and show how searches don't show them</li>
<li>talk about optimizing, add an optimize.sh</li>
<li>talk about deleting, add a delete.sh</li>
<li>talk about dynamic fields?</li>
