%0 Journal Article %1 Arab1992a %A Arab, Mouloud %D 1992 %J SIGPLAN Not. %K programming program_comprehension style documentation typographic %N 2 %P 37--46 %R http://doi.acm.org/10.1145/130973.130975 %T Enhancing program comprehension: formatting and documenting %V 27 %X In order to make computer programs more readable, presentation and documentation of program source texts need to be enhanced. In this paper, we propose a presentation scheme which highlights the structure of the program and we present some aspects concerning the internal documentation (comments) which enhance the program comprehension. This presentation facilitates error correction and makes the program more readable for other programmers. We propose an automatic formatting and documenting tool which takes into account human factors in man/machine interaction aspect. It provides satisfactory results, programmers produce structured programs which help them in detecting bad constructs and in achieving homogeneity of their programs' presentation and internal documentation.

@article{Arab1992a, abstract = {In order to make computer programs more readable, presentation and documentation of program source texts need to be enhanced. In this paper, we propose a presentation scheme which highlights the structure of the program and we present some aspects concerning the internal documentation (comments) which enhance the program comprehension. This presentation facilitates error correction and makes the program more readable for other programmers. We propose an automatic formatting and documenting tool which takes into account human factors in man/machine interaction aspect. It provides satisfactory results, programmers produce structured programs which help them in detecting bad constructs and in achieving homogeneity of their programs' presentation and internal documentation.}, added-at = {2009-05-22T15:45:38.000+0200}, author = {Arab, Mouloud}, biburl = {https://www.bibsonomy.org/bibtex/2a759a5e1e46557ee26dad64ca37f88e0/sjbutler}, doi = {http://doi.acm.org/10.1145/130973.130975}, interhash = {f88d81cf74553e9e335d3033202481aa}, intrahash = {a759a5e1e46557ee26dad64ca37f88e0}, issn = {0362-1340}, journal = {SIGPLAN Not.}, keywords = {programming program_comprehension style documentation typographic}, number = 2, pages = {37--46}, timestamp = {2009-05-22T15:45:38.000+0200}, title = {Enhancing program comprehension: formatting and documenting}, volume = 27, year = 1992 }