Why 2 NEWS templates?

[Jelmer Vernooij]

On Mon, Jan 24, 2011 at 03:40:24PM -0600, John Arbash Meinel wrote:
> I just started adding an entry in doc/en/release-notes/bzr-2.4.txt, and
> I noticed that it was missing the vim line down at the bottom. I also
> noticed that Vincent recently cleaned up a bunch of too-long lines from
> Jelmer. (Which probably wouldn't have happened if the vim line was at
> the bottom, since it tells vim to wrap at 74 chars.)

> Then I saw that there is both:

>   doc/en/release-notes/series-template.txt
>   doc/en/release-notes/release-template.txt

> With the only difference being:
> - --- doc/en/release-notes/release-template.txt
> +++ doc/en/release-notes/series-template.txt
> @@ -1,3 +1,10 @@
> +####################
> +Bazaar Release Notes
> +####################
> +
> +.. toctree::
> +   :maxdepth: 1
> +
>  bzr ?.?.?
>  #########

> @@ -51,3 +58,5 @@
>     spurious test failures and changes to the way things should be tested.


> +..
> +   vim: tw=74 ft=rst ff=unix


> ^- A header, and the vim line at the bottom. Suspicious?



> Anyway, I don't see why we would have 2 templates. My guess is maybe one
> was added in old releases and got merged up without someone realizing
> there was one already there with a different name?

> It seems like we should standardize one way or another. I really like
> having the vim line (though I really miss the encoding=utf8 that we used
> to be able to use.)
+1. I also prefer having the vim line. That indeed would've helped with
the line wrapping.

Cheers,

Jelmer