diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index 24da31edcb..2d7f1df97e 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -308,32 +308,35 @@
Show a Particular Feature or Branch Change
- Significant features or branches are tagged in the Yocto Project tree to divide
- changes.
- Remember to first determine (or add) the tag of interest.
+ Developers use tags in the Yocto Project tree to divide changes for significant
+ features or branches.
+ Once you know a particular tag, you can use Git commands
+ to show changes associated with the tag and find the branches that contain
+ the feature.
Because BSP branch, kernel.org, and feature tags are all
present, there could be many tags.
+ The git show <tag> command shows changes that are tagged by
+ a feature.
+ Here is an example that shows changes tagged by the systemtap
+ feature:
- # show the changes tagged by a feature
- > git show <tag>
- > eg: git show yaffs2
-
- # determine which branches contain a feature
- > git branch --contains <tag>
-
- # show the changes in a kernel type
- > git whatchanged yocto/base..<kernel type>
- > eg: git whatchanged yocto/base..yocto/standard/base
+ $ git show systemtap
+
+ You can use the git branch --contains <tag> command
+ to show the branches that contain a particular feature.
+ This command shows the branches that contain the systemtap
+ feature:
+
+ $ git branch --contains systemtap
- You can use many other comparisons to isolate BSP changes.
+ You can use many other comparisons to isolate BSP and kernel changes.
For example, you can compare against kernel.org tags
- (e.g. v2.6.27.18, etc), or
- you can compare against subsystems (e.g. git whatchanged mm).
+ such as the v3.4 tag.