]> sjero.net Git - wget/blob - README.branches
5f9cabb728d08c2f0b76f6d77340ab1ee6768a0f
[wget] / README.branches
1 In late 2000, time constraints delayed the release of Wget 1.6.  While
2 it was awaiting release, people had new features and other changes they
3 wanted added to the CVS archive, but these were deemed not safe to
4 introduce just before a release.
5
6 The solution was to split the stable 1.6 off onto its own branch, while
7 free-wheeling development continued on the main branch (whose version
8 was changed from 1.5.3+dev to 1.7-dev).
9
10 Unfortunately it's difficult to portray this branched development in the
11 flat ChangeLog file.  Either you include 1.6-branch changes in the
12 1.7-branch ChangeLog, in which case it becomes impossible to tell what
13 release version a given change first went into Wget, just judging by
14 date and position in the ChangeLog, or you omit all 1.6-branch changes
15 from the 1.7-branch ChangeLog, in which case all evidence of the
16 existence of 1.6 (and further information about that branch) disappears
17 from future versions of Wget.
18
19 The solution that was decided upon was to make a subdirectory called
20 ChangeLog-branches adjacent to each ChangeLog file.  Inside is the
21 corresponding ChangeLog from the most recent release on the stable
22 branch (e.g. 1.6_branch.ChangeLog).  This way, no information is lost
23 and there's no misleading information in the ChangeLog.