VB Classic VB.NET ADO.NET VBA C# |
 |
|
HOME WORKSHOPS TIPPS & TRICKS BEFEHLSREFERENZ API-REFERENZ FAQ FORUM DOWNLOAD
 Gesamtübersicht[258 User online]  |
  Doctor Source - Dokumentationstool für VB-Projekte"Erzeugen Sie Dokumentationen zu Ihren VB-Projekten per Knopfdruck". So lautet der Werbeslogan auf der Internetseite von Daniel Springwald, Autor dieses Tools. Doctor Source erstellt jederzeit auf Knopfdruck eine HTML-Dokumentation / HTML-Help mit der vollständigen Struktur Ihres Projekts, einschließlich der gesamten Funktions- und Prozedur-Deklarationen. Wir haben "Doctor Source" unter die Lupe genommen und waren gespannt, ob das Tool die Ansprüche erfüllt und tatsächlich so einfach zu bedienenen ist.15.09.03Ein Bericht von Gerhard Kuklau Version 2.3 Vertrieb: über das Internet (www.doctorsource.de) Die Software kann unter vorgenannter Adresse heruntergeladen und 60 Tage lang kostenlos getestet werden. Installation
Dokumentation Erster Kontakt mit Doctor Source
In der Tat ist es sehr einfach mit den 11 zur Verfügung stehenden Tags die Vorbereitung für die automatische Dokumentation zu bewerkstelligen. Hier würde ich mir allerdings wünschen, wenn es in einer folgenden Version möglich wäre, selbst Tags anzulegen, z.B. ein Picture-Tag, um Grafiken / Hardcopies in der Doku aufnehmen zu können (Hardcopy der verwendeten Forms). Die Oberfläche ist etwas gewöhnungsbedürftig. Es ist schade, dass die Möglichkeiten des Tooltipps nicht genutzt werden, um die einzelnen Spalten und deren Funktionen im Grid (Aufgabenspalten) zu erläutern. Dies wird zwar durch eine Legende unterhalb des Aufgaben-Grids erledigt, aber der Umgang damit ist doch sehr gewöhnungsbedürftig.
Dokumentationstypen
Die Erstellung der HTML-Hilfe-Datei, die mich persönlich am meisten interessierte, gestaltet sich da schon etwas schwieriger. Nach der ersten Erstellung habe ich vergeblich die HTML-Hilfe (*.chm) gesucht. Die Hilfe-Datei von Doctor Source hat hier leider auch keinerlei Auskunft gegeben. Lediglich in den Aufgabenspalten des Grids gibt es die Auswahlmöglichkeit HTML-Dateien schreiben zu lassen. Daraufhin habe ich den Support ausprobiert und Daniel Springwald eine Mail geschickt.Wenn auch die Hilfe darauf keine Antwort gab, so funktioniert doch der Support vorbildlich. Innerhalb von einer (!) Stunde hatte ich die Antwort: Bei Microsoft muss zur Erstellung der HTML-Dateien der HTML-Workshop heruntergeladen werden ( Das Projekt ließ sich kompilieren und es wurde erwartungsgemäß die HTML-Hilfe-Datei erstellt.
Was mir nicht gefiel
Wie weiter oben schon beschrieben, ist die Oberfläche leider nicht so intuitiv zu bedienen, wie ich es mir von Anwendungen wünsche. Dazu gehört die gewöhnungsbedürftige Bedienung der Legende und die fehlenden Tooltipps für das Aufgaben-Grid. Der fehlende Hinweis darauf, wie das HTML-Help-File erstellt wird. Was mich am meisten gestört hat, ist die Tatsache, dass Doctor Source pro Sub/Function... nur einen Dokumentationsblock (z.B. DESC Bei der Erstellung der Doku sollte die Auswertung der REM-Tags angeboten werden. Dadurch hat der Programmierer die Möglichkeit eine Doku mit und / oder ohne aller Inline-Dokumentationen zu erstellen. Registrierung
Bewertung
Fazit Kontakt Diese Seite wurde bereits 23.050 mal aufgerufen.  |
sevOutBar 4.0  Vertikale Menüleisten á la Outlook Erstellen von Outlook ähnlichen Benutzer- interfaces - mit beliebig vielen Gruppen und Symboleinträgen. Moderner OfficeXP-Style mit Farbverläufen, Balloon-Tips, u.v.m. Tipp des Monats  September 2023Dieter Otter PopUp-Menü wird nicht angezeigt :-( In diesem Tipp verraten wir Ihnen, wie Sie Probleme mit PopUp-Menüs umgehen können, wenn diese unter bestimmten Umständen einfach nicht angezeigt werden. vb@rchiv CD Vol.6  Vol.6 Geballtes Wissen aus mehr als 8 Jahren vb@rchiv! Online-Update-Funktion Entwickler-Vollversionen u.v.m. |
||||||||||||||||||||||||||
|
Microsoft, Windows und Visual Basic sind entweder eingetragene Marken oder Marken der Microsoft Corporation in den USA und/oder anderen Ländern. Weitere auf dieser Homepage aufgeführten Produkt- und Firmennamen können geschützte Marken ihrer jeweiligen Inhaber sein. |
||||||||||||||||||||||||||||
auswertet und in die Doku übernimmt. Sobald eine Leerzeile und Code-Zeile dazwischen auftaucht, werden die übrigen (von mir gezielt erstellen Dokumentationszeilen) nicht in die Doku übernommen! Das sollte unbedingt geändert werden, denn genau hier liegt ein ungeheuer großer Vorteil, wenn der Programmierer wirklich im Code die Doku an der richtigen Stelle unterbringen kann und sich sicher ist, dass sie anschließend auch im Dokument erscheint. Dazu wäre es auch hilfreich, wenn der Tag DESC für die globale Beschreibung der Funktion und der REM-Tag im Code zur Verwendung kommen würde.
guter und schneller Support
gewöhnungsbedürftige Oberfläche
Druckansicht