[qsb-mac] r1085 committed - Edited wiki page GettingStarted through web user interface.

[qsb...@googlecode.com]

Revision: 1085
Author: qsb...@gmail.com
Date: Wed Sep 26 14:34:14 2012
Log: Edited wiki page GettingStarted through web user interface.
http://code.google.com/p/qsb-mac/source/detail?r=1085

Modified:
/wiki/GettingStarted.wiki

=======================================
--- /wiki/GettingStarted.wiki Tue Mar 30 12:00:26 2010
+++ /wiki/GettingStarted.wiki Wed Sep 26 14:34:14 2012
@@ -8,71 +8,100 @@
#
[http://knol.google.com/k/qsb-helper/quick-search-box-faq/3im14657rtwuu/1#Getting_Started_with_Quick_Search_Box
QSB FAQ]
#
[http://knol.google.com/k/steven-combs/docs-tech-notes-guide-to-google-quick/j2ku4uapiz7c/1#
Doc’s Tech Notes’ Guide to Quick Search Box (QSB) for Mac]

+=What the Quick Search Box finds=
+
+You can use the Quick Search Box to find the following:
+
+ * *Programs and files on your computer*<br>Start typing the first few
letters of a program's name. As you type, the search box will show you
matching programs.
+
+ * *Search results on Google*<br>Super-easy: Type a keyword and hit
Enter.
+
+ * *Websites or search suggestions*<br>Start typing a URL or website
name and Google can automatically show you search and site suggestions that
are similar to what you've entered. Bookmarks from your default browser
will also pop up.
+
+ * *Calculations*<br>Enter a formula you want to calculate and the
search box will automatically show you its answer.
+
+ * *Site-specific results*<br>Select a URL or website name, then press
Tab on your keyboard to refine your search to only that site.
+
+ * *Weather and definitions*<br>Enter words you want to define directly
in the search box. You can also enter zip codes to get local weather
reports.
+
+ * *Spotlight search results*<br>Quick Search Box can show Spotlight
results when you search. The performance of the Quick Search Box can slow
down when Spotlight results are enabled, so they are disabled by default.
To enable it, select the Spotlight Results checkbox in Preferences under
Searchable Items tab.
+
+ * *Contacts*<br>Quick Search Box will find contacts you have stored in
your Address Book.
+
+ * *Tip*: The Quick Search Box can save you even more time by showing
you actions that are related to your search results. For instance, if you
search for an Address Book contact, you can see options to call or email
the contact in the search box. To see available actions for a search
result, select the result and press Tab on your keyboard. Then select the
action you want and press Enter on your keyboard.
+
+=How to install=
+
+You can install Quick Search Box on Mac OS 10.5 or later.
+
+ # Visit [http://www.google.com/quicksearchbox Quick Search Box]
+ # Click Download Quick Search Box.
+ # Open the file you just downloaded. It should contain a file
named 'Google Quick Search Box.'
+ # Drag this file to your Applications folder.
+
=Invoking the Quick Search Box=
If you'd like to bring up the Quick Search Box, you press Cmd-Cmd (The
Apple
-Key) twice. You can configure this from preferences.
+Key) twice. You can configure this from preferences. Once you're finished
using the Quick Search Box, simply press the keyboard shortcut or click
anywhere outside the search box to hide it from view again.

-=Features=
- # It works as a location bar AND a search box - It'll autocomplete URLs
and you can use TAB to search any website using Site Search.
- # The tab key has special functionality beyond just site search. It is
equivalent to "search in this context": you'll see that the results of a
contextual search include related items, contents, and actions.
- # Calculation, Weather, and Definition one boxes will show up
periodically. More are on the way. What else would you expect to see?
- # If you enable it, spotlight results will show up. Usually these are
relegated to the "More" section at the bottom of the window, but once you
use these items, they'll be learned and become much faster to access.
+=Clear your search history=

-=The basics=
- * Search the web (Type "britney spears")
- * Start applications (Type "itunes")
- * Open websites (Type "wikipedia.com")
- * Search for contacts in Address Book (Type "Bob")
- * Find files on your computer (Type the filename)
- * Find music (Type the name of a song or artist in your iTunes library)
- * Definitions and more: "Define Word", "Weather 94043", "5 + 5"
+The Quick Search Box will personalize your results the more you use it.
For example, if you frequently open Firefox using the Quick Search Box,
it'll gradually learn to bring up Firefox as the first option whenever you
type ff into the search box.

-= Accounts =
-Accounts allow you to access/manipulate data out on the web. Once you have
set up your Google account you will be able to search your Google Docs, and
if you set up a Twitter account, you will be able to tweet.
+To reset the search box to its default behavior, follow these steps:
+ # Open a new Finder window.
+ # Navigate to the folder ~/Library/Application Support/Google/Quick
Search Box/
+ # Delete the file named 'shortcuts.db.'

-To set up your accounts
- # Click on down arrow on the right hand side of the Quick Search Box.
- # Select Preferences.
- # Select the "Accounts" tab.
- # Click on the "Add" button.
- # Choose the type of account you would like to set up (currently we
support Google and Twitter accounts).
- # Type in your name and password. Your password will be stored in the
standard Apple keychain.
- # Click on the "OK" button
-Assuming you entered your account information correctly, and QSB can reach
the website to verify your account, you should now have your account set
up. If you have set up a Google account, you will now want to go to
the "Searchable Items" tab of the preferences and enable the sources that
you would like to search such as Google Docs, Bookmarks, and Picasa.
+=Accounts=

-=What's missing=
- * QSB does not yet search Gmail
- * QSB does not yet search Firefox
+You can allow the Quick Search Box to search your content saved in your
personal accounts, such as your [https://www.google.com/accounts Google
Account]. For instance, if you give the Quick Search Box access to your
Google Account, you'll be able to use the search box to find Google
Bookmarks, Google Docs, and Picasa Web Albums photos.
+You can also associate your *Twitter* account and send tweets. To
associate an account with the search box, follow these steps:
+ # Click the down arrow on the right-hand side of the search box.
+ # Select *Preferences*.
+ # Click the *Add Accounts* tab.
+ # Click *Add*.
+ # Select the type of account you'd like to associate with the Quick
Search Box.
+ # Enter your account name and password. For Google Accounts, remember
to use your full email address. Your password will be stored in the
standard Apple keychain.
+ # Click *Setup*.

-=Advanced features=
- * Type (TAB) to restrict your search to the selected results:
- * "wikipedia.com (TAB) toy" will return matches from wikipedia
- * Type (TAB) to see actions for the selected results:
- * "CONTACTNAME (TAB) email" will show the "Email" action
+If you've added a Google Account, go to the Searchable Items tab in
Preferences to select the types of content you want the Quick Search Box to
find.

-= Frequently Asked Questions =
-== What are the system requirements? ==
+=Tweet with Twitter=
+To tweet using the QSB first set up your Twitter account, as documented in
the *Accounts* section above.

-Quick Search Box requires Mac OS X 10.5 Leopard. Sorry, Tiger is
unsupported.
+ # Open the Quick Search Box.
+ # Start by entering a space. (This tells the Quick Search Box to treat
the text you enter as a text item rather than a search or a program name.)
+ # Enter the text you want to tweet. Don't forget Twitter's 140
character limit!
+ # The default selected result should be a text item. Press *Tab* on
your keyboard to see your possible actions.
+ # Select *Send Twitter Status* (or type 'tw' as a handy shortcut).
+ # Press *Enter* to send your tweet.

-== How do I give you feedback? ==
+=Privacy and Product Features=

-We love feedback, and it will be a major driver as far as what we are
going to focus on. The absolute best way to send us feedback is to make
sure that you have
enabled "[http://code.google.com/p/qsb-mac/wiki/Terms_of_Service_and_Usage_Statistics#Usage_Statistics
Usage Statistics]" in the QSB preferences. If you think you have found a
bug, or have an enhancement you would like to see, please check our
[http://code.google.com/p/qsb-mac/issues/list issues list] to see if
someone has already submitted something already. If it isn't there, please
[http://code.google.com/p/qsb-mac/issues/entry?template=Defect%20report%20from%20user
log an issue] so we can track it, and actually do something about it. We
also encourage you to join our
[http://groups.google.com/group/qsb-mac-discuss mailing list]. Members of
the team will be monitoring the list, and it's probably the best way to get
ahold of us. Please *do not* add feature requests to this page, as it's
tough for us to keep track of them.
+March 1, 2012

-==How do I "Get a Sample" ==
+The [http://www.google.com/policies/privacy/ Google Privacy Policy]
describes how we treat information when you use Google's products and
services, including information provided when you use Google Quick Search
Box ("QSB"). In addition, the following describes features that are
specific to Google QSB. You should be aware that Google QSB allows you to
install third-party plug-ins that introduce new sources of searchable
information. Google is not responsible for third-party products and you
should review the relevant privacy policy before installing a plug-in.

-Sometimes when a bug is reported as a "hang" or an unresponsive
application, we will ask for a "sample". To get a sample:
- # Start up Activity Monitor (Applications/Utilities/Activity Monitor)
- # Select "Quick Search Box" from the list of applications
- # Select "Sample Process" from the toolbar (or from the View menu)
- # Copy and paste the sample and send it our way
- # Please make sure to include a _full_ version number with your sample
(e.g. 2.0.0.808)
+*Features*

-==How do I tweet with Twitter ==
-To tweet using the QSB first set up your Twitter account, as documented
above.
+Google QSB provides a unified search experience, giving you the ability to
search across your computer and the Internet.
+ * *Internet Search*: When you use QSB to search the Internet by sending
a query to Google, QSB sends standard, limited
[http://www.google.com/intl/en/policies/privacy/faq/ information] that may
include items such as your search query, Internet Protocol address, the
date and time of your request, and one or more
[http://support.google.com/accounts/bin/answer.py?hl=en&answer=27448
cookies] that may uniquely identify your browser. This data is retained in
Google’s [http://www.google.com/intl/en/policies/privacy/faq/#serverlogs
server logs] and protected according to our general Privacy Policy.
+ * When you type URLs or queries in the QSB search box, the letters
you type are sent to Google so the Suggest feature can automatically
recommend search terms or URLs you may be looking for. If you disable the
Suggest feature through the Preferences menu, these letters will not be
sent to Google.
+ * *Local Computer Search*: When you use QSB to search information
stored locally on your computer, Google does not receive information such
as your search queries or the locally-stored results. When you use
third-party plug-ins to search other sources of information, Google does
not receive those search queries or results either.
+ * Exception: If the Suggest feature is enabled, Google may receive
some letters of your typed query before execution, regardless of the search
type.
+ * Your copy of Google QSB may include one or more unique application
numbers. These numbers and information about your installation (e.g.,
operating system type, version number) will be sent to Google when you
first install and use it and when Google QSB automatically checks for
updates, and with optional usage statistics and crash reports. Google does
not associate these unique application numbers with you or your Google
Account.
+ * Optional usage statistics include non-personal, summary
information such as your operating system type, the number of searches you
do, and the time it takes for you to see your results. Crash reports may
contain information from files, applications and services that were running
at the time of a malfunction. You can turn off optional usage statistics
and crash reports in the Preferences menu.
+ * If you choose to log-in to your Google Account within QSB, you may be
able to search and access certain sources that require that log-in, such as
Google Docs or Gmail. In those cases, Google will treat your personal
information in accordance with Google’s Privacy Policy (and the specific
Privacy Policy of any Google Service).

-Once you've set up your account, you can tweet from the Quick Search Box
in one of two ways:
- # *The secret of creating a "text" item*: Text items are queries that
start with a space (e.g. hit the space bar and then start typing). To
tweet, activate the QSB, hit the space bar (creating a text item), and type
in the text you want to tweet - remember Twitter has a 140 character limit!
The selected result should be a "text" item. Hit the tab key to show the
available actions on the item. Select the "Send Twitter Status" action for
the account you wish to tweet with and hit the return key.
- # *Pivoting on the search result*: If the text item thing confuses you,
just pull up the QSB, type your query, and pivot (hit tab) on the search
result. Select the "Send Twitter Status" action for the account you wish to
tweet with and hit the return key.
+*Your choices*

-Using either method, you should then receive a notification that you have
successfully tweeted! Nice job!
+ * By default, QSB will search a variety of pre-defined sources. You can
add or remove sources from the scope of QSB's search functionality through
the Preferences menu.
+ * You can choose to disable/enable the Suggest feature (which display
search query and website suggestions from Google as you type) through the
Preferences menu.
+ * You can choose to log-in to your Google Account to search information
that requires those credentials through the Preferences menu. You can still
use QSB if you choose not to log-in to Google.
+ * You can choose to opt-out of the collection of usage statistics by
Google through the Preferences menu.
+ * You can choose to add third-party plug-ins that allow you to search
other sources of information. You should review a third-party's privacy
policy carefully before adding a plug-in.
+
+*More information*
+
+ * For more information about our privacy practices, go to
[http://www.google.com/privacypolicy.html Google's Privacy Policy].
+ * For questions concerning the product or your account, please visit
[http://support.google.com/?hl=en Google Help].