Mark deprecated apis more clearly

Move them to their own section in the docs.

1 files changed, 4 insertions, 11 deletions

diff --git a/pango/pango-engine.c b/pango/pango-engine.c
index a22270eb..0cd57407 100644
--- a/pango/pango-engine.c
+++ b/pango/pango-engine.c
@@ -24,19 +24,12 @@
  * @short_description:Language-specific and rendering-system-specific processing
  * @title:Engines
  *
- * Pango utilizes a module architecture in which the language-specific
+ * Pango used to have a module architecture in which the language-specific
  * and render-system-specific components are provided by loadable
- * modules. Each loadable module supplies one or more
- * <firstterm>engines</firstterm>.  Each <firstterm>engine</firstterm>
- * has an associated <firstterm>engine type</firstterm> and
- * <firstterm>render type</firstterm>. These two types are represented by strings.
+ * modules.
  *
- * Each dynamically-loaded module exports several functions which provide
- * the public API. These functions are script_engine_list(),
- * script_engine_init() and script_engine_exit, and
- * script_engine_create(). The latter three functions are used when
- * creating engines from the module at run time, while the first
- * function is used when building a catalog of all available modules.
+ * This is no longer the case, and all the APIs related
+ * to modules and engines should not be used anymore.
  *
  * Deprecated: 1.38
  */