Files |  Tutorials |  Articles |  Links |  Home |  Team |  Forum |  Wiki |  Impressum

Aktuelle Zeit: Fr Mär 29, 2024 01:12

Foren-Übersicht » DGL » News
Unbeantwortete Themen | Aktive Themen



Ein neues Thema erstellen Auf das Thema antworten  [ 9 Beiträge ] 
Autor Nachricht
BeitragVerfasst: Sa Apr 25, 2009 21:35 
Offline
Guitar Hero
Benutzeravatar

Registriert: Do Sep 25, 2003 15:56
Beiträge: 7804
Wohnort: Sachsen - ERZ / C
Programmiersprache: Java (, Pascal)
Unser Mitglied dj3hut1 hat sich unser Wiki mal etwas genauer besehen und einige fehlende Stücken identifiziert.

Ursprünglich (und wenig überraschend) betraf dies die neuen OpenGL 3.0 Funktionen.

Beim genaueren Hinsehen fiel aber auf, dass weitere - auch ältere Funktionen - nicht vollständig dokumentiert sind.
Dies liegt daran, dass beim Erstellen des Wikis die OpenGL1.1 Manpages vielfach als Vorlage dienten. Funktionen die später neue Parameterwerte erhalten haben sind dementsprechend nicht vollständig dokumentiert.

Da die üblichen Verdächtigen für Wikiarbeiten (z.B. Flash=ich) gerade beruflich/privat stark eingebunden sind, bitte ich alle, die das hier lesen, um ihre Mithilfe diese Löcher zu stopfen.

Ein erster Schritt, um die bestehenden Wikiartikel auf einen aktuelleren Stand zu bringen ist, die Artikel der OpenGL2.1 Referenz mit den Artikeln bei uns im Wiki zu vergleichen, und Dokumentationslücken zu schließen.

Ein krasses Beispiel ist die Funktion glTexParameter. Diese wurde 4x erweitert ohne das dies bei uns im Wiki abgebildet wurde.

Wer sich mit OpenGL 3.0 beschäftigt und die Spezifikation lesen und verstehen kann, würde uns (und allen deutschsprachigen OpenGLern) sehr helfen, wenn ihr euer Wissen im Stile der man-Pages (denn in diesem Stile sind die Wikiartikel gehalten) bei uns im Wiki hinterlegen könntet. Eine OpenGL Referenz (wie die oben verlinkte für OGL2.1) ist für OGL3.0 noch nicht von uns gefunden worden. Wer es besser weiß, bitte melden.

Bitte helft mit wo ihr könnt.
Wer keine Erfahrung mit Wikis hat brauch keine Angst zu haben. Jeder der OpenGL Programmieren kann, kann Wikicode innerhalb von 10Sekunden verstehen. ;)

_________________
Blog: kevin-fleischer.de und fbaingermany.com


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Mo Apr 27, 2009 23:29 
Offline
DGL Member
Benutzeravatar

Registriert: Sa Aug 18, 2007 18:47
Beiträge: 694
Wohnort: Köln
Programmiersprache: Java
Vielleicht wäre noch eine Checkliste sinnvoll.
Damit nicht alle Artikel doppelt und dreifach geprüft werden.

Ein spezielles Tag, ein kurze Text im Artikel selbst oder eine weitere Spalte "Gecheckt" in der Funktionsübersicht?

_________________
Es werde Licht.
glEnable(GL_LIGHTING);
Und es ward Licht.


Zitat aus einem Java Buch: "C makes it easy to shoot yourself in the foot; C++ makes it harder, but when you do it blows your whole leg off"

on error goto next


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Di Apr 28, 2009 06:43 
Offline
DGL Member
Benutzeravatar

Registriert: Di Dez 27, 2005 12:44
Beiträge: 393
Wohnort: Berlin
Programmiersprache: Java, C++, Groovy
Hallo damadmax,

ja die Idee ist gut, man bräucht so eine Art Siegel, vielleicht auch als Kategorie : 'geprüft gegen offizielle OGL 2.1 Reference Pages', oder umgekehrt alle Artikel, die noch nicht überprüft wurden normal als 'unvollständig' einstufen ( würde allerdings viel Arbeit machen, könnte man vielleicht einen Bot schreiben, der erstmal alle gl_ - Artikel als unvollständig einstuft ? )


Viele Grüße
dj3hut1

_________________
Wenn Gauß heute lebte, wäre er ein Hacker.
Peter Sarnak, Professor an der Princeton University


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Di Apr 28, 2009 12:41 
Offline
Guitar Hero
Benutzeravatar

Registriert: Do Sep 25, 2003 15:56
Beiträge: 7804
Wohnort: Sachsen - ERZ / C
Programmiersprache: Java (, Pascal)
Das müsste dann Flo machen. Der hat die Fähigkeit "Bot-Control" ;)

Eingefügt werden müsste dann einfach

{{Unvollständig|Prüfen ob Änderungen bis OGL2.1 vorliegen}}

Wenn man keinen Komentar mit dazu schreibt, kommen wir dann mit den "normalen" unvollständigen Artikeln durcheinander.

_________________
Blog: kevin-fleischer.de und fbaingermany.com


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Di Apr 28, 2009 19:50 
Offline
DGL Member
Benutzeravatar

Registriert: Do Sep 02, 2004 19:42
Beiträge: 4158
Programmiersprache: FreePascal, C++
Ich glaube, ein Gütesiegel wäre angebrachter, oder aber ein neues Tag anstatt "Unvollständig". Sonst wirds wirklich unübersichtlich... Am allerbesten wäre es, wenn dieses Gütesiegel direkt bei den Links auf den Artikel auftauchen würde, sodass man einen nicht auf die aktuelle Spec gepüften Artikel sofort erkennen kann. Am Optimalsten wäre es, mehrere Siegel für alle OpenGL-Versionen zu haben, sodass man sehen kann, bis wann dieser Artikel noch aktuell ist bzw. ob Handlungsbedarf besteht.

Gruß Lord Horazont

_________________
If you find any deadlinks, please send me a notification – Wenn du tote Links findest, sende mir eine Benachrichtigung.
current projects: ManiacLab; aioxmpp
zombofant networkmy photostream
„Writing code is like writing poetry“ - source unknown


„Give a man a fish, and you feed him for a day. Teach a man to fish and you feed him for a lifetime. “ ~ A Chinese Proverb


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Mi Apr 29, 2009 14:11 
Offline
DGL Member
Benutzeravatar

Registriert: Di Mai 18, 2004 16:45
Beiträge: 2621
Wohnort: Berlin
Programmiersprache: Go, C/C++
Ich finde die Idee mit den Siegel, für jede Version, sehr schön. Allerdings würde ich dieses im Artikel Unterbringen, da man ja mehrere Siegel für ein Befehl haben kann(glViewport hätte 3) und das die wohl etwas überladen Aussehen lässt. Am link dahin würde ich ledeglich ein Symbol verwenden, unzwar welches angibt bis zu welcher Spec diese Funktion aktualisiert wurde.

_________________
"Wer die Freiheit aufgibt um Sicherheit zu gewinnen, der wird am Ende beides verlieren"
Benjamin Franklin

Projekte: https://github.com/tak2004


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Mi Apr 29, 2009 16:19 
Offline
DGL Member
Benutzeravatar

Registriert: Do Sep 02, 2004 19:42
Beiträge: 4158
Programmiersprache: FreePascal, C++
Dass die Siegel (bzw mindestens eins, am besten das höchste) am Link sichtbar sein sollte (am besten automatisch, wie auch immer das gehen könnte :-/), damit man in der Übersicht sehr schnell nicht geprüfte Funktionen finden kann.

Gruß Lord Horazont

_________________
If you find any deadlinks, please send me a notification – Wenn du tote Links findest, sende mir eine Benachrichtigung.
current projects: ManiacLab; aioxmpp
zombofant networkmy photostream
„Writing code is like writing poetry“ - source unknown


„Give a man a fish, and you feed him for a day. Teach a man to fish and you feed him for a lifetime. “ ~ A Chinese Proverb


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Mi Apr 29, 2009 19:09 
Offline
Guitar Hero
Benutzeravatar

Registriert: Do Sep 25, 2003 15:56
Beiträge: 7804
Wohnort: Sachsen - ERZ / C
Programmiersprache: Java (, Pascal)
Nette Idee. Nur sehe ich nicht wie sowas umgesetzt werden kann.
Einen Bott zu schreiben, der erstmal alle Artikel "ungeprüft" setzt ist das eine, aber alle Artikel am Link zu markieren ist ne ganz andere Aufgabe.
Außerdem, was machst du wenn du mit der Specifikation 2.1 prüfst, die Funktion aber zuletzt bei 1.5 aktualisiert wurde. Machst du dann das 1.5er Siegel, oder das 2.1er Siegel hin?

_________________
Blog: kevin-fleischer.de und fbaingermany.com


Nach oben
 Profil  
Mit Zitat antworten  
 Betreff des Beitrags:
BeitragVerfasst: Do Apr 30, 2009 02:12 
Offline
DGL Member
Benutzeravatar

Registriert: Di Mai 18, 2004 16:45
Beiträge: 2621
Wohnort: Berlin
Programmiersprache: Go, C/C++
Genau aus diesem Grund meinte ich das mit den 2 Siegeln, mehrere Siegel für die verfügbarkeit einer Version im Artikel und ein Siegel für den Stand der aktualisierung am Link.
Wenn am Link 3.1 steht und im Artikel 1.5 dann ist klar, dass die Funktion nur bis 1.5 im Kern war und andersrum, am Link steht 1.5 und im Artikel 3.1 dann hat wer die versionen 1.5 bis 3.0 noch nicht geprüft aber schon die 3.1 und man muss alle Specs von 1.5 bis 3.1 durchgehen um den Link auf 3.1 zu bringen.

_________________
"Wer die Freiheit aufgibt um Sicherheit zu gewinnen, der wird am Ende beides verlieren"
Benjamin Franklin

Projekte: https://github.com/tak2004


Nach oben
 Profil  
Mit Zitat antworten  
Beiträge der letzten Zeit anzeigen:  Sortiere nach  
Ein neues Thema erstellen Auf das Thema antworten  [ 9 Beiträge ] 
Foren-Übersicht » DGL » News


Wer ist online?

Mitglieder in diesem Forum: 0 Mitglieder und 25 Gäste


Du darfst keine neuen Themen in diesem Forum erstellen.
Du darfst keine Antworten zu Themen in diesem Forum erstellen.
Du darfst deine Beiträge in diesem Forum nicht ändern.
Du darfst deine Beiträge in diesem Forum nicht löschen.
Du darfst keine Dateianhänge in diesem Forum erstellen.

Suche nach:
Gehe zu:  
cron
  Powered by phpBB® Forum Software © phpBB Group
Deutsche Übersetzung durch phpBB.de
[ Time : 0.179s | 17 Queries | GZIP : On ]