Maintainer's Guide

Getting Started

1. Setting up the unified build system
2. Packaging workflow
3. Areas of contribution
4. Documentation resources
5. Additional resources

Overview of the Build System

1. Hierarchy

   1. Description
   2. Categories
   3. Meta-packages

2. Component structure

   1. Files
   2. Makefile targets
   3. Testing
   4. Recommendations
3. IPS manifests
   1. Manifest generation
   2. Package actions
   3. Transforms
   4. Variants and facets
   5. Incorporations
   6. Linting
4. Package repositories
   1. On-disk repositories
   2. Remote repositories
   3. Working with a pkg(5) server

Common Tasks

1. Updating an existing component
   1. Version bump
   2. Patches and security fixes
2. Creating a new component
3. Deprecating a component
4. Renaming a component
5. Submitting a component for review
6. Using pkg(5) for packaging tasks
7. Best practices

Specific Packaging Rules

1. Component templates for build systems
2. Software specific make-rules
3. External software gates
   1. illumos-gate
   2. gfx-drm
4. Advanced packaging rules
   1. Python
   2. Perl
   3. MPI

Continuous Integration

1. Using Jenkins for OpenIndiana Hipster
2. Build server workflow
3. Setting up incremental builds
4. Troubleshooting