From 8858169086c793cdfc17df745408871a16ef99c6 Mon Sep 17 00:00:00 2001
From: "Thomas B. \"dm8tbr\" Ruecker" <thomas@ruecker.fi>
Date: Sat, 30 Mar 2013 07:09:14 +0000
Subject: [PATCH] Adding "A word of warning" to Icecast config file
 documentation.

svn path=/icecast/trunk/icecast/; revision=18890
---
 doc/icecast2_config_file.html | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/icecast2_config_file.html b/doc/icecast2_config_file.html
index 56f6acdd..7a982cfb 100644
--- a/doc/icecast2_config_file.html
+++ b/doc/icecast2_config_file.html
@@ -29,6 +29,20 @@ This section will describe each section of the config file and is grouped into t
 <br />
 <br />
 </p>
+<h2>A word of warning</h2>
+<p>
+Please note that, especially for new Icecast users, editing the config file can be quite tricky. <strong>It is thus recommended to start by just changing all passwords, nothing else.</strong> You can then use the source-password to bring up an initial stream and get more comfortable with how Icecast works.
+</p>
+<p>
+Should you need to customize the configuration, then make a backup of your working config file, before you make any changes. If Icecast refuses to start it is in most cases due to a malformed config file. In such a case running the following command should point out most XML syntax problems.
+<pre>xmllint icecast.xml</pre>
+Also check the Icecast error.log for additional hints.
+</p>
+<p>
+<br />
+<br />
+<br />
+</p>
 <a name="limits"></a>
 <h2>Limits</h2>
 <pre>