Changes between Version 18 and Version 19 of FrequentlyAskedQuestions

Timestamp:

12/08/09 20:11:00 (14 years ago)

Author:

masc01

Comment:

added ids

FrequentlyAskedQuestions

@@ -1 +1 @@
 = Frequently Asked Questions =
 
+=== I have this problem, found this bug, need this help! What can I do to get a good answer? === #bugreport
 
-=== Can I install additional voices/components after the main installation, or do I have to reinstall everything "from scratch"? ===
+A good answer is possible only if you send an informative problem report. Sending an excerpt of an exception, saying that some component "behaves strangely" etc. is not sufficiently informative to diagnose the problem.
+
+An informative problem report should include sufficient details to '''reproduce''' the problem.
+
+ - which platform are you working on (Linux, MacOSX, Windows);
+ - which Java version are you using (output of java -version);
+ - which command have you been running *exactly*?
+
+If your call involved the starting of MARY TTS:
+
+ - any custom config files that you may have created, e.g. for a new language;
+ - the debug output log (i.e., run with maryserver -Dlog.level=debug -Dlog.tofile=true).
+
+If you used voice building tools:
+
+ - trace the problem to the exact input file that caused it and attach that.
+
+
+
+
+=== Can I install additional voices/components after the main installation, or do I have to reinstall everything "from scratch"? === #installvoices
 
 To install or uninstall additional languages and voices, please run the MARY TTS/bin/mary-component-installer.
 
 
-=== Maryserver takes ages to start up! What can I do? ===
+=== Maryserver takes ages to start up! What can I do? === #slowstart
 
 What takes time is starting components and, in particular, unit selection voices. So the more languages and voices you install, the longer maryserver will take to start up. Use the mary-component-installer to uninstall what you don't need.
 
 
-=== What exactly is the license for the software? ===
+=== What exactly is the license for the software? === #license
 
 The OpenMary core system is released under the Lesser GNU General Public License [LGPL|http://www.gnu.org/licenses/lgpl-3.0-standalone.html]. Language components for English, German, Telugu and Turkish are currently also released under the LGPL.
@@ -18 +39 @@
 Different speech synthesis voices are distributed under different licenses:
 
- * the [Arctic license|http://mary.dfki.de/download/voices/arctic-license.html]
- * the [Creative Commons Attribution-NoDerivatives license|http://mary.dfki.de/download/by-nd-3.0.html]
- * The [MBROLA license|http://mary.dfki.de/download/Mbrola%20software%20user%20agreement.html]
+ * the [http://mary.dfki.de/download/voices/arctic-license.html Arctic license]
+ * the [http://mary.dfki.de/download/by-nd-3.0.html Creative Commons Attribution-NoDerivatives license]
+ * The [http://mary.dfki.de/download/Mbrola%20software%20user%20agreement.html MBROLA license]
  * maybe other licenses in the future.
 
@@ -26 +47 @@
 
 
-=== How difficult is it to add support for Hebrew/Italian/Spanish/Hindi/...? Is Mary modular in that sense? ===
+=== How difficult is it to add support for Hebrew/Italian/Spanish/Hindi/...? Is Mary modular in that sense? === #newlanguage
 
 MARY 4.0 comes with substantial support for adding new languages, see NewLanguageSupport. This should help you get started; to do intelligent language-specific things, of course additional work will be needed.
 
-=== I have no experience with Java. I have made some changes in the Mary source code -- how I can compile and test my changes? ===
+=== I have no experience with Java. I have made some changes in the Mary source code -- how I can compile and test my changes? === #compile
 
 
@@ -71 +92 @@
 
 
-=== Will there be support for the open 'ogg vorbis' format for audio output? ===
+=== Will there be support for the open 'ogg vorbis' format for audio output? === #oggvorbis
 
 If someone writes a reliable ogg vorbis encoder in Java, we will be happy to add support for it. We do not intend to use native libraries though, the deployment issues are simply too complex and time-consuming.