[PATCH] doc/org-manual.org: Specify that tangling requires language identifier

[PATCH] doc/org-manual.org: Specify that tangling requires language identifier

[Thibaut Meyer via General discussions about Org-mode.]

TINYCHANGE
---
See discussion "[BUG] Inconsistent org-babel tangle behaviour"

 doc/org-manual.org | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 2d5fd57b3..7710bfe7e 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -18028,7 +18028,8 @@ or
   block.  See [[*Languages]], for identifiers of supported languages.
 
   When =<language>= identifier is omitted, the block also cannot
-  have =<switches>= and =<header arguments>=.
+  have =<switches>= and =<header arguments>=.  Otherwise, the first
+  switch/argument will be treated as =<language>=.
 
   Language identifier is also used to fontify code blocks in Org
   buffers, when ~org-src-fontify-natively~ is set to non-~nil~.  See
@@ -19429,6 +19430,9 @@ configured through the options.  During this tangling process, Org
 expands variables in the source code, and resolves any noweb style
 references (see [[*Noweb Reference Syntax]]).
 
+Note that code blocks can only be tangled when a =<language>=
+identifier is specified.
+
 *** Header arguments
 :PROPERTIES:
 :UNNUMBERED: notoc
-- 
2.47.1