Skip to content

Add org.bndtools.help Eclipse help plugin with bnd and Bndtools UI documentation#7111

Draft
Copilot wants to merge 4 commits intomasterfrom
copilot/create-eclipse-help-plugin
Draft

Add org.bndtools.help Eclipse help plugin with bnd and Bndtools UI documentation#7111
Copilot wants to merge 4 commits intomasterfrom
copilot/create-eclipse-help-plugin

Conversation

Copy link
Contributor

Copilot AI commented Feb 25, 2026

Adds a new org.bndtools.help OSGi bundle that integrates bnd/Bndtools documentation into the Eclipse Help infocenter system (Help > Help Contents) via the org.eclipse.help.toc extension point.

New plugin: org.bndtools.help

  • bnd.bnd — resource-only bundle (-resourceonly: true), no Java code needed
  • _plugin.xml — registers with org.eclipse.help.toc as primary TOC
  • toc.xml — hierarchical TOC with ~490 entries across 6 sections

Documentation content

bnd reference docs (converted from docs/ markdown sources):

  • 44 user guide chapters
  • 153 instruction reference pages
  • 55 manifest header pages
  • 138 macro pages
  • 77 CLI command pages

Bndtools UI manual (sourced from bndtools/bndtools.github.io/_manual/):

  • Bndtools Explorer, Bnd Editor, JAR Viewer, Repositories View, Resolution View, Project Templates
  • Images linked to live https://bndtools.org/images/... (keeps bundle small; no offline image copies)

TOC structure

<toc label="bnd Documentation" topic="docs/index.html">
   <topic label="Bndtools UI Manual" href="docs/manual/index.html">
      <topic label="Bndtools Explorer" href="docs/manual/packageexplorer.html"/>
      <topic label="Bnd Editor"        href="docs/manual/bndeditor.html"/>
      <topic label="Resolution View"   href="docs/manual/resolution-view.html"/>
      ...
   </topic>
   <topic label="User Guide">...</topic>
   <topic label="Instructions Reference">...</topic>
   ...
</toc>

Integration

  • org.bndtools.p2/bnd.bnd — added to p2 site -dependson
  • org.bndtools.p2/bndtools.main.feature.bndrun — added to feature -runbundles
  • bndtools.core/bndtools.shared.bndrun and bndtools.shared.latest.bndrun — added to Eclipse dev launch configs

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • bndtools.jfrog.io
    • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java /usr/lib/jvm/temurin-17-jdk-amd64/bin/java --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.lang.invoke=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.prefs/java.util.prefs=ALL-UNNAMED --add-exports=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.prefs/java.util.prefs=ALL-UNNAMED --add-opens=java.base/java.nio.charset=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED --add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED --add-opens=java.xml/javax.xml.namespace=ALL-UNNAMED --add-opens=java.base/java.time=ALL-UNNAMED -Xms1024m -Xmx2048m -Dfile.encoding=UTF-8 -Duser.country -Duser.language=en (dns block)
  • scans-in.gradle.com
    • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java /usr/lib/jvm/temurin-17-jdk-amd64/bin/java --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.lang.invoke=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.prefs/java.util.prefs=ALL-UNNAMED --add-exports=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.prefs/java.util.prefs=ALL-UNNAMED --add-opens=java.base/java.nio.charset=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED --add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED --add-opens=java.xml/javax.xml.namespace=ALL-UNNAMED --add-opens=java.base/java.time=ALL-UNNAMED -Xms1024m -Xmx2048m -Dfile.encoding=UTF-8 -Duser.country -Duser.language=en (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits February 25, 2026 14:31
Co-authored-by: peterkir <250545+peterkir@users.noreply.github.com>
Co-authored-by: peterkir <250545+peterkir@users.noreply.github.com>
Copilot AI changed the title [WIP] Add Eclipse help plugin for org.bndtools.help Add org.bndtools.help Eclipse help plugin with bundled bnd documentation Feb 25, 2026
Co-authored-by: peterkir <250545+peterkir@users.noreply.github.com>
Copilot AI changed the title Add org.bndtools.help Eclipse help plugin with bundled bnd documentation Add org.bndtools.help Eclipse help plugin with bnd and Bndtools UI documentation Feb 25, 2026
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