[automake-commit] branch master updated: doc: update Vala documentation

[Karl Berry]

This is an automated email from the git hooks/post-receive script.

karl pushed a commit to branch master
in repository automake.

View the commit online:
https://git.savannah.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=fa816226f0be1c1bb181026c629fdb3963173be1

The following commit(s) were added to refs/heads/master by this push:
     new fa816226f doc: update Vala documentation
fa816226f is described below

commit fa816226f0be1c1bb181026c629fdb3963173be1
Author: Reuben Thomas <rrt@sc3d.org>
AuthorDate: Mon May 6 08:16:40 2024 -0700

    doc: update Vala documentation
    
    From https://bugs.gnu.org/70557#29.
    
    * doc/automake.texi (Vala Support): Update the URL for Vala.
    Drop the mention of a version requirement, as no current system
      will have a too-old version of Vala.
    Note the restriction on conditional inclusion of source files in
      *_SOURCES.
---
 doc/automake.texi | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/doc/automake.texi b/doc/automake.texi
index d30905e0f..2b897204e 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -7017,24 +7017,29 @@ the @code{_LDFLAGS} variable for the program.
 
 
 @node Vala Support
-@comment  node-name,  next,  previous,  up
 @section Vala Support
 
-@cindex Vala Support
+@cindex Vala support
 @cindex Support for Vala
+@cindex GNU Make, required by Vala
 
-Automake provides initial support for Vala
-(@uref{https://www.vala-project.org/}).
-This requires valac version 0.7.0 or later, and currently requires
-the user to use GNU @command{make}.
+Automake supports Vala (@uref{https://vala.dev/}).
+Vala support requires the user to use GNU @command{make}.
 
 @example
 foo_SOURCES = foo.vala bar.vala zardoz.c
 @end example
 
 Any @file{.vala} file listed in a @code{_SOURCES} variable will be
-compiled into C code by the Vala compiler. The generated @file{.c} files
-are distributed. The end user does not need to have a Vala compiler installed.
+compiled into C code by the Vala compiler.  The generated @file{.c}
+files are distributed. The end user does not need to have a Vala
+compiler installed.
+
+Because all C files must be generated, and the Vala compiler compiles
+all the @file{.vala} files for a target at once, it is not possible to
+add files to a @code{_SOURCES} variable that cannot be compiled
+together; for example, alternative platform-specific definitions of
+the same methods.
 
 Automake ships with an Autoconf macro called @code{AM_PROG_VALAC}
 that will locate the Vala compiler and optionally check its version