As características de um sistema para permitir a um computador dar apoio à documentação de sistemas são apresentadas. Verificam-se quais são as características principais que um tal sistema deve ter; em termos de quais as operações que ele deve tornar disponíveis. Para que isso seja possível, três subsiste mas são considerados: Um para definir a linguagem que deve ser usada na descrição; outro para manipular a descrição propriamente dita; e o terceiro para tarefas auxiliares às operações com a armazenagem da descrição. Qualquer linguagem relacional pode ser definida especificando-se os tipos de objetos e os tipos de relação que caracterizam o tipo de sistema em consideração. Após a definição de uma linguagem, qualquer sistema, do tipo considerado pode ser documentado. A descrição pode ser feita em etapas sendo que novas informações vão sendo incorporadas a uma base de dados. Em qualquer estágio da descrição, podem ser solicitados testes de consistência e completeza, e relatórios sobre qualquer aspecto do sistema jã descrito. Apresenta- se uma implementação de um sistema de apoio por computador à documentação de sistemas com essas características, composta de cerca de 200 rotinas, escritas em FORTRAN IV para um computador PDP 11/45 operando sob o Sistema Operacional RSX- 11M. Essa implementação teve como um dos objetivos principais a facilidade de ser levada para outros computadores, com o minimo de adaptações. Além disso ela não limita a dimensão que uma descrição pode ter, sendo essa limitação fixada pelo computador onde estiver operando. No computador PDP 11/45 até um máximo de 32766 objetos e o mesmo número de relações podem ser especificados em cada descrição. São apresentados 2 exemplos de aplicação do sistema implementado: um utilizando uma linguagem definida para descrição de orquestras, e outro utilizando uma linguagem definida para descrição de Sistemas de Informação, baseada na metodologia HIPO da IBM. Inclui-se 71 referências bibliográficas, sendo que 13 são trabalhos anteriores do próprio autor, que vem trabalhando nessa área desde 1974.

The requirements for a system to beused for documenting any type of system are presented. To avoid confusion, the system to be documented is herein called target system. In the requirements, three subsystems are considered: one for the definition of the language to be used in the description; another for manipulating the description itself and the third to be usedasan utilitarian. subsystem. Any relational description language can be defined. For such definition, the types of objects and typesof relations that form the language have to be specified. After the definition of a language, any target system describablie in it can be documented. The description ofa system can be fed incrementally in a computer data-base. Once described, a variety of reports can be obtained. Completeness and consistency in the description can be carried by the computer. An implementation of such àa system is presented. The corresponding software is composed of about 200 rotines, written in FORTRAN IV for a PDP 11/45 under RSX-11M Operating System. The System implementations has been conceived aiming portability so that the effort to install it in other computers should Wbe minimun. Limitations on the PDP implementatior are a maximun of 32766 objects and the same number of relations, for each target systems description. Two application of the implemented system are presented. One regarding a language for describing an orchestra,considered as a system composed of types os objects like musician, instrument, part, etc. and types of relations like plays, conducts, etc. Another regarding a language for describing Information Systems based on IBM HIPO. Seventy-one bibliographical references are included on basic and related works. Of these, 13 are of the author previous work, which has been going since 1974.