Title: Little more than javadoc
Product review: This book focuses on commenting code in a structured language which can be parsed into documentation, an idea which has gained great popularity with the distribution of JavaDoc for java comments. There are various essays concerning structured programming and a detailed description of CWeb, an early JavaDoc-like system. I bought this book hoping for a guide to writing readable structured code and formalizing comment semantics, but those problems are not addressed in this text.
Would you say this review depicts the product in a flattering or unflattering light?
