Indicate mlt_geometry is deprecated in API docs.

diff --git a/src/framework/mlt.h b/src/framework/mlt.h
index b8adca9a03a088b0e7eb3128ab516c489224ade6..9d93064f6f865af1459762fb5e3551ef553898e9 100644 (file)
--- a/src/framework/mlt.h
+++ b/src/framework/mlt.h
@@ -24,6 +24,15 @@
 #ifndef _MLT_H_
 #define _MLT_H_
 
+/** \mainpage MLT API Reference Documentation
+ * \par
+ * We recommend that you look in <a href="annotated.html"><b>Data Structures</b></a>
+ * or <a href="files.html"><b>Files</b></a>.
+ * \par
+ * Additional documentation about MLT, in general, can be found on the
+ * <a href="http://www.mltframework.org/bin/view/MLT/Documentation">MLT website</a>.
+ */
+
 #ifdef __cplusplus
 extern "C"
 {

diff --git a/src/framework/mlt_animation.c b/src/framework/mlt_animation.c
index 7468bb586957258681af7b0520ea804dd5ca924a..14b79782368a2dbb213878413a94a203bffb81d2 100644 (file)
--- a/src/framework/mlt_animation.c
+++ b/src/framework/mlt_animation.c
@@ -1,7 +1,7 @@
 /**
  * \file mlt_animation.c
  * \brief Property Animation class definition
- * \see mlt_animaton_s
+ * \see mlt_animation_s
  *
  * Copyright (C) 2004-2013 Ushodaya Enterprises Limited
  * \author Charles Yates <charles.yates@pandora.be>

diff --git a/src/framework/mlt_animation.h b/src/framework/mlt_animation.h
index 4dbd60dcb2f60e210c77021e6bb3b7894eb6c95c..a102596f14484c52b4d3464e112d0d47d21bf06a 100644 (file)
--- a/src/framework/mlt_animation.h
+++ b/src/framework/mlt_animation.h
@@ -1,7 +1,7 @@
 /**
  * \file mlt_animation.h
  * \brief Property Animation class declaration
- * \see mlt_animaton_s
+ * \see mlt_animation_s
  *
  * Copyright (C) 2004-2013 Ushodaya Enterprises Limited
  * \author Charles Yates <charles.yates@pandora.be>

diff --git a/src/framework/mlt_geometry.c b/src/framework/mlt_geometry.c
index 301963ddca24b0fe0ed0eea7796b8d11ae09bd4b..6b41d3306e7fd32ff7ac1d7400a53c1f89f33138 100644 (file)
--- a/src/framework/mlt_geometry.c
+++ b/src/framework/mlt_geometry.c
@@ -1,7 +1,10 @@
-/*
- * mlt_geometry.c -- provides the geometry API
+/**
+ * \file mlt_geometry.c
+ * \brief geometry animation API (deprecated)
+ * \deprecated use mlt_animation_s instead
+ *
  * Copyright (C) 2004-2005 Ushodaya Enterprises Limited
- * Author: Charles Yates <charles.yates@pandora.be>
+ * \author Charles Yates <charles.yates@pandora.be>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -27,6 +30,10 @@
 #include <stdlib.h>
 #include <string.h>
 
+/** private part of geometry animation item (deprecated)
+ * \deprecated use mlt_animation_s instead
+ */
+
 typedef struct geometry_item_s
 {
        struct mlt_geometry_item_s data;
@@ -34,6 +41,10 @@ typedef struct geometry_item_s
 }
 *geometry_item;
 
+/** private part of geometry object (deprecated)
+ * \deprecated use mlt_animation_s instead
+ */
+
 typedef struct
 {
        char *data;

diff --git a/src/framework/mlt_geometry.h b/src/framework/mlt_geometry.h
index e753c67b84008e3de3e7143e2b523e32b45dbd05..fffe2d841abfa0bb5eb804458237cb0c1fe78df9 100644 (file)
--- a/src/framework/mlt_geometry.h
+++ b/src/framework/mlt_geometry.h
@@ -1,7 +1,10 @@
-/*
- * mlt_geometry.h -- provides the geometry API
+/**
+ * \file mlt_geometry.h
+ * \brief geometry animation API (deprecated)
+ * \deprecated use mlt_animation_s instead
+ *
  * Copyright (C) 2004-2005 Ushodaya Enterprises Limited
- * Author: Charles Yates <charles.yates@pandora.be>
+ * \author Charles Yates <charles.yates@pandora.be>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -23,6 +26,10 @@
 
 #include "mlt_types.h"
 
+/** geometry animation item (deprecated)
+ * \deprecated use mlt_animation_s instead
+ */
+
 struct mlt_geometry_item_s
 {
        /* Will be 1 when this is a key frame */
@@ -37,6 +44,10 @@ struct mlt_geometry_item_s
        int f[ 5 ];
 };
 
+/** geometry object (deprecated)
+ * \deprecated use mlt_animation_s instead
+ */
+
 struct mlt_geometry_s
 {
        void *local;