From e67599f5171108c6a233f4d99ac06a0eea6b3064 Mon Sep 17 00:00:00 2001 From: Yuval Tassa Date: Sat, 28 Dec 2024 08:49:36 -0800 Subject: [PATCH] Add weak deprecation notice include in XMLreference. PiperOrigin-RevId: 710300945 Change-Id: I5a3dd066ef643d606d97ec36ffe1e797bb628659 --- doc/XMLreference.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/XMLreference.rst b/doc/XMLreference.rst index 49818cfa..a903b526 100644 --- a/doc/XMLreference.rst +++ b/doc/XMLreference.rst @@ -264,6 +264,11 @@ how to use includes and how to modularize large files if desired. The name of the XML file to be included. The file location is relative to the directory of the main MJCF file. If the file is not in the same directory, it should be prefixed with a relative path. +.. admonition:: Prefer attach to include + :class: note + + While some use cases for :ref:`include` remain valid, it is recommended to use the + :ref:`attach` element instead, where applicable. .. _mujoco: