Bug 297572

Summary: search is broken in KHelpCenter
Product: [openSUSE] openSUSE 11.3 Reporter: Tim Fechtner <timmi>
Component: KDE4 WorkspaceAssignee: E-mail List <kde-maintainers>
Status: RESOLVED WONTFIX QA Contact: E-mail List <qa-bugs>
Severity: Critical    
Priority: P3 - Medium CC: axel.braun, carlos.e.r, coolo, ctrippe, forgotten_Xh41Ao4q6j, harbrink, ke, managetech, nderkach, unskipp_raul, wstephenson
Version: Final   
Target Milestone: Final   
Hardware: Other   
OS: Other   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---
Bug Depends on: 325691    
Bug Blocks: 170570, 173441, 191885    
Attachments: snapshot1.png
screenshot of broken help view Re Comment #14

Description Tim Fechtner 2007-08-04 22:21:47 UTC
Start khelpcenter and search for something. You get a result containing many internal options which I don't understand. On _none_ of the entrys you can click to view the corresponding site.
Comment 1 Tim Fechtner 2007-08-04 22:22:15 UTC
Created attachment 155604 [details]
snapshot1.png
Comment 2 Stephan Binner 2007-08-18 11:03:32 UTC
*** Bug 300664 has been marked as a duplicate of this bug. ***
Comment 3 Axel Braun 2007-08-18 12:18:57 UTC
This bug describes that ersults cant be clicked, 300664 describes that the 'search' button cant be clicked - is this the same root cause?
Comment 4 Will Stephenson 2007-08-31 17:10:06 UTC
Please see what you can do on this.  I am away getting married for the whole month of september so I can't do anything on this, sorry :/
Comment 5 Axel Braun 2007-09-11 19:23:01 UTC
Beta3: The search button can be clicked in between, but the result is the same as described in comment #1
Comment 6 Stephan Binner 2007-09-17 20:47:54 UTC
*** Bug 325791 has been marked as a duplicate of this bug. ***
Comment 7 Karl Eichwalder 2007-10-16 07:27:30 UTC
In case the bug did not disappear automagically, it is kind of urgent now.  It blocks some other bug and if possible, we should try to push an online update.  At least, please "accept" the bug.
Comment 8 Danny Al-Gaaf 2007-10-29 16:07:05 UTC
(In reply to comment #7 from Karl Eichwalder)
> In case the bug did not disappear automagically, it is kind of urgent now.  It
> blocks some other bug and if possible, we should try to push an online update. 
> At least, please "accept" the bug.

see bug #337560 for the not activated search button. IMO the wrong search results are caused by something other.
Comment 9 Axel Braun 2007-11-02 12:08:10 UTC
Having installed 10.3 final, the problem is still there (as in comment #1).
Means the helpcenter is completely useless.
Comment 10 Dr. Martin Rosenbauer 2007-11-16 15:58:31 UTC
In 10.3 the problem is still there.
One of the Reason seems to be:
htdig package was forgotten among dependencies of package kdebase3
Workaround: Install this package manually...
... this changes a lot, but it's not yet the final solution...
(perhaps it requires a running httpd server???)
Comment 11 Axel Braun 2007-11-16 16:54:58 UTC
Yes, installing htdig changes the error message, but does not fix the problem.

I feel this needs to be fixed urgently before 10.3 is useable for newbies....and I have some in the queue.
Comment 12 Will Stephenson 2007-12-14 10:57:55 UTC
*** Bug 337560 has been marked as a duplicate of this bug. ***
Comment 13 Dr. Martin Rosenbauer 2008-01-24 13:55:08 UTC
One problem might be that the command

/srv/www/cgi-bin/htsearch -c $HOME/.kde/share/apps/khelpcenter/index//book_opensuse_startupde.conf format=&method=and&words=drucker

which is issued by some perl script (/opt/kde3/bin/khc_htsearch.pl) when searching the generated index files does not work on 64-bit systems.

At least on my 32-bit toshiba notebook the help center search function does not show any problems. And on my 64-bit dual-core PC the htsearch command yields "memory faults"...
Comment 14 Carlos Robinson 2008-03-28 11:37:16 UTC
My system is 32 bits and I do have apache installed; the help system doesn't work, search does not work, either gnome, kde, or text mode. Nope.

If I run:

nimrodel:~ # susehelpindex --force
DOCUMENT:
Creating index files...
.........................................
Created index for 41 documents.
nimrodel:~ # ls /var/lib/htdig/db/
nimrodel:~ #

The database is empty. But "susehelpindex --show" does show things:

nimrodel:~ # susehelpindex --show
DOCUMENT:
Show index state:

ok     : release-notes (Release Notes)
ok     : apparmor-adminen (Novell AppArmor Administration Guide (en))
ok     : @id@ (GNU Licenses)
...
ok     : books-lkmpg (Linux Kernel Module Programming Guide (Pt. 1))
ok     : books-lkmpg2 (Linux Kernel Module Programming Guide (Pt. 2))
ok     : qt3 (QT 3 developer information)
41 indexable documents.
nimrodel:~ #


However, help does not work at all.


It appears that, contrary to htdig manpage, the databases are in /var/cache/susehelp/. Perhaps this is the problem, the non standard place.



When I try "help" in any kde program, I get nothing. I try to click on the
manual in "kbabel" (for instance), and I get a firefox window opened in
<http://nimrodel.valinor/susehelp/cgi-bin/showdir.cgi?lang=en&depth=1&cgiprefix=/susehelp/cgi-bin/&fileprefix=&header=1>,
showing:


SUSE Help


Home    Content         Search Options  Search:_____________

    * Release Notes
      A short description of the most important changes for this SUSE Linux release
    * Novell AppArmor Administration Guide (en)
      Novell AppArmor Administration Guide (en)
          o GNU Licenses
            GNU Licenses

....
    * Development
      Documentation for Developers
          o Languages
          o Libraries
          o Tools
    * Online Resources
          o openSUSE Homepage
          o openSUSE Hardware Database


Some of the entries have content, but not all of them. And nothing about kbabel. If I search "kabel" in the page above, if finds nothing.

However, I do have a directory in "/opt/kde3/share/doc/HTML/en/kbabel" full of things that seem to be documentation or help. However, the files there are .png or .docbook - not a single .html file that can be browsed with firefox or anything. 

Ie, there are index.docbook, faq.docbook, menu.docbook, pref_wizard_page2.png, etc.

Is the problem that the help files are still in source format and were not "made", thus can not be searched or browsed?


If I try "konqueror", I get a black konqueror window from kde4 (instead of
kde3!). On it I try the manual, and I get a black
"help:/konqueror/index.html" window, empty of contents, except for a
browse tab on the left, showing in Scope only "unix manpages", unclicked.

If I click on "build search index" the only scope offered is:

 search scope            | status
[ ] application manuals  | missing


And this is after I run "susehelpindex --force" as root, first of all (see
above).


If I click on "build" it says its going to place the index somewhere under
~/.kde4 (my home), but then requests my root password to continue (!). I
type it, nothing runs. The status says:

index creation finished. kdesu(16612)/kdesu (kdelibs)
KDESu::KDESuPrivate::KCookie::getXCookie: No X authentication info set for
display ":0.0" QProcess: Destroyed while process is still running.


If I try "search" for "konqueror", I am prompted to build the index again, and again it fails, with:

kdesu(16663)/kdesu (kdelibs) KDESu::KDESuPrivate::KCookie::getXCookie: No X authentication info set for display ":0.0"
kdesu(16663)/kdesu (kdelibs) KDESu::KDESuPrivate::KCookie::getXCookie: No X authentication info set for display ":0.0"
kdesu(16663)/kdesu (kdelibs) KDESu::KDESuPrivate::KCookie::getXCookie: No X authentication info set for display ":0.0"



The "Glosary" tab of the search left windowpane is empty (shows
alphabetically and by topic, both empty). The "contents" tab is full. Under
Internet there are entries for "konqueror" and "konqueror/kde3", both empty.
There is another entry somewhere about "kde faq", it is also empty.


Gnome help also fails in the exact same way.


Where is my help gone to?


This is not today, it has been so since I installed 10.3. No help at all.


Now that I have repeated the procedure to get you an screenshot (see attachment later), I read in black letters over almost black background this text:

   The requested help file could not be parsed:
   /usr/share/doc/kde/HTML/en//konqueror/index.docbook

Bingo!

There is not help because you did not provide the help files! How come? :-/


Comment 15 Carlos Robinson 2008-03-28 11:45:38 UTC
Created attachment 204618 [details]
screenshot of broken help view Re Comment #14
Comment 16 Carlos Robinson 2008-03-29 13:04:12 UTC
I removed everything related to KDE 4, and some problems were solved. Then I run "susehelpindex --force --verbose" and it got better.

If I click on Help in konqueror, a firefox window pops up, where I can search for "konqueror" and find nothing.

If I manually open "khelpcenter" (on the same or another workspace) and repeat the previous test, I get a "khelpcenter" window with knoqueror manual opened.

If I type search for "kbabel" in "khelpcenter", I get this:

 
]  Search Results for 'kbabel':
]
]Novell AppArmor Administration Guide (en)
]GNU Licenses
] Htdig error: 
]Unable to read configuration file
]
]Background Information on AppArmor Profiling
] Htdig error: 
]Unable to read configuration file
...
(a lot more errors, then...)
...
] Application Manuals
] KDE Application Manuals
] kbabel

and clicking there rbings me the kbabel manual.


If I click "help" on a gnome app, like gnome-terminal, I get the firefox window, without the manual. Searching for "gnome-terminal" gets me this:


] SUSE Help
]	
]  	
]  	
] Home 	Content 	Search Options 	Search:
]
] Search Results for 'gnometerminal'

and nothing found.

So, Help only works in "khelpcenter" - although that is unable to find the "gnome-terminal". Thinking that that manual might not exist, I try with one I do know that exists (it is in "contents"), like the "gedit" manual: search does not find it. It finds entries, but wrong ones that do not work:

 
]  Search Results for 'gedit':
]
]Novell AppArmor Administration Guide (en)
]GNU Licenses
] Htdig error: 
]Unable to read configuration file
]
]Background Information on AppArmor Profiling
] Htdig error: 
]Unable to read configuration file
...
]GNOME User Guide (en)
]GNOME Desktop
]openSUSE 10.2 (11/23/06)
	  	
 but clicking there pops up another error:

] 	Unable to run the command specified. The file or folder 
] file:///usr/share/doc/manual/opensuse-gnomeuser_en/manual/sec.linwin.sys.html
] does not exist.

And it is true, the dir exists, but not the file.

If I manually start "yelp" and search for "gedit", I get:

] Search results for "gedit"
]
] file:///opt/kde3/share/doc/HTML/en/kdelibs-apidocs/kdeui/html/kcolordialog_8cpp-source.html
] Applications with Devanagri
] SCIM (智能通用输入法平台) 使用手册
] Setting up Loadlin
] How this Xmodmap solution works on various systems
] Other Items - GNU Aspell 0.60.4
] PfaEdit (FontForge ????????) ???????X?_
] Changes to pfaedit (predecessor to fontforge)
] Index
] HPLIP Troubleshooting - General/Other
]
]
]
] Repeat the search online at the GNOME Support Forums

It doesn't find the manual, which is findable browsing for it. You see, it is impossible to reliably search for anything in the help system.
Comment 17 Axel Braun 2009-01-07 17:53:50 UTC
Just by chance I used the Help in 11.1/KDE 3.5.10 -> still the same problem, the help is not working out of the box:

Suchergebnisse für "DHCP"
Start
Installation und Einrichtung
khc_htsearch.pl --indexdir=/home/axel/.kde/share/apps/khelpcenter/index/ --config=book_opensuse_startupde --words=DHCP --method=and --maxnum=5 --lang=de
Comment 18 Karl Eichwalder 2009-01-08 09:53:14 UTC
If it does not work and nobody can fix it because of time constraints or whatever, we should remove this feature from the GUI.

I'm not sure about KDE 4, though.
Comment 19 Eberhard Harbrink 2009-01-08 21:28:26 UTC
For me, after upgrading to 11.1, the search works now.
Comment 20 Axel Braun 2009-01-09 09:23:32 UTC
(In reply to comment #19 from Eberhard Harbrink)
> For me, after upgrading to 11.1, the search works now.

what additional packages did you install? 

Comment 21 Eberhard Harbrink 2009-01-10 20:36:10 UTC
Nothing special I know of. I upgraded from 10.3 to 11.1 using the default package selection for KDE 4 and KDE3.
Comment 22 Forgotten User Xh41Ao4q6j 2010-11-28 17:38:40 UTC
I use 11.3 and after building index as user I have options to search:
openSUSE Documenation (en)
Application Manuals
Unix manual pages 
(side note:see the capitalization)

Default search is to look in none of them. (??)

When I enable search for all it will give error for openSUSE docs:
"Htdig error:
Unable to read word database file '/home/user/.kde4/share/apps/khelpcenter/index//opensuse-manuals_en.words.db'
Did you run htdig?"

When in /home/user/.kde4/share/apps/khelpcenter/index/ :
> ls -1
kde_application_manuals.conf
kde_application_manuals.docdb
kde_application_manuals.docs.index
kde_application_manuals.excerpts
kde_application_manuals.exists
kde_application_manuals.tmp
kde_application_manuals.words.db
kde_application_manuals.words.db_weakcmpr
opensuse-manuals_en.conf
opensuse-manuals_en.docdb
opensuse-manuals_en.docs.index
opensuse-manuals_en.excerpts
opensuse-manuals_en.exists

So htdig is looking for non existing word database. 

Changing product to 11.3.
Comment 23 Karl Eichwalder 2010-11-29 08:13:21 UTC
jw experienced something similar recently.
Comment 24 Stelescu Raul 2012-01-07 14:13:55 UTC
This bug is fixed in openSUSE 12.1
Comment 25 Christian Trippe 2012-01-07 20:07:12 UTC
@Stelescu Raul: How did you test this? To my knowledge the search was removed (temporaly?!) with KDE 4.6 and as such is not available in openSUSE 11.4 and 12.1?

For 11.3 this probably means WONTFIX.

References to upstream reports about the removed search:
https://bugs.kde.org/show_bug.cgi?id=269619
https://bugs.kde.org/show_bug.cgi?id=277464