From aced20dca3815c8f43ff6a13e10eeb82e3c1072b Mon Sep 17 00:00:00 2001
From: Suzanne Soy <jsmaniac.github@suzanne.soy>
Date: Thu, 27 Jan 2022 01:38:10 +0000
Subject: [PATCH] Updated README with warning, place search bar in a standalone
 toolbar instead of the File toolbar.

---
 InitGui.py | 17 +++++++++--------
 README.md  | 18 ++++++++++++++++++
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/InitGui.py b/InitGui.py
index 0beb9e7..40b8655 100644
--- a/InitGui.py
+++ b/InitGui.py
@@ -7,12 +7,7 @@ def addToolSearchBox():
   import SearchBoxLight
   global wax, sea
   mw = FreeCADGui.getMainWindow()
-  mbr = mw.findChildren(QtGui.QToolBar, 'File')
-  # The toolbar will be unavailable if this file is loaded during startup, because no workbench is active and no toolbars are visible.
-  if len(mbr) > 0:
-    # Get the first toolbar named 'File', and add 
-    mbr = mbr[0]
-    # Create search box widget
+  if mw:
     sea = SearchBoxLight.SearchBoxLight(getItemGroups   = lambda: __import__('GetItemGroups').getItemGroups(),
                                         getToolTip      = lambda groupId, setParent: __import__('GetItemGroups').getToolTip(groupId, setParent),
                                         getItemDelegate = lambda: __import__('IndentedItemDelegate').IndentedItemDelegate())
@@ -21,8 +16,14 @@ def addToolSearchBox():
     wax.setWhatsThis('Use this search bar to find tools, document objects, preferences and more')
     sea.setWhatsThis('Use this search bar to find tools, document objects, preferences and more')
     wax.setDefaultWidget(sea)
-    #mbr.addWidget(sea)
-    mbr.addAction(wax)
+    ##mbr.addWidget(sea)
+    #mbr.addAction(wax)
+    tbr = QtGui.QToolBar("SearchBar") #QtGui.QDockWidget()
+    # Include FreeCAD in the name so that one can find windows labeled with FreeCAD easily in window managers which allow search through the list of open windows.
+    tbr.setObjectName("SearchBar")
+    tbr.addAction(wax)
+    mw.addToolBar(tbr)
+    tbr.show()
 
 addToolSearchBox()
 import FreeCADGui
diff --git a/README.md b/README.md
index fd04e54..47236da 100644
--- a/README.md
+++ b/README.md
@@ -3,10 +3,28 @@ SearchBar
 
 This FreeCAD mod adds a search bar for tools, document objects and preferences.
 
+⚠️ Several issues related to the C++ memory management interacting badly with Python's have caused lots of segfaults during development. ⚠️
+
+⚠️️ Most of these should now be solved, but save your work often and proceed with caution while testing this extension. ⚠️
+
+Extensibility
+-------------
+
 It can be extended by other mods, by adding a new result provider.
 
+Usage
+-----
+
+The search bar appars next to the What's this? tool, in FreeCAD's default File toolbar.
+
 ![Screenshot of the search bar, with results in its drop-down menu and extra info about the result in a separate pane](screenshot.png)
 
+Development
+-----------
+
+* `InitGui.py` adds an instance of `SearchBoxLight` to the GUI.
+* `SearchBoxLight` is a hollowed-out implementation of a search box, it loads everything lazily.
+
 License
 -------