bd66361195
I don't think people really follow the links or think very abstractly at all in the first place. So I was thinking more of some explicit examples. I actually think every command should have an example in the man-page, and hey, here's a patch to start things off. Of course, I'm not exactly "Mr Documentation", and I don't know that this is the prettiest way to do this, but I checked that the resulting html and man-page seems at least reasonable. And hey, if the examples look like each other, that's just because I'm also not "Mr Imagination". Signed-off-by: Linus Torvalds <torvalds@osdl.org> Signed-off-by: Junio C Hamano <junkio@cox.net>
52 lines
856 B
Plaintext
52 lines
856 B
Plaintext
gitk(1)
|
|
=======
|
|
|
|
NAME
|
|
----
|
|
gitk - Some git command not yet documented.
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'gitk' [ --option ] <args>...
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Does something not yet documented.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
--option::
|
|
Some option not yet documented.
|
|
|
|
<args>...::
|
|
Some argument not yet documented.
|
|
|
|
|
|
Examples
|
|
--------
|
|
gitk v2.6.12.. include/scsi drivers/scsi::
|
|
|
|
Show as the changes since version 'v2.6.12' that changed any
|
|
file in the include/scsi or drivers/scsi subdirectories
|
|
|
|
gitk --since="2 weeks ago" -- gitk::
|
|
|
|
Show the changes during the last two weeks to the file 'gitk'.
|
|
The "--" is necessary to avoid confusion with the *branch* named
|
|
'gitk'
|
|
|
|
Author
|
|
------
|
|
Written by Paul Mackerras <paulus@samba.org>
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
GIT
|
|
---
|
|
Part of the gitlink:git[7] suite
|
|
|