darcs

Issue 983 Darcs v2 format, semantics and convert are not documented

Title Darcs v2 format, semantics and convert are not documented
Priority urgent Status resolved
Milestone Resolved in
Superseder Nosy List WorldMaker, darcs-devel, dmitry.kurochkin, kowey, thorkilnaur, tommy
Assigned To
Topics Documentation

Created on 2008-08-11.00:29:14 by dagit, last changed 2009-10-24.00:00:20 by admin.

Messages
msg5366 (view) Author: dagit Date: 2008-08-11.00:29:11
The manual:
http://darcs.net/manual/node8.html#SECTION008111000000000000000

The wiki:
http://wiki.darcs.net/DarcsWiki/DarcsTwo

(see darcs convert --help)

All fail to describe the darcs 2 format.

Users need to at least know:
(a) Why to upgrade
(b) How to upgrade
(c) The risk of upgrading

We should also explain how darcs 2 semantics differ from darcs1 semantics.
msg5367 (view) Author: dagit Date: 2008-08-11.07:01:04
The process for converting a repository is hinted at here:
http://darcs.net/manual/node7.html#SECTION00740000000000000000
msg5369 (view) Author: kowey Date: 2008-08-11.08:31:48
Indeed, this was added recently via

Thu Aug  7 20:54:29 BST 2008  Max Battcher <me@worldmaker.net>
  * Add user-focused documentation of repository format options

We should ask Max for help here in figuring out what else needs to be documented
msg6165 (view) Author: simon Date: 2008-09-28.22:11:22
Cf issue1103
msg8097 (view) Author: kowey Date: 2009-08-11.16:51:17
Looks resolved to me
History
Date User Action Args
2008-08-11 00:29:14dagitcreate
2008-08-11 07:01:07dagitsetstatus: unread -> unknown
nosy: tommy, beschmi, kowey, dagit
messages: + msg5367
2008-08-11 08:31:51koweysetnosy: tommy, beschmi, kowey, dagit
messages: + msg5369
2008-08-11 09:11:47WorldMakersetnosy: + WorldMaker
2008-09-11 10:30:16koweysetnosy: tommy, beschmi, kowey, dagit, WorldMaker
assignedto: WorldMaker
2008-09-28 22:11:23simonsetnosy: + simon, thorkilnaur
messages: + msg6165
2009-08-06 21:10:24adminsetnosy: + dmitry.kurochkin, - beschmi
2009-08-11 00:19:53adminsetnosy: - dagit
2009-08-11 16:51:29koweysetstatus: unknown -> resolved
nosy: tommy, kowey, simon, WorldMaker, thorkilnaur, dmitry.kurochkin
topic: + Documentation
messages: + msg8097
assignedto: WorldMaker ->
2009-08-25 17:29:45adminsetnosy: + darcs-devel, - simon
2009-08-27 14:23:04adminsetnosy: tommy, kowey, darcs-devel, WorldMaker, thorkilnaur, dmitry.kurochkin
2009-10-23 22:38:57adminsetnosy: + maxbattcher, - WorldMaker
2009-10-24 00:00:20adminsetnosy: + WorldMaker, - maxbattcher