forked from marfrit/marfrit-packages
marfrit
a1dc662c39
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.
78 lines
2.8 KiB
Markdown
78 lines
2.8 KiB
Markdown
# 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).
|