Quilt

Introduction

Quilt is a little tool used to manage patches. The project is hosted on savannah forge and can be found in debian package repository.

Using quilt in ARMadeus project

Quilt is useful when linux kernel or buildroot modification must be done. Because ARMadeus use official linux/buildroot sources, each specific modification for our platform must be done with a patch. And patches are versionned on ARMadeus sourceforge repository in directory /home/fabien/Projects/exer/software/bsp/buildroot/target/device/armadeus/linux/kernel-patches/ for Linux kernel and in patches/buildroot for buildroot.

To use it under ARMadeus Project, a simple script was written to simplify it : quiltify.sh. Launch it from the root project :

  [  ] $ ./scripts/quiltify.sh

Then answer questions (defaults are recommended). For linux kernel, quiltify will rename your source directory and download/patch/compile again the sources.

Once you done it, you can go to linux sources directory buildroot/project_build_armv5te/apf27/linux-2.6.29.6 then list all patches applied to with quilt command :

  [  ] $ quilt applied
015-armadeus-logo-add_armadeus-project_tux.patch
016-armadeus-imxfb-add_platform_specific_init_exit_functions.patch
018-armadeus-i2c-imx-add_driver_to_linux_build_system.patch
…
336-armadeus-imxfb-makes_it_compatible_with_arch_imx.patch
337-armadeus-imxfb-add_lcd_clock_def_for_imx_platform.patch
338-denx-mxcgpio-emulates_interrupt_on_both_edges.patch
339-apf27-armadeus-spidev.patch

If you want to create a new patche, just use new quilt command. Then before modifying linux file, add it to quilt with add command.

The file can be modified according to your wish.

Once modification done, you can generate the patch using refresh command. To add yours patches in the right directory, go to your project root then launch the script with export command :

  [  ] $ ./scripts/quiltify.sh export

Your patch is now ready to be committed on ARMadeus sourceforge.

Documentation

The man page of quilt is a good documentation, it's strongly recommended to read it before using it.