aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJoey Hess <joey@gnu.kitenet.net>2010-03-29 13:17:49 -0400
committerJoey Hess <joey@gnu.kitenet.net>2010-03-29 13:17:49 -0400
commit3e192a4c4a2e80ce35ce35d5edc9afd6b2373f83 (patch)
treeb7b0ac0b281dc66bf5ae86a78cb4bda015070074 /doc
parente466d11fd363b4758bc4f624ff73664d89891f9e (diff)
downloadikiwiki-3e192a4c4a2e80ce35ce35d5edc9afd6b2373f83.tar
ikiwiki-3e192a4c4a2e80ce35ce35d5edc9afd6b2373f83.tar.gz
add a table summarizing state of each rcs plugin
Diffstat (limited to 'doc')
-rw-r--r--doc/rcs.mdwn23
1 files changed, 20 insertions, 3 deletions
diff --git a/doc/rcs.mdwn b/doc/rcs.mdwn
index f66b85495..cd41e7f49 100644
--- a/doc/rcs.mdwn
+++ b/doc/rcs.mdwn
@@ -7,10 +7,27 @@ Ikiwiki started out supporting only [[Subversion|svn]], but the interface
ikiwiki uses to a revision control system is sufficiently simple and
generic that it can be adapted to work with many systems by writing a
[[plugin|plugins/write]]. [[Subversion|svn]] is still a recommended choice;
-[[git]] is another well-tested option.
+[[git]] is another well-tested option.
-These are all the supported revision control systems:
-[[!inline pages="rcs/* and !*/Discussion and !rcs/details" archive=yes]]
+While all supported revision control systems work well enough for basic use,
+some advanced or special features are not supported in all of them.
+Lack of support in [[ikiwiki-makerepo]] or auto.setup can make it harder to
+set up a wiki using that revision control system. The `rcs_commit_staged`
+hook is needed to use [[plugins/attachments]] or [[plugins/comments]]. And so
+on. The table below summarises this for each revision control system and links
+to more information about each.
+
+[[!table data="""
+feature |[[git]]|[[svn]]|[[bzr]] |[[monotone]]|[[mercurial]]|[[darcs]]|[[tla]] |[[cvs]]
+[[ikiwiki-makerepo]]|yes |yes |yes |yes |yes |yes |no |yes
+auto.setup |yes |yes |incomplete|yes |incomplete |yes |incomplete|yes
+`rcs_commit_staged` |yes |yes |yes |yes |no |yes |no |yes
+`rcs_rename` |yes |yes |yes |yes |no |yes |no |yes
+`rcs_remove` |yes |yes |yes |yes |no |yes |no |yes
+`rcs_diff` |yes |yes |yes |yes |no |yes |yes |yes
+anonymous push |yes |no |no |no |no |no |no |no
+conflict handling |yes |yes |yes |buggy |yes |yes |yes |yes
+"""]]
There is a page with [[details]] about how the different systems work with
ikiwiki, for the curious.