add find artifact page

git-svn-id: https://svn.apache.org/repos/asf/maven/archiva/trunk@597622 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/archiva-docs/src/site/apt/userguide/find-artifact.apt b/archiva-docs/src/site/apt/userguide/find-artifact.apt
index 132636716e2641789cf2be5c0d1f5c5b4edcd83b..8bdfb5aba8c8cde544aa7f3e0ba6fd0e426f45ab 100644 (file)
--- a/archiva-docs/src/site/apt/userguide/find-artifact.apt
+++ b/archiva-docs/src/site/apt/userguide/find-artifact.apt
@@ -4,5 +4,33 @@
 
 Identifying an Artifact
 
-  :STUB: This is a documentation stub.
+  Archiva indexes all of the artifacts that it discovers during the repository scanning process, storing information about their contents.
+  This includes the checksum of the artifact, which can help to uniquely identify it within the repository.
+
+  Archiva includes a feature that allows you to check for the existence of a given artifact in the repository by checksum. This is useful in
+  identifying a JAR or other artifact located from an external source that does not contain any Maven or version information.
+
+  To use this functionality, click the "Find Artifact" link in the left navigation.
+
+  When the screen first loads, a Java applet that will allow you to create a local checksum of a given artifact is loaded. Since it is reading the
+  content of the artifact from the filesystem, it will present a security dialog similar to the following:
+
+[../images/find-artifact-security.png] Java Applet
+
+  By trusting the applet, you can checksum files of any size locally and just upload the small checksum to the server. If you opt not to trust the
+  applet, you must enter the checksum into the web form by hand.
+
+  Once you have loaded the page, you have the choice of browsing for a local file to identify, or entering the checksum directly.
+
+[../images/find-artifact.png] Find Artifact
+
+  Once you submit the form Archiva will look to match the checksum:
+
+    * If more than one artifact matches, a list of results are returned
+
+    * If a unique match is found, the individual artifact information page is returned
+
+    * If no match is found, a "no results" page is returned
+
+  
 

diff --git a/archiva-docs/src/site/resources/images/find-artifact-security.png b/archiva-docs/src/site/resources/images/find-artifact-security.png
new file mode 100644 (file)
index 0000000..bbc4682
Binary files /dev/null and b/archiva-docs/src/site/resources/images/find-artifact-security.png differ

diff --git a/archiva-docs/src/site/resources/images/find-artifact.png b/archiva-docs/src/site/resources/images/find-artifact.png
new file mode 100644 (file)
index 0000000..4a2a296
Binary files /dev/null and b/archiva-docs/src/site/resources/images/find-artifact.png differ