[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: changes in r112843
From: |
Xue Fuqiao |
Subject: |
Re: changes in r112843 |
Date: |
Wed, 5 Jun 2013 07:12:24 +0800 |
On Wed, Jun 5, 2013 at 6:59 AM, Xue Fuqiao <address@hidden> wrote:
> On Wed, Jun 5, 2013 at 1:40 AM, Glenn Morris <address@hidden> wrote:
>>
>> *** doc/emacs/maintaining.texi 2013-05-30 09:27:55 +0000
>> --- doc/emacs/maintaining.texi 2013-06-02 11:56:39 +0000
>> ***************
>> *** 1266,1275 ****
>> @cindex branch (version control)
>>
>> One use of version control is to support multiple independent lines
>> ! of development, which are called @dfn{branches}. Branches are used
>> ! for maintaining separate ``stable'' and ``development'' versions of a
>> ! program, and for developing unrelated features in isolation from one
>> ! another.
>>
>> VC's support for branch operations is currently fairly limited. For
>> decentralized version control systems, it provides commands for
>> --- 1267,1282 ----
>> @cindex branch (version control)
>>
>> One use of version control is to support multiple independent lines
>> ! of development, which are called @dfn{branches}. Branches allow for
>> ! parts of software to be developed in parallel. Large projects require
>> ! many roles to be filled, including developers, build managers, and
>> ! quality assurance personnel. Further, multiple releases on different
>> ! operating system platforms may have to be maintained. Branches allow
>> ! contributors to isolate changes without destabilizing the codebase,
>> ! for example, fixes for bugs, new features, and versions
>> ! integration. These changes may be later merged (resynchronized) after
>> ! testing.
>
>> The new text is copied verbatim from Wikipedia.
>> Please just remove it, since (IMO) the Emacs manual does not need to
>> explain every possible reason why people might want to use branches.
>
> IMHO (at least) this sentence is useful here:
>
> Branches allow contributors to isolate changes without destabilizing the
> codebase, for example, fixes for bugs, new features, and
> versions integration.
Or just only leave the first sentence:
One use of version control is to support multiple independent lines.
Remove the (both versions) motivation of branching.
--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/