프로그램(원시 코드)의 이해를 높이고 유지보수를 효과적으로 수행하기 위하여 원시 코드에 주석을 삽입하는 방법이 전통적으로 사용되고 있다. C 언어가 주로 사용되는 mission critical 응용 소프트웨어 영역에는 문서화, 간결성, 정확성을 갖는 원시 코드가 요구된다. 코드의 문서화를 위하여 주석의 사용이 권고되지만 명확한 지침과 지원도구가 미비하다. 문서의 내용을 구조와 표현으로 분리하여 취급하는 XML 기술은 원시 코드의 문서화에 새로운 기회를 제공하고 있다. 본 연구는 XML 기술을 활용한 원시 코드의 주석관리 체계를 개발하고 있다. 본 연구의 주석 관리체제는 주석 사용자 모듈, 검토자 모듈, 주석 추출 모듈, 주석 추적 연계 모듈, 주석 태그 정의 모듈, 저장관리 모듈로 구성되어 있다.
To enhance understanding and to perform effectively maintenance for a program, the method inserting comments into source code has been used conventionally. Well documented, simplified and clarified source code should be required for the mission critical application software area in which C programing language is generally used. The use of comments for a source code documentation is recommended, however there are no dear guidelines and supporting tools. na technologies, which separate and manage the content of a document as structure and presentation give us the new motivation for a source code documentation. We have developed the comments management system for source code by applying XML technologies. This system is composed of the following modules : user module for inserting comments, reviewer module for inspecting the inserted comments, comment extraction module, tacking and linking module, tags definition module and storage management module.
