Files
marfrit-packages/upstream-submissions/README.md
marfrit a1dc662c39 upstream-submissions: top-level README
Index README for upstream-submissions/. Captures:
- Directory layout (3 subdirs, one per series).
- Where the actual patch files live.
- Submission status table (none filed yet).
- Validation gates common to all three series.
- Recommended submission order: vb2-dma-resv first (the
  architectural correction the kwin patch's premise depends on),
  qt6-base-fourier independently anytime, kwin-fourier last
  with reference to the merged/in-flight kernel patch.
- Cadence after submitting: review feedback loop, LTS backport
  requests, eventual retirement of the local -fourier packages
  once the upstream changes ship.
2026-04-28 19:54:06 +00:00

2.8 KiB

upstream-submissions/

Drafts of the upstream submission texts for the patch series in arch/ and kernel/. Each subdirectory pairs a patch series with the issue / merge-request / mailing-list body that should accompany it when going upstream.

Layout

upstream-submissions/
├── qt6-base-fourier/       # bugreports.qt.io issue + Gerrit notes
│   └── qt-bug-report.md
├── kwin-fourier/           # invent.kde.org MR body + KDE flow notes
│   └── kde-mr-body.md
└── vb2-dma-resv/           # linux-media cover letter + send-email recipe
    └── lkml-submission-notes.md

The patches themselves live in:

  • arch/qt6-base-fourier/0001..0003-*.patch (Qt 6 patches)
  • arch/kwin-fourier/0002-*.patch (KWin upstream-shape patch; 0001-*-bypass-*.patch is the local diagnostic, not for upstream)
  • kernel/vb2-dma-resv-rfc/0001..0003-*.patch plus 0000-cover-letter.patch (kernel patches)

Submission status

Series Bug filed Patches submitted Landed
qt6-base-fourier not yet not yet not yet
kwin-fourier (0002) n/a — KDE goes straight to MR not yet not yet
vb2-dma-resv n/a — kernel goes straight to mailing list not yet not yet

Validation gates before submitting

Each subdirectory's notes file lists the validation gates specific to that series. Common to all three:

  • Patches must apply cleanly to the latest upstream branch (rebase before sending).
  • Build must complete (compile-test for kernel; the others are already validated as building cleanly).
  • End-to-end runtime test on ohm should still pass with the patch applied (preferably with the other layers of the campaign also applied, so the patch doesn't get blamed for behavior in another layer).

Submission order

Recommended:

  1. vb2-dma-resv to linux-media first. The kernel-side fix is the architectural correction that makes the kwin patch's premise (the wait will signal correctly) actually true. If the kernel patch isn't merged or accepted, the kwin patch submission can still proceed but on weaker rationale.

  2. qt6-base-fourier to bugreports.qt.io + Gerrit second. Independent of the others; pure spec-correctness improvement for OpenGL ES 3.x, can land at any time.

  3. kwin-fourier (0002) to invent.kde.org last, ideally referencing the merged or in-flight kernel patch as the underlying correctness fix.

Cadence after submitting

  • Watch each upstream for review feedback; revise and resubmit.
  • After landing, request backports to LTS branches where applicable (Qt 6.5 LTS, Plasma 6.x, kernel stable).
  • Once landed in a release shipping to Arch / Debian / etc., the corresponding arch/*-fourier/ package becomes redundant and can be retired (drop the epoch=1 override, archive the PKGBUILD as historical reference).