From 92bd0e70aa7f76691a6b877be0966969fe7b92d3 Mon Sep 17 00:00:00 2001 From: Lars Vogel Date: Tue, 21 Nov 2023 12:25:42 +0100 Subject: [PATCH] Migrating Category wiki page Moves an improved version of https://wiki.eclipse.org/Tycho/category.xml to the Tycho documentation See #2564 --- src/site/markdown/Category.md | 64 +++++++++++++++++++++++++++++++++++ src/site/site.xml | 1 + 2 files changed, 65 insertions(+) create mode 100644 src/site/markdown/Category.md diff --git a/src/site/markdown/Category.md b/src/site/markdown/Category.md new file mode 100644 index 0000000000..307a849b4c --- /dev/null +++ b/src/site/markdown/Category.md @@ -0,0 +1,64 @@ +# Category + +A category.xml file can be used to define which content is placed into a p2 repository. +It can also specify how to display the content in the p2 installation dialog. +For Tycho to use it, it must to be placed into the root of an project with the packaging type 'eclipse-repository'. + +The 'category.xml' format was originally defined by the Eclipse PDE project. +There are extensions to the format only supported by p2 and Tycho. + +The following listing is a simple category file listing only one feature and one plug-in. + + +``` + + + + + + + +``` +The following is an example, demonstrating a complex category definition. + +``` + + + + + + + + + + + + + + + + + + + another.unit.id + + + + + + + + + Details on the category + + + + + + + id ~= /javax.*/ + + +``` \ No newline at end of file diff --git a/src/site/site.xml b/src/site/site.xml index d8c47bd0c6..144ab76d9f 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -8,6 +8,7 @@ +