Hi!

I have just committed a script to check what DocBook XML tags we use,
and what are only used once or twice (like formalpara). The results are
interesting...

IMHO this list would alos help to make some standard for used tags,
and don't let everybody invent his/her own tag usage style. If we use
a small subset of tags, people can easily identify what tag means
what... Using "exotic" tags like formalpara may lead to confusion
for authors, and new contributors.

The text file sent is a test on the "en" XML tree.

Goba
TAG USAGE STATISCTICS

=========================================================
In this file you can find tag usage stats compiled
from the following tree[s] at phpdoc:
en.

You may find some rarely used tags here, and find out
what tags others use to write documentation.
=========================================================

function                       10168
parameter                      8434
para                           7294
paramdef                       5147
title                          3889
entry                          3357
simpara                        2726
refsect1                       2583
refnamediv                     2577
refentry                       2577
refname                        2577
refpurpose                     2577
funcdef                        2570
funcprototype                  2570
funcsynopsis                   2560
listitem                       1939
literal                        1330
row                            1155
programlisting                 1073
link                           903
optional                       811
example                        699
term                           489
varlistentry                   489
note                           399
informalexample                332
ulink                          306
filename                       259
member                         219
type                           216
itemizedlist                   213
?xml                           158
emphasis                       155
varname                        150
sect1                          148
sect2                          146
titleabbrev                    123
reference                      110
partintro                      102
constant                       98
replaceable                    96
acronym                        88
answer                         82
qandaentry                     82
question                       82
tgroup                         72
tbody                          72
variablelist                   70
table                          68
screen                         61
thead                          59
warning                        57
command                        54
option                         51
literallayout                  39
chapter                        36
section                        29
simplelist                     18
refsect2                       17
orderedlist                    17
sect3                          16
systemitem                     14
errortype                      14
qandaset                       13
productname                    12
envar                          12
computeroutput                 11
firstname                      10
appendix                       10
userinput                      10
caution                        10
surname                        10
author                         8
classname                      8
abbrev                         7
tip                            6
sgmltag                        6
glossterm                      5
synopsis                       5
year                           5
informaltable                  4
sect4                          3
editor                         2
manvolnum                      2
refentrytitle                  2
authorgroup                    2
refsynopsisdiv                 2
citerefentry                   2
blockquote                     2
application                    2
holder                         1
bookinfo                       1
pubdate                        1
symbol                         1
copyright                      1
abstract                       1
errorcode                      1
prompt                         1
citation                       1
preface                        1
legalnotice                    1
footnoteref                    1
footnote                       1
formalpara                     1

Reply via email to