CRUX-ARM : Home

Home :: Documentation :: Download :: Development :: Community :: Ports :: Packages :: Bugs :: Links :: About :: Donors

Documentation

Maintain Overlays


Introduction

This is a brief guide to describe the necessary steps to update a port from an overlay repository.

Considerations

The right order to maintain overlays is: core-arm, opt-arm, xorg-arm, <officially-supported_device>-arm, <officially-supported_device>-arm, ...
This means that we should not start with a port from opt-arm if there is a pending update port from core-arm.

Steps

Get a copy of devtools.git and use checkOverlayUpdates.sh to look for new available updates upstream:

 $ checkOverlayUpdates.sh core-arm
 Results for overlay: core-arm
 PORT                 VERSION              UPSTREAM
 util-linux           2.24-1               2.24.1-1 (core)

Note that you must run 'ports -u' before use checkOverlayUpdates.sh to be sure you are up-to-date

If there are available updates we must to know the differences applied upstream.
For this case we should go to CRUX upstream's gitweb interface:
http://crux.nu/gitweb/?p=ports/core.git;a=commitdiff;h=53bc70dfcd7e28cc2996e7e2e0bda297fe955588

If upstream changes are trivial as increment the version number, then apply the same difference to the Pkgfile and build the port:
http://crux-arm.nu/gitweb?p=ports/core-arm.git;a=commitdiff;h=65ff2db684cdd1de1ab24cb517d2b7dc56bd4ac9
However, if something must be adapted to ARM devices then it will need more work.

At the end, if we can't update the port overlay then we should file a ticket with all the research progress we made.
The ticket must be tagged as task type: Update Request, and it should contain a brief description of the problem, and all the needed info to reproduce it. Also it would be fine to append all the research info, useful url links, etc.