sjero.net Git - wget/blob - ChangeLog.README

   1 Please note that Wget has more than one ChangeLog file:
   2
   3     ./ChangeLog: documents changes to files in the top-level directory
   4                  and to files in subdirectories like po/ that don't have
   5                  their own ChangeLogs
   6
   7     doc/ChangeLog: documents only changes to files in the doc directory
   8
   9     src/ChangeLog: documents only changes to files in the src directory
  10
  11 When checking to see if a patch you sent in has been applied, please
  12 look in the appropriate ChangeLog(s).
  13
  14 In addition, you'll notice the ChangeLog-branches directories.
  15
  16 In late 2000, time constraints delayed the release of Wget 1.6.  While
  17 it was awaiting release, people had new features and other changes they
  18 wanted added to the CVS archive, but these were deemed not safe to
  19 introduce just before a release.
  20
  21 The solution was to split the stable 1.6 off onto its own branch, while
  22 free-wheeling development continued on the main branch (whose version
  23 was changed from 1.5.3+dev to 1.7-dev).
  24
  25 Unfortunately it's difficult to portray this branched development in the
  26 flat ChangeLog file.  Either you include 1.6-branch changes in the
  27 1.7-branch ChangeLog, in which case it becomes impossible to tell what
  28 release version a given change first went into Wget, just judging by
  29 date and position in the ChangeLog, or you omit all 1.6-branch changes
  30 from the 1.7-branch ChangeLog, in which case all evidence of the
  31 existence of 1.6 (and further information about that branch) disappears
  32 from future versions of Wget.
  33
  34 The solution that was decided upon was to make a subdirectory called
  35 ChangeLog-branches adjacent to each ChangeLog file.  Inside is the
  36 corresponding ChangeLog from the most recent release on the stable
  37 branch (e.g. 1.6_branch.ChangeLog).  This way, no information is lost
  38 and there's no misleading information in the ChangeLog.