mbox series

[0/6] meson build improvements

Message ID 20200109115631.500056-1-bruce.richardson@intel.com (mailing list archive)
Headers
Series meson build improvements |

Message

Bruce Richardson Jan. 9, 2020, 11:56 a.m. UTC
  These patches make some improvements to the meson build, particularly
for documentation. They also remove many, but not all warnings issued by
meson e.g. warnings about newer features unsupported in baseline.

The biggest change is to improve the handling of the guide html docs.
The change here is more significant, and the doc build now uses a
wrapper script around sphinx. This wrapper script allows us to output
correct dependency information for the sphinx build in a .d file. This
.d file is processed by ninja (not meson) on build, so that any changes
to doc files trigger a rebuild to the guides using sphinx.

For now, the two patches which remove the meson version warnings are
CC'ed to stable for backport, theoretically this who set could be
backported if so desired, as all changes could be considered fixes to
some degree or other, and nothing introduces a whole new feature.

Note: for completeness and simplicity, previously submitted patch
http://patches.dpdk.org/patch/64189/ is included in this set, and will
be marked superceded in patchwork.

Bruce Richardson (6):
  kernel/linux/kni: fix meson warning about console keyword
  build: skip processing docs folder if docs disabled
  doc/api: fix warning with meson build
  doc/guides: reduce whitespace in meson build file
  doc/guides: rebuild with meson whenever a file changes
  doc/api: reduce indentation in meson build file

 buildtools/call-sphinx-build.py | 29 ++++++++++
 buildtools/meson.build          |  6 +-
 doc/api/meson.build             | 99 +++++++++++++++++----------------
 doc/guides/meson.build          | 38 ++++++-------
 doc/meson.build                 |  4 ++
 kernel/linux/kni/meson.build    |  1 -
 6 files changed, 104 insertions(+), 73 deletions(-)
 create mode 100755 buildtools/call-sphinx-build.py
  

Comments

Bruce Richardson Jan. 9, 2020, 12:07 p.m. UTC | #1
These patches make some improvements to the meson build, particularly
for documentation. They also remove many, but not all warnings issued by
meson e.g. warnings about newer features unsupported in baseline.

The biggest change is to improve the handling of the guide html docs.
The change here is more significant, and the doc build now uses a
wrapper script around sphinx. This wrapper script allows us to output
correct dependency information for the sphinx build in a .d file. This
.d file is processed by ninja (not meson) on build, so that any changes
to doc files trigger a rebuild to the guides using sphinx.

For now, the two patches which remove the meson version warnings are
CC'ed to stable for backport, theoretically this who set could be
backported if so desired, as all changes could be considered fixes to
some degree or other, and nothing introduces a whole new feature.

Note: for completeness and simplicity, previously submitted patch
http://patches.dpdk.org/patch/64189/ is included in this set, and will
be marked superceded in patchwork.

V2: resend to correct email addresses

Bruce Richardson (6):
  kernel/linux/kni: fix meson warning about console keyword
  build: skip processing docs folder if docs disabled
  doc/api: fix warning with meson build
  doc/guides: reduce whitespace in meson build file
  doc/guides: rebuild with meson whenever a file changes
  doc/api: reduce indentation in meson build file

 buildtools/call-sphinx-build.py | 29 ++++++++++
 buildtools/meson.build          |  6 +-
 doc/api/meson.build             | 99 +++++++++++++++++----------------
 doc/guides/meson.build          | 38 ++++++-------
 doc/meson.build                 |  4 ++
 kernel/linux/kni/meson.build    |  1 -
 6 files changed, 104 insertions(+), 73 deletions(-)
 create mode 100755 buildtools/call-sphinx-build.py
  
Luca Boccassi Jan. 9, 2020, 3:30 p.m. UTC | #2
On Thu, 2020-01-09 at 12:07 +0000, Bruce Richardson wrote:
> These patches make some improvements to the meson build, particularly
> for documentation. They also remove many, but not all warnings issued
> by
> meson e.g. warnings about newer features unsupported in baseline.
> 
> The biggest change is to improve the handling of the guide html docs.
> The change here is more significant, and the doc build now uses a
> wrapper script around sphinx. This wrapper script allows us to output
> correct dependency information for the sphinx build in a .d file.
> This
> .d file is processed by ninja (not meson) on build, so that any
> changes
> to doc files trigger a rebuild to the guides using sphinx.
> 
> For now, the two patches which remove the meson version warnings are
> CC'ed to stable for backport, theoretically this who set could be
> backported if so desired, as all changes could be considered fixes to
> some degree or other, and nothing introduces a whole new feature.
> 
> Note: for completeness and simplicity, previously submitted patch
> http://patches.dpdk.org/patch/64189/
>  is included in this set, and will
> be marked superceded in patchwork.
> 
> V2: resend to correct email addresses
> 
> Bruce Richardson (6):
>   kernel/linux/kni: fix meson warning about console keyword
>   build: skip processing docs folder if docs disabled
>   doc/api: fix warning with meson build
>   doc/guides: reduce whitespace in meson build file
>   doc/guides: rebuild with meson whenever a file changes
>   doc/api: reduce indentation in meson build file
> 
>  buildtools/call-sphinx-build.py | 29 ++++++++++
>  buildtools/meson.build          |  6 +-
>  doc/api/meson.build             | 99 +++++++++++++++++------------
> ----
>  doc/guides/meson.build          | 38 ++++++-------
>  doc/meson.build                 |  4 ++
>  kernel/linux/kni/meson.build    |  1 -
>  6 files changed, 104 insertions(+), 73 deletions(-)
>  create mode 100755 buildtools/call-sphinx-build.py

Series-acked-by: Luca Boccassi <bluca@debian.org>