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.

Comparative cost-effectiveness of policy instruments for reducing the global burden of alcohol, tobacco and illicit drug use

Alcohol, tobacco and illicit drug use together pose a formidable challenge to international public health. Building on earlier estimates of the demonstrated burden of alcohol, tobacco and illicit drug use at the global level, this review aims to consider the comparative cost-effectiveness of evidence-based interventions for reducing the global burden of disease from these three risk factors. Although the number of published cost-effectiveness studies in the addictions field is now extensive ( reviewed briefly here) there are a series of practical problems in using them for sector-wide decision making, including methodological heterogeneity, differences in analytical reference point and the specificity of findings to a particular context. In response to these limitations, a more generalised form of cost-effectiveness analysis (CEA) is proposed, which enables like-with-like comparisons of the relative efficiency of preventive or individual-based strategies to be made, not only within but also across diseases or their risk factors. The application of generalised CEA to a range of personal and non-personal interventions for reducing the burden of addictive substances is described. While such a development avoids many of the obstacles that have plagued earlier attempts and in so doing opens up new opportunities to address important policy questions, there remain a number of caveats to population-level analysis of this kind, particularly when conducted at the global level. These issues are the subject of the final section of this review.

On the absolute calibration of bench-top small-angle X-ray scattering instruments: a comparison of different standard methods

Absolute calibration relates the measured (arbitrary) intensity to the differential scattering cross section of the sample, which contains all of the quantitative information specific to the material. The importance of absolute calibration in small-angle scattering experiments has long been recognized. This work details the absolute calibration procedure of a small-angle X-ray scattering instrument from Bruker AXS. The absolute calibration presented here was achieved by using a number of different types of primary and secondary standards. The samples were: a glassy carbon specimen, which had been independently calibrated from neutron radiation; a range of pure liquids, which can be used as primary standards as their differential scattering cross section is directly related to their isothermal compressibility; and a suspension of monodisperse silica particles for which the differential scattering cross section is obtained from Porod's law. Good agreement was obtained between the different standard samples, provided that care was taken to obtain significant signal averaging and all sources of background scattering were accounted for. The specimen best suited for routine calibration was the glassy carbon sample, due to its relatively intense scattering and stability over time; however, initial calibration from a primary source is necessary. Pure liquids can be used as primary calibration standards, but the measurements take significantly longer and are, therefore, less suited for frequent use.