Re: [Doxygen-users] Making an Easy and fast readable C Library Manual reference.(TODO-Suggestions)

[Carlo W. <ca...@al...>]

On Tue, Nov 20, 2001 at 08:06:24AM -0000, Stephen Goudge wrote:
> So in your example, all of the headers would be moved down into the m/
> directory, except for the four you've identified as "documented ones".

I tried the equivalent of just putting those four in the INPUT field.
But that doesn't work: all those header files DO contain documentation,
they just shouldn't be included by the user directly.  I don't want
them listed.

If I do what you suggest I get this:

~/c++/libcw_branch-threading/src/libcwd/documentation>make
doxygen doxygen.config
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:293 Warning: member `init' of class `debug_channels_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:333 Warning: member `init' of class `debug_objects_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:383 Warning: member `ST_uninit' of class `debug_objects_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:451 Warning: member `calculate_capacity' of class `debug_string_ct' cannot be found/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:464 Warning: member `NS_internal_init' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:473 Warning: member `ST_internal_deinit' of class `debug_string_ct' cannot be found/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:478 Warning: member `internal_assign' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:487 Warning: member `internal_append' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:496 Warning: member `internal_prepend' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:504 Warning: member `reserve' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:515 Warning: member `internal_swallow' of class `debug_string_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:525 Warning: member `push_margin' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:536 Warning: member `pop_margin' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:549 Warning: member `push_marker' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:559 Warning: member `pop_marker' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:572 Warning: no matching class member found for void start(LIBCWD_TSD_PARAM)
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:711 Warning: member `finish' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:832 Warning: member `fatal_finish' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:838 Warning: member `NS_init' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:942 Warning: member `~debug_ct' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1044 Warning: member `NS_initialize' of class `channel_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1122 Warning: member `NS_initialize' of class `fatal_channel_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1158 Warning: member `NS_initialize' of class `continued_channel_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1164 Warning: member `off' of class `channel_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1174 Warning: member `on' of class `channel_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1194 Warning: member `operator|' of class `channel_set_st' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1220 Warning: member `operator|' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1254 Warning: member `operator|' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debug.cc:1260 Warning: member `operator &' of class `debug_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debugmalloc.cc:1675 Warning: member `register_marker' of class `marker_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/debugmalloc.cc:1699 Warning: member `~marker_ct' of class `marker_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/bfd.cc:1149 Warning: member `M_pc_location' of class `location_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/bfd.cc:1312 Warning: member `clear' of class `location_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/bfd.cc:1325 Warning: member `location_ct' of class `location_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/bfd.cc:1340 Warning: member `move' of class `location_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/bfd.cc:1354 Warning: member `operator=' of class `location_ct' cannot be found
/home/carlo/c++/libcw_branch-threading/src/libcwd/include/libcw/debug.h:163 Warning: reference to unknown section control_flags in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/include/libcw/debug.h:189 Warning: reference to unknown section control_flags in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/deallocation_pointer_validation.dox:3 Warning: link to unknown entity `enable_libcwd_magic' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/deallocation_pointer_validation.dox:3 Warning: reference to unknown section invisible in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `enable_libcwd_libbfd' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `enable_libcwd_location' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `BFD' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `enable_libcwd_location' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `Debug_Channel_objects' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `Allocated_memory_Overview' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/location.dox:3 Warning: link to unknown entity `libcw::debug::alloc_ct::location' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/preparation.dox:3 Warning: reference to unknown section configuration in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section libcw::debug::debug_ct in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section libcw::debug::channel_ct in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section debug_ct_formatting in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section control_flags in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section ForAllDebugObjects in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: reference to unknown section ForAllDebugChannels in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: link to unknown entity `libcw::debug::check_configuration' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/documentation/reference.dox:1 Warning: link to unknown entity `libcw::debug::make_all_allocations_invisible_except' in the documentation of this entity!
/home/carlo/c++/libcw_branch-threading/src/libcwd/demangle3.cc:15 Warning: reference to unknown section type_info_of in the documentation of this entity!

In other words, the header ARE input files.

-- 
Carlo Wood <ca...@al...>