Softwaredokumentation wie doxygen

[Robert]

Hallo,

gibt es eigentlich ein brauchbares Tool um automatische eine Softwaredokumentation zu erstellen?
Z.B. sowas wie doxygen, wo man spezielle Kommentare/Tags anbringen muss und am Ende eine Dokumentation raus kommt:
- welche Klassen gibt es
- welche Methoden/Attribute in einer Klasse
- Übersicht über Klassenvererbung
- welche Funktionen gibt es
- was (Klassen/Funktionen) ist in welcher datei

Es ist sicher aufwendig, alle Features (dank Makros bzw. allgemein dem dynmaischen Charakter von Xbase) abzubilden,
aber vielleicht gibt es ja doch was?

In der Newsgroup gibts von Philip Jackson "CodeMapper", was aber bei mir nicht läuft (fehlende XPPSYS.dll??)
aber das soll auch primär nur mit Funktionen gute Dienste leisten.

Ich hab ja gehofft, als ich von der eingebauten Dokumentation in Visual Xbase:
/// <summary>
/// <para>
/// </para>
///</summary>
gelesen hab, dass damit rudimentäre Ansätze zum Generieren bereits möglich sind, aber das ist wohl (noch) nicht der Fall...

[Jan]

Hallo Robert,

die eingebaute Doku in VX funktioniert. Ich benutze die ausgiebig. Ist halt nur ein dickes Stück Arbeit, das erstmal einzubauen. Automatisch geht da garnichts.

Jan

[Manfred]

Hi,

das dienst nur dem Zweck wenn eigene Funktionen aufgerufen werden, dass eine Erklärung erscheint. Das klappt aber nicht richtig. Sobald bestimmte Schlüsselworte vorher im Quelltext stehen, wird nur noch die Parameterliste angezeigt. Ist aber glaube ich auch erst seit 2006 oder so bekannt.

[AUGE_OHR]

In der Newsgroup gibts von Philip Jackson "CodeMapper", was aber bei mir nicht läuft (fehlende XPPSYS.dll??)

Danke für den Tip aber ohne Link ...
die XppSys.DLL gibt es erst seit der v1.9x ... hast du noch die v1.8x ?

[Robert]

In der Newsgroup gibts von Philip Jackson "CodeMapper", was aber bei mir nicht läuft (fehlende XPPSYS.dll??)

Danke für den Tip aber ohne Link ...
die XppSys.DLL gibt es erst seit der v1.9x ... hast du noch die v1.8x ?

Ich hab die v1.9x aber weder im lib noch im runtime Verzeichnis gibts die XPPSys.dll


Dokumentation:

Newsgroup: 3pp
Betreff: CodeMapper for xBase Languages - looking for early adopters
Datum 29.09.2011

Newsgroup: Xbabse.generic
Programm:
Betreff: How to generate automatically a Flow Chart from source Code
Datum: 13.09.2011 23:33 (Dort sind die zip-Dateien)

[AUGE_OHR]

Ich hab die v1.9x aber weder im lib noch im runtime Verzeichnis gibts die XPPSys.dll

sorry ich meine die v1.9.355 SL1
wenn du nur die v1.9.331 hast dann gibt es die XppSys.DLL nicht !

bei der v1.9.355 SL1 siehe mal in das Verzeichniss x:\ALASKA\XPPW32\Source\dll\.
Dort müsste ein README.TXT und eine PROJECT.XPJ sein.

Dokumentation:
Newsgroup: 3pp
Betreff: CodeMapper for xBase Languages - looking for early adopters
Datum 29.09.2011

Newsgroup: Xbabse.generic
Programm:
Betreff: How to generate automatically a Flow Chart from source Code
Datum: 13.09.2011 23:33 (Dort sind die zip-Dateien)

ok danke.
ich habe ja in den (englischen) Threads schon geantwortet.
ähnlich wie das "CodeMapper" EXE verwende ich "alten" Cl*pper Code der "aufgebohrt" wurde für Xbase++.
man kann damit nun auch "dokumentieren" ... aber eben nur so viel wie man "ihm" beigebracht hat.

ich gehe mal davon aus das wir über "Source Code Dokumentation" sprechen der es z.b. einem Nachfolger ermöglicht sich in den Source einzuarbeiten.
als Programmierer interessieren mich zunächst die Procedure / Function, was die machen, und deren Parameter.

Tools wie CodeMapper, CLICK!, SNAP, DFlow usw. können da nur begrenzt "mitdenken" was der Programmierer sich mit den Parametern (a,b,c) gedacht hat.
diese Information gehört in den Header wo auch ein Nachfolger die sofort findet.

einige Editoren können Kommentare "direkt" im Source einfügen und die später für Dokumentation verwenden.