DFLAGS = -g -DDEBUG -Werror
PROGS = tig
DOCS = tig.1.html tig.1 tigrc.5.html tigrc.5 \
- manual.html manual.html-chunked README.html
+ manual.toc manual.html manual.html-chunked README.html \
ifneq (,$(wildcard .git))
VERSION = $(shell git-describe)
.PHONY: all all-debug doc install install-doc clean spell-check
+manual.toc: manual.txt
+ sed -n '/^\[\[/,/\(---\|~~~\)/p' < $< | while read line; do \
+ case "$$line" in \
+ "-----"*) echo ". <<$$ref>>"; ref= ;; \
+ "~~~~~"*) echo "- <<$$ref>>"; ref= ;; \
+ "[["*"]]") ref="$$line" ;; \
+ *) ref="$$ref, $$line" ;; \
+ esac; done | sed 's/\[\[\(.*\)\]\]/\1/' > $@
+
tig: tig.c
README.html: README
xmlto man $<
%.html : %.txt
- asciidoc -b xhtml11 -d article $<
+ asciidoc -b xhtml11 -d article -n $<
%.xml : %.txt
asciidoc -b docbook -d article $<
the user with various views, such as summarized commit log and showing the
commit with the log message, diffstat, and the diff.
+ifndef::backend-docbook[]
+include::manual.toc[]
+endif::backend-docbook[]
+
+[[calling-conventions]]
Calling Conventions
-------------------
+[[pager-mode]]
Pager Mode
~~~~~~~~~~
$ git show | tig
-----------------------------------------------------------------------------
+[[cmd-options]]
Git Command Options
~~~~~~~~~~~~~~~~~~~
to revision options supported by the git commands. For details on specific git
command options, refer to the man page of the command in question.
+[[env-variables]]
Environment Variables
---------------------
Several options related to the interface with git can be configured via
environment options.
+[[repo-refs]]
Repository References
~~~~~~~~~~~~~~~~~~~~~
the option: `--pretty=raw` since the main view parser expects to
read that format.
+[[viewer]]
The Viewer
----------
and the diff view in the bottom window. You can switch between the two views
by pressing 'Tab'. To maximize the log view again, simply press 'l'.
+[[commit-id]]
Current Head and Commit ID
~~~~~~~~~~~~~~~~~~~~~~~~~~
The head ID is used when opening the main and log view to indicate from what
revision to show history.
+[[views]]
Views
~~~~~
The help view::
Displays key binding quick reference.
+[[title-window]]
Title Windows
~~~~~~~~~~~~~
[main] 77d9e40fbcea3238015aea403e06f61542df9a31 - commit 1 of 779 (0%) 5s
-----------------------------------------------------------------------------
+[[keys]]
Keys
----
Below the default key bindings are shown.
+[[view-switching]]
View Switching
~~~~~~~~~~~~~~
m::
h, ?::
Show man page.
+[[view-manipulation]]
View Manipulation
~~~~~~~~~~~~~~~~~
q::
Down::
Similar to 'Up' but will move down.
+[[cursor-nav]]
Cursor Navigation
~~~~~~~~~~~~~~~~~
j::
End::
Jump to last line.
+[[view-scrolling]]
Scrolling
~~~~~~~~~
Insert::
s::
Scroll view one page down.
+[[misc-keys]]
Misc
~~~~
Q::
in this section. For example, by configuring the environment variables
described in the <<history-commands, "History commands">> section.
+[[path-limiting]]
Limit by Path Name
~~~~~~~~~~~~~~~~~~
specify two "\--" options. The first will make tig stop option processing
and the latter will be passed to git log.
+[[date-number-limiting]]
Limit by Date or Number
~~~~~~~~~~~~~~~~~~~~~~~
NOTE: If you want to avoid having to quote dates containing spaces you can use
"." instead, e.g. `--after=May.5th`.
+[[commit-range-limiting]]
Limiting by Commit Ranges
~~~~~~~~~~~~~~~~~~~~~~~~~
will list what will be pushed to the remote branch. Optionally, the ending
'HEAD' can be left out since it is implied.
+[[reachability-limiting]]
Limiting by Reachability
~~~~~~~~~~~~~~~~~~~~~~~~
You can think of '^' as a negation operator. Using this alternate syntax, it
is possible to further prune commits by specifying multiple branch cut offs.
+[[refspec-combi]]
Combining Revisions Specification
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ tig -- --since=1.month -n20 -- Documentation/
-----------------------------------------------------------------------------
+[[refspec-all]]
Examining All Repository References
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
include::BUGS[]
+[[copy-right]]
Copyright
---------
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
+[[references]]
References and Related Tools
----------------------------