debian/git-doc: register documentation with doc-base
Recommended in policy ยง9.10 "registering documents using doc-base".
Titles, authors, and abstracts are made up based on the files'
history.
diff --git a/debian/changelog b/debian/changelog
index 41f49a7..1ae5166 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -73,6 +73,8 @@
from lintian guidelines.
* debian/implicit: install debian/pkg.doc-base.docid to
/usr/share/doc-base/docid.
+ * debian/git-doc.doc-base.*: new; register documentation with
+ doc-base.
* debian/git.README.Debian: server logs go in /var/log/apache2, not
/var/log/apache-ssl.
diff --git a/debian/git-doc.doc-base.everyday-git b/debian/git-doc.doc-base.everyday-git
new file mode 100644
index 0000000..89d24e9
--- /dev/null
+++ b/debian/git-doc.doc-base.everyday-git
@@ -0,0 +1,12 @@
+Document: everyday-git
+Title: Everyday Git With 20 Commands Or So
+Author: Junio C Hamano
+Abstract: A useful minimum set of git commands, in context.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/everyday.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/everyday.html
+Files: /usr/share/doc/git-doc/everyday.html
diff --git a/debian/git-doc.doc-base.git-bisect-lk2009 b/debian/git-doc.doc-base.git-bisect-lk2009
new file mode 100644
index 0000000..69d763e
--- /dev/null
+++ b/debian/git-doc.doc-base.git-bisect-lk2009
@@ -0,0 +1,19 @@
+Document: git-bisect-lk2009
+Title: Fighting regressions with git bisect
+Author: Christian Couder
+Abstract: "git bisect" enables software users and developers
+ to easily find the commit that introduced a regression. We
+ show why it is important to have good tools to fight
+ regressions. We describe how "git bisect" works from the
+ outside and the algorithms it uses inside. Then we explain
+ how to take advantage of "git bisect" to improve current
+ practices. And we discuss how "git bisect" could improve in
+ the future.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/git-bisect-lk2009.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/git-bisect-lk2009.html
+Files: /usr/share/doc/git-doc/git-bisect-lk2009.html
diff --git a/debian/git-doc.doc-base.git-howtos b/debian/git-doc.doc-base.git-howtos
new file mode 100644
index 0000000..437b878
--- /dev/null
+++ b/debian/git-doc.doc-base.git-howtos
@@ -0,0 +1,16 @@
+Document: git-howtos
+Title: Git How-to Documents
+Author: The git list
+Abstract: Mailing list postings made by various people
+ describing how they use git in their workflow.
+Section: File Management
+
+Format: Text
+Index: /usr/share/doc/git-doc/howto-index.txt
+Files: /usr/share/doc/git-doc/howto-index.txt
+ /usr/share/doc/git-doc/howto/*.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/howto-index.html
+Files: /usr/share/doc/git-doc/howto-index.html
+ /usr/share/doc/git-doc/howto/*.html
diff --git a/debian/git-doc.doc-base.git-pack-format b/debian/git-doc.doc-base.git-pack-format
new file mode 100644
index 0000000..e7c728b
--- /dev/null
+++ b/debian/git-doc.doc-base.git-pack-format
@@ -0,0 +1,9 @@
+Document: git-pack-format
+Title: Git pack format and packing heuristics
+Author: Jon Loeliger, Junio C Hamano, and the git list
+Abstract: Git's packed data format.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/technical/pack-format.txt
+ /usr/share/doc/git-doc/technical/pack-heuristics.txt
diff --git a/debian/git-doc.doc-base.git-protocol b/debian/git-doc.doc-base.git-protocol
new file mode 100644
index 0000000..4495708
--- /dev/null
+++ b/debian/git-doc.doc-base.git-protocol
@@ -0,0 +1,12 @@
+Document: git-protocol
+Title: Technical documentation for git protocol
+Author: Scott Chacon and the git list
+Abstract: Reference documentation for the upload-pack and
+ receive-pack protocols that underlie git's ssh://, git://,
+ file://, and smart http:// transports.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/technical/pack-protocol.txt
+ /usr/share/doc/git-doc/technical/protocol-*.txt
+ /usr/share/doc/git-doc/technical/send-pack-pipeline.txt
diff --git a/debian/git-doc.doc-base.git-reference-manual b/debian/git-doc.doc-base.git-reference-manual
new file mode 100644
index 0000000..f22068b
--- /dev/null
+++ b/debian/git-doc.doc-base.git-reference-manual
@@ -0,0 +1,14 @@
+Document: git-reference-manual
+Title: Git Reference Manual
+Author: David Greaves and the git list
+Abstract: Git manual pages, including glossary and tutorials.
+Section: File Management
+
+Format: HTML
+Index: /usr/share/doc/git-doc/git.html
+Files: /usr/share/doc/git-doc/git.html
+ /usr/share/doc/git-doc/git[a-z]*.html
+ /usr/share/doc/git-doc/git-[ac-su-z]*.html
+ /usr/share/doc/git-doc/git-b[a-hj-z]*.html
+ /usr/share/doc/git-doc/git-bisect.html
+ /usr/share/doc/git-doc/git-t[a-np-z]*.html
diff --git a/debian/git-doc.doc-base.git-shallow-clone-design b/debian/git-doc.doc-base.git-shallow-clone-design
new file mode 100644
index 0000000..9f94a2f
--- /dev/null
+++ b/debian/git-doc.doc-base.git-shallow-clone-design
@@ -0,0 +1,12 @@
+Document: git-shallow-clone-design
+Title: Technical documentation for shallow clones in git
+Author: Johannes Schindelin
+Abstract: There has not been any work on the git fetch/clone
+ --depth lately, so it is hard to find out what it does, and
+ how. This document describes the ideas as well as the
+ current problems, and can serve as a starting point for
+ shallow people.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/technical/shallow.txt
diff --git a/debian/git-doc.doc-base.git-technical b/debian/git-doc.doc-base.git-technical
new file mode 100644
index 0000000..0bb74d0
--- /dev/null
+++ b/debian/git-doc.doc-base.git-technical
@@ -0,0 +1,14 @@
+Document: git-api
+Title: Git internal API documentation
+Author: Junio C Hamano and the git list
+Abstract: Git has grown a set of internal API over time.
+ This collection documents them.
+Section: Programming/C
+
+Format: Text
+Index: /usr/share/doc/git-doc/technical/api-index.txt
+Files: /usr/share/doc/git-doc/technical/api-*.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/technical/api-index.html
+Files: /usr/share/doc/git-doc/technical/api-*.html
diff --git a/debian/git-doc.doc-base.git-tools b/debian/git-doc.doc-base.git-tools
new file mode 100644
index 0000000..1199fa0
--- /dev/null
+++ b/debian/git-doc.doc-base.git-tools
@@ -0,0 +1,13 @@
+Document: git-tools
+Title: A short git tools survey
+Author: Marco Costalba
+Abstract: A brief and outdated survey of useful git tools,
+ including third-party and external projects.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/git-tools.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/git-tools.html
+Files: /usr/share/doc/git-doc/git-tools.html
diff --git a/debian/git-doc.doc-base.git-trivial-merge-rules b/debian/git-doc.doc-base.git-trivial-merge-rules
new file mode 100644
index 0000000..b6ae363
--- /dev/null
+++ b/debian/git-doc.doc-base.git-trivial-merge-rules
@@ -0,0 +1,9 @@
+Document: git-trivial-merge-rules
+Title: Trivial merge rules for git read-tree
+Author: Daniel Barkalow
+Abstract: This document describes the outcomes of the
+ trivial merge logic in git read-tree.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/technical/trivial-merge.txt
diff --git a/debian/git-doc.doc-base.git-user-manual b/debian/git-doc.doc-base.git-user-manual
new file mode 100644
index 0000000..5e9a98d
--- /dev/null
+++ b/debian/git-doc.doc-base.git-user-manual
@@ -0,0 +1,16 @@
+Document: git-user-manual
+Title: Git User's Manual (for version 1.5.3 or newer)
+Author: J. Bruce Fields and the git list
+Abstract: This manual provides a leisurely but practical
+ introduction to git. Chapters 1 and 2 explain how to fetch
+ and study a project using git. People needing to do actual
+ development will also want to read chapters 3 and 4.
+ Further chapters cover more specialized topics.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/user-manual.txt
+
+Format: HTML
+Index: /usr/share/doc/git-doc/user-manual.html
+Files: /usr/share/doc/git-doc/user-manual.html
diff --git a/debian/git-doc.doc-base.the-racy-git-problem b/debian/git-doc.doc-base.the-racy-git-problem
new file mode 100644
index 0000000..4b7890b
--- /dev/null
+++ b/debian/git-doc.doc-base.the-racy-git-problem
@@ -0,0 +1,19 @@
+Document: the-racy-git-problem
+Title: Use of index and the "racy git" problem
+Author: Junio C Hamano
+Abstract: In order to speed up comparison between files in
+ the work tree and index entries, git compares current
+ lstat(2) information with saved lstat(2) information from
+ whenever it updated the corresponding index entry. A very
+ quick update that does not change file size could therefore
+ make git can incorrectly think files in the working tree
+ are unmodified even though they actually are. This is
+ called the "racy git" problem (discovered by Pasky), and
+ the entries that would appear clean when they ought not to
+ be because of this problem are called "racily clean".
+ .
+ This document explains how git avoids that problem.
+Section: File Management
+
+Format: Text
+Files: /usr/share/doc/git-doc/technical/racy-git.txt