← Prev in month ← Prev in thread

Re: [docbook] Why do formalparas only allow one para?

From
Scott Hudson <>
Date
2009-07-23T20:55:24+00:00
ID
Thread
Re: [docbook] Why do formalparas only allow one para?
Ah. Perhaps this is where the proposed <topic> element would support 
this? The TC is currently discussing the addition of a new element to 
provide similar functionality?

Best regards,

--Scott
Scott Hudson	
Senior XML Architect

+1 (303) 542-2146  |  Office
+1 (303) 332-1883  |  Cell

==========================================
Flatirons Solutions
http://www.flatironssolutions.com

 wrote:
> 
> Here is an example where we would really like the second para to be part 
> of the formalpara.
> 
> <formalpara>
>     <title>Simple encryption</title>
>     <para>This level of encryption is equivalent to obfuscation and 
> makes it more difficult for someone using a disk utility to look at the 
> file to decipher the data in your database. Simple encryption does not 
> require a key to encrypt the database.</para>
>    </formalpara>
>    <para>Simple encryption technology is supported in previous versions 
> of &sa_full;.</para>
> 
> 
> The problem is that it is easy to grab the formalpara to move it 
> somewhere else and not realize that the sentence following the 
> formalpara belongs with it.
> 
> We don't want to use a section or a simplesect -- those tags are too big 
> for our purposes.
> 
> 
> 
> 
> 
> *Scott Hudson <>*
> 
> 07/23/2009 03:50 PM
> 
> 	
> To
> 	"" <>
> cc
> 	Jirka Kosek <>, "" 
> <>
> Subject
> 	Re: [docbook] Why do formalparas only allow one para?
> 
> 
> 	
> 
> 
> 
> 
> 
> Sorry, but what makes this different than a <section> then?
> 
> Section has a title and allows multiple para elements?
> 
> Best regards,
> 
> --Scott
> 
> 
>  wrote:
>  >
>  > One problem with simplesect is that it is not allowed to float in a
>  > component. That is, you cannot place anything after it.
>  > This restriction is a deal breaker for us.
>  >
>  >
>  >
>  >
>  > *Jirka Kosek <>*
>  >
>  > 07/23/2009 01:25 PM
>  >
>  >                  
>  > To
>  >                  
>  > cc
>  >                  
>  > Subject
>  >                  Re: [docbook] Why do formalparas only allow one para?
>  >
>  >
>  >                  
>  >
>  >
>  >
>  >
>  >
>  >  wrote:
>  >  >  It would be nice if you could include multiple paras within a
>  >  > <formalpara>. Is there a reason why you can only have one <para> in a
>  >  > <formalpara> tag?
>  >  > We have a lot of cases where we would like to use <formalpara> but 
> can't
>  >  > because of the one para restriction.
>  >  > We like the format of a formalpara because you can put an (inline) 
> title
>  >  > on the content, you can embed indexterms within it, and because it is
>  >  > container tag,  you can move it easily.
>  >
>  > Doesn't simplesect fits your needs?
>  >
>  > --
>  > ------------------------------------------------------------------
>  >  Jirka Kosek      e-mail:       http://xmlguru.cz
>  > ------------------------------------------------------------------
>  >       Professional XML consulting and training services
>  >  DocBook customization, custom XSLT/XSL-FO document processing
>  > ------------------------------------------------------------------
>  > OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
>  > ------------------------------------------------------------------
>  >
>  >
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: 
> For additional commands, e-mail: 
> 
> 
>
← Prev in month ← Prev in thread