Hello there, I hope you could help me with the following problem: after installation of KDevelop 2.1 I wanted to index the KDE and Qt library documentation through the options menu and everything seemed to work fine, htdig was creating some search database, but strangely, after completing the Kde and Qt stuff it continued to process other files on my disk that i didn't want - it even tried to access cd-rom drives, so I interrupted this weird process by ctrl-c. My question is, how to avoid this indexing of files that have nothing to do with the documentation I selected.
Regards,
Rene Puchinger

You'll find help if you search for entries here for 90 days or more. I found the following responses below and I used the one that reads:

and after editing my htdig.conf in ~/.kde/share/apps/kdevelop, and reindexing, I was able to get my searches to work.

By the way, I edited my htdig.conf and made the following changes:

start_url: file://localhost/usr/share/doc/HTML/en/kdevelop/ \
file://localhost/usr/lib/qt-3.0.5/doc/html/ \
file://localhost/usr/share/doc/kdelibs-devel-3/

limit_urls_to: /usr/share/doc/HTML/en/kdevelop/ \
/usr/lib/qt-3.0.5/doc/html/ \
/usr/share/doc/kdelibs-devel-3/

I hope this gets it sorted for you, it did for me.

John



----------------------------------------------------------
I've found that changing /usr/share/apps/kdevelop/tools/htdig.conf
AND $HOME/.kde/share/apps/kdevelop/tools/htdig.conf
fixes the problem.

But now that I've switched to Mandrake 9.0 since my RedHat and EXT3fs
messedup all my XFree 4.X.X... Which didn't want to start after a sudden power down. ( I think ext3 is worse than ext2...), I am back to better and STABLE and REAL journal fs ---->> Reiserfs.

With RedHat, I have learned that (thanks to Larry) there must be a $HOME/.kdevelop-doc subdir for htdig. This is where it supposed to store its db. When re-doing "create search database" from Kdevelop->Documentation dlg, this subdir's content must be cleared otherwize htdig will NOT re-create its db. ...

I am still searching how to get htdig to process KDE html docs on both RedHat and Mandrake. Because only QT and STL search works - noting for KDE - ?????
btw: "additionnal directories to index" doesn't work either...

--------------------------------------

I ended up having to remove the glimpse indexing utilities that I had installed. I saw in the KDevelop source that it was always using the glimpse indexes by default if it was installed. However, I could never get anything but a message saying that the search item was not found in the documentation.

I ended up removing glimpse, all the .glimpse* index files, and after editing my htdig.conf in ~/.kde/share/apps/kdevelop, and reindexing, I was able to get my searches to work.

By the way, I edited my htdig.conf and made the following changes:

start_url: file://localhost/usr/share/doc/HTML/en/kdevelop/ \
file://localhost/usr/lib/qt-3.0.5/doc/html/ \
file://localhost/usr/share/doc/kdelibs-devel-3/

limit_urls_to: /usr/share/doc/HTML/en/kdevelop/ \
/usr/lib/qt-3.0.5/doc/html/ \
/usr/share/doc/kdelibs-devel-3/

I tried setting limit_urls_to: ${start_url}, but it htdig would not index anything at that point. Doing it this way allowed it to process what I wanted it to and also prevented the wierdness that has cropped up where it wants to index the entire computer system.

---------------------------------------------------------

I successfully found entries in the Qt, KDE, and C++ Standard Library docs when trying some test searches (which doesn't mean anything except that those steps worked on my particular system).

Are you sure htdig is actually building database files when you run setup? If a URL doesn't contain a string pattern that matches one of the patterns in the limit_urls_to attribute, htdig won't index the docs that reside there. It's important to note where setup finds your Qt and KDE docs. If it finds them through symbolic links, and the URLs formed from those paths don't contain a string pattern you've specified with limit_urls_to, the docs won't be indexed, even if a URL that could be formed from their actual directories would contain the right string pattern.

I recommend copying the output that's generated during indexing and saving it to a file, so you can search it to make sure everything you intended to be indexed was.

I didn't note that I specified medium for the index size, as recommended in the "Create Search Database" section here: [www.kdevelop.org]

--------------------------------------------------

These steps indexed the Qt, KDE, and Standard C++ library documentation with a default install of KDevelop 2.1.3 under Red Hat 8 for me:

Delete the files in ~/.kdevelop-doc/
(assuming previous attempts)

Edit ~/.kde/share/apps/kdevelop/tools/htdig.conf
change limit_urls_to: file://
to this: limit_urls_to: /usr/
(if other directories you're indexing don't have /usr/ in their path, add an entry to this line for them)

Run kdevelop --setup

Setup found the Qt and KDE library doc directories in my plain vanilla Red Hat 8 install.

Add other directories for indexing, like:
/usr/share/doc/libstdc++-devel-3.2/html/

Don't forget to click the button to start the indexing.

You'll find help if you search for entries here for 90 days or more. I found the following responses below and I used the one that reads:

and after editing my htdig.conf in ~/.kde/share/apps/kdevelop, and reindexing, I was able to get my searches to work.

By the way, I edited my htdig.conf and made the following changes:

start_url: file://localhost/usr/share/doc/HTML/en/kdevelop/ \
file://localhost/usr/lib/qt-3.0.5/doc/html/ \
file://localhost/usr/share/doc/kdelibs-devel-3/

limit_urls_to: /usr/share/doc/HTML/en/kdevelop/ \
/usr/lib/qt-3.0.5/doc/html/ \
/usr/share/doc/kdelibs-devel-3/

I hope this gets it sorted for you, it did for me.

John



----------------------------------------------------------
I've found that changing /usr/share/apps/kdevelop/tools/htdig.conf
AND $HOME/.kde/share/apps/kdevelop/tools/htdig.conf
fixes the problem.

But now that I've switched to Mandrake 9.0 since my RedHat and EXT3fs
messedup all my XFree 4.X.X... Which didn't want to start after a sudden power down. ( I think ext3 is worse than ext2...), I am back to better and STABLE and REAL journal fs ---->> Reiserfs.

With RedHat, I have learned that (thanks to Larry) there must be a $HOME/.kdevelop-doc subdir for htdig. This is where it supposed to store its db. When re-doing "create search database" from Kdevelop->Documentation dlg, this subdir's content must be cleared otherwize htdig will NOT re-create its db. ...

I am still searching how to get htdig to process KDE html docs on both RedHat and Mandrake. Because only QT and STL search works - noting for KDE - ?????
btw: "additionnal directories to index" doesn't work either...

--------------------------------------

I ended up having to remove the glimpse indexing utilities that I had installed. I saw in the KDevelop source that it was always using the glimpse indexes by default if it was installed. However, I could never get anything but a message saying that the search item was not found in the documentation.

I ended up removing glimpse, all the .glimpse* index files, and after editing my htdig.conf in ~/.kde/share/apps/kdevelop, and reindexing, I was able to get my searches to work.

By the way, I edited my htdig.conf and made the following changes:

start_url: file://localhost/usr/share/doc/HTML/en/kdevelop/ \
file://localhost/usr/lib/qt-3.0.5/doc/html/ \
file://localhost/usr/share/doc/kdelibs-devel-3/

limit_urls_to: /usr/share/doc/HTML/en/kdevelop/ \
/usr/lib/qt-3.0.5/doc/html/ \
/usr/share/doc/kdelibs-devel-3/

I tried setting limit_urls_to: ${start_url}, but it htdig would not index anything at that point. Doing it this way allowed it to process what I wanted it to and also prevented the wierdness that has cropped up where it wants to index the entire computer system.

---------------------------------------------------------

I successfully found entries in the Qt, KDE, and C++ Standard Library docs when trying some test searches (which doesn't mean anything except that those steps worked on my particular system).

Are you sure htdig is actually building database files when you run setup? If a URL doesn't contain a string pattern that matches one of the patterns in the limit_urls_to attribute, htdig won't index the docs that reside there. It's important to note where setup finds your Qt and KDE docs. If it finds them through symbolic links, and the URLs formed from those paths don't contain a string pattern you've specified with limit_urls_to, the docs won't be indexed, even if a URL that could be formed from their actual directories would contain the right string pattern.

I recommend copying the output that's generated during indexing and saving it to a file, so you can search it to make sure everything you intended to be indexed was.

I didn't note that I specified medium for the index size, as recommended in the "Create Search Database" section here: [www.kdevelop.org]

--------------------------------------------------

These steps indexed the Qt, KDE, and Standard C++ library documentation with a default install of KDevelop 2.1.3 under Red Hat 8 for me:

Delete the files in ~/.kdevelop-doc/
(assuming previous attempts)

Edit ~/.kde/share/apps/kdevelop/tools/htdig.conf
change limit_urls_to: file://
to this: limit_urls_to: /usr/
(if other directories you're indexing don't have /usr/ in their path, add an entry to this line for them)

Run kdevelop --setup

Setup found the Qt and KDE library doc directories in my plain vanilla Red Hat 8 install.

Add other directories for indexing, like:
/usr/share/doc/libstdc++-devel-3.2/html/

Don't forget to click the button to start the indexing.