diff options
authorRaphael Cojocaru <>2016-08-18 16:34:21 (GMT)
committerRaphael Cojocaru <>2016-08-18 16:34:21 (GMT)
commitc5547a11454be8f4ff1a74d9cd329ef7eb997574 (patch)
parenta1b96416e4324f943760f0086919cae8adddf81b (diff)
Updated documentation for Finding Objects in order to include Akarsh internet searching feature
-rw-r--r--doc/find.pngbin66559 -> 17314 bytes
-rw-r--r--doc/find2.pngbin0 -> 20000 bytes
3 files changed, 47 insertions, 4 deletions
diff --git a/doc/find.png b/doc/find.png
index 06ef9df..e67e5d3 100644
--- a/doc/find.png
+++ b/doc/find.png
Binary files differ
diff --git a/doc/find2.png b/doc/find2.png
new file mode 100644
index 0000000..0c24eb3
--- /dev/null
+++ b/doc/find2.png
Binary files differ
diff --git a/doc/quicktour.docbook b/doc/quicktour.docbook
index dd3e28a..07e74ff 100644
--- a/doc/quicktour.docbook
+++ b/doc/quicktour.docbook
@@ -253,13 +253,13 @@ Object</guilabel> tool, which can be opened by clicking on the
The <guilabel>Find Object</guilabel> window is shown below:
-<screeninfo>Find Object Window</screeninfo>
+<screeninfo>Find Object Window with search online feature</screeninfo>
- <imagedata fileref="find.png" format="PNG"/>
+ <imagedata fileref="find2.png" format="PNG"/>
- <phrase>Find Object Window</phrase>
+ <phrase>Find Object Window with search online feature</phrase>
@@ -274,7 +274,50 @@ by object type. To filter by name, enter a string in the edit box
at the top of the window; the list will then only contain names
which start with that string. To filter by type, select a type
from the combo box at the bottom of the window.
+&kstars; provides another method for resolving the objects that are
+missing from any of its predefined catalogues, by using an internet
+connection. Thus, if you want to find an object that &kstars; is not
+aware of, you can easily do this by querying several professional
+astronomical databases as: SIMBAD, NED or VizieR. This can be done by
+entering the object's name and then press the <guibutton>or search the
+internet for ObjectName</guibutton> button. After your object is found,
+you can use it exactly as any object that is already loaded into &kstars;
+(&ie; adding it to the Observing WishList). If the object was not found
+in the online databases, then a warning dialogue will pop-up. Once you
+resolve an object by using this method, it is stored in &kstars; database,
+so if you close &kstars; and open it again, your object will still be there.
+You can choose to enable or disable this feature by checking or unchecking the
+<guibutton>Resolve names not known to &kstars; using online services</guibutton>
+check box from <guilabel>Catalogs</guilabel> tab, inside of
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure KStars</guimenuitem></menuchoice>
+window. If this checkbox is checked, when an object name unknown to &kstars;
+is entered in the <guilabel>Find Dialog</guilabel>, &kstars; will contact online
+services to learn about the desired object and then add it directly to &kstars;
+database. The objects acquired in this manner are stored in a fake catalog, called
+<quote>_Internet_Resolved</quote>. Thus, you can enable or disable the display of
+these objects by checking or unchecking the <quote>_Internet_Resolved</quote> catalog
+from the catalogues list. Note that you can not delete this fake catalogue, as you can
+do with a custom catalogue. If this checkbox is unchecked, then the
+<guilabel>Find Dialog</guilabel> window will be exactly the same, excepting a minor change:
+the online searching button will no longer be visible.
+<screeninfo>Find Object Window</screeninfo>
+ <imageobject>
+ <imagedata fileref="find.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Find Object Window</phrase>
+ </textobject>
To center the display on an object, highlight the desired object in
the list, and press <guibutton>Ok</guibutton>. Note that if the
object is below the horizon, the program will warn you that you may