; Mention new modes in the Emacs user manual

* etc/NEWS: Mark new modes as documented.
* doc/emacs/programs.texi (Program Modes): Add PHP.  (Bug#71380)
Add other new modes.

2 files changed, 13 insertions, 12 deletions

diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index b944d24d91f..3b863eefd72 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -94,14 +94,15 @@ mode for the C programming language is @code{c-mode}.
 @cindex TOML mode
   Emacs has programming language modes for Lisp, Scheme, the
 Scheme-based DSSSL expression language, Ada, ASM, AWK, C, C++, C#,
-Fortran, Icon, IDL (CORBA), IDLWAVE, Java, Javascript, M4, Makefiles,
-Metafont (@TeX{}'s companion for font creation), Modula2, Object
-Pascal, Objective-C, Octave, Pascal, Perl, Pike, PostScript, Prolog,
-Python, Ruby, Simula, SQL, Tcl, TypeScript, Verilog, and VHDL@.  An
-alternative mode for Perl is called CPerl mode.  Modes are also
-available for the scripting languages of the common GNU and Unix
-shells, and MS-DOS/MS-Windows @samp{BAT} files, JSON, DNS master
-files, CSS (Cascading Style Sheets), Dockerfiles, CMake files, and various sorts of configuration files.
+Elixir, Fortran, Icon, IDL (CORBA), HEEx, IDLWAVE, Java, Javascript,
+Lua, M4, Makefiles, Metafont (@TeX{}'s companion for font creation),
+Modula2, Object Pascal, Objective-C, Octave, Pascal, Perl, PHP, Pike,
+PostScript, Prolog, Python, Ruby, Simula, SQL, Tcl, TypeScript, Verilog,
+and VHDL@.  The recommended mode for Perl is called CPerl mode.  Modes
+are also available for the scripting languages of the common GNU and
+Unix shells, and MS-DOS/MS-Windows @samp{BAT} files, JSON, DNS master
+files, CSS (Cascading Style Sheets), Dockerfiles, CMake files, and
+various sorts of configuration files.
 
   Ideally, Emacs should have a major mode for each programming
 language that you might want to edit.  If it doesn't have a mode for
diff --git a/etc/NEWS b/etc/NEWS
index 53bc8dc9534..b2fdbc4a88f 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1983,19 +1983,19 @@ the functionality of 'after-change-functions':
 An optional major mode based on the tree-sitter library for editing
 HTML files.
 
----
++++
 *** New major mode 'heex-ts-mode'.
 A major mode based on the tree-sitter library for editing HEEx files.
 
----
++++
 *** New major mode 'elixir-ts-mode'.
 A major mode based on the tree-sitter library for editing Elixir files.
 
----
++++
 *** New major mode 'lua-ts-mode'.
 A major mode based on the tree-sitter library for editing Lua files.
 
----
++++
 *** New major mode 'php-ts-mode'.
 A major mode based on the tree-sitter library for editing PHP files.