aboutsummaryrefslogtreecommitdiff
path: root/doc/developer-guidelines.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/developer-guidelines.sgml')
-rw-r--r--doc/developer-guidelines.sgml18
1 files changed, 13 insertions, 5 deletions
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index d336ff13..e6a864d1 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -497,15 +497,23 @@
Coding standards</ulink> for general guidelines.</para>
<section><title>Comments</title>
<para>You should use /* */ for comments and not // as some compilers
- do not handle the latter form</para>
+ do not handle the latter form.</para>
</section>
<section><title>CVS comments</title>
<para>When adding CVS comments at commit time, you can use the following prefixes:
- <unorderedlist>
- <listitem>"-" for a comment that can be removed from the Changelog</listitem>
- <listitem>"*" for an important amendment to be included into a features list
- </unorderedlist>
+ <variablelist>
+ <varlistentry><term>- comment</term>
+ <listitem>
+ <para>for a comment that can be removed from the Changelog</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>* comment</term>
+ <listitem>
+ <para>for an important amendment to be included into a features list</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</section>
</section>