Re: [Docutils-users] Re: ReST syntax questions

[Mike O. <ms...@oz...>]

Felix Wiemann wrote:

> Well, adding a comment is indeed the way to separate field lists at 
> the moment.


That's fine.  I can see how parallelism between field lists and regular 
lists (which allow a blank line between items) is important.

>Regarding the indented paragraph, are you sure that you want to indicate
>a block quote (see
><http://docutils.sf.net/docs/ref/rst/restructuredtext.html#block-quotes>)?
>If not, why are you indenting the paragraph?
>  
>

The document covers several application and platforms.  Most of the 
instructions are common to all of them, but those that denote 
differences are indented.  There's too many combinations to have a 
different style for each or use a note for them so I'm doing two styles, 
normal and indented.

>>::
>>    emerge PACKAGE                      -- Install the package.
>>    emerge '>=SECTION/PACKAGE-VERSION'  -- Install this version minimum.
>>    
>>
>
>There's a blank line missing after "::".
>  
>

Ah, I totally missed that.  But it makes sense since a :: at the end of 
a paragraph works.

>It has been proposed that the blank line be made unnecessary; see
><http://docutils.sf.net/docs/dev/todo.html#literal-block-without-a-blank-line>.
>Would be a good idea indeed.
>  
>

I was expecting it to work like a comment or directive since that's what 
it looks like.

>>.. admonition::  Do *NOT* put these files under Apache's document root.
>>   They are not static files to be published literally.  Doing so is no help
>>   to the user and a security vulnerability.
>>
>>.. note::
>>   Filenames are case-sensitive on Unix, case-insensitive on Windows, and
>>   either way on the Macintosh.
>>    
>>
>
>While the second example ("note") should work as you expect, the
>"admonition" directive indicates a *generic* admonition and needs a
>title.  See
><http://docutils.sf.net/docs/ref/rst/directives.html#generic-admonition>.
>  
>

Good, that answers another question of mine, why can't you have a 
title?  So... I guess I need a blank line after the admonition line.