2 This docuemnt attempts to reverse engenier some design decissions in
6 When creating SGML IDS, we append ":CAPS" to all
7 all-caps identifiers to prevent name clashes (SGML ids are case-insensitive).
8 (It basically never is the case that mixed-case identifiers would collide.)
10 Unfortunately we create ambigous ids. The document structure ids are e.g.
11 GtkWidget.{top_of_page,synopsis,object-hierarchy,...}
12 and that is ambigous with eventual structure memeber of the same name.
15 find . -name "*.xml" -exec grep -o "id=\"[a-zA-Z_:.\-]*\"" {} \; | sort | uniq
18 gtk-doc differenciates between plain-sections and gobject-sections:
19 +---------+----------------+
21 +---------+----------------+
22 | plain | $module-$title |
24 +---------+----------------+
26 - links to #GtkWidget would go to $title
27 - linking to the struct would need #GtkWidget-struct