From 925ee0d23fc0778573e7e08848dc89acfe1d90d1 Mon Sep 17 00:00:00 2001
From: Stefan Kost <ensonic@users.sourceforge.net>
Date: Wed, 9 Jul 2008 12:13:09 +0000
Subject: gst/festival/gstfestival.c: Add a note to the docs, that festival
 need to be running. Also log an error it it is not....

Original commit message from CVS:
* gst/festival/gstfestival.c:
Add a note to the docs, that festival need to be running. Also log an
error it it is not. Fixes #541327
---
 gst/festival/gstfestival.c | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

(limited to 'gst')

diff --git a/gst/festival/gstfestival.c b/gst/festival/gstfestival.c
index f2ce45a6..d67c5403 100644
--- a/gst/festival/gstfestival.c
+++ b/gst/festival/gstfestival.c
@@ -64,13 +64,14 @@
  * SECTION:element-festival
  * 
  * This element connects to a
- * <ulink url="http://www.festvox.org/festival/index.html">festival</ulink> server 
- * process and uses it to synthesize speech.
+ * <ulink url="http://www.festvox.org/festival/index.html">festival</ulink>
+ * server process and uses it to synthesize speech. Festival need to run already
+ * in server mode, started as <screen>festival --server</screen>
  * 
  * <refsect2>
  * <title>Example pipeline</title>
  * |[
- * echo "hi" | gst-launch fdsrc fd=0 ! festival ! wavparse ! audioconvert ! alsasink
+ * echo 'Hello G-Streamer!' | gst-launch fdsrc fd=0 ! festival ! wavparse ! audioconvert ! alsasink
  * ]|
  * </refsect2>
  */
@@ -462,8 +463,11 @@ gst_festival_open (GstFestival * festival)
   festival->info->server_fd =
       festival_socket_open (festival->info->server_host,
       festival->info->server_port);
-  if (festival->info->server_fd == -1)
+  if (festival->info->server_fd == -1) {
+    GST_ERROR
+        ("Could not talk to festival server (no server running or wrong host/port?)");
     return FALSE;
+  }
 
   return TRUE;
 }
-- 
cgit v1.2.1