blob: 0da9614d69b277878f53d7dfdfd6c94e0e4a25cc [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<meta name="copyright"
content="Copyright (c) IBM Corporation and others 2009, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
<meta http-equiv="Content-Type"
content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Content categorization</title>
</head>
<body>
<h1>Content categorization</h1>
<p>
By default, the p2 Install Software Dialog groups all the installable units by category. If an installable unit is not
categorized, it will not be displayed in the user interface.
</p>
<img src="images/no_category.png" alt="Picture showing the 'Install Software' dialog without categorized items">
<p>
There are currently two supported methods for categorizing content.
</p>
<ol>
<li><a href="#category_def">A category definition file</a></li>
<li><a href="#p2_inf">A p2.inf file</a></li>
</ol>
<h2><a name="category_def">Category Definition File</a></h2>
<p>
A category definition file is an XML file that describes which categories a feature should be listed in.
The category definition file can be edited using the
<a href="../../org.eclipse.pde.doc.user/guide/tools/editors/category_editor/definition_page.htm">Category Definition Editor</a>.
The category definition can be specified when
<a href="../../org.eclipse.pde.doc.user/guide/tools/export_wizards/export_features.htm">exporting a feature</a>,
<a href="../../org.eclipse.pde.doc.user/tasks/pde_p2_builds.htm">building using PDE Build</a>,
or injected into a repository using the
<a href="p2_publisher.html#category_publisher">category publisher</a>.
</p>
<h2><a name="p2_inf">The p2.inf File</a></h2>
<p>
The p2.inf file is a properties file that can be used to customize capabilites, properties, and instructions. Information
about this provisional file is available in the section
<a href="p2_customizing_metadata.html">Customizing p2 metadata</a>.
</p>
</body>
</html>