[Bug 1549] It must be easier to write tests

bugzilla-daemon at rtems.org bugzilla-daemon at rtems.org
Fri Jun 11 08:10:36 UTC 2010


https://www.rtems.org/bugzilla/show_bug.cgi?id=1549





--- Comment #5 from Ralf Corsepius <ralf.corsepius at rtems.org>  2010-06-11 03:10:32 ---
Sebastian, vertainly, there is much of room for improvment, but this PR to me
is close to qualify as "clueless" ranting.

I am considering this PR to be not helpful, I am seriously considering to close
it as "Invalid" and/or "SPAM".

Some comments:

> Grouping by directory or file name prefix is not that different.
Wrong, it is substantially different.


> AM_CPPFLAGS += -I$(top_srcdir)/../support/include
>
> # This is a hack.  It makes it hard (impossible?) to add multiple programs to
> # one Makefile.am. 
Wrong, you don't seem to understand.

Correct, it is impossible to add multiple programs to one Makefile.am, but the
cause is not AM_CPPFLAGS, the cause is make-exe in "*.cfg" and the MANAGERS.

> Yes, we have the texinfo files.  Compare the update frequency of the source
> code path with the documentation tree.  It is a constant burden to keep this
> synchronized.  Only few people touch the texinfo files at all.  We should move
> to source code embedded documentation (e.g. Doxygen) entirely.  You can write
> book style documentation with Doxygen easily.  See
Apples and oranges:
* RTEMS doc/ and the doxygen comments serve different purposes.
* texinfo is just _one_ output format of documentation.

That said, I agree insofar, as that source-code documentation should be removed
from doc/ and be replaced with doxygen generated documentation in *info* 
format (!)

Finally: IMO, the current doxygen stuff (esp. the online incarnation) is simply
plain broken and invalid.

-- 
Configure bugmail: https://www.rtems.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching all bug changes.



More information about the bugs mailing list