Hallo
ich habe derzeit ein Problem, welches ich nicht in Google Worte fassen kann,
weil ich es selbst nicht ganz verstehe, warum das alles so ist. Wir
dokumentieren ein Webprojekt. Da drin gibt es nat�rlich auch die
entsprechenden Webcontrols in der Codebehind Seite
Protected WithEvents TextBoxContactName As System.Web.UI.WebControls.TextBox
Mit z.B. VBCommenter habe ich das wie folgt dokumentiert:
'''
----------------------------------------------------------------------------
-
''' <summary>
''' TextBoxContactName As System.Web.UI.WebControls.TextBox
''' </summary>
''' <value>
''' TextBoxContactName As System.Web.UI.WebControls.TextBox
''' </value>
''' <remarks>
''' TextBoxContactName As System.Web.UI.WebControls.TextBox
''' </remarks>
''' <history>
''' [Kovacic-Voss] 20.12.2004 Created
''' </history>
'''
----------------------------------------------------------------------------
-
Warum mit <value>? Kommt gleich (Hinweis: Property) ... hier das Ergebnis in
der aus VBDoc (0.4) oder VBCommenter (1.2) erzeugten XML Datei:
<member
name="F:Siller.Itelius.Modules.Shop.AdministrationControl.TextBoxContactName
">
<summary>
TextBoxContactName As System.Web.UI.WebControls.TextBox
</summary>
<value>
TextBoxContactName As System.Web.UI.WebControls.TextBox
</value>
<remarks>
TextBoxContactName As System.Web.UI.WebControls.TextBox
</remarks>
<history>
[Kovacic-Voss] 20.12.2004 Created
</history>
</member>
NDoc (1.3) hat ja die nette Option, MissingParams entsprechend zu
kennzeichen. Damit kann ich ja sehen, ob die Damen und Herren alles komplett
dokumentiert haben. Ausserdem wollen wir nur eine interne Dokumentation
machen, daher sollen auch internal, protected und private Funktionen /
Variablen usw. mit dokumentiert werden. Das funktioniert auch ganz gut bis
auf die Webcontrols.
Ohne die AutoPropertyBackersSummaries Option in NDoc bekomme ich bei der
Textbox den Hinweis:
Missing <summary> documentation for
F:Siller.Itelius.Modules.Shop.AdministrationControl._TextBoxContactName (man
beachte den "_" !!!)
Mit der Option wird hier automatisch was eingetragen und die Textbox taucht
auch noch als Property auf (TextBoxContactName Property), aber auch hier der
Hinweis:
Missing <summary> documentation for
P:Siller.Itelius.Modules.Shop.AdministrationControl.TextBoxContactName
Wenn ich das richtig sehe, m�sste ich VBDoc oder VBCommenter nur dazu
bringen aus
F:Siller.Itelius.Modules.Shop.AdministrationControl.TextBoxContactName das F
gegen ein P zu ersetzen
(P:Siller.Itelius.Modules.Shop.AdministrationControl.TextBoxContactName).
Doch wie? Oder ist es doch eine Einstellung in NDoc ? Ich habe schon
gegoogelt, aber ich habe nichts brauchbares gefunden. Auch der Begriff
Backer ist mir nicht gel�ufig. F�r meine Begriffe ist die Textbox ein Feld,
keine Eigenschaft. Daher bin ich f�r jede Hilfe dankbar, dass ich endlich
die Missing Hinweise hier eliminieren kann.
Gru�
Dominik
Mit freundlichen Gr��en | Best regards,
Dominik Kovacic-Vo�
Dipl.-Informatiker (FH)
Produktentwicklung * Siller AG
Wannen�ckerstra�e 43 * 74078 Heilbronn * Germany
mailto:[EMAIL PROTECTED] * http://www.siller.de
_______________________________________________
Asp.net Mailingliste, Postings senden an:
[email protected]
An-/Abmeldung und Suchfunktion unter:
http://www.glengamoi.com/mailman/listinfo/asp.net
