en:users:drivers:ath10k:sources
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
en:users:drivers:ath10k:sources [2016/01/22 11:14] Kalle Valo ath.git is in kernel.org now |
en:users:drivers:ath10k:sources [2017/05/16 05:39] Kalle Valo Refactor submitting patches to it's own page. |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| - | ===== ath10k sources location ===== | + | ===== ath10k sources ===== |
| //ath10k// development happens in Kalle Valo's ath.git tree on kernel.org: | //ath10k// development happens in Kalle Valo's ath.git tree on kernel.org: | ||
| Line 21: | Line 21: | ||
| Periodically Kalle Valo pulls the ath tree into wireless-drivers-next tree. Then David Miller pulls it to net-next which is eventually pulled by Linus Torvalds to official kernel releases. As a rough estimate it takes 2-4 months for a patch to propage from ath.git to an official Linux release. | Periodically Kalle Valo pulls the ath tree into wireless-drivers-next tree. Then David Miller pulls it to net-next which is eventually pulled by Linus Torvalds to official kernel releases. As a rough estimate it takes 2-4 months for a patch to propage from ath.git to an official Linux release. | ||
| - | + | See also [[en/users/drivers/ath10k/submittingpatches|submitting ath10k patches]]. | |
| - | ===== Submitting patches ===== | + | |
| - | + | ||
| - | Send patches to the mailing lists below. Kalle Valo reviews the patches within the next few days and, if they are ok, commits them to ath.git. | + | |
| - | * To: [[mailto:ath10k@lists.infradead.org|ath10k@lists.infradead.org]] | + | |
| - | * Cc: [[mailto:linux-wireless@vger.kernel.org|linux-wireless@vger.kernel.org]] | + | |
| - | + | ||
| - | Preferably use ath.git master branch as the baseline for patches. Other trees can be used as well, but then the chances of conflicts are higher. | + | |
| - | + | ||
| - | More info about submitting patches: | + | |
| - | * [[en/developers/Documentation/SubmittingPatches|en/developers/Documentation/SubmittingPatches]] | + | |
| - | * [[en/developers/Documentation/git-guide|en/developers/Documentation/git-guide]] | + | |
| - | + | ||
| - | Guidelines for patches: | + | |
| - | * MUST follow [[https://www.kernel.org/doc/Documentation/SubmittingPatches|Documentation/SubmittingPatches]] | + | |
| - | * MUST be compiler warning free. | + | |
| - | * MUST be sparse warning free. | + | |
| - | * Commit log MUST not be empty. | + | |
| - | * The commit log MUST answer the question "Why?": | + | |
| - | * Describe the motivation behind the bug. | + | |
| - | * How does it change the functionality from user's point of view? | + | |
| - | * Does it fix a bug? If it does, please describe the bug (doesn't need to be long). Also if there's a public bug report add a link to the bug report. | + | |
| - | * If a problem has been found during code review and doesn't fix a known issues, mention that in the commit log. | + | |
| - | * Ingo Molnar has written [[https://lkml.kernel.org/g/20150314075357.GA8319@gmail.com|a nice description]] about what maintainers are looking from a commit log. | + | |
| - | * If others have reported the issue commit log SHOULD use Reported-by: and Tested-by: tags. | + | |
| - | * SHOULD be checkpatch clean: | + | |
| - | * FIXME: add checkpatch example with correct arguments | + | |
| - | * Patches SHOULD be sent with git send-email tool. | + | |
| - | * Patchsets SHOULD contain no more than 12 patches. | + | |
| - | * Patches SHOULD follow [[en/users/Drivers/ath10k/CodingStyle|ath10k coding style]] | + | |
| - | + | ||
| - | The terminology is from [[http://www.ietf.org/rfc/rfc2119.txt|http://www.ietf.org/rfc/rfc2119.txt]] | + | |
| - | + | ||
| - | The ath10k patch flow is this: | + | |
| - | * Patch gets posted to the mailing lists. | + | |
| - | * Kalle immediately applies the patch to pending branch for build testing. | + | |
| - | * Kalle waits two business days for patch being under review (unless the patch is urgent). | + | |
| - | * If no comments or warnings, Kalle applies the patch to ath-next branch and sends a "Thanks, applied" reply. | + | |
| - | * Kalle merges ath-next to master branch immeadiately after the patch is applies. | + | |
| - | * Kalle merges ath-next into wireless-drivers-next roughly every 2-3 weeks | + | |
| - | * David Miller merges wireless-drivers-next into net-next every two weeks or so | + | |
| - | * Linus Torvalds merges net-next into linux.git during [[https://www.kernel.org/doc/Documentation/development-process/2.Process|merge window]] | + | |
| ===== Git branches ===== | ===== Git branches ===== | ||
| Line 72: | Line 30: | ||
| * ath-next : Based on John's wireless-next tree and John will pull from this branch. ath6kl/ath10k patches are commited to this branch first and then merged to the master branch. For bisect runs it's better to use this branch instead of the master branch. | * ath-next : Based on John's wireless-next tree and John will pull from this branch. ath6kl/ath10k patches are commited to this branch first and then merged to the master branch. For bisect runs it's better to use this branch instead of the master branch. | ||
| * pending : Used for building and runtime testing patches under review. Is rebased almost daily and hence commit ids are NOT stable. Use this only if you know what you are doing. | * pending : Used for building and runtime testing patches under review. Is rebased almost daily and hence commit ids are NOT stable. Use this only if you know what you are doing. | ||
| + | * master-pending : The pending branch merged on top of the master, for easier testing of the pending patches. Same rules apply as with the pending branch. | ||
en/users/drivers/ath10k/sources.txt · Last modified: 2024/06/24 18:27 by Kalle Valo
Page Tools
