Re: Removing warnings in doc

Geert Stappers <[email protected]>
Newsgroups gmane.editors.conglomerate.devel
Message-ID <[email protected]> 
On Fri, Nov 05, 2004 at 09:23:05PM +0100, Geert Stappers wrote:
> On Fri, Nov 05, 2004 at 11:38:49AM +0100, Mich?le Garoche wrote:
 <snip>proposal about reducing gtk-doc warnings</snip>
> > Or is it a very bad idea? 
> 
> Another idea is to find how the  files conglomerate-overrides.txt
> and conglomerate-unused.txt in doc/reference work.
> I guess they surpress the warnings and wouldn't polute the output.

The attachment is what I found in my CVS tree
with the great nsh patch and after a sync with HEAD.

It are reductions, but not ChangeLog documented.

Does some one recognise them?

And what to do with it?


Geert Stappers

_______________________________________________
Conglomerate-devel mailing list
[email protected]
http://lists.copyleft.no/mailman/listinfo/conglomerate-devel
undocumented.patch (text/plain, 15.6 KB) 
? doc/reference/conglomerate-undocumented.txt
? doc/reference/conglomerate-unused.txt
? doc/reference/uncommit
Index: doc/reference/conglomerate-docs.sgml
===================================================================
RCS file: /cvs/gnome/conglomerate/doc/reference/conglomerate-docs.sgml,v
retrieving revision 1.12
diff -u -r1.12 conglomerate-docs.sgml
--- doc/reference/conglomerate-docs.sgml	27 Oct 2004 14:58:27 -0000	1.12
+++ doc/reference/conglomerate-docs.sgml	5 Nov 2004 21:48:24 -0000
@@ -31,10 +31,6 @@
     <!ENTITY cong-modification-selection-change	SYSTEM "xml/cong-modification-selection-change.xml">
     <!ENTITY cong-modification-set-dtd-ptr	SYSTEM "xml/cong-modification-set-dtd-ptr.xml">
     <!ENTITY cong-editor-widget                           SYSTEM "xml/cong-editor-widget.xml">
-    <!ENTITY cong-editor-line-fragments                           SYSTEM "xml/cong-editor-line-fragments.xml">
-    <!ENTITY cong-editor-child-policy                           SYSTEM "xml/cong-editor-child-policy.xml">
-    <!ENTITY cong-editor-child-policy-flow-holder                           SYSTEM "xml/cong-editor-child-policy-flow-holder.xml">
-    <!ENTITY cong-editor-child-policy-inline                           SYSTEM "xml/cong-editor-child-policy-inline.xml">
     <!ENTITY cong-editor-node                           SYSTEM "xml/cong-editor-node.xml">
     <!ENTITY cong-editor-node-comment                           SYSTEM "xml/cong-editor-node-comment.xml">
     <!ENTITY cong-editor-node-document                           SYSTEM "xml/cong-editor-node-document.xml">
@@ -55,10 +51,6 @@
     <!ENTITY cong-editor-area-entity-decl                           SYSTEM "xml/cong-editor-area-entity-decl.xml">
     <!ENTITY cong-editor-area-entity-ref                           SYSTEM "xml/cong-editor-area-entity-ref.xml">
     <!ENTITY cong-editor-area-expander                           SYSTEM "xml/cong-editor-area-expander.xml">
-    <!ENTITY cong-editor-area-flow-holder-blocks                           SYSTEM "xml/cong-editor-area-flow-holder-blocks.xml">
-    <!ENTITY cong-editor-area-flow-holder-inlines                           SYSTEM "xml/cong-editor-area-flow-holder-inlines.xml">
-    <!ENTITY cong-editor-area-flow-holder-single                           SYSTEM "xml/cong-editor-area-flow-holder-single.xml">
-    <!ENTITY cong-editor-area-flow-holder                           SYSTEM "xml/cong-editor-area-flow-holder.xml">
     <!ENTITY cong-editor-area-labelled                           SYSTEM "xml/cong-editor-area-labelled.xml">
     <!ENTITY cong-editor-area-line                           SYSTEM "xml/cong-editor-area-line.xml">
     <!ENTITY cong-editor-area-pixbuf                           SYSTEM "xml/cong-editor-area-pixbuf.xml">
@@ -124,7 +116,6 @@
     <!ENTITY cong-graph                           SYSTEM "xml/cong-graph.xml">
     <!ENTITY cong-marshal                           SYSTEM "xml/cong-marshal.xml">
     <!ENTITY cong-parser-error                           SYSTEM "xml/cong-parser-error.xml">
-    <!ENTITY fo                           SYSTEM "xml/fo.xml">
     <!ENTITY global                           SYSTEM "xml/global.xml">
     <!ENTITY cong-vfs                           SYSTEM "xml/cong-vfs.xml">
 
@@ -222,14 +213,7 @@
     <para> If you want to see the <classname>CongEditorAreas</classname>, then go to <filename>src/cong-editor-area.c</filename> and play around with the #define settings; in particular <constant>DEBUG_RENDER_ALLOCATIONS</constant> can be used to render rectangles to indicate all of the bounding boxes of the CongEditorAreas.</para>
     </partintro>
     &cong-editor-widget;
-    &cong-editor-line-fragments;
 
-    <chapter>
-      <title>Child Policies</title>
-      &cong-editor-child-policy;
-      &cong-editor-child-policy-flow-holder;
-      &cong-editor-child-policy-inline;
-    </chapter>
 
     <chapter>
       <title>Editor Nodes</title>
@@ -257,10 +241,6 @@
       &cong-editor-area-entity-decl;
       &cong-editor-area-entity-ref;
       &cong-editor-area-expander;
-      &cong-editor-area-flow-holder-blocks;
-      &cong-editor-area-flow-holder-inlines;
-      &cong-editor-area-flow-holder-single;
-      &cong-editor-area-flow-holder;
       &cong-editor-area-labelled;
       &cong-editor-area-line;
       &cong-editor-area-pixbuf;
Index: doc/reference/conglomerate-overrides.txt
===================================================================
RCS file: /cvs/gnome/conglomerate/doc/reference/conglomerate-overrides.txt,v
retrieving revision 1.4
diff -u -r1.4 conglomerate-overrides.txt
--- doc/reference/conglomerate-overrides.txt	25 Jun 2004 00:33:02 -0000	1.4
+++ doc/reference/conglomerate-overrides.txt	5 Nov 2004 21:48:25 -0000
@@ -47,12 +47,6 @@
 <NAME>CongEditorAreaExpander</NAME>
 </STRUCT>
 <STRUCT>
-<NAME>CongEditorAreaFlowHolderBlocks</NAME>
-</STRUCT>
-<STRUCT>
-<NAME>CongEditorAreaFlowHolderInlines</NAME>
-</STRUCT>
-<STRUCT>
 <NAME>CongEditorAreaFlowHolderSingle</NAME>
 </STRUCT>
 <STRUCT>
Index: doc/reference/conglomerate-sections.txt
===================================================================
RCS file: /cvs/gnome/conglomerate/doc/reference/conglomerate-sections.txt,v
retrieving revision 1.6
diff -u -r1.6 conglomerate-sections.txt
--- doc/reference/conglomerate-sections.txt	27 Oct 2004 14:58:27 -0000	1.6
+++ doc/reference/conglomerate-sections.txt	5 Nov 2004 21:48:26 -0000
@@ -497,66 +497,6 @@
 cong_editor_area_expander_get_state
 </SECTION>
 
-<SECTION>
-<FILE>cong-editor-area-flow-holder-blocks</FILE>
-<TITLE>CongEditorAreaFlowHolderBlocks</TITLE>
-CongEditorAreaFlowHolderBlocks
-CONG_EDITOR_AREA_FLOW_HOLDER_BLOCKS
-CONG_EDITOR_AREA_FLOW_HOLDER_BLOCKS_CLASS
-IS_CONG_EDITOR_AREA_FLOW_HOLDER_BLOCKS
-cong_editor_area_flow_holder_blocks_get_type
-cong_editor_area_flow_holder_blocks_construct
-cong_editor_area_flow_holder_blocks_new
-cong_editor_area_flow_holder_get_child_flow_holder_for_node
-cong_editor_area_flow_holder_get_previous_child_flow_holder
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-area-flow-holder-inlines</FILE>
-<TITLE>CongEditorAreaFlowHolderInlines</TITLE>
-CongEditorAreaFlowHolderInlines
-CONG_EDITOR_AREA_FLOW_HOLDER_INLINES
-CONG_EDITOR_AREA_FLOW_HOLDER_INLINES_CLASS
-IS_CONG_EDITOR_AREA_FLOW_HOLDER_INLINES
-cong_editor_area_flow_holder_inlines_get_type
-cong_editor_area_flow_holder_inlines_construct
-cong_editor_area_flow_holder_inlines_new
-cong_editor_area_flow_holder_inlines_get_current_line
-cong_editor_area_flow_holder_inlines_get_line_width
-cong_editor_area_flow_holder_inlines_get_current_indent
-cong_editor_area_flow_holder_inlines_destroy_lines
-cong_editor_area_flow_holder_inlines_insert_line
-cong_editor_area_flow_holder_inlines_reflow_required
-cong_editor_area_flow_holder_inlines_get_first_node
-cong_editor_area_flow_holder_inlines_get_final_node
-cong_editor_area_flow_holder_inlines_contains_editor_node_directly
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-area-flow-holder-single</FILE>
-<TITLE>CongEditorAreaFlowHolderSingle</TITLE>
-CongEditorAreaFlowHolderSingle
-CONG_EDITOR_AREA_FLOW_HOLDER_SINGLE
-CONG_EDITOR_AREA_FLOW_HOLDER_SINGLE_CLASS
-IS_CONG_EDITOR_AREA_FLOW_HOLDER_SINGLE
-cong_editor_area_flow_holder_single_get_type
-cong_editor_area_flow_holder_single_construct
-cong_editor_area_flow_holder_single_new
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-area-flow-holder</FILE>
-<TITLE>CongEditorAreaFlowHolder</TITLE>
-CongEditorAreaFlowHolder
-CONG_EDITOR_AREA_FLOW_HOLDER
-CONG_EDITOR_AREA_FLOW_HOLDER_CLASS
-IS_CONG_EDITOR_AREA_FLOW_HOLDER
-cong_editor_area_flow_holder_get_type
-cong_editor_area_flow_holder_construct
-cong_editor_area_flow_holder_insert_areas_for_node
-cong_editor_area_flow_holder_remove_areas_for_node
-cong_editor_area_flow_holder_manufacture
-</SECTION>
 
 <SECTION>
 <FILE>cong-editor-area-labelled</FILE>
@@ -767,70 +707,12 @@
 </SECTION>
 
 <SECTION>
-<FILE>cong-editor-child-policy-flow-holder</FILE>
-<TITLE>CongEditorChildPolicyFlowHolder</TITLE>
-CongEditorChildPolicyFlowHolder
-CONG_EDITOR_CHILD_POLICY_FLOW_HOLDER
-CONG_EDITOR_CHILD_POLICY_FLOW_HOLDER_CLASS
-IS_CONG_EDITOR_CHILD_POLICY_FLOW_HOLDER
-cong_editor_child_policy_flow_holder_get_type
-cong_editor_child_policy_flow_holder_construct
-cong_editor_child_policy_flow_holder_new
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-child-policy-inline</FILE>
-<TITLE>CongEditorChildPolicyInline</TITLE>
-CongEditorChildPolicyInline
-CONG_EDITOR_CHILD_POLICY_INLINE
-CONG_EDITOR_CHILD_POLICY_INLINE_CLASS
-IS_CONG_EDITOR_CHILD_POLICY_INLINE
-cong_editor_child_policy_inline_get_type
-cong_editor_child_policy_inline_construct
-cong_editor_child_policy_inline_new
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-child-policy</FILE>
-DEBUG_EDITOR_CHILD_POLICY_LIFETIMES
-<TITLE>CongEditorChildPolicy</TITLE>
-CongEditorChildPolicy
-CONG_EDITOR_CHILD_POLICY
-CONG_EDITOR_CHILD_POLICY_CLASS
-IS_CONG_EDITOR_CHILD_POLICY
-cong_editor_child_policy_get_type
-cong_editor_child_policy_construct
-cong_editor_child_policy_get_node
-cong_editor_child_policy_get_widget
-cong_editor_child_policy_insert_areas_for_node
-cong_editor_child_policy_remove_areas_for_node
-</SECTION>
-
-<SECTION>
-<FILE>cong-editor-line-fragments</FILE>
-DEBUG_EDITOR_LINE_FRAGMENTS_LIFETIMES
-<TITLE>CongEditorLineFragments</TITLE>
-CongEditorLineFragments
-CONG_EDITOR_LINE_FRAGMENTS
-CONG_EDITOR_LINE_FRAGMENTS_CLASS
-IS_CONG_EDITOR_LINE_FRAGMENTS
-cong_editor_line_fragments_get_type
-cong_editor_line_fragments_construct
-cong_editor_line_fragments_new
-cong_editor_line_fragments_get_area_list
-cong_editor_line_fragments_add_area
-</SECTION>
-
-<SECTION>
 <FILE>cong-editor-node-comment</FILE>
 <TITLE>CongEditorNodeComment</TITLE>
 CongEditorNodeComment
 CONG_EDITOR_NODE_COMMENT
 CONG_EDITOR_NODE_COMMENT_CLASS
 IS_CONG_EDITOR_NODE_COMMENT
-cong_editor_node_comment_get_type
-cong_editor_node_comment_construct
-cong_editor_node_comment_new
 </SECTION>
 
 <SECTION>
@@ -840,9 +722,6 @@
 CONG_EDITOR_NODE_DOCUMENT
 CONG_EDITOR_NODE_DOCUMENT_CLASS
 IS_CONG_EDITOR_NODE_DOCUMENT
-cong_editor_node_document_get_type
-cong_editor_node_document_construct
-cong_editor_node_document_new
 </SECTION>
 
 <SECTION>
@@ -852,9 +731,6 @@
 CONG_EDITOR_NODE_DTD
 CONG_EDITOR_NODE_DTD_CLASS
 IS_CONG_EDITOR_NODE_DTD
-cong_editor_node_dtd_get_type
-cong_editor_node_dtd_construct
-cong_editor_node_dtd_new
 </SECTION>
 
 <SECTION>
@@ -864,9 +740,6 @@
 CONG_EDITOR_NODE_ELEMENT_SPAN
 CONG_EDITOR_NODE_ELEMENT_SPAN_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_SPAN
-cong_editor_node_element_span_get_type
-cong_editor_node_element_span_construct
-cong_editor_node_element_span_new
 </SECTION>
 
 <SECTION>
@@ -876,9 +749,6 @@
 CONG_EDITOR_NODE_ELEMENT_STRUCTURAL
 CONG_EDITOR_NODE_ELEMENT_STRUCTURAL_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_STRUCTURAL
-cong_editor_node_element_structural_get_type
-cong_editor_node_element_structural_construct
-cong_editor_node_element_structural_new
 </SECTION>
 
 <SECTION>
@@ -888,9 +758,6 @@
 CONG_EDITOR_NODE_ELEMENT_UNKNOWN
 CONG_EDITOR_NODE_ELEMENT_UNKNOWN_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_UNKNOWN
-cong_editor_node_element_unknown_get_type
-cong_editor_node_element_unknown_construct
-cong_editor_node_element_unknown_new
 </SECTION>
 
 <SECTION>
@@ -900,9 +767,6 @@
 CONG_EDITOR_NODE_ELEMENT
 CONG_EDITOR_NODE_ELEMENT_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT
-cong_editor_node_element_get_type
-cong_editor_node_element_construct
-cong_editor_node_element_get_dispspec_element
 </SECTION>
 
 <SECTION>
@@ -912,9 +776,6 @@
 CONG_EDITOR_NODE_ENTITY_DECL
 CONG_EDITOR_NODE_ENTITY_DECL_CLASS
 IS_CONG_EDITOR_NODE_ENTITY_DECL
-cong_editor_node_entity_decl_get_type
-cong_editor_node_entity_decl_construct
-cong_editor_node_entity_decl_new
 </SECTION>
 
 <SECTION>
@@ -924,9 +785,6 @@
 CONG_EDITOR_NODE_ENTITY_REF
 CONG_EDITOR_NODE_ENTITY_REF_CLASS
 IS_CONG_EDITOR_NODE_ENTITY_REF
-cong_editor_node_entity_ref_get_type
-cong_editor_node_entity_ref_construct
-cong_editor_node_entity_ref_new
 </SECTION>
 
 <SECTION>
@@ -936,9 +794,6 @@
 CONG_EDITOR_NODE_TEXT
 CONG_EDITOR_NODE_TEXT_CLASS
 IS_CONG_EDITOR_NODE_TEXT
-cong_editor_node_text_get_type
-cong_editor_node_text_construct
-cong_editor_node_text_new
 cong_editor_node_text_convert_original_byte_offset_to_stripped
 cong_editor_node_text_calc_up
 cong_editor_node_text_calc_down
@@ -951,9 +806,6 @@
 CONG_EDITOR_NODE_UNIMPLEMENTED
 CONG_EDITOR_NODE_UNIMPLEMENTED_CLASS
 IS_CONG_EDITOR_NODE_UNIMPLEMENTED
-cong_editor_node_unimplemented_get_type
-cong_editor_node_unimplemented_construct
-cong_editor_node_unimplemented_new
 </SECTION>
 
 <SECTION>
@@ -1988,9 +1840,6 @@
 CONG_EDITOR_NODE_ELEMENT_ADMONITION
 CONG_EDITOR_NODE_ELEMENT_ADMONITION_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_ADMONITION
-cong_editor_node_element_admonition_get_type
-cong_editor_node_element_admonition_construct
-cong_editor_node_element_admonition_new
 </SECTION>
 
 <SECTION>
@@ -2013,9 +1862,6 @@
 CONG_EDITOR_NODE_ELEMENT_LISTITEM
 CONG_EDITOR_NODE_ELEMENT_LISTITEM_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_LISTITEM
-cong_editor_node_element_listitem_get_type
-cong_editor_node_element_listitem_construct
-cong_editor_node_element_listitem_new
 cong_editor_node_element_listitem_get_label
 </SECTION>
 
@@ -2038,9 +1884,6 @@
 CONG_EDITOR_NODE_ELEMENT_PARAGRAPH
 CONG_EDITOR_NODE_ELEMENT_PARAGRAPH_CLASS
 IS_CONG_EDITOR_NODE_ELEMENT_PARAGRAPH
-cong_editor_node_element_paragraph_get_type
-cong_editor_node_element_paragraph_construct
-cong_editor_node_element_paragraph_new
 </SECTION>
 
 <SECTION>
Index: doc/reference/conglomerate.types
===================================================================
RCS file: /cvs/gnome/conglomerate/doc/reference/conglomerate.types,v
retrieving revision 1.10
diff -u -r1.10 conglomerate.types
--- doc/reference/conglomerate.types	16 Oct 2004 00:48:51 -0000	1.10
+++ doc/reference/conglomerate.types	5 Nov 2004 21:48:26 -0000
@@ -22,10 +22,6 @@
 #include "cong-editor-area-entity-decl.h"
 #include "cong-editor-area-entity-ref.h"
 #include "cong-editor-area-expander.h"
-#include "cong-editor-area-flow-holder-blocks.h"
-#include "cong-editor-area-flow-holder-inlines.h"
-#include "cong-editor-area-flow-holder-single.h"
-#include "cong-editor-area-flow-holder.h"
 #include "cong-editor-area-labelled.h"
 #include "cong-editor-area-line.h"
 #include "cong-editor-area-pixbuf.h"
@@ -39,10 +35,6 @@
 #include "cong-editor-area-underline.h"
 #include "cong-editor-area-unknown-tag.h"
 #include "cong-editor-area.h"
-#include "cong-editor-child-policy-flow-holder.h"
-#include "cong-editor-child-policy-inline.h"
-#include "cong-editor-child-policy.h"
-#include "cong-editor-line-fragments.h"
 #include "cong-editor-node-comment.h"
 #include "cong-editor-node-document.h"
 #include "cong-editor-node-dtd.h"
@@ -114,10 +106,6 @@
 cong_editor_area_entity_decl_get_type
 cong_editor_area_entity_ref_get_type
 cong_editor_area_expander_get_type
-cong_editor_area_flow_holder_blocks_get_type
-cong_editor_area_flow_holder_inlines_get_type
-cong_editor_area_flow_holder_single_get_type
-cong_editor_area_flow_holder_get_type
 cong_editor_area_labelled_get_type
 cong_editor_area_line_get_type
 cong_editor_area_pixbuf_get_type
@@ -131,22 +119,6 @@
 cong_editor_area_underline_get_type
 cong_editor_area_unknown_tag_get_type
 cong_editor_area_get_type
-cong_editor_child_policy_flow_holder_get_type
-cong_editor_child_policy_inline_get_type
-cong_editor_child_policy_get_type
-cong_editor_line_fragments_get_type
-cong_editor_node_comment_get_type
-cong_editor_node_document_get_type
-cong_editor_node_dtd_get_type
-cong_editor_node_element_admonition_get_type
-cong_editor_node_element_span_get_type
-cong_editor_node_element_structural_get_type
-cong_editor_node_element_unknown_get_type
-cong_editor_node_element_get_type
-cong_editor_node_entity_decl_get_type
-cong_editor_node_entity_ref_get_type
-cong_editor_node_text_get_type
-cong_editor_node_unimplemented_get_type
 cong_editor_node_get_type
 cong_editor_widget3_get_type
 cong_modification_cursor_change_get_type
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.