--- deliantra/server/pod/skill_help.pod	2006/09/09 22:39:59	1.2
+++ deliantra/server/pod/skill_help.pod	2007/05/18 13:54:52	1.5
@@ -1,3 +1,11 @@
+=begin comment
+***
+*** WARNING: THIS IS A GENERATED FILE - CHANGES WILL BE LOST
+*** The source for this file is in CFPlus/pod/skill_help.pod
+*** Make any changes there and then run ./copy_doc
+***
+=end comment
+
 =head1 Skills
 
 =head1 Description
@@ -171,6 +179,8 @@
 similar to the L<alchemy skill|skill_description/alchemy>, only that
 you need to put the ingredients in a B<jeweler's workbench>.
 
+For a more detailed documentation look in the L<jeweler skill documentation|jeweler_skill>.
+
 =head2 jumping
 
 You can "skip" over one, two or three spaces in the selected
@@ -232,10 +242,17 @@
 
 =head2 oratory
 
-You may "recruit" followers. Recruitees must be of lower level, and
-unaggressive to start. Use of this skill may anger the audience. Also,
-"special" monsters are immune to recruitment. Success depends on user's
-L<charisma|stat_Cha> and level.
+You may "recruit" followers targeting them with your B<oratory>
+skill. Recruitees must be unaggressive to start (a good way to pacify
+monsters is the L<singing skill|skill_description/singing>). Use of
+this skill may anger the audience. Also, some monsters are immune to
+recruitment. Success depends on user's level and her L<charisma|stat_Cha>
+vs. the recruitee's L<intelligence|stat_Int> and level.
+
+Kill experience from your followers goes directly to your oratory skill.
+
+Cleaning women and unagggressive low-level monsters (such as the dogs in
+the wizards house in scorn) are good initial targets for this skill.
 
 =head2 praying
 
@@ -276,8 +293,14 @@
 
 =head2 singing
 
-You may pacify hostile monsters with this skill. Certain kinds of
-monsters are immune. Success depends on user level and L<charisma|stat_Cha>.
+You may pacify hostile monsters with this area attack skill.  Certain
+kinds of monsters are immune. Success depends on user's level and her
+L<charisma|stat_Cha> vs. the monster's L<intelligence|stat_Int> and level.
+
+Singing is a good companion skill for the L<oratory
+skill|skill_description/oratory>: first you pacify creates using singing,
+then you can orate them, convincing them if your cause. It is a useful
+skill when monsters are overwhelming you, too.
 
 =head2 smithery