[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

[PATCH] Fix design doc

From: Madan U Sreenivasan <madan_at_collab.net>
Date: 2006-05-22 22:09:23 CEST

[[[
Update design doc.

* doc/design/model.xml
   (model.nolock): Remove section. Not true anymore.
]]]

Index: doc/design/model.xml
===================================================================
--- doc/design/model.xml (revision 19746)
+++ doc/design/model.xml (working copy)
@@ -262,63 +262,6 @@
     </itemizedlist>
   </sect1>
 
- <sect1 id="model.nolock">
- <title>Subversion Does Not Lock Files</title>
-
- <para>Subversion does not prevent two users from making changes to the same
- file at the same time. For example, if both you and Felix have checked
- out working directories of <filename>/trunk/write</filename>, Subversion
- will allow both of you to change <filename>write/search.c</filename> in
- your working directories. Then, the following sequence of events will
- occur:</para>
-
- <itemizedlist mark="bullet">
- <listitem><para>Suppose Felix tries to commit his changes to
- <filename>search.c</filename> first. Hiscommit will succeed, and his
- text will appear in the latest revision inthe
- repository.</para></listitem>
- <listitem><para>When you attempt to commit your changes to
- <filename>search.c</filename>, Subversionwill reject your commit, and
- tell you that you must update<filename>search.c</filename> before you
- can commit it.</para></listitem>
- <listitem><para>When you update <filename>search.c</filename>, Subversion
- will try to merge Felix'schanges from the repository with your local
- changes. By default,Subversion merges as if it were applying a
- patch: if your local changesdo not overlap textually with Felix's,
- then all is well; otherwise,Subversion leaves it to you to resolve
- the overlappingchanges. In either case,Subversion carefully
- preserves a copy of the original pre-merge text.</para></listitem>
- <listitem><para>Once you have verified that Felix's changes and your
- changes have beenmerged correctly, you can commit the new revision of
- <filename>search.c</filename>,which now contains everyone's
- changes.</para></listitem>
- </itemizedlist>
-
- <para>Some version control systems provide &ldquo;locks&rdquo;, which
- prevent others from changing a file once one person has begun working on
- it. In our experience, merging is preferable to locks, because:</para>
-
- <itemizedlist mark="bullet">
- <listitem><para>changes usually do not conflict, so Subversion's behavior
- does the rightthing by default, while locking can interfere with
- legitimate work;</para></listitem>
- <listitem><para>locking can prevent conflicts within a file, but not
- conflicts betweenfiles (say, between a C header file and another file
- that includes it),so it doesn't really solve the problem; and
- finally,</para></listitem>
- <listitem><para>people often forget that they are holding locks,
- resulting inunnecessary delays and friction.</para></listitem>
- </itemizedlist>
-
- <para>Of course, the merge process needs to be under the users' control.
- Patch is not appropriate for files with rigid formats, like images or
- executables. Subversion allows users to customize its merging behavior
- on a per-file basis. You can direct Subversion to refuse to merge
- changes to certain files, and simply present you with the two original
- texts to choose from. (Or, someday, you can direct Subversion to merge
- using a tool which respects the semantics of the file format.)</para>
- </sect1>
-
   <sect1 id="model.props">
     <title>Properties</title>
 

Update design doc.

* doc/design/model.xml
  (model.nolock): Remove section. Not true anymore.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Mon May 22 21:38:51 2006

This is an archived mail posted to the Subversion Dev mailing list.