By kah on Feb 04, 2008
Since Derby's documentation is spread across a number of different manuals, and I have never actually tried to learn which manual contains what, I usually end up using Google when I need to look something up.
So, say that I wanted to look up the syntax for
ALTER TABLE, I would type "derby alter table" in the search bar. The results from the search however only contained links to sections about
ALTER TABLE in old Derby manuals archived on the Apache site, and a number of hits in forums and mailing list archives. To find it in the most recent manuals, I would therefore also append "site:db.apache.org/derby/docs/dev" which would limit the search to the alpha version manuals. That's tedious to type, though, and hits in the Portuguese translation of the manual tended be on top of the list (and I don't read Portuguese that well... :) ). Using "Advanced Search" and limiting the search to English pages would be even more tedious.
Finally, I got sufficiently tired of typing and scrolling, and came up with a quicker way of doing it. Firefox has this quick search function, which allows you to type a keyword that tells which search engine to use, followed by the search terms, and then Firefox automatically jumps to a URL that performs the search. To create my own quick search for the Derby documentation, I selected Bookmarks->Organize Bookmarks and added a bookmark in the "Quick Searches" folder with the following properties:
Now, I only need to go to Firefox's address bar and type "derby alter table", and Firefox sends me to this page, which shows exactly what I want.