Recent changes to this wiki:

add news item for git-repair 1.20170626
diff --git a/doc/news/version_1.20170626.mdwn b/doc/news/version_1.20170626.mdwn
new file mode 100644
index 0000000..9e9830a
--- /dev/null
+++ b/doc/news/version_1.20170626.mdwn
@@ -0,0 +1,5 @@
+git-repair 1.20170626 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+   * Merge from git-annex.
+   * Removes dependency on MissingH, adding a dependency on split instead.
+   * Fixes build with directory-1.3."""]]
\ No newline at end of file

add news item for git-repair 1.20161118
diff --git a/doc/news/version_1.20161118.mdwn b/doc/news/version_1.20161118.mdwn
new file mode 100644
index 0000000..c687f46
--- /dev/null
+++ b/doc/news/version_1.20161118.mdwn
@@ -0,0 +1,3 @@
+git-repair 1.20161118 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+   * Fix build with recent versions of cabal and ghc."""]]
\ No newline at end of file

add news item for git-repair 1.20161111
diff --git a/doc/news/version_1.20161111.mdwn b/doc/news/version_1.20161111.mdwn
new file mode 100644
index 0000000..baba58b
--- /dev/null
+++ b/doc/news/version_1.20161111.mdwn
@@ -0,0 +1,10 @@
+git-repair 1.20161111 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+   * git-repair.cabal: Add Setup-Depends.
+   * Updated cabal file explictly lists source files. The tarball
+     on hackage will include only the files needed for cabal install;
+     it is NOT the full git-repair source tree.
+   * debian/changelog: Converted to symlinks to CHANGELOG.
+   * Merge from git-annex.
+   * Makefile: Support building with stack as well as cabal.
+   * Makefile: The CABAL variable has been renamed to BUILDER."""]]
\ No newline at end of file

add news item for git-repair 1.20151215
diff --git a/doc/news/version_1.20151215.mdwn b/doc/news/version_1.20151215.mdwn
new file mode 100644
index 0000000..79b16f1
--- /dev/null
+++ b/doc/news/version_1.20151215.mdwn
@@ -0,0 +1,5 @@
+git-repair 1.20151215 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+   * Fix insecure temporary permissions and potential denial of
+     service attack when creating temp dirs. Closes: #[807341](http://bugs.debian.org/807341)
+   * Merge from git-annex."""]]
\ No newline at end of file

add rss feed for new versions etc
diff --git a/doc/index.mdwn b/doc/index.mdwn
index a6778ed..503c2c2 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -49,3 +49,7 @@ tags.
 
 Since this command unpacks all packs in the repository, you may want to
 run `git gc` afterwards.
+
+## news
+
+[[!inline pages="news/* and !*/Discussion" show="4" archive=yes]]
diff --git a/doc/news/version_1.20141027.mdwn b/doc/news/version_1.20141027.mdwn
new file mode 100644
index 0000000..b65c652
--- /dev/null
+++ b/doc/news/version_1.20141027.mdwn
@@ -0,0 +1 @@
+git-repair 1.20140613 released

typo
diff --git a/doc/index.mdwn b/doc/index.mdwn
index 1d9a7a9..a6778ed 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -44,7 +44,7 @@ or the stash, if they were unable to be recovered. This command does not
 try to clean up either the reflog or the stash. 
 
 Also note that the `--force` option never touches tags, even if they are no
-longer usable due to missing data, so fack may also find problems with
+longer usable due to missing data, so fsck may also find problems with
 tags.
 
 Since this command unpacks all packs in the repository, you may want to

update descs
diff --git a/debian/control b/debian/control
index bf14911..1defbd2 100644
--- a/debian/control
+++ b/debian/control
@@ -27,3 +27,7 @@ Description: repair various forms of damage to git repositorie
  git-repair can repair various forms of damage to git repositories.
  .
  It is a complement to git fsck, which finds problems, but does not fix them.
+ .
+ As well as avoiding the need to rm -rf a damaged repository and re-clone,
+ using git-repair can help rescue commits you've made to the damaged
+ repository and not yet pushed out.
diff --git a/doc/index.mdwn b/doc/index.mdwn
index e081051..1d9a7a9 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -3,6 +3,10 @@
 It is a complement to `git fsck`, which finds problems, but does not fix
 them.
 
+As well as avoiding the need to rm -rf a damaged repository and re-clone,
+using git-repair can help rescue commits you've made to the damaged
+repository and not yet pushed out.
+
 ## download
 
 * `git clone git://git-repair.branchable.com/ git-repair`
diff --git a/git-repair.cabal b/git-repair.cabal
index 286a712..41b00c1 100644
--- a/git-repair.cabal
+++ b/git-repair.cabal
@@ -16,6 +16,10 @@ Description:
  .
  It is a complement to git fsck, which finds problems, but does not fix
  them.
+ .
+ As well as avoiding the need to rm -rf a damaged repository and re-clone,
+ using git-repair can help rescue commits you've made to the damaged
+ repository and not yet pushed out.
 
 Executable git-repair
   Main-Is: git-repair.hs

update
diff --git a/doc/index.mdwn b/doc/index.mdwn
index d4b7e03..e081051 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -5,10 +5,7 @@ them.
 
 ## download
 
-* git
-
-	git clone git://git-repair.branchable.com/ git-repair
-
+* `git clone git://git-repair.branchable.com/ git-repair`
 * from [Hackage](http://hackage.haskell.org/package/git-repair)
 
 ## install

update
diff --git a/doc/index.mdwn b/doc/index.mdwn
index f880bc6..d4b7e03 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -5,8 +5,12 @@ them.
 
 ## download
 
+* git
+
 	git clone git://git-repair.branchable.com/ git-repair
 
+* from [Hackage](http://hackage.haskell.org/package/git-repair)
+
 ## install
 
 This is a Haskell program, developed as a spinoff of

update
diff --git a/doc/index.mdwn b/doc/index.mdwn
index 4ff28c8..f880bc6 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -43,4 +43,4 @@ longer usable due to missing data, so fack may also find problems with
 tags.
 
 Since this command unpacks all packs in the repository, you may want to
-run `git gc`afterwards.
+run `git gc` afterwards.

update
diff --git a/doc/index.mdwn b/doc/index.mdwn
index e924db8..4ff28c8 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -3,17 +3,21 @@
 It is a complement to `git fsck`, which finds problems, but does not fix
 them.
 
+## download
+
+	git clone git://git-repair.branchable.com/ git-repair
+
 ## install
 
 This is a Haskell program, developed as a spinoff of
 [git-annex](http://git-annex.branchable.com/).
 
-You can clone the source `git clone git://git-repair.branchable.com/ git-repair`
-
 To build it, you will need to install the
 [Haskell Platform](http://www.haskell.org/platform/).
 
-Then you can run `cabal update; cabal install git-repair --bindir=$HOME/bin`
+Then to install it:
+
+	cabal update; cabal install git-repair --bindir=$HOME/bin
 
 ## how it works
 

page
diff --git a/doc/index.mdwn b/doc/index.mdwn
index b8b43b1..e924db8 100644
--- a/doc/index.mdwn
+++ b/doc/index.mdwn
@@ -1,3 +1,42 @@
-This is my wiki. There's nothing here yet.
+`git-repair` can repair various forms of damage to git repositories.
 
-All wikis are supposed to have a [[SandBox]], so this one does too.
+It is a complement to `git fsck`, which finds problems, but does not fix
+them.
+
+## install
+
+This is a Haskell program, developed as a spinoff of
+[git-annex](http://git-annex.branchable.com/).
+
+You can clone the source `git clone git://git-repair.branchable.com/ git-repair`
+
+To build it, you will need to install the
+[Haskell Platform](http://www.haskell.org/platform/).
+
+Then you can run `cabal update; cabal install git-repair --bindir=$HOME/bin`
+
+## how it works
+
+`git-repair` starts by deleting all corrupt objects, and
+retreiving all missing objects that it can from the remotes of the
+repository.
+
+If that is not sufficient to fully recover the repository, it can also
+reset branches back to commits before the corruption happened, delete
+branches that are no longer available due to the lost data, and remove any
+missing files from the index. It will only do this if run with the
+`--force` option, since that rewrites history and throws out missing data.
+
+After running this command, you will probably want to run `git fsck` to
+verify it fixed the repository.
+
+Note that fsck may still complain about objects referenced by the reflog,
+or the stash, if they were unable to be recovered. This command does not
+try to clean up either the reflog or the stash. 
+
+Also note that the `--force` option never touches tags, even if they are no
+longer usable due to missing data, so fack may also find problems with
+tags.
+
+Since this command unpacks all packs in the repository, you may want to
+run `git gc`afterwards.

rename
diff --git a/doc/index.mdwn b/doc/index.mdwn
new file mode 100644
index 0000000..b8b43b1
--- /dev/null
+++ b/doc/index.mdwn
@@ -0,0 +1,3 @@
+This is my wiki. There's nothing here yet.
+
+All wikis are supposed to have a [[SandBox]], so this one does too.
diff --git a/index.mdwn b/index.mdwn
deleted file mode 100644
index b8b43b1..0000000
--- a/index.mdwn
+++ /dev/null
@@ -1,3 +0,0 @@
-This is my wiki. There's nothing here yet.
-
-All wikis are supposed to have a [[SandBox]], so this one does too.