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.
This commit is contained in:
@@ -0,0 +1,77 @@
|
||||
# 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).
|
||||
Reference in New Issue
Block a user