Managing Xen Patches with Git-series

This document assumes that you are familiar with the following documents

• Xen Project Repositories
• Submitting Xen Project Patches - the document explains conventions related to cover letters, *-by tags, etc. as well as the tooling involved in sending patches and patch series

This document lays out a very basic example on how to use git-series. Git series is an add-on to git implemented in Rust.

For installation instructions see https://github.com/git-series/git-series/blob/master/README.md Before you install git-series, you will need to have install if not on your system yet

• Rust: see https://www.rust-lang.org/tools/install
• cmake: see https://cmake.org/download/ - note that this dependency is not documented in the git-series README file, which is why it is covered here. Also note that after an install, the command line tools are not installed automatically for all operating systems. Go to the UI and select Tools > How to Install for Command line use.

Similar documents exist for

• Git: see Managing Xen Patches with Git.
• StGit: see Managing Xen Patches with StGit.

git-series Basics

Before you consider using git-series, please check out the following youtube video:

• Minutes 0:00 to 13:28: Explains the problem that git-series solves. Note that this is worthwhile watching regardless of whether you choose to use git-series
• Minutes 13:28 to 24:30: Demo of git-series
  • Minutes 19:43: Instructions on how to format a series and send pull requests based on one
  • Minutes 20:20: Working on multiple series in parallel
• Minutes 24:30 to 40:24: How does git-series work internally and interacts with git
• Minutes 24:30 to end: Discussion - worthwhile watching

git-series Tutorials

• README
• Man Page
• Video recording of git-series with demo