Re: changes in r112843

[Xue Fuqiao <xfq.free@gmail.com>]

On Wed, Jun 5, 2013 at 6:59 AM, Xue Fuqiao <xfq.free@gmail.com> wrote:
> On Wed, Jun 5, 2013 at 1:40 AM, Glenn Morris <rgm@gnu.org> 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/