You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2006/02/10 19:18:24 UTC

svn commit: r376785 - in /db/derby/site/trunk: build/site/faq.html src/documentation/content/xdocs/faq.xml

Author: jta
Date: Fri Feb 10 10:18:22 2006
New Revision: 376785

URL: http://svn.apache.org/viewcvs?rev=376785&view=rev
Log:
Added an FAQ on how to search the derby web site.

Modified:
    db/derby/site/trunk/build/site/faq.html
    db/derby/site/trunk/src/documentation/content/xdocs/faq.xml

Modified: db/derby/site/trunk/build/site/faq.html
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/faq.html?rev=376785&r1=376784&r2=376785&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/faq.html (original)
+++ db/derby/site/trunk/build/site/faq.html Fri Feb 10 10:18:22 2006
@@ -123,6 +123,11 @@
         How can I add a new entry to the Derby FAQ?
       </a>
 </li>
+<li>
+<a href="#site_search">2.2. 
+        How do I search the Derby site?
+      </a>
+</li>
 </ul>
 </li>
 <li>
@@ -341,9 +346,40 @@
          if you don't already have one.
         </p>
 </div>
-<a name="N10046"></a><a name="developers"></a>
+<a name="N10046"></a><a name="site_search"></a>
+<h4 class="faq">2.2. 
+        How do I search the Derby site?
+      </h4>
+<div align="right">
+<a href="#site_search-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p> The left-hand menu on the Derby web site
+           includes a search box that searches the
+           entire db.apache.org web site; 
+           so, that includes Derby and the other Apache DB Project sub-projects.
+        </p>
+<p>If you want to search all of apache.org, the 
+           <a class="external" href="http://www.apache.org/">ASF home page</a> has a search
+           box for all of apache.org.
+        </p>
+<p>
+           If you want to restrict a search to a subset of the Derby site,
+           for example to just the Derby manuals,
+           one way to do that is to use a
+           <a class="external" href="http://www.google.com">www.google.com</a>
+            <a class="external" href="http://www.google.com/help/refinesearch.html">domain 
+           search</a>.  
+           For example, the search string below looks for all references
+           to "create table" in the 10.1 documentation set:
+        </p>
+<pre class="code">
+"create table" site:db.apache.org/derby/docs/10.1
+</pre>
+</div>
+<a name="N10064"></a><a name="developers"></a>
 <h3 class="boxed">3. Developing Derby</h3>
-<a name="N1004A"></a><a name="derby_source"></a>
+<a name="N10068"></a><a name="derby_source"></a>
 <h4 class="faq">3.1. 
         Where is the Derby source code?
       </h4>
@@ -361,7 +397,7 @@
 	interface to view Derby source code using your web browser.
         </p>
 </div>
-<a name="N1005A"></a><a name="derby_internals"></a>
+<a name="N10078"></a><a name="derby_internals"></a>
 <h4 class="faq">3.2. 
         Where can I read about Derby internals?
       </h4>
@@ -378,7 +414,7 @@
 	mail list and post any questions you have.
         </p>
 </div>
-<a name="N1006A"></a><a name="derby_issues"></a>
+<a name="N10088"></a><a name="derby_issues"></a>
 <h4 class="faq">3.3. 
         Where are Apache Derby bugs logged?
       </h4>
@@ -392,7 +428,7 @@
 	tracker</a> to track bugs.
 	</p>
 </div>
-<a name="N10076"></a><a name="derby_update"></a>
+<a name="N10094"></a><a name="derby_update"></a>
 <h4 class="faq">3.4. 
         Who can create a new Apache Derby issue?
       </h4>
@@ -411,7 +447,7 @@
          request that it be added to the derby-developers Jira list.
 	</p>
 </div>
-<a name="N10086"></a><a name="derby_eclipse"></a>
+<a name="N100A4"></a><a name="derby_eclipse"></a>
 <h4 class="faq">3.5. 
         How do you build Derby using Eclipse?
       </h4>
@@ -425,9 +461,9 @@
 
 	</p>
 </div>
-<a name="N10092"></a><a name="users_getstart"></a>
+<a name="N100B0"></a><a name="users_getstart"></a>
 <h3 class="boxed">4. Using Derby: Getting Started</h3>
-<a name="N10096"></a><a name="derby_ask"></a>
+<a name="N100B4"></a><a name="derby_ask"></a>
 <h4 class="faq">4.1. 
         Where can I ask questions about how to use Derby?
       </h4>
@@ -447,7 +483,7 @@
         feel free to ask for more help.
         </p>
 </div>
-<a name="N100A2"></a><a name="derby_jar"></a>
+<a name="N100C0"></a><a name="derby_jar"></a>
 <h4 class="faq">4.2. 
         Where can I download the Derby jar files?
       </h4>
@@ -460,7 +496,7 @@
 	from the <a href="derby_downloads.html">Derby Downloads</a> page.
 	</p>
 </div>
-<a name="N100AE"></a><a name="derby_alpha"></a>
+<a name="N100CC"></a><a name="derby_alpha"></a>
 <h4 class="faq">4.3. 
       What are Derby alpha snaphots and should I use them?
       </h4>
@@ -478,7 +514,7 @@
       must not be used for production</a>.
       </p>
 </div>
-<a name="N100BE"></a><a name="where_are_docs"></a>
+<a name="N100DC"></a><a name="where_are_docs"></a>
 <h4 class="faq">4.4. 
       Where can I find the Derby documentation?
       </h4>
@@ -504,7 +540,7 @@
       instructions.
       </p>
 </div>
-<a name="N100E0"></a><a name="pda"></a>
+<a name="N100FE"></a><a name="pda"></a>
 <h4 class="faq">4.5. 
       Can you run Derby on PDAs?
       </h4>
@@ -520,7 +556,7 @@
       Guide</a>.
       </p>
 </div>
-<a name="N100EC"></a><a name="createdb_OS_X"></a>
+<a name="N1010A"></a><a name="createdb_OS_X"></a>
 <h4 class="faq">4.6. 
         Why can't I create a new database or modify an existing database 
 	on Mac OS X?
@@ -546,7 +582,7 @@
 	sync instead of write sync for log writes.
 	</p>
 </div>
-<a name="N100FC"></a><a name="derby_jdk51"></a>
+<a name="N1011A"></a><a name="derby_jdk51"></a>
 <h4 class="faq">4.7. 
       Can I use Derby on JDK 5.0?
       </h4>
@@ -565,7 +601,7 @@
       5.0 is also known as JDK 1.5</a>.
       </p>
 </div>
-<a name="N10110"></a><a name="in_memory"></a>
+<a name="N1012E"></a><a name="in_memory"></a>
 <h4 class="faq">4.8. 
       Does Derby have a mode that causes it to run entirely in memory?
       </h4>
@@ -582,7 +618,7 @@
       Check that mail list for current status.
       </p>
 </div>
-<a name="N10120"></a><a name="derby_gui"></a>
+<a name="N1013E"></a><a name="derby_gui"></a>
 <h4 class="faq">4.9. 
       Does Derby have a GUI?
       </h4>
@@ -597,7 +633,7 @@
       that work with Derby.
       </p>
 </div>
-<a name="N1012C"></a><a name="db_name"></a>
+<a name="N1014A"></a><a name="db_name"></a>
 <h4 class="faq">4.10. 
       How do you specify database location?
       </h4>
@@ -615,9 +651,9 @@
       Wiki</a>.
       </p>
 </div>
-<a name="N1013C"></a><a name="users_sql"></a>
+<a name="N1015A"></a><a name="users_sql"></a>
 <h3 class="boxed">5. Using Derby: SQL</h3>
-<a name="N10140"></a><a name="null_args"></a>
+<a name="N1015E"></a><a name="null_args"></a>
 <h4 class="faq">5.1. 
       Why can't my SQL function/procedure pass a NULL INTEGER?
       </h4>
@@ -636,7 +672,7 @@
       mail list topic.
       </p>
 </div>
-<a name="N1014C"></a><a name="limit"></a>
+<a name="N1016A"></a><a name="limit"></a>
 <h4 class="faq">5.2. 
       Does Derby support a LIMIT command? 
       </h4>
@@ -649,7 +685,7 @@
       <a class="external" href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200411.mbox/%3c41A95632.3010301@debrunners.com%3e">JDBC</a>.
       </p>
 </div>
-<a name="N10158"></a><a name="schema_exist"></a>
+<a name="N10176"></a><a name="schema_exist"></a>
 <h4 class="faq">5.3. 
       Why do I get the error 'schema does not exist'?
       </h4>
@@ -681,7 +717,7 @@
       to create in a particular schema and no explicit CREATE SCHEMA was issued.
       </p>
 </div>
-<a name="N10169"></a><a name="debug_lock_timeout"></a>
+<a name="N10187"></a><a name="debug_lock_timeout"></a>
 <h4 class="faq">5.4. 
       I get a lock timeout error. How do I debug this?
       </h4>
@@ -710,7 +746,7 @@
       to narrow down which statements may be holding the locks.
       </p>
 </div>
-<a name="N10183"></a><a name="identity"></a>
+<a name="N101A1"></a><a name="identity"></a>
 <h4 class="faq">5.5. 
       Can Derby generate unique identifiers like sequences?
       </h4>
@@ -727,9 +763,9 @@
        function returns the most recently assigned number.
       </p>
 </div>
-<a name="N10193"></a><a name="users_client"></a>
+<a name="N101B1"></a><a name="users_client"></a>
 <h3 class="boxed">6. Using Derby: Client Programming</h3>
-<a name="N10197"></a><a name="clientserv"></a>
+<a name="N101B5"></a><a name="clientserv"></a>
 <h4 class="faq">6.1. 
       Can you use Derby for client-server applications?
       </h4>
@@ -750,7 +786,7 @@
       DB2 JDBC Universal Driver</a>.
       </p>
 </div>
-<a name="N101AF"></a><a name="netclient"></a>
+<a name="N101CD"></a><a name="netclient"></a>
 <h4 class="faq">6.2. 
       Does Derby include a client-server ("network") jdbc driver?
       </h4>
@@ -766,7 +802,7 @@
       and it became available in Derby 10.1.
       </p>
 </div>
-<a name="N101BB"></a><a name="db2_jcc_errors"></a>
+<a name="N101D9"></a><a name="db2_jcc_errors"></a>
 <h4 class="faq">6.3. 
       How can I get the message text for an error using the DB2 JDBC
       Universal Driver?
@@ -784,7 +820,7 @@
       mail list topic.
       </p>
 </div>
-<a name="N101CA"></a><a name="derby_xa"></a>
+<a name="N101E8"></a><a name="derby_xa"></a>
 <h4 class="faq">6.4. 
       Can you execute a query that spans two Derby databases 
       across different JVMs?
@@ -800,7 +836,7 @@
       <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminapps811478.html">Admin and Server Guide</a>.
       </p>
 </div>
-<a name="N101D6"></a><a name="derby_faster"></a>
+<a name="N101F4"></a><a name="derby_faster"></a>
 <h4 class="faq">6.5. 
       Are there any tips to make Derby go faster?
       </h4>
@@ -835,7 +871,7 @@
       
 </ol>
 </div>
-<a name="N101EF"></a><a name="jdbc_lob"></a>
+<a name="N1020D"></a><a name="jdbc_lob"></a>
 <h4 class="faq">6.6. 
       Where is an example that shows how to insert a CLOB?
       </h4>

Modified: db/derby/site/trunk/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/faq.xml?rev=376785&r1=376784&r2=376785&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/faq.xml Fri Feb 10 10:18:22 2006
@@ -70,6 +70,36 @@
         </p>
       </answer>
     </faq>
+    <faq id="site_search">
+      <question>
+        How do I search the Derby site?
+      </question>
+      <answer>
+        <p> The left-hand menu on the Derby web site
+           includes a search box that searches the
+           entire db.apache.org web site; 
+           so, that includes Derby and the other Apache DB Project sub-projects.
+        </p>
+        <p>If you want to search all of apache.org, the 
+           <a href="http://www.apache.org/">ASF home page</a> has a search
+           box for all of apache.org.
+        </p>
+        <p>
+           If you want to restrict a search to a subset of the Derby site,
+           for example to just the Derby manuals,
+           one way to do that is to use a
+           <a href="http://www.google.com">www.google.com</a>
+            <a href="http://www.google.com/help/refinesearch.html">domain 
+           search</a>.  
+           For example, the search string below looks for all references
+           to "create table" in the 10.1 documentation set:
+        </p>
+<source>
+"create table" site:db.apache.org/derby/docs/10.1
+</source>
+
+      </answer>
+    </faq>
   </faqsection>
 
   <faqsection id="developers">