mirrors/git
0
0
Fork 0
mirror of https://github.com/git/git.git synced 2024-11-30 21:44:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'fl/doc'

Browse Source 
* fl/doc:
  Documentation: unbreak user-manual.
  Documentation: Add version information to man pages
  Documentation: Replace @@GIT_VERSION@@ in documentation
This commit is contained in:
Junio C Hamano 2007-04-04 00:10:13 -07:00
commit bdceecbbd7
2 changed files with 37 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
Documentation/Makefile
View File

@ -65,6 +65,11 @@ install: man
$(INSTALL) -m644 $(DOC_MAN7) $(DESTDIR)$(man7dir) $(INSTALL) -m644 $(DOC_MAN7) $(DESTDIR)$(man7dir)
../GIT-VERSION-FILE: .FORCE-GIT-VERSION-FILE
$(MAKE) -C ../ GIT-VERSION-FILE
-include ../GIT-VERSION-FILE
# #
# Determine "include::" file references in asciidoc files. # Determine "include::" file references in asciidoc files.
# #
@ -91,17 +96,25 @@ $(cmds_txt): cmd-list.perl $(MAN1_TXT)
git.7 git.html: git.txt core-intro.txt git.7 git.html: git.txt core-intro.txt
clean: clean:
rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html doc.dep rm -f *.xml *.xml+ *.html *.html+ *.1 *.7 howto-index.txt howto/*.html doc.dep
rm -f $(cmds_txt) rm -f $(cmds_txt)
%.html : %.txt %.html : %.txt
$(ASCIIDOC) -b xhtml11 -d manpage -f asciidoc.conf $(ASCIIDOC_EXTRA) $< rm -f $@+ $@
$(ASCIIDOC) -b xhtml11 -d manpage -f asciidoc.conf \
$(ASCIIDOC_EXTRA) -o - $< | \
sed -e 's/@@GIT_VERSION@@/$(GIT_VERSION)/g' >$@+
mv $@+ $@
%.1 %.7 : %.xml %.1 %.7 : %.xml
xmlto -m callouts.xsl man $< xmlto -m callouts.xsl man $<
%.xml : %.txt %.xml : %.txt
$(ASCIIDOC) -b docbook -d manpage -f asciidoc.conf $< rm -f $@+ $@
$(ASCIIDOC) -b docbook -d manpage -f asciidoc.conf \
$(ASCIIDOC_EXTRA) -o - $< | \
sed -e 's/@@GIT_VERSION@@/$(GIT_VERSION)/g' >$@+
mv $@+ $@
user-manual.xml: user-manual.txt user-manual.conf user-manual.xml: user-manual.txt user-manual.conf
$(ASCIIDOC) -b docbook -d book $< $(ASCIIDOC) -b docbook -d book $<
@ -132,3 +145,5 @@ install-webdoc : html
quick-install: quick-install:
sh ./install-doc-quick.sh $(DOC_REF) $(mandir) sh ./install-doc-quick.sh $(DOC_REF) $(mandir)
.PHONY: .FORCE-GIT-VERSION-FILE

19
Documentation/asciidoc.conf
View File

@ -31,6 +31,25 @@ ifdef::backend-docbook[]
{title#}</example> {title#}</example>
endif::backend-docbook[] endif::backend-docbook[]
ifdef::doctype-manpage[]
ifdef::backend-docbook[]
[header]
template::[header-declarations]
<refentry>
<refmeta>
<refentrytitle>{mantitle}</refentrytitle>
<manvolnum>{manvolnum}</manvolnum>
<refmiscinfo class="source">Git</refmiscinfo>
<refmiscinfo class="version">@@GIT_VERSION@@</refmiscinfo>
<refmiscinfo class="manual">Git Manual</refmiscinfo>
</refmeta>
<refnamediv>
<refname>{manname}</refname>
<refpurpose>{manpurpose}</refpurpose>
</refnamediv>
endif::backend-docbook[]
endif::doctype-manpage[]
ifdef::backend-xhtml11[] ifdef::backend-xhtml11[]
[gitlink-inlinemacro] [gitlink-inlinemacro]
<a href="{target}.html">{target}{0?({0})}</a> <a href="{target}.html">{target}{0?({0})}</a>