[gtk-doc] mkdb: add a deprecation warning for sgml mode

[Stefan Kost <stefkost src gnome org>]

commit 7585aeab493f366257a718af852358d4e2748426
Author: Stefan Sauer <ensonic users sf net>
Date:   Sat Apr 25 09:55:08 2015 +0200

    mkdb: add a deprecation warning for sgml mode

 gtkdoc-mkdb.in   |   10 ++++++++++
 gtkdoc-mkhtml.in |    8 ++++++++
 2 files changed, 18 insertions(+), 0 deletions(-)
---
diff --git a/gtkdoc-mkdb.in b/gtkdoc-mkdb.in
index 52eddd5..cc8a36a 100755
--- a/gtkdoc-mkdb.in
+++ b/gtkdoc-mkdb.in
@@ -140,6 +140,16 @@ if (! defined($OUTPUT_FORMAT) || ($OUTPUT_FORMAT eq "")) {
     $OUTPUT_FORMAT = lc($OUTPUT_FORMAT);
 }
 
+if ($OUTPUT_FORMAT eq "sgml") {
+print <<EOF;
+###############################################################################
+sgml support in gtk-doc is deprecated and will be removed from one of the next
+gtk-doc release.
+Please refer to the documentation "Modernizing the documentation"/"GTK-Doc 1.9".
+###############################################################################
+EOF
+}
+
 @TRACE@(" output-format: [$OUTPUT_FORMAT]\n");
 
 if ($OUTPUT_FORMAT eq "xml") {
diff --git a/gtkdoc-mkhtml.in b/gtkdoc-mkhtml.in
index 13256fc..5f171be 100644
--- a/gtkdoc-mkhtml.in
+++ b/gtkdoc-mkhtml.in
@@ -102,6 +102,14 @@ if $is_xml; then
         --stringparam chunker.output.quiet $quiet \
         "$@" $gtkdocdir/gtk-doc.xsl $document || exit $?
 else
+    echo <<EOF;
+###############################################################################
+sgml support in gtk-doc is deprecated and will be removed from one of the next
+gtk-doc release.
+Please refer to the documentation "Modernizing the documentation"/"GTK-Doc 1.9".
+###############################################################################
+EOF
+
     @JADE@ $path_arg -t @SGML_FORMAT_TYPE@ -w no-idref -d $gtkdocdir/gtk-doc.dsl \
         -V "gtkdoc-bookname=$module" -V "gtkdoc-version= VERSION@" \
         "$@" $gtkdocdir/gtk-doc.dcl $document || exit $?