Hi Basil, "Basil L. Contovounesios" <[email protected]> writes:
> Automake 1.16.4 introduced the option of keeping a NEWS.md file. > > Is there interest in better accommodating variations of the traditional > 'noteworthy changes' format (e.g. in a NEWS.md), without needing to > patch the modules maintainer-makefile, do-release-commit-and-tag, > readme-release, and announce-gen (and perhaps others)? > > In the simplest case, for example, I would use an ATX '#' heading in > Markdown in place of an outline-mode '*' heading. > > I noticed that the aforementioned modules support heading variations to > varying degrees in various places: > - do-release-commit-and-tag, and maint.mk's release-commit and > release-prep, expect 'noteworthy changes' on line 3 of NEWS. > - announce-gen allows for '[major ]changes' too, on any line in any > given file, but accepts no heading prefix other than '*'. > - maint.mk's NEWS_hash works on any line of NEWS, but only in the > standard format. > - maint.mk's news-check works on any given line of NEWS. > - maint.mk's syntax-check expects NEWS. > > I arrived at the attached patches in an initial attempt to loosen some > of these requirements, and make them more internally consistent. I > wasn't sure how best to parametrise announce-gen's print_news_deltas. > > Before pursuing this further, I was hoping to get some feedback on > whether changes in this direction are welcome, and suggestions for the > implementation (or maybe someone more experienced would like to > implement it instead of me). WDYT? I haven't looked at the patches, but allowing other formats seems reasonable. Aside from Markdown, I have seen reStructuredText and Org mode used in many places. Collin
