[kde-doc-english] Re: KDevelop Manual

[Éric Bischoff]

Le Mercredi 27 Avril 2005 09:53, Joe Dev a écrit :
> index.docbook:1398: element formalpara: validity error : Element formalpara
> content does not follow the DTD, expecting (title , indexterm* , para), got
> (title indexterm para para para para )
> </formalpara>
> which seems to mean that a formalpara accepts only one para inside.

That's correct. A <formalpara> is a <paragraph> with a title. A formal 
paragraph, somehow ;-).

> Either I put my additional paras outside the formalpara,
> or I make a formalpara around each of my paras,

Then you will need a <title> for each one.

Are you sure you are not looking for something like <bridgehead> ? Which is 
adviced against, BTW.

> or (preferred?) we eliminate the formalparas altogether.
> I'll check that with the documentation team.

> Doc people:
> Could someone look at the KDevelop user manual's markup please?
> What shall we do with it, especially the formalparas?

I do not consider myself as a doc person anymore, but if you send in private 
the files as an attachement, I will do it.

(I have CVS access, but I temporarily removed my copy of the repository 
because of 1) next switch to subversion and 2) machine change).

-- 
Never try and teach a pig to sing,
you waste your time and annoy the pig
        - Mark Twain