Styleguide für die DP

[ibp]

Mir ist mal wieder bei einem thread aufgefallen, dass es häufig vorkommt, dass der sc schlecht oder nicht formatiert ist. Nun gibt es ja bei delphi-source den Styleguide, vielleicht könnte man ja soetwas auch hier einbinden!


(Falls jemand jetzt anfängt und mosert, dass ich erstmal mit der gross und kleinschreibung anfangen soll :warn: das hat andere gründe!!!)

[Hansa]

Wo ist die Quelle ?

[Luckie]

Zitat:

Zitat von ibp

(Falls jemand jetzt anfängt und mosert, dass ich erstmal mit der gross und kleinschreibung anfangen soll :warn: das hat andere gründe!!!)

Ach?!? :shock: Welchen Grund kann es haben, dass bei dir die Umschalttaste nur immer am Satzanfang funktioniert? :roll: :gruebel:

Für Codeschnippsel haben wir die Codetags und wenn wir so anfangen auf für den Rest einen Styleguide festzulegen, dann könnte ich jeden Tag entweder hunderte von beiträgen editieren und korrigieren (deinen inklusive), was den einfügen von Delphi-Tags entsprechen würde, oder ich könnte hunderte von Beiträgen schließen.

Und wenn wir es einführen, dann wäre ich für korrekte Grammatik und Rechtsschreibung und jetzt guck dir dein Beitrag noch mal auf diese beiden Forderungen hin an. Wie war das mit dem Glashaus...

[Nicodius]

Zitat:

Zitat von Luckie

Vorderungen

:stupid:

[Martin]

Zitat:

Zitat von Hansa

Wo ist die Quelle ?

www.delphi-source.de/grundlagen/styleguide/

[Luckie]

Zitat:

Zitat von Nicodius

Zitat:

Zitat von Luckie

Vorderungen

:stupid:

Ich habe von absichtlich ignorierter Rechtschreibung und Grammatik gesprochen und nicht von Tippfehlern. ;)

Oder geht es hier nur um den Quellcode, der gepostet wird?

[Kedariodakon]

:wiejetzt: Ich halte mich bestimmt net an die Delphi-Source Style guide...

Zitat:

Zitat von Delphi-Source Style

Delphi-Quellcode:

// FALSCH
while (LongExpression1 or LongExpression2) do begin
  // DoSomething
  // DoSomethingElse;
end;

// RICHTIG
while (LongExpression1 or LongExpression2) do
begin
  // DoSomething
  // DoSomethingElse;
end;

Hmm bei mir ist das genau andersherrum... :zwinker:

Und da es keine Style Regeln gibt, sondern nur verschiedene Richtlinien *abgelehnt* :cheers:


Oder sowas hier :lol:

Zitat:

Zitat von Delphi-Source Style

Delphi-Quellcode:

// FALSCH
  if A < B then begin
    DoSomething;
    DoSomethingElse;
  end else begin
    DoThis;
    DoThat;
  end;

  // RICHTIG
  if A < B then
  begin
    DoSomething;
    DoSomethingElse;
  end
  else
  begin
    DoThis;
    DoThat;
  end;

Also ich weiß ja net...
Hauptsache der code is gut lesbar...
Aber einfach zu sagen so ist der style falsch und so richtig?!? :angel2:

Und meine meinung dazu, die als falsch angesehenen, lassen sich besser lesen als die richtigen... :gruebel:



Bye

[Neelix]

Hallo Kedariodakon,

hast Du schon mal in Delphi if einegeben und danach auf <STRG> J gedrückt?
Ergebnis ist folgendes:

Delphi erzeugt

if then
begin

end
else
begin

end;

Zitat:

Zitat von Kedariodakon

Und meine meinung dazu, die als falsch angesehenen, lassen sich besser lesen als die richtigen...

Darüber läßt sich trefflich streiten. :-D

[Hansa]

Zuerst einmal hat Luckie vollkommen Recht ! Bevor es einen StyleGuide für die DP gibt, sollte es erst mal einen Rechtschreib-Guide geben und dann noch einen Deutsch-Guide.

Es gibt viele, die schreiben so unleserlich und finden es noch cool 8) , daß man doppelt so lange braucht, zu verstehen, was derjenige überhaupt will. Dies Art von Coolness nennt man zu deutsch immer noch Dummheit. :lol:

@keldo-dings??

Delphi-Quellcode:

// FALSCH 
  if A < B then begin 
    DoSomething; 
    DoSomethingElse; 
  end else begin 
    DoThis; 
    DoThat; 
  end; 

  // RICHTIG 
  if A < B then 
  begin 
    DoSomething; 
    DoSomethingElse; 
  end 
  else 
  begin 
    DoThis; 
    DoThat; 
  end;

Ich schreibe es noch etwas anders und zwar so :

Delphi-Quellcode:

//HANSA 
  if A < B then begin 
    DoSomething; 
    DoSomethingElse; 
  end 
  else begin 
    DoThis; 
    DoThat; 
  end;

Es gibt keine Regel ohne Ausnahme. Der Styleguide ist als Richtlinie gut, aber nicht überall sinnvoll durchgezogen worden. Diese Regel hier ist IMHO ein Fehler. Warum ?

In meinem Beispiel gehört das end zu dem if oder das andere zu dem else. Im Styleguide gehört es (immer auf die Einrückung bezogen) zu dem begin oder dem if oder eben dem else.

Habe ich nun einen größeren Code-Block, z.B. 200 Zeilen und das ganze mal 5 mit "if then else if then" usw. dann kann man sich schnell vertun und die Einrückung dient als Anhaltspunkt.

Hierbei nützt es nichts, auf den ersten Blick zu sehen, daß das end; zu einem begin gehört. Wichtig ist, zu welchem if / else ! Dasselbe gilt natürlich auch für WHILE usw. Noch ein Vorteil ist, daß man für ein begin micht noch eine Zeile extra braucht. So wird der Sourcecode wesentlich kompakter, zumindest wenn z.B. im if-Zweig nicht viel drin steht.

[Luckie]

darüber läßt sich streiten, letztendlich ist es geschmackssache bzw. die Vorgabe des Teams speilt auch eine Rolle. An dieser Stelle diese Diskussion zu führen, halte ich nicht für sehr sinnvoll. Kommt bitte wieder zurück zum Thema.

[ibp]

Zitat:

Zitat von Luckie

Ach?!? :shock: Welchen Grund kann es haben, dass bei dir die Umschalttaste nur immer am Satzanfang funktioniert? :roll: :gruebel:

...

Und wenn wir es einführen, dann wäre ich für korrekte Grammatik und Rechtsschreibung und jetzt guck dir dein Beitrag noch mal auf diese beiden Forderungen hin an. Wie war das mit dem Glashaus...

... ich erinnere dich daran!

Zitat:

Zitat von Luckie

Für Codeschnippsel haben wir die Codetags und wenn wir so anfangen auf für den Rest einen Styleguide festzulegen, dann könnte ich jeden Tag entweder hunderte von beiträgen editieren und korrigieren (deinen inklusive), was den einfügen von Delphi-Tags entsprechen würde, oder ich könnte hunderte von Beiträgen schließen.

... es geht nicht um das korrigieren oder nacheditieren durch die mods, sondern manche auf eine gewisse grundstruktur aufmerksam zu machen!

[Luckie]

Zitat:

Zitat von ibp

Zitat:

Zitat von Luckie

Ach?!? :shock: Welchen Grund kann es haben, dass bei dir die Umschalttaste nur immer am Satzanfang funktioniert? :roll: :gruebel:

...

Und wenn wir es einführen, dann wäre ich für korrekte Grammatik und Rechtsschreibung und jetzt guck dir dein Beitrag noch mal auf diese beiden Forderungen hin an. Wie war das mit dem Glashaus...

... ich erinnere dich daran!

Was hat meine Referenz CD mit der Tatsache zu tun, dass du nur am Satzanfang in der Lage bist Großbuchstaben zu tippen? Ich habe nie behauptet, dass ich keine Rechtschreibfehler mache, sei es nun aus Unwissenheit oder, weil ich mich vertippt habe.

Desweitern halte ich es nicht für gut hier vorschreiben zu wollen, wie man sein Posting abzufassen hat von der Grundstruktur her. Ob man nun zu erst den Quellcode postet und dann die Frage oder umgekehrt, finde ich, ist egal. Jeder soll es so machen, wie er es für richtig hält. Etwas Individualismuss sollte schon noch möglich sein.

[Kedariodakon]

Zitat:

Zitat von Neelix

Hallo Kedariodakon,

hast Du schon mal in Delphi if einegeben und danach auf <STRG> J gedrückt?
Ergebnis ist folgendes:

Delphi erzeugt

if then
begin

end
else
begin

end;

Zitat:

Zitat von Kedariodakon

Und meine meinung dazu, die als falsch angesehenen, lassen sich besser lesen als die richtigen...

Darüber läßt sich trefflich streiten. :-D

Rate mal wie das dann bei mir aussschaut :zwinker:

jedenfalls nicht so wie da oben :warn:

Bye

[Luckie]

Ich hatte euch doch gebeten diese Styleguide Diskussion, wie man Delphicode zu formatieren hat, nicht hier zu führen, da ich denke, dass es das an dieser Stelle keinen Sinn macht. Darüber können wir dann diskutieren, wenn wir uns dazu entscheiden sollten einen Styleguide in der DP für Delphiquellcode einzuführen. Die Wahrscheinlichkeit, dass dies geschiet halte ich aber für ziemlich gering. Man überlege nur mal, was es bedeutet, wenn in einer Firma oder einem Team ein anderer Styleguide benutzt wird, dann müsste man ja alles umformatieren, nur um hier den Quellcode posten zu können. :roll:

[ibp]

Zitat:

Zitat von Luckie

Was hat meine Referenz CD mit der Tatsache zu tun, dass du nur am Satzanfang in der Lage bist Großbuchstaben zu tippen? Ich habe nie behauptet, dass ich keine Rechtschreibfehler mache, sei es nun aus Unwissenheit oder, weil ich mich vertippt habe.

.. das war nichts persönliches, sonder es bezog sich auf mich! ich kann auch anders!

Zitat:

Zitat von Luckie

Desweitern halte ich es nicht für gut hier vorschreiben zu wollen, wie man sein Posting abzufassen hat von der Grundstruktur her. Ob man nun zu erst den Quellcode postet und dann die Frage oder umgekehrt, finde ich, ist egal. Jeder soll es so machen, wie er es für richtig hält. Etwas Individualismuss sollte schon noch möglich sein.

.. es ging mir dabei um den sourcecode (sc)!!!

[Luckie]

Also doch den Sourcecode. Dann habe ich dazu ja schon meine Meinung kund getan im letzten Posting.