bladeRF/doc/development/version_change_checklist.md
Jon Szymaniak d4b1b812ac doc: Fixed project-wide tag instructions
We want the tag to be at/after the debian changelog update.
2014-12-23 11:56:33 -05:00

3 KiB

bladeRF Version Change Checklist

This document describes tasks that must be performed when updating the version numbers of various components contained in this repository.

Build and functional tasks are a given are documented elsewhere and are not covered here.

When multiple components in the repo have changed, this checklist should be performed in the following order:

  • FPGA
  • FX3 Firmware
  • libbladeRF
  • bladeRF-cli
  • Project-wide items

FPGA

  • Update the hdl/CHANGELOG file

  • Update the version number in the NIOS II lms_spi_controller.c file.

  • Update the version compatibilty table in the libbladeRF version_compat.c file.

  • Apply the tag: fpga_vX.Y.Z

  • Generate the official bitstreams at the tag and have them uploaded to https://www.nuand.com/fpga

  • Update the bladerf-fpga-hostedx115.postinst and bladerf-fpga-hostedx40.postinst files under host/debian/.

FX3 Firmware

  • Update the fx3_firmware/CHANGELOG file

  • Update the version number in the FX3 firmware CMakeLists.txt file

  • Update the version compatibility table in the libbladeRF version_compat.c file.

  • Apply the tag: firmware_vX.Y.Z

  • Generate the official image at the tag with the following CMake config:

    • -DTAGGED_RELEASE=Yes (If building from top-level)
    • -DVERSION_INFO_EXTRA="" (If building in fx3_firmware)
  • Have the image uploaded to https://www.nuand.com/fx3

  • Update the bladerf-firmware-fx3.postinst file under host/debian.

libbladeRF

  • Update the libbladeRF/CHANGELOG file

  • Update the version number in the CMakeLists.txt file

  • Apply the tag: libbladeRF_vX.Y.Z

  • Generate Doxygen pages at the tag with:

    • -DTAGGED_RELEASE=Yes (If building from top-level)
    • -DVERSION_INFO_EXTRA="" (If building in host/)

bladeRF-cli

  • Regenerate the fallback cmd_help.* items using the generate.bash script. (This is in src/cmd/doc/.)

  • Update the version number in the CMakeLists.txt file

  • Update the bladeRF-cli/CHANGELOG file

  • Apply the tag bladeRF-cli_vX.Y.X

Project-wide items

  • Ensure all of the above items are at a tagged version

  • Update the top-level CHANGELOG file.

  • Update the debian/CHANGELOG file

  • Apply the tag: YYYY-MM[-rcN]

  • Prepare the API docs and binary packages