docs(common): add FAQ for modifying locally built Debian package version#1912
Merged
Milir-Radxa merged 1 commit intoJul 7, 2026
Conversation
Add a FAQ entry under the shared Kernel build-system template (common/radxa-os/build-system/_kernel.mdx) explaining how to override the version of the locally built Debian package by editing debian/changelog and re-running `make deb`. Use linux-qcom as the example repo, since it is the one used by Dragon Q6A. This FAQ applies to any product that imports the shared template, in particular Dragon Q6A (docs/dragon/q6a/low-level-dev/build-system/kernel). - Chinese: docs/common/radxa-os/build-system/_kernel.mdx - English: i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/build-system/_kernel.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
Dragon Q6A 客户在本地编译 Kernel Debian 包时，常常希望把版本号改高，避免与官方发布包混淆（也方便在 OTA/批量升级场景里区分自己编译的版本）。
当前
docs/dragon/q6a/low-level-dev/build-system/kernel公共模版 FAQ 里只覆盖了「如何使用增量编译模式」，没有覆盖「如何改版本号」。这次在公共模版（common/radxa-os/build-system/_kernel.mdx）FAQ 末尾追加一条 FAQ，复用linux-qcom作为示例仓库，与 Q6A 默认仓库一致。改动
在
common/radxa-os/build-system/_kernel.mdx（中文 + 英文）的 FAQ 末尾追加：如何修改本地构建出的 Debian 包的版本？
以 linux-qcom 仓库 为例，打开
debian/changelog文件，修改第一行括号里的版本号。例如：把括号里的
7.0.11-2改成你想要的版本号，比如7.0.11-99，再执行make deb，最终产出的 Debian 包版本就是7.0.11-99。影响范围
common/radxa-os/build-system/_kernel.mdx（同时影响所有 import 该模版的页面）docs/dragon/q6a/low-level-dev/build-system/kernel），以及未来使用同一模版的其他产品检查
scripts/github_pr_guard.py check→ok=trueagent-doc-translation-guard→ passedagent-doc-drift-guard --warn-only→ passed备注
仓库既有的「
debuild命令片段」是 unlabeled code fence 风格，本次 FAQ 为保持同一风格也使用裸textfence；如后续希望统一改用<NewCodeBlock>，建议另开一个 cleanup PR 处理。