Enhancing Code for Readability and Comprehension Using SGML, D.D. Cowan and D.M. Germ\'an and C.J.P. Lucena and A. von Staa
@InProceedings{ cowan.german.ea:enhancing,
key = {Cowan et. al, 1994},
author = {D.D. Cowan and D.M. Germ\'an and C.J.P. Lucena and A. von
Staa},
title = {Enhancing Code for Readability and Comprehension Using
SGML},
pages = {181-190},
booktitle = {Proceedings of the International Conference on Software
Maintenance ~1994},
year = {1994},
publisher = {IEEE Computer Society Press},
month = sep,
abstract = {Reading and understanding programs is a key activity in
software reengineering, development, and maintenance. The
ability of people to understand programs is directly
related to the ease with which the source code and
documentation can be read. Thus, enhancements to the style
of presentation should heighten this comprehensibility. The
authors describe methods that use markup laguages such as
SGML to embed information about the syntax and semantics of
a program in the program code, and then show how these can
be used to enhance its presentation style. The authors also
briefly discuss the extension of these markup language
concepts to text databases, and indicate how they can
support various structural views of the code through
browsing techniques associcated with database queries.},
class = {Software_Reverse_Engineering, Reverse_Design,
Fundamental_Methods_in_Reverse_Design,
Reformatting_and_Markup_Languages}
}
The book paradigm for improved maintenance, P.W. Oman and C.R. Cook
@Article{ oman.cook:book,
title = {The book paradigm for improved maintenance},
author = {P.W. Oman and C.R. Cook},
journal = {{IEEE} Software},
volume = {7},
number = {1},
pages = {39--45},
year = {1990},
note = { It is shown that traditional typographical formats used
in books work very well to aid program understanding},
class = {Software_Reverse_Engineering, Reverse_Design,
Fundamental_Methods_in_Reverse_Design,
Reformatting_and_Markup_Languages}
}