[libvirt PATCH 5/5] news: Add information about old releases

Andrea Bolognani posted 5 patches 5 years, 8 months ago
[libvirt PATCH 5/5] news: Add information about old releases
Posted by Andrea Bolognani 5 years, 8 months ago
Until libvirt 2.5.0 we didn't have a real process for release
notes in place, and we just published the list of commits that
had made it into each release, dividing them into categories that
mostly matched the sections we use today. Those documents haven't
been relevant for years, but they're still in the git repository
and collectively take up almost 2 MiB of disk space.

Let's import the only valuable piece of information they contain,
the release date for each libvirt versions, into the current
document and then drop them for good.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
---
 NEWS.rst               |  721 +++++++-
 docs/news-2005.html.in |   28 -
 docs/news-2006.html.in |  354 ----
 docs/news-2007.html.in |  534 ------
 docs/news-2008.html.in |  580 -------
 docs/news-2009.html.in | 1603 -----------------
 docs/news-2010.html.in | 2218 ------------------------
 docs/news-2011.html.in | 3314 -----------------------------------
 docs/news-2012.html.in | 3012 --------------------------------
 docs/news-2013.html.in | 3675 ---------------------------------------
 docs/news-2014.html.in | 3418 ------------------------------------
 docs/news-2015.html.in | 2864 ------------------------------
 docs/news-2016.html.in | 3740 ----------------------------------------
 13 files changed, 718 insertions(+), 25343 deletions(-)
 delete mode 100644 docs/news-2005.html.in
 delete mode 100644 docs/news-2006.html.in
 delete mode 100644 docs/news-2007.html.in
 delete mode 100644 docs/news-2008.html.in
 delete mode 100644 docs/news-2009.html.in
 delete mode 100644 docs/news-2010.html.in
 delete mode 100644 docs/news-2011.html.in
 delete mode 100644 docs/news-2012.html.in
 delete mode 100644 docs/news-2013.html.in
 delete mode 100644 docs/news-2014.html.in
 delete mode 100644 docs/news-2015.html.in
 delete mode 100644 docs/news-2016.html.in

diff --git a/NEWS.rst b/NEWS.rst
index 128b899b88..82b93d5a44 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -3354,9 +3354,724 @@ v2.5.0 (2016-12-04)
   - Fix compilation on macOS
 
 
-Older libvirt releases didn't have proper release notes: if you are interested
-in changes between them, you should check out docs/news-\*.html or the full git
-log (see instructions in ChangeLog).
+v2.4.0 (2016-11-01)
+===================
+
+No release notes.
+
[...]
+
+v0.0.1 (2005-12-19)
+===================
+
+No release notes.
 
 
 .. _git log: https://gitlab.com/libvirt/libvirt/-/commits/master
diff --git a/docs/news-2005.html.in b/docs/news-2005.html.in
deleted file mode 100644
index 8d6dc150d3..0000000000
--- a/docs/news-2005.html.in
+++ /dev/null
@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2005)</h1>
-    <p>Here is the list of official releases made during the year 2005.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
-    <h3>0.0.1: Dec 19 2005</h3>
-    <ul>
-      <li>Features:<br/>
-      First release,<br/>
-      Basic management of existing Xen domains,<br/>
-      Minimal autogenerated Python bindings<br/>
-      </li>
-    </ul>
-
-  </body>
-</html>
diff --git a/docs/news-2006.html.in b/docs/news-2006.html.in
deleted file mode 100644
index 7463d7bad3..0000000000
--- a/docs/news-2006.html.in
+++ /dev/null
@@ -1,354 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2006)</h1>
-    <p>Here is the list of official releases made during the year 2006.
-    A similar list for <a href="news-2005.html">2005</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2007.html.in b/docs/news-2007.html.in
deleted file mode 100644
index 14099936fd..0000000000
--- a/docs/news-2007.html.in
+++ /dev/null
@@ -1,534 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2007)</h1>
-    <p>Here is the list of official releases made during the year 2007.
-    A similar list for <a href="news-2006.html">2006</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2008.html.in b/docs/news-2008.html.in
deleted file mode 100644
index 28f3b98d82..0000000000
--- a/docs/news-2008.html.in
+++ /dev/null
@@ -1,580 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2008)</h1>
-    <p>Here is the list of official releases made during the year 2008.
-    A similar list for <a href="news-2007.html">2007</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2009.html.in b/docs/news-2009.html.in
deleted file mode 100644
index 9c0df7a82f..0000000000
--- a/docs/news-2009.html.in
+++ /dev/null
@@ -1,1603 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2009)</h1>
-    <p>Here is the list of official releases made during the year 2009.
-    A similar list for <a href="news-2008.html">2008</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2010.html.in b/docs/news-2010.html.in
deleted file mode 100644
index 8d9ee1dea4..0000000000
--- a/docs/news-2010.html.in
+++ /dev/null
@@ -1,2218 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2010)</h1>
-    <p>Here is the list of official releases made during the year 2010.
-    A similar list for <a href="news-2009.html">2009</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2011.html.in b/docs/news-2011.html.in
deleted file mode 100644
index f59bb196cd..0000000000
--- a/docs/news-2011.html.in
+++ /dev/null
@@ -1,3314 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2011)</h1>
-    <p>Here is the list of official releases made during the year 2011.
-    A similar list for <a href="news-2010.html">2010</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2012.html.in b/docs/news-2012.html.in
deleted file mode 100644
index ede85c41c7..0000000000
--- a/docs/news-2012.html.in
+++ /dev/null
@@ -1,3012 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2012)</h1>
-    <p>Here is the list of official releases made during the year 2012.
-    A similar list for <a href="news-2011.html">2011</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2013.html.in b/docs/news-2013.html.in
deleted file mode 100644
index 6cc3bca2ff..0000000000
--- a/docs/news-2013.html.in
+++ /dev/null
@@ -1,3675 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2013)</h1>
-    <p>Here is the list of official releases made during the year 2013.
-    A similar list for <a href="news-2012.html">2012</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2014.html.in b/docs/news-2014.html.in
deleted file mode 100644
index 2dbbe070de..0000000000
--- a/docs/news-2014.html.in
+++ /dev/null
@@ -1,3418 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2014)</h1>
-    <p>Here is the list of official releases made during the year 2014.
-    A similar list for <a href="news-2013.html">2013</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2015.html.in b/docs/news-2015.html.in
deleted file mode 100644
index bb71af1c46..0000000000
--- a/docs/news-2015.html.in
+++ /dev/null
@@ -1,2864 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2015)</h1>
-    <p>Here is the list of official releases made during the year 2015.
-    A similar list for <a href="news-2014.html">2014</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
diff --git a/docs/news-2016.html.in b/docs/news-2016.html.in
deleted file mode 100644
index a7be451a2e..0000000000
--- a/docs/news-2016.html.in
+++ /dev/null
@@ -1,3740 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  </head>
-  <body>
-    <h1>Releases (2016)</h1>
-    <p>Here is the list of official releases made during the year 2016.
-    A similar list for <a href="news-2015.html">2015</a> is also available.
-    </p>
-    <p>It is also possible to just use
-    the <a href="downloads.html">GIT version or snapshot</a>,
-    contact the mailing list and check
-    the <a href="https://libvirt.org/git/?p=libvirt.git;a=log">GIT log</a>
-    to gauge progress.
-    </p>
-
[...]
-
-  </body>
-</html>
-- 
2.25.4

Re: [libvirt PATCH 5/5] news: Add information about old releases
Posted by Ján Tomko 5 years, 8 months ago
On a Tuesday in 2020, Andrea Bolognani wrote:
>Until libvirt 2.5.0 we didn't have a real process for release
>notes in place, and we just published the list of commits that
>had made it into each release, dividing them into categories that
>mostly matched the sections we use today. Those documents haven't
>been relevant for years, but they're still in the git repository
>and collectively take up almost 2 MiB of disk space.
>
>Let's import the only valuable piece of information they contain,
>the release date for each libvirt versions, into the current
>document and then drop them for good.
>
>Signed-off-by: Andrea Bolognani <abologna@redhat.com>
>---
> NEWS.rst               |  721 +++++++-
> docs/news-2005.html.in |   28 -
> docs/news-2006.html.in |  354 ----
> docs/news-2007.html.in |  534 ------
> docs/news-2008.html.in |  580 -------
> docs/news-2009.html.in | 1603 -----------------
> docs/news-2010.html.in | 2218 ------------------------
> docs/news-2011.html.in | 3314 -----------------------------------
> docs/news-2012.html.in | 3012 --------------------------------
> docs/news-2013.html.in | 3675 ---------------------------------------
> docs/news-2014.html.in | 3418 ------------------------------------
> docs/news-2015.html.in | 2864 ------------------------------
> docs/news-2016.html.in | 3740 ----------------------------------------
> 13 files changed, 718 insertions(+), 25343 deletions(-)
> delete mode 100644 docs/news-2005.html.in
> delete mode 100644 docs/news-2006.html.in
> delete mode 100644 docs/news-2007.html.in
> delete mode 100644 docs/news-2008.html.in
> delete mode 100644 docs/news-2009.html.in
> delete mode 100644 docs/news-2010.html.in
> delete mode 100644 docs/news-2011.html.in
> delete mode 100644 docs/news-2012.html.in
> delete mode 100644 docs/news-2013.html.in
> delete mode 100644 docs/news-2014.html.in
> delete mode 100644 docs/news-2015.html.in
> delete mode 100644 docs/news-2016.html.in
>
>diff --git a/NEWS.rst b/NEWS.rst
>index 128b899b88..82b93d5a44 100644
>--- a/NEWS.rst
>+++ b/NEWS.rst
>@@ -3354,9 +3354,724 @@ v2.5.0 (2016-12-04)
>   - Fix compilation on macOS
>
>
>-Older libvirt releases didn't have proper release notes: if you are interested
>-in changes between them, you should check out docs/news-\*.html or the full git
>-log (see instructions in ChangeLog).
>+v2.4.0 (2016-11-01)
>+===================
>+
>+No release notes.
>+
>[...]
>+
>+v0.0.1 (2005-12-19)
>+===================
>+
>+No release notes.
>

This looks excessive - I'd rather drop them for good. We still have the
info in the tagged relase commits.

With the docs/news.*html reference dropped above:

Reviewed-by: Ján Tomko <jtomko@redhat.com>

Jano
Re: [libvirt PATCH 5/5] news: Add information about old releases
Posted by Andrea Bolognani 5 years, 8 months ago
On Wed, 2020-06-03 at 14:44 +0200, Ján Tomko wrote:
> On a Tuesday in 2020, Andrea Bolognani wrote:
> > -Older libvirt releases didn't have proper release notes: if you are interested
> > -in changes between them, you should check out docs/news-\*.html or the full git
> > -log (see instructions in ChangeLog).
> > +v2.4.0 (2016-11-01)
> > +===================
> > +
> > +No release notes.
> > +
> > [...]
> > +
> > +v0.0.1 (2005-12-19)
> > +===================
> > +
> > +No release notes.
> 
> This looks excessive - I'd rather drop them for good. We still have the
> info in the tagged relase commits.

I think it's valuable to retain that information and have it all
stored in one place, and considering how many lines we're removing
with this patch we come out massively on top either way.

That said, this is not a hill I'm particularly interested in dying
on, so if you insist on dropping the information altogether I will
begrudgingly comply :)

-- 
Andrea Bolognani / Red Hat / Virtualization