Ph.D. Dissertation

241Appendix BSemantic PropertiesTable B.1: Meta-Information PropertiesProperty Context Purpose/Descriptionauthor Fullname [email] Modules Lists an author of the module. The text has no special internal structure.A doc comment may contain multiple author properties. A standardauthor property includes only the full name of the author andshould not include other information (like an email address, web page,etc.) unless necessary.bon Textbug TextModules,FeaturesModules,Featurescopyright Text Files A copyright notice.description Text Files A brief description of a file.Provides a one-sentence summary of the construct. This sentence ismeant to correlate with the BON specification of the construct.Describes a known bug in the module or feature. One property shouldbe used for each bug. If a construct has a known bug, it should be described.Omission of a bug description is considered as bad an offenseas the existence of the bug in the first place.history Text All Describes how a feature has been modified over time. For each majorchange, the description should include: who made it, when it was made(date and version), what was done, why it was done, and a referenceto the change request and/or user requirement that resulted in thechange being made.license Text Files A license notice.title Text Files Documents the title of the project with which the file is associated.