formatting of code blocks and lists of type table

11 views
Skip to first unread message

Alan Shiers

unread,
Sep 25, 2014, 7:07:09 PM9/25/14
to docu-...@googlegroups.com
I tried using docu on my project and found two problem areas: code blocks and lists of type table.
When I have a code block like this:

/// <code>
/// String temp = Request[&quot;action&quot;]; 
/// if (temp != null) 
///   pms.setAction(temp); 
/// temp = Request[&quot;id&quot;]; 
/// if (temp != null) 
///   pms.setID(temp); 
/// temp = Request[&quot;start&quot;]; 
/// if (temp != null) 
///   pms.setStart(Convert.ToInt32(temp));
/// ...
/// </code>

The HTML output doesn't indent those lines that need indenting.  For the heck of it, I put in html space: &nbsp; where required. But all that did was mess things up even worse.

To create a table I have this:

/// <list type="table"> 
/// <listheader><term>Type</term><term>Requires Arguments</term><term>How Many</term><term>Argument Type</term></listheader> 
/// <item><term>REQUIRED</term><term>false</term><term></term><term></term></item> 
/// <item><term>DATE_FORMAT</term><term>true</term><term>1</term><term>use DateFormat constant</term></item> 
/// <item><term>EMAIL_REQUIRED</term><term>false</term><term></term><term></term></item> 
/// <item><term>BOOLEAN_REQUIRED</term><term>false</term><term></term><term></term></item> 
/// <item><term>NUMERIC_REQUIRED</term><term>false</term><term></term><term></term></item> 
/// <item><term>MINNUM_REQUIRED</term><term>true</term><term>1</term><term>An integer value representing the smallest numeric value this field is permitted.</term></item> 
/// <item><term>MAXNUM_REQUIRED</term><term>true</term><term>1</term><term>An integer value representing the largest numeric value this field is permitted.</term></item>
/// <item><term>MINMAXNUM_REQUIRED</term><term>true</term><term>2</term><term>Use two integer values: the first representing the smallest numeric value this field is permitted, the second representing the largest numeric value this field is permitted.</term></item> 
/// <item><term>MINLEN_REQUIRED</term><term>true</term><term>1</term><term>An integer value representing the minimum number of characters permitted in this field.</term></item> 
/// <item><term>MAXLEN_REQUIRED</term><term>true</term><term>1</term><term>An integer value representing the maximum number of characters permitted in this field.</term></item> 
/// <item><term>MINMAXLEN_REQUIRED</term><term>true</term><term>2</term><term>Use two integer values: the first representing the minimum number of characters permitted in this field, the second representing the maximum number of characters permitted in this field.</term></item> 
/// <item><term>IP_REQUIRED</term><term>false</term><term></term><term></term></item> 
/// <item><term>URI_REQUIRED</term><term>false</term><term></term><term></term></item> 
/// </list>


In this instance, the table generated ignores the listheader tags altogether, so none of the headers gets generated, and only the first item on each row gets generated.  All else is ignored.  To make these two things work properly, what is it I need to do?



Reply all
Reply to author
Forward
0 new messages