Tool support for executable documentation of Java class hierarchies

While object-oriented programming offers great solutions for today's software developers, this success has created difficult problems in class documentation and testing. In Java, two tools provide assistance: Javadoc allows class interface documentation to be embedded as code comments and JUnit supports unit testing by providing assert constructs and a test framework. This paper describes JUnitDoc, an integration of Javadoc and JUnit, which provides better support for class documentation and testing. With JUnitDoc, test cases are embedded in Javadoc comments and used as both examples for documentation and test cases for quality assurance. JUnitDoc extracts the test cases for use in HTML files serving as class documentation and in JUnit drivers for class testing. To address the difficult problem of testing inheritance hierarchies, JUnitDoc provides a novel solution in the form of a parallel test hierarchy. A small controlled experiment compares the readability of JUnitDoc documentation to formal documentation written in Object-Z. Copyright (c) 2005 John Wiley & Sons, Ltd.

Dominance hierarchies and health: Constructing personal zones of spiritual power and healing in modern medicine

Ethological studies of animals in groups and sociobiology indicate that hierarchies of dominance amongst some species ensure the survival of the group. When transferred to human groups, dominance hierarchies suggest a crucial role played by recasting the scope of such hierarchies of dominant and subordinate members to included hyper-dominant beings. A recognition of such beings as even more dominant than the socially dominant members of a hierarchy facilitates the empowerment of the socially subordinate members. Religious belief and practice works to establish such hyper-dominant beings (gods, goddesses, and so forth) as superior members of human groups. Doing so is a means of ensuring the survival of the species and, thus, enhancing healing and human health. The doctor-patient relationship is examined from such a point of view, with an emphasis on whether the hierarchy created by the relationship allows consideration of alternative and complementary forms of medical treatment.