Home » Eclipse Projects » Platform - User Assistance (UA) » How make infocenter use pre-built plugin indexes?
How make infocenter use pre-built plugin indexes? [message #473804] |
Fri, 23 May 2008 08:55 |
Ian Messages: 7 Registered: July 2009 |
Junior Member |
|
|
I'm testing alternative ways to provide pre-built help search indexes for
use with an infocenter served on the Web. We have a lot of doc plug-ins
that are added and updated in independently, published by different teams,
and used in a variety of infocenters, so I thought it better to pre-build
the search index for each plug-in rather than pre-build for the entire
infocenter (product search index).
I cannot seem to get the Eclipse help to use the index pre-built in each
plug-in. I've timed some search tests, and the effect and time is the same
for both 1) no search index and 2) pre-built plug-in search indexes. In
both cases, the Eclipse help builds the search index when the first search
is performed. Having pre-built search index for each plug-in does not
seem to make this any faster.
Is there anything special I should do tell Eclipse help to use pre-built
plugin search indexes?
What effect should I expect to see on first search?
Note: When using a pre-built product index, the search is instant without
any "Indexing..." delay. Adding a plug-in with a pre-built plugin search
index seems to put the help into an "Indexing..." loop, hanging on 0%
complete, although I have the index built, the pre-built product index,
and the pre-built plugin index!
Scenarios:
1) Publish plug-ins to new infocenter (want instant search index from
pre-built plugin indexes - but could live with pre-built product index
first time)
2) Add new plug-ins (want to update index to add pre-built plugin index)
3) Add new version of a plug-in (want to update index to replace plugin
results with new version pre-built plugin index)
So, after all the waffle :-)
Is there anything special I should do tell Eclipse help to use pre-built
plugin search indexes?
Regards,
Ian
|
|
|
Re: How make infocenter use pre-built plugin indexes? [message #473808 is a reply to message #473804] |
Fri, 23 May 2008 13:01 |
Eclipse User |
|
|
|
Originally posted by: nospam_kowalskilee.gmail.com
Hi Ian,
What version of the Eclipse infocenter are you using? What level of Eclipse?
Best regards,
Lee Anne
Ian wrote:
> I'm testing alternative ways to provide pre-built help search indexes
> for use with an infocenter served on the Web. We have a lot of doc
> plug-ins that are added and updated in independently, published by
> different teams, and used in a variety of infocenters, so I thought it
> better to pre-build the search index for each plug-in rather than
> pre-build for the entire infocenter (product search index).
>
> I cannot seem to get the Eclipse help to use the index pre-built in each
> plug-in. I've timed some search tests, and the effect and time is the
> same for both 1) no search index and 2) pre-built plug-in search
> indexes. In both cases, the Eclipse help builds the search index when
> the first search is performed. Having pre-built search index for each
> plug-in does not seem to make this any faster.
>
> Is there anything special I should do tell Eclipse help to use pre-built
> plugin search indexes?
>
> What effect should I expect to see on first search?
>
> Note: When using a pre-built product index, the search is instant
> without any "Indexing..." delay. Adding a plug-in with a pre-built
> plugin search index seems to put the help into an "Indexing..." loop,
> hanging on 0% complete, although I have the index built, the pre-built
> product index, and the pre-built plugin index!
>
> Scenarios:
> 1) Publish plug-ins to new infocenter (want instant search index from
> pre-built plugin indexes - but could live with pre-built product index
> first time)
> 2) Add new plug-ins (want to update index to add pre-built plugin index)
> 3) Add new version of a plug-in (want to update index to replace plugin
> results with new version pre-built plugin index)
>
> So, after all the waffle :-)
>
> Is there anything special I should do tell Eclipse help to use pre-built
> plugin search indexes?
>
> Regards,
> Ian
>
>
>
>
>
>
|
|
| |
Re: How make infocenter use pre-built plugin indexes? [message #473812 is a reply to message #473810] |
Fri, 23 May 2008 16:16 |
Eclipse User |
|
|
|
Originally posted by: nospam_kowalskilee.gmail.com
Hi Ian,
So, just to confirm, the "hanging on 0" complete" that you mentioned in
your initial post--you've fixed that, right?
I'm not completely convinced that timing the search speed is the most
accurate test of the question "Is Eclipse using the pre-built indexes or
not?"
I mean, each pre-index is a zip file (doc_index.zip). When Eclipse
runtime starts up, it has to figure out what plug-ins to load up, and it
builds the directories under eclipse/configuration. (For example, at
startup, that's when the org.eclipse.osgi directory gets created under
eclipse/configuration).
At some point in time, Eclipse has to take each of those doc_index.zip
files and unpack them appropriately to create the:
eclipse/configuration/org.eclipse.help.base/index/en_US/* set of files
that is the collection that represents the search index for the active
doc configuration.
Those set of steps (in turn, get each doc_index.zip file, unpack it, add
contents to org.eclipse.help.base/index/en_US/*) has to be done for each
doc_index.zip file--so it makes sense that as there are more
doc_index.zip files, something is going to take longer.
What I'm not sure of is what that "something" is that will take longer.
I had thought that the unpacking of each doc_index.zip would take place
during runtime startup, and not at initial search use.
Lastly, maybe better test for the question "Is Eclipse using the
pre-built indexes or not?" might be the following:
a. Create pre-built indexes as usual.
b. Then, after they're built, alter one of the topic HTML files to have
some word that you know is not in the rest of the files (like Poodle)
c. Then, with a clean eclipse/configuration, start up Eclipse and then
try a search for Poodle.
The predicted outcome would be that if Eclipse is using the pre-built
indexes, then a search for "Poodle" would fail. If Eclipse is not using
the pre-built indexes and instead re-indexing the topics, then a search
for "Poodle" would succeed--because the term would have gotten indexed
in the re-indexing.
What do you think?
Best regards,
Lee Anne
|
|
| |
Re: How make infocenter use pre-built plugin indexes? [message #614386 is a reply to message #473804] |
Fri, 23 May 2008 13:01 |
Eclipse User |
|
|
|
Originally posted by: nospam_kowalskilee.gmail.com
Hi Ian,
What version of the Eclipse infocenter are you using? What level of Eclipse?
Best regards,
Lee Anne
Ian wrote:
> I'm testing alternative ways to provide pre-built help search indexes
> for use with an infocenter served on the Web. We have a lot of doc
> plug-ins that are added and updated in independently, published by
> different teams, and used in a variety of infocenters, so I thought it
> better to pre-build the search index for each plug-in rather than
> pre-build for the entire infocenter (product search index).
>
> I cannot seem to get the Eclipse help to use the index pre-built in each
> plug-in. I've timed some search tests, and the effect and time is the
> same for both 1) no search index and 2) pre-built plug-in search
> indexes. In both cases, the Eclipse help builds the search index when
> the first search is performed. Having pre-built search index for each
> plug-in does not seem to make this any faster.
>
> Is there anything special I should do tell Eclipse help to use pre-built
> plugin search indexes?
>
> What effect should I expect to see on first search?
>
> Note: When using a pre-built product index, the search is instant
> without any "Indexing..." delay. Adding a plug-in with a pre-built
> plugin search index seems to put the help into an "Indexing..." loop,
> hanging on 0% complete, although I have the index built, the pre-built
> product index, and the pre-built plugin index!
>
> Scenarios:
> 1) Publish plug-ins to new infocenter (want instant search index from
> pre-built plugin indexes - but could live with pre-built product index
> first time)
> 2) Add new plug-ins (want to update index to add pre-built plugin index)
> 3) Add new version of a plug-in (want to update index to replace plugin
> results with new version pre-built plugin index)
>
> So, after all the waffle :-)
>
> Is there anything special I should do tell Eclipse help to use pre-built
> plugin search indexes?
>
> Regards,
> Ian
>
>
>
>
>
>
|
|
| |
Re: How make infocenter use pre-built plugin indexes? [message #614388 is a reply to message #473810] |
Fri, 23 May 2008 16:16 |
Eclipse User |
|
|
|
Originally posted by: nospam_kowalskilee.gmail.com
Hi Ian,
So, just to confirm, the "hanging on 0" complete" that you mentioned in
your initial post--you've fixed that, right?
I'm not completely convinced that timing the search speed is the most
accurate test of the question "Is Eclipse using the pre-built indexes or
not?"
I mean, each pre-index is a zip file (doc_index.zip). When Eclipse
runtime starts up, it has to figure out what plug-ins to load up, and it
builds the directories under eclipse/configuration. (For example, at
startup, that's when the org.eclipse.osgi directory gets created under
eclipse/configuration).
At some point in time, Eclipse has to take each of those doc_index.zip
files and unpack them appropriately to create the:
eclipse/configuration/org.eclipse.help.base/index/en_US/* set of files
that is the collection that represents the search index for the active
doc configuration.
Those set of steps (in turn, get each doc_index.zip file, unpack it, add
contents to org.eclipse.help.base/index/en_US/*) has to be done for each
doc_index.zip file--so it makes sense that as there are more
doc_index.zip files, something is going to take longer.
What I'm not sure of is what that "something" is that will take longer.
I had thought that the unpacking of each doc_index.zip would take place
during runtime startup, and not at initial search use.
Lastly, maybe better test for the question "Is Eclipse using the
pre-built indexes or not?" might be the following:
a. Create pre-built indexes as usual.
b. Then, after they're built, alter one of the topic HTML files to have
some word that you know is not in the rest of the files (like Poodle)
c. Then, with a clean eclipse/configuration, start up Eclipse and then
try a search for Poodle.
The predicted outcome would be that if Eclipse is using the pre-built
indexes, then a search for "Poodle" would fail. If Eclipse is not using
the pre-built indexes and instead re-indexing the topics, then a search
for "Poodle" would succeed--because the term would have gotten indexed
in the re-indexing.
What do you think?
Best regards,
Lee Anne
|
|
| |
Goto Forum:
Current Time: Fri Apr 19 21:26:50 GMT 2024
Powered by FUDForum. Page generated in 0.03712 seconds
|