Skip to content

Remove pre-built indexes for Eclipse Help system#264

Merged
MatthewKhouzam merged 1 commit intoeclipse-tracecompass-incubator:masterfrom
jonahgraham:indexes
Mar 11, 2026
Merged

Remove pre-built indexes for Eclipse Help system#264
MatthewKhouzam merged 1 commit intoeclipse-tracecompass-incubator:masterfrom
jonahgraham:indexes

Conversation

@jonahgraham
Copy link
Contributor

@jonahgraham jonahgraham commented Mar 11, 2026

What it does

This change fixes errors when doing a Help -> Contents and then initiating a search.

Errors such as:

!ENTRY org.eclipse.help.base 2 0 2026-03-11 13:55:32.290
!MESSAGE Unable to consume Lucene index from bundle 'org.eclipse.tracecompass.doc.user_11.2.0.202512122003 [236]'. The index should be rebuilt with Lucene 10.3.2

or

!ENTRY org.eclipse.help.base 4 0 2026-03-11 14:34:35.767
!MESSAGE Help index declared, but missing for plugin org.eclipse.tracecompass.incubator.ros2.doc.user.

The latter error generally happens for the incubator because the skeleton included building the index, but the build.properties was missing the the index/ entry, so they were not included in built bundles.

See eclipse-simrel/simrel.build#1288

How to test

  1. Build the bundles (with maven) and install them into Eclipse or start the RCP app.
  2. From Help -> Contents start a search
  3. Check the error log to make sure that no index errors are displayed - you should also see indexing message in the help:
image

Follow-ups

Review checklist

  • As an author, I have thoroughly tested my changes and carefully followed the instructions in this template

Summary by CodeRabbit

  • Chores
    • Simplified documentation build configuration by removing help search index generation across all documentation modules and the parent build system.

This change fixes errors when doing a Help -> Contents and then
initiating a search.

Errors such as:

```
!ENTRY org.eclipse.help.base 2 0 2026-03-11 13:55:32.290
!MESSAGE Unable to consume Lucene index from bundle 'org.eclipse.tracecompass.doc.user_11.2.0.202512122003 [236]'. The index should be rebuilt with Lucene 10.3.2
```

or

```
!ENTRY org.eclipse.help.base 4 0 2026-03-11 14:34:35.767
!MESSAGE Help index declared, but missing for plugin org.eclipse.tracecompass.incubator.ros2.doc.user.
```

The latter error generally happens for the incubator because the
skeleton included building the index, but the build.properties
was missing the the `index/` entry, so they were not included in
built bundles.

See eclipse-simrel/simrel.build#1288
@coderabbitai
Copy link

coderabbitai bot commented Mar 11, 2026

📝 Walkthrough

Walkthrough

This change removes help index building functionality from Trace Compass documentation modules across the project. The modification deletes Ant build targets named build.index, removes Eclipse help index configuration elements from plugin files, and eliminates Maven plugin configurations for tycho-eclipserun and maven-clean from approximately 30 documentation modules and parent POM files.

Changes

Cohort / File(s) Summary
Documentation Build Targets (Ant)
doc/org.eclipse.tracecompass.incubator.*/build.xml, skeleton/skeleton.doc.user/build.xml, doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/build.xml
Removed the build.index Ant target that previously built plugin search indexes when eclipse.running was true. All occurrences consistently deleted with no replacements.
Documentation Plugin Extensions
doc/org.eclipse.tracecompass.incubator.*/plugin.xml, skeleton/skeleton.doc.user/plugin.xml, doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/plugin.xml
Removed the <index path="index/"></index> element from Eclipse help TOC extensions in all doc modules, eliminating help index contributions.
Documentation Maven Build Config
doc/org.eclipse.tracecompass.incubator.*/pom.xml, skeleton/skeleton.doc.user/pom.xml, doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/pom.xml
Deleted tycho-eclipserun-plugin configurations and maven-clean-plugin executions across all doc modules, removing automated help index generation and index cleanup during Maven build phases.
Build Configuration
pom.xml, skeleton/skeleton.rcp/skeleton.tracecompass.parent/pom.xml
Removed help-docs-eclipserun-repo property and tycho-eclipserun-plugin configuration from root and parent POM files.
External Tool Builder Config
doc/org.eclipse.tracecompass.incubator.inandout.doc.user/.externalToolBuilders/Trace Compass Incubator User Guide Builder.launch
Removed build.index from the ANT_MANUAL_TARGETS value, leaving only the build target as manually executable.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 wiggles nose thoughtfully
Index pages flutter and fade away,
Build targets packed up for the day,
Maven plugins dance a new ballet—
Simpler docs now light the way! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Remove pre-built indexes for Eclipse Help system' directly and clearly summarizes the main change across all modified files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
doc/org.eclipse.tracecompass.incubator.inandout.doc.user/.externalToolBuilders/Trace Compass Incubator User Guide Builder.launch (1)

4-4: Sync this builder with the in-and-out doc bundle.

Removing index here is fine, but this launch config still points at /org.eclipse.tracecompass.tmf.pcap.doc.user/build.xml on Lines 7-9 and Line 18, and the project id on Line 16 does not match this bundle’s path. As committed, invoking this external builder will still target the wrong doc plugin.

Proposed fix
-<stringAttribute key="org.eclipse.debug.core.ATTR_REFRESH_SCOPE" value="${working_set:&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;&#10;&lt;resources&gt;&#10;&lt;item path=&quot;/org.eclipse.tracecompass.tmf.pcap.doc.user&quot; type=&quot;4&quot;/&gt;&#10;&lt;/resources&gt;}"/>
+<stringAttribute key="org.eclipse.debug.core.ATTR_REFRESH_SCOPE" value="${working_set:&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;&#10;&lt;resources&gt;&#10;&lt;item path=&quot;/org.eclipse.tracecompass.incubator.inandout.doc.user&quot; type=&quot;4&quot;/&gt;&#10;&lt;/resources&gt;}"/>
 <listAttribute key="org.eclipse.debug.core.MAPPED_RESOURCE_PATHS">
-<listEntry value="/org.eclipse.tracecompass.tmf.pcap.doc.user/build.xml"/>
+<listEntry value="/org.eclipse.tracecompass.incubator.inandout.doc.user/build.xml"/>
 </listAttribute>
-<stringAttribute key="org.eclipse.jdt.launching.PROJECT_ATTR" value="org.eclipse.tracecompass.incubator.inandoutdoc.user"/>
+<stringAttribute key="org.eclipse.jdt.launching.PROJECT_ATTR" value="org.eclipse.tracecompass.incubator.inandout.doc.user"/>
-<stringAttribute key="org.eclipse.ui.externaltools.ATTR_LOCATION" value="${workspace_loc:/org.eclipse.tracecompass.tmf.pcap.doc.user/build.xml}"/>
+<stringAttribute key="org.eclipse.ui.externaltools.ATTR_LOCATION" value="${workspace_loc:/org.eclipse.tracecompass.incubator.inandout.doc.user/build.xml}"/>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@doc/org.eclipse.tracecompass.incubator.inandout.doc.user/.externalToolBuilders/Trace`
Compass Incubator User Guide Builder.launch at line 4, The launch configuration
still references the wrong doc bundle and project: update the ANT build file
path and project id entries in this launch config so they point to this bundle’s
build.xml (replace the /org.eclipse.tracecompass.tmf.pcap.doc.user/build.xml
references) and set the project id to this bundle’s id, and if you removed the
index target ensure org.eclipse.ant.ui.ATTR_ANT_MANUAL_TARGETS only lists the
intended targets (e.g., "build") so the external builder runs against the
correct doc plugin.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In
`@doc/org.eclipse.tracecompass.incubator.inandout.doc.user/.externalToolBuilders/Trace`
Compass Incubator User Guide Builder.launch:
- Line 4: The launch configuration still references the wrong doc bundle and
project: update the ANT build file path and project id entries in this launch
config so they point to this bundle’s build.xml (replace the
/org.eclipse.tracecompass.tmf.pcap.doc.user/build.xml references) and set the
project id to this bundle’s id, and if you removed the index target ensure
org.eclipse.ant.ui.ATTR_ANT_MANUAL_TARGETS only lists the intended targets
(e.g., "build") so the external builder runs against the correct doc plugin.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a2ce0dd7-9f17-410f-9440-88299413db2e

📥 Commits

Reviewing files that changed from the base of the PR and between 11f36c0 and 3df0448.

📒 Files selected for processing (66)
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/.externalToolBuilders/Trace Compass Incubator User Guide Builder.launch
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/build.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/pom.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/pom.xml
  • pom.xml
  • skeleton/skeleton.doc.user/build.xml
  • skeleton/skeleton.doc.user/plugin.xml
  • skeleton/skeleton.doc.user/pom.xml
  • skeleton/skeleton.rcp/skeleton.tracecompass.parent/pom.xml
💤 Files with no reviewable changes (65)
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/build.xml
  • skeleton/skeleton.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.eventfieldcount.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.opentracing.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.gerrit.doc.user/pom.xml
  • skeleton/skeleton.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.virtual.machine.analysis.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/build.xml
  • doc/org.eclipse.tracecompass.incubator.filters.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ros2.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.uftrace.doc.user/plugin.xml
  • pom.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.otf2.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ros.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.system.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.inandout.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.kernel.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.trace.server.doc.dev/pom.xml
  • doc/org.eclipse.tracecompass.incubator.atrace.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.executioncomparison.doc.user/pom.xml
  • skeleton/skeleton.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.gpu.doc.user/pom.xml
  • doc/org.eclipse.tracecompass.incubator.scripting.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.ftrace.doc.user/plugin.xml
  • doc/org.eclipse.tracecompass.incubator.perf.profiling.doc.user/build.xml
  • doc/org.eclipse.tracecompass.incubator.lttng2.ust.extras.doc.user/plugin.xml
  • skeleton/skeleton.rcp/skeleton.tracecompass.parent/pom.xml

@MatthewKhouzam MatthewKhouzam merged commit acf0796 into eclipse-tracecompass-incubator:master Mar 11, 2026
3 checks passed
@jonahgraham jonahgraham deleted the indexes branch March 12, 2026 13:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants