Re: needless <para>'s
| From: | Daniel Convissor | Date: | Thu, 22 Apr 2010 17:32:48 +0000 |
| Subject: | Re: needless <para>'s | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969381679@lists.php.net to get a copy of this message | ||
Hello Again:
On Tue, Apr 20, 2010 at 11:38:29AM -0400, Daniel Convissor wrote:
>
> * variablelist in the parameters section
> * informaltable in the changelog section
> * example in the examples section
> * simplelist in the seealso section
>
> The Element Reference in "DocBook: The Definitive Guide" indicates these
> elements are allowed to be free standing inside <refsect1>'s so the
> <para>'s seemingly add needless clutter and nesting. Can I remove them
> from the skeletons, or is there something I'm missing?
Some (many?) of our documentation files already don't use the para's
around these elements.
The only thing that happens in the output when removing the extra para's
is there is no vertical spacing between repeated elements. See
http://us.php.net/manual/en/mysqli.autocommit.php
for an example. The
following CSS snippet (for line 867 of site.css) puts that spacing back
in without impacting examples that do have para's around them:
div.refsect1 div.example {
margin-top: 20px;
}
Thanks,
--Dan
--
T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
data intensive web and database programming
http://www.AnalysisAndSolutions.com/
4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409