Du bist nicht angemeldet.

Stilllegung des Forums
Das Forum wurde am 05.06.2023 nach über 20 Jahren stillgelegt (weitere Informationen und ein kleiner Rückblick).
Registrierungen, Anmeldungen und Postings sind nicht mehr möglich. Öffentliche Inhalte sind weiterhin zugänglich.
Das Team von spieleprogrammierer.de bedankt sich bei der Community für die vielen schönen Jahre.
Wenn du eine deutschsprachige Spieleentwickler-Community suchst, schau doch mal im Discord und auf ZFX vorbei!

Werbeanzeige

1

08.01.2012, 18:51

NetBeans, Doc Comments (und SFML)

Hallo zusammen,

ich möchte gerne mit Hilfe der SFML ein Spiel in C++ programmieren. Dafür suche ich zurzeit noch nach einer C++ IDE für Windows und Linux. Bis jetzt habe ich CodeLite, Code::Blocks und Eclipse CDT ausprobiert. Nun habe ich mir noch NetBeans installiert, welches mir vom Gesamteindruck bisher am besten gefällt. Das Programm ist übersichtlich, hat eine statische Code-Analyse vergleichbar mit der von Eclipse CDT und Visual Studio, und zeigt die Doc Comments von Klassen, Methoden usw. an.

Die Doc Comments bereiten mir allerdings noch etwas Probleme: Wenn ich mich nicht irre, ünterstützt NetBeans ausschließlich die Syntax von Javadoc, bei der die Kommentare mit /** eingeleitet werden. Die Doc Comments in den Headerdateien von SFML beginnen aber alle mit /// und werden dementsprechend auch nicht in NetBeans ausgegeben. Ich bin mir sicher, dass ich diesen Umstand irgendwie verkraften kann ;), aber lieber wäre es mir natürlich, wenn sich eine Lösung dafür finden ließe. Schließlich ist das eine sehr praktische Funktion.

Für eine manuelle Konvertierung der Doc Comments wäre ich mir letztendlich zwar auch nicht zu schade, aber damit würde ich mir etwas ungeschickt vorkommen, sollte es dann doch einen eleganteren Weg geben.

Benutzt noch jemand NetBeans und kann hier Abhilfe schaffen?

DarioFrodo

Treue Seele

Beiträge: 349

Wohnort: Kerkau, 100km nördlich von Magdeburg

Beruf: Selbstständig

  • Private Nachricht senden

2

08.01.2012, 20:02

Ich benutze sehr gerne NetBeans zum programmieren, aber Doc Comments habe ich bisher noch nicht entdeckt (._.);
Erst wenn der letzte Fluss vergiftet,
der letzte Baum gefällt,
der letzte Fisch gefangen,
dann werdet ihr merken, dass man Geld nicht essen kann

Man verkauft die Erde nicht, auf der die Menschen wandeln.

- Indianerweisheiten

Ich bin auch ein einhornimmond ;)

3

13.01.2012, 00:00

Sieht ganz so aus, als müsste ich die Doc Comments von SFML händisch anpassen. Ist auch nicht weiter schlimm; so viel Arbeit ist es ja nicht.

@DarioFrodo

Wenn du in deinem Code auf den Bezeichner einer Methode, Funktion oder Ähnlichem klickst, kannst du mit Strg + Leertaste den Doc Comment des angeklickten Objekts in einem Fenster anzeigen lassen. Voraussetzung ist jedoch, dass der Doc Comment den Javadoc Syntax benutzt (also: /** ... @param ... */). Die Doc Comments werden auch während der Code-Vervollständigung für den aktuell ausgewählten Vorschlag eingeblendet.

Ich beziehe mich hier übrigens auf das C++ Paket von NetBeans 7.1. In älteren Versionen verhält sich das Ganze möglicherweise etwas oder komplett anders.

4

13.01.2012, 13:34

Vielleicht kannst du für SFML die man pages auf deinem System generieren/installieren, dann sollte Netbeans das auch anzeigen. Das ganze ist übrigens nicht nur die übliche JavaDoc Formatierung sondern AFAIK auch die übliche doxygen Syntax.

Ich bin auch von Netbeans überzeugt. Was ich schade finde ist, dass Google wohl spätestens nach der Oracle Übernahme von Sun Plugins wie das für GWT immer nur für Eclipse bereitstellt...

@DarioFrodo: Schau sonst mal hier http://netbeans.org/kb/docs/cnd/navigating-editing.html

Dieser Beitrag wurde bereits 2 mal editiert, zuletzt von »Chromanoid« (13.01.2012, 13:48)


EcaFaYn!

Frischling

Beiträge: 62

Wohnort: NRW

Beruf: Azubi + Student

  • Private Nachricht senden

5

14.01.2012, 19:22

Ist ja lustig, ich hab genau das gleiche geplant und werde dafür auch NetBeans benutzen, da ich die IDE ohnehin schon auf der Arbeit verwende und großartig finde. Vielleicht können wir uns ja das ein oder andere Mal gegenseitig helfen.
On the grind - Supersci

6

15.01.2012, 01:10

@Chromanoid

Danke für den Tipp. Mit Doxygen konnte ich aus den SFML-Headerdateien Manpages generieren. Allerdings habe in den FAQ von MinGW erfahren, dass es für MinGW zurzeit noch kein "man" gibt. Es gibt lediglich einen Entwicklungs-Snapshot, den man sich selbst kompilieren muss. Das habe ich bisher aber nicht versucht. Ich schätze, ich werde stattdessen den bequemen Weg gehen und einfach auf die finale Version warten.

Mal sehen, was die Übernahme durch Oracle noch so alles mit sich bringt. Hoffentlich nicht noch ein Fork. Das GWT-Plugin für NetBeans scheint aber immerhin von einer Einzelperson gepflegt zu werden.

@EcaFaYn

Gerne!

Ist es bei dir zufällig auch ein Weltraumspiel?

Werbeanzeige