Title :
Source code documentation simul loco
Author :
Rojas, Sergio Gálvez ; Mora, José Manuel Carrasco
Author_Institution :
Dept. Lenguajes y Cienc. de la Comput., Univ. de Malaga, Málaga, Spain
Abstract :
Comments in source code are one of the aspects of programming languages and tools with a minor evolution along computer´s history. In this paper we propose a new kind of comments which breaks the text based limit of comments allowed by current programming languages. Simul loco comments allow creating a graphical comment layer over the source code that can contain any resource to provide a suitable documentation. We tested this brand new concept in REM, an Eclipse´s plugin that allows associating a graphical comment file with any Java or C file. REM shows the abilities of simul loco documentation and the huge amount of possibilities that this approach offers, particularly in agile software development.
Keywords :
C language; Java; document handling; program compilers; software prototyping; source coding; C file; Java; agile software development; current programming languages; graphical comment file; graphical comment layer; programming languages; programming tools; source code documentation simul loco; text based limit; Documentation; Graphics; Java; Programming; Software; Synchronization; development methodologies; graphical IDE; programming languages; project documentation;
Conference_Titel :
Information Systems and Technologies (CISTI), 2012 7th Iberian Conference on
Conference_Location :
Madrid
Print_ISBN :
978-1-4673-2843-2