[rkward] doc/rkwardplugins: Fix XML

Yuri Chornoivan null at kde.org
Sun Jan 29 12:23:54 UTC 2017


Git commit 7f0761efae648a1b299a9da4cc78a81ec1358a12 by Yuri Chornoivan.
Committed on 29/01/2017 at 12:23.
Pushed by yurchor into branch 'master'.

Fix XML

M  +6    -2    doc/rkwardplugins/index.docbook

https://commits.kde.org/rkward/7f0761efae648a1b299a9da4cc78a81ec1358a12

diff --git a/doc/rkwardplugins/index.docbook b/doc/rkwardplugins/index.docbook
index d4f1cda7..c253d7cd 100644
--- a/doc/rkwardplugins/index.docbook
+++ b/doc/rkwardplugins/index.docbook
@@ -373,7 +373,9 @@ This is a guide to writing plugins for &rkward;.
 		Using this simple tag you create a list from which the user can select variables. You have to specify an <parameter>id</parameter> for this element, so &rkward; knows how to find it.
 	</para>
 	<warning>
+		<para>
 			You may NOT use a dot (.) in the <parameter>id</parameter> string.
+		</para>
 	</warning>
 	<programlisting>
 					<column>
@@ -1054,7 +1056,9 @@ function printout () {
 	</para>
 	<para>
 		<caution>
+			<para>
 				Probably the <quote>button</quote> approach should only ever be used for plugins that can never be invalid (for missing/bad settings). Otherwise the user would not be able to submit the code, but might have a hard time finding out, the reason for that is hidden behind some button.
+			</para>	
 		</caution>
 	</para>
 </sect1>
@@ -3614,7 +3618,7 @@ Attributes:
 	<varlistentry>
 	<term><parameter>require_true</parameter></term>
 	<listitem><para>If set to "true", the property will become required, and will only be considered valid, if its state is true/on. Hence, if the property is false, it will block the <guibutton>Submit</guibutton> button (optional, defaults to "false").
-		<caution>If you use this, make sure the user can easily detect what's wrong, such as by showing an explanatory <text>.</caution></para></listitem>
+		<caution><para>If you use this, make sure the user can easily detect what's wrong, such as by showing an explanatory <text>.</para></caution></para></listitem>
 	</varlistentry>
 	</variablelist></para></listitem>
 </varlistentry>
@@ -4498,7 +4502,7 @@ different types, using modifiers may lead to errors. For <replaceable>fixed_valu
 	</variablelist></para></listitem>
 </varlistentry>
 <varlistentry><term>Class "RObject"</term>
-<listitem><para>Class which represents a single &r; object. An instance of this class can be obtained by using <command>makeRObject(objectname)</command>. The following methods are available for instances of class "RObject": <warning>If any commands are still pending in the backend, the information provided by these methods can be out-of-date by the time that the plugin code is run. Do <emphasis>not</emphasis> rely on it for critical operations (risking loss of data).</warning>
+<listitem><para>Class which represents a single &r; object. An instance of this class can be obtained by using <command>makeRObject(objectname)</command>. The following methods are available for instances of class "RObject": <warning><para>If any commands are still pending in the backend, the information provided by these methods can be out-of-date by the time that the plugin code is run. Do <emphasis>not</emphasis> rely on it for critical operations (risking loss of data).</para></warning>
 	<variablelist>
 	<varlistentry><term>getName()</term><listitem><para>Returns the absolute name of the object.</para></listitem></varlistentry>
 	<varlistentry><term>exists()</term><listitem><para>Returns whether the object exists. You should generally check this before using any of the methods listed below.</para></listitem></varlistentry>



More information about the rkward-tracker mailing list