Diskussion:Kommentar (Programmierung)
Erstellung dieses Artikels
[Quelltext bearbeiten]Vorgeschichte
[Quelltext bearbeiten]Der Artikel Kommentar (Programmierung) ist aus dem Streit um den Artikel C-Sharp entstanden. Letzterer wurde von einem Nutzer in sehr umfangreicher Weise verfasst (an dieser Stelle erstmal Danke für die Mühe!), jedoch leider entgegen der Wiki-Regeln, d.h. er ging durch Aufzählung Unzähliger Sprachmerkmale, die als allgemein bekannt gelten (for, goto, etc.) viel zu sehr ins Detail. In langen Diskussionen (Diskussion:C-Sharp) wurden Kürzungen, Verschiebungen, Löschungen und Aufteilungen diskutiert. Alles steht zur Zeit kurz vor einem Edit War. Ein mutiger User hat einen Teil aus C-Sharp, der von Kommentaren in C# handelte, in ein eigenes Thema namens Kommentar (Programmierung) verschoben und verlinkt. Leider war dieser Artikel sehr auf C, C++ und C# Konzentriert. Dieses Problem wurde in Diskussion:C-Sharp diskutiert und die Anlage dieses Artiekls wurde als gescheiterter Versuch angesehen.
Lösungsversuch
[Quelltext bearbeiten]Ich habe nun den Kompletten Artikel gelöscht und neu geschrieben. Besonderes Augenmerk habe ich darauf gelegt, das ganze möglichst für alle Sprachen geltend zu machen. Ich behaupte also hiermit, dass es eine Reihe von Gemeinsamkeiten zwsichen Sprachen in veschiedenen Sprachen gibt (dies wurde in der vorhergegangenen Diskussion abgestritten). Natürlich gestehe ich ein, dass es auch Unterschiede gibt. Diese habe ich ansatzweise klar gemacht.
Weiteres Vorgehen
[Quelltext bearbeiten]Alles was darüber hinaus geht (z.B. "In der Sprache XYZ gelten Kommentare auch als Weg, die GUI zu beeinflussen") würde nicht in diesen Artikel gehören, sondern in den Artikel der Sprache XYZ. Hingegen würde eine Aussage wie "Die Sprache XYZ besitzt auch Kommentare, welche ein einer Zeile beginnen und in einer anderen enden können." nicht zur allgemeinen Definition der Sprache XYZ gehören, da es einfach allgemein bekannt ist, dass Sprachen Kommentare besitzen, und da die Tatsache, dass sie Zeilenüberschreitend sein können, auch nichts besonderes ist. Gäbe es hingegen eine Spache ABC, die keinerlei Kommentare erlaubt, so wäre es sinnvoll, dies in der Definition von ABC zu erwähnen, da dies eine Besonderheit darstellt.
Abschließende Worte
[Quelltext bearbeiten]Ich hoffe das eben gesagte wird von der Mehrheit der Wikipädianer als richtig angesehen und hilft zur zukünftigien Wikipedia:Wikiliebe. Solle ich etwas falsch verstanden haben (bin erst seit 2 Tagen dabei), so korrigiert mich bitte.
Ich hofft das Vorgehen, den Kommentarkram aus C-Sharp nach hier zu verschieben und die Aktion meinerseits, es auf alle Sprachen zu verallgemeinern, war richtig und ist auch der richtige Ansatz für den restlichen C-Sharp-Artikel.
Alle Eigenschaften von C-Sharp, die
1. für das Wesen der Sprache ausschlaggebend sind
2. nicht durch einen allgemeinen Artikel wie diesen Abgedeckt werden
können und sollten dann direkt im C-Sharp-Artikel beschrieben werden.
MFG Brian 80.185.140.69 21:22, 11. Jul 2004 (CEST)
PS: Jetzt hab ich meinen langen Diskussionsbeitrag soweit formatiert, dass es gar nicht mehr wie eine Diskussion aussieht. Selbstverständlich ist es noch eine, und selbstversäntlich sind Antworten und Kritik erwünscht. Brian 80.185.140.69 22:50, 11. Jul 2004 (CEST)
- Stimme dem offensichtlicherweise zu, da ich diesen Artikel ursprünglich von C# herkopiert hatte. Als eigener Artikel kann er wesentilch umfassender und detaillierter auf den Begriff eingehen, als dies als einzelner Abschnitt im Artikel C# möglich wäre. Was allerdings noch viel mehr wiegt, ist die Tatsache, daß er in dieser Form nun auch von anderen Sprachen aus verlinkt werden kann und damit Wissen öffentlicher gemacht wird. --Sprezz 00:44, 12. Jul 2004 (CEST)
Pragmas
[Quelltext bearbeiten]Manche Sprachen verwenden Kommentare auch fuer Compiler-Pragmas (Okay, was heiszt „manche Sprachen“? Zugegebenerweise kenn ich das nur von Haskell). Meinem Gefuehl nach ist das zwar etwas aehnliches wie Praeprozessor-Anweisungen, aber nicht das gleiche - sollten wir das vielleicht auch noch einfuegen oder den Punkt zu den PPs ein bisschen allgemeiner fassen? --FAR 01:53, 30. Nov 2005 (CET)
- Auch Turbo Pascal / Delphi sowie einige C++ - Compiler (zB Watson C++) kennen Pragmas, d.h. Kommentare, die die Arbeitsweise des eigentlichen Compilers beeinflussen. NineBerry 21:17, 17. Mär. 2007 (CET)
"Präprozessor" ist ein bisschen eng gefasst. Diese schrecklichen "conditional comments" für den Internet Explorer und sowas wie # -*- coding: utf-8 -*-
werden ja nicht in einem extra Durchgang geparst.--87.162.32.206 23:33, 11. Apr. 2010 (CEST)
Assembler
[Quelltext bearbeiten]Hallo, kann man nicht in Assembler mit /* und */ auch Zeilenübergreifend kommentieren? -- Mit freundlichen Grüßen, Michael Schönitzer 00:25, 22. Mai 2008 (CEST)
Betriebssysteme
[Quelltext bearbeiten]Einige Betriebssysteme erlauben für Scripts ebenfalls Kommentare, vgl. nur REM bei MS-DOS. Ich habe meine Probleme damit, DOS als Programmiersprache durchgehen zu lassen und bin deshalb unschlüssig, ob das in diesen Artikel gehört. Okmijnuhb 16:40, 4. Aug. 2009 (CEST)
- Warum soll eine Shellsprache keine Programmiersprache sein? Seit DOS 6 ist Batch turingvollständig. Es geht aber gar nicht nur um Programmiersprachen hier, sonst wäre HTML auch fehl am Platz.--87.162.32.206 23:30, 11. Apr. 2010 (CEST)
Beispiele
[Quelltext bearbeiten]"//" in Pascal? Gibt es dafür eine Quelle? Ich habe Pascal in der Tabellenzeile für "//" erst einmal auskommentiert. -- Gebu 08:27, 13. Mai 2010 (CEST)
- Würde mich wundern, wenn // bei Pascal stimmen sollte - auf jeden Fall ohne Quelle auskommentiert lassen. --GiordanoBruno 10:48, 13. Mai 2010 (CEST)
- zumindest in der aktuellen FreePascal Syntax
http://www.freepascal.org/docs-html/ref/refse2.html#x10-90001.2 DirkBausB 11:59, 19. Jul. 2011 (CEST)
Verwendung
[Quelltext bearbeiten]Das Beispiel bei Verwendung / Gliederung des Quelltextes spricht von "residenten" Teilen im Quelltext. Ich finde das Adjektiv weder im Artikel zum Quelltext noch im Duden. Ist der Ausdruck tatsächlich in Gebrauch oder nur ein unglückliche Übersetzung aus dem Englischen? -- 153.96.32.62 15:43, 26. Apr. 2011 (CEST)
":" in BASIC?
[Quelltext bearbeiten]Das Bild "Ausschnitt ... Listing" im Artikel BASIC lässt vermuten, dass neben "REM" auch ":" einen Kommentar codiert. --Helium4 14:12, 9. Dez. 2011 (CET)
Einsehen / Anzeigen von Kommentaren im Browser
[Quelltext bearbeiten]Wikipedia Nutzer sind Browser-Nutzer, deshalb fände ich einen Abschnitt als kleine praktische Anleitung zum Einsehen von Kommentaren, insbesondere in einem Web-Browser hilfreich. Allgemein der Wechsel zwischen den Ebenen Programm-Editieren und Programm-Durchführen. Im Browser das Anzeigen des zeilenweisen HTML-Codes oder der Seitendarstellung des Inhalts. Konkret macht z.B. im Browser Safari die Menufunktion "> Darstellung > Quelltext anzeigen" die der Anzeige zugrundeliegenden HTML-Zeilen durch Anzeige in einem eigenen Fenster einsehbar, in diesem unformatierten Zeilentext sind die Kommentarzeilen sichtbar und (am Apple) durch die Suchfunktion "Apfel-/Befehls-Taste + F" und Eingabe der Zeichenfolge "<", "!", "--" ins Fenster für den Suchbegriff aufzufinden und kopierbar. --Helium4 14:31, 9. Dez. 2011 (CET)
Zeilenverlängerung
[Quelltext bearbeiten]Kann in Fortran (oder BASIC?) eine Kommentarzeile durch den Code ";" (Folgezeile) auch über eine weitere Zeile laufbar gemacht werden? --Helium4 14:35, 9. Dez. 2011 (CET)
Kommentare in LaTeX
[Quelltext bearbeiten]Kommentare in LaTeX werden auch mit % erzeugt. 2003:EE:573F:F900:C4BC:37A3:2361:CF3A 21:14, 4. Apr. 2021 (CEST)
Ergänzungen zum Abschnitt Verwendung
[Quelltext bearbeiten]WP ist zwar kein Ratgeber (WP:WWNI Punkt 9), aber dass in Empfehlungen zur Verwendung von Kommentaren davon abgeraten wird, damit zu beschreiben, was eine Programmzeile tut, könnte man hier ergänzen — sowie diese positiven Verwendungen:
- Angabe der Einheit zu einer Variablen, die eine physikalische Größe repräsentiert (als konkretes Beispiel unter einem Punkt "informeller Teil einer Schnittstellendefinition").
- Warnung an die Verwender einer Funktion, dass diese nur valide Parameter verträgt (dito).
- Deep Links in eine Designspezifikation, um die Verifikation zu erleichtern.
- Formale Hinweise an einen Linter, für die markierten Stellen bestimmte Warnungen zu unterdrücken.