branch.c: use 'ref-filter' APIs
[gitweb.git] / Documentation / git-for-each-ref.txt
index 324ad2c7397b78ea25d951cb273446dabbd9c3e6..16b4ac561438c259279397bcb89da54cbb33af2d 100644 (file)
@@ -157,6 +157,9 @@ For sorting purposes, fields with numeric values sort in numeric
 order (`objectsize`, `authordate`, `committerdate`, `taggerdate`).
 All other fields are used to sort in their byte-value order.
 
+There is also an option to sort by versions, this can be done by using
+the fieldname `version:refname` or its alias `v:refname`.
+
 In any case, a field name that refers to a field inapplicable to
 the object referred by the ref does not cause an error.  It
 returns an empty string instead.