diff options
author | https://www.google.com/accounts/o8/id?id=AItOawkO4VQw6MI8y9Tqnjv7B2ZaqLa9dd0BCyw <Hongchi@web> | 2013-09-18 11:24:06 -0400 |
---|---|---|
committer | admin <admin@branchable.com> | 2013-09-18 11:24:06 -0400 |
commit | 78dfa75303a660a82c67b574cd05243bae9a5fe9 (patch) | |
tree | 7f058edc802effaec1790ede6daa8edefb5253bb /doc/rcs.Makefile | |
parent | 95842fb2b0765b5660bc8d52ebdd5f85a12a2df8 (diff) | |
download | ikiwiki-78dfa75303a660a82c67b574cd05243bae9a5fe9.tar ikiwiki-78dfa75303a660a82c67b574cd05243bae9a5fe9.tar.gz |
rename rcs.mdwn to rcs.Makefile
Diffstat (limited to 'doc/rcs.Makefile')
-rw-r--r-- | doc/rcs.Makefile | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/doc/rcs.Makefile b/doc/rcs.Makefile new file mode 100644 index 000000000..1f6b3c24e --- /dev/null +++ b/doc/rcs.Makefile @@ -0,0 +1,44 @@ +[[!meta title="Revision Control Systems"]] + +Ikiwiki supports using several revision control systems for storing page +histories. + +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]]. These days, most people use [[git]]. + +While all supported revision control systems work well enough for basic +use, some advanced or special features are not supported in all of them. +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 |yes |yes |no |yes +`rcs_rename` |yes |yes |yes |yes |yes |yes |no |yes +`rcs_remove` |yes |yes |yes |yes |yes |yes |no |yes +`rcs_diff` |yes |yes |yes |yes |yes |yes |yes |yes +`rcs_getctime` |fast |slow |slow |slow |fast |slow |slow |slow +`rcs_getmtime` |fast |slow |slow |slow |fast |no |no |no +`rcs_preprevert` |yes |no |no |no |no |no |no |no +`rcs_revert` |yes |no |no |no |no |no |no |no +anonymous push |yes |no |no |no |no |no |no |no +conflict handling |yes |yes |yes |buggy |yes |yes |yes |yes +openid username |yes |no |no |no |yes |yes |no |no +"""]] + +Notes: + +* 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 [[attachments|plugins/attachment]] + or [[plugins/comments]]. +* `rcs_getctime` and `rcs_getmtime` may be implemented in a fast way (ie, one log + lookup for all files), or very slowly (one lookup per file). +* Openid username support allows avoiding display of Google's ugly openids. + +There is a page with [[details]] about how the different systems work with +ikiwiki, for the curious. |