www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - What do you think about my D style guide? - CLAYTEK_3D_STYLEGUIDE.d

reply clayasaurus <clayasaurus_member pathlink.com> writes:
Hello. I've been working on a project and something that is setting me back
is to have a good consistent style to code with. 

I've created a style guide for myself and am posting it here for comments
and critiques. 

Some of you will have differing opinions on things which may be constructive.
Also, I'm open to any additional ideas.

Thanks all for your time

(see attachment)
(http://svn.dsource.org/svn/projects/claytek/trunk/CLAYTEK_3D_STYLEGUIDE.d)


begin 0644 CLAYTEK_3D_STYLEGUIDE.d

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
M=6YI;VX 54Y)3TX >WT "0D)"0D)"0I\"6-O;G-T(%!)(#T ,RXQ-#L "0D)
M"0D)"0I\"0D)"0D)"0D)"0D*?"`B079O:60 ;65A;FEN9VQE<W, ='EP92!A
M;&EA<V5S+B( "0D)"0D)"0D*?`DM($0 4W1Y;&4 1W5I9&4L("AD:6=I=&%L
M;6%R<RYC;VTO9"D*?`D)"0D)"0D)"0D)"GP)17AA;7!L93H)+BXN;V8 ;65A
M;FEN9VQE<W, 86QI87-E<RXN+ D)"0D)"0D*?`D)86QI87, =F]I9"!63TE$
M.R`)"0D)"0D)"GP)"6%L:6%S(&EN="!)3E0[(`D)"0D)"0I\"0EA;&EA<R!I
M;G0J('!I;G0["0D)"0D*?`D)"0D)"0D)"0D)"0D*?`D)"0D)"0D)"0D)"0D*
M"2)3=')U8W1U<F5S('!E<F9O<FT 8F5T=&5R(&9O<B!S;6%L;"!D871A('-E
M=', 86YD(&%R90H)(&-O<&EE9"!B>2!V86QU92X 0VQA<W-E<R!P97)F;W)M
M(&)E='1E<B!F;W( ;&%R9V5R(&1A=&$ " D <V5T<R!A;F0 87)E(&-O<&EE

M;&EZ960 =VET:"!N97<L('=H97)E87, <W1R=6-T=7)E<R!D;R!N;W0N(B`*
M?`D "2T 06YO;GEM;W5S+"`H1&EG:71A;&UA<G,N8V]M(&0N1"!N97=S9W)O
M=7`I"0D)"0I\"0D)"0D)"0D)"0D)"GP)17AA;7!L93H)"0D)"0D)"0D)"0D*
M?`D)"0D)"0D)"0D)"0D)"GP)<W1R=6-T(%9E8W1O<B`O*B!S;6%L;"!D871A
M('-E="`J+PD)"0D)"0D)"GP)>PD)"0D)"0D)"0D)"0D*?`D):6YT(&U8+"!M
M62P ;5H[(`D)"0D)"0I\"7T)"0D)"0D)"0D)"0D)"GP)"0D)"0D)"0D)"0D)
M"GP)5F5C=&]R(&)O8B`](&IA;CLO*B!I;B!M96UO<GD 8F]B(&%N9"!J86X 
M87)E('-E<&5R871E*B\)(`I\"6IA;B`K/2`S.PD)"0D)"0D)"0D)"0I\"0D)
M"0D)"0D)"0D)"0D*?`EC;&%S<R!0;&%Y97( +RH ;&%R9V4 9&%T82!S970 
M*B\ "0D)"0D)"0D*?`E["0D)"0D)"0D)"0D)"0I\"0DN+BX ;&%R9V4 86UO
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
M871I;VYS+B`*"2!$;VXG="!U<V4 :68 =&AE>2!O;FQY('-E="]G970 82!V
M87)I86)L92X 5&AE>2=R92!U9VQY+"`*"2!T86ME('!R96-I;W5S('1Y<&EN
M9R!T:6UE+"!A;F0 <&]S<VEB;'D =V%S=&4 8W!U(`H)(&-Y8VQE<RXB("T 
M8VQA>6%S875R=7, "0D)"0D)"0D)"GP)"0D)"0D)"0D)"0D)"0I\"0D)"0D)
M"0D)"0D)"0I\"45X86UP;&4Z"0D)"0D)"0D)"0D*?`D)"0D)"0D)"0D)"0I\
M"6-L87-S($9O;PD)"0D)"0D)"0I\"7L)"0D)"0D)"0D)"0D)"GP)"7!R:79A

M960["0D)"0D)"0I\"0D)"0D)"0D)"0D)"0D*?`D)<'5B;&EC. D)"0D)"0D)
M"0D)"GP)"0D)"0D)"0D)"0D)"GP)"0EV;VED('-P965D*&EN="!P:5-P965D
M*2`O*B!O;FQY('5S92!S970 :68 =&AE>0D)(`H)"0D)"0EP97)F;W)M(&%D
M9&ET:6]N86P ;W!E<F%T:6]N<R`J+PD*?`D)"7L)"0D)"0D)"0D)"0I\"0D)
M"6U3<&5E9"`]('!I4W!E960 *B!M0V%L8U-P965D.PD)"0D)"0I\"0D)?0D)
M"0D)"0D)"0D)"GP)"0D)"0D)"0D)"0D)"0I\"0D):6YT('-P965D*"D)"0D)

M86QC4W!E960[(`D)"0D)"0D*?`D)"7T)"0D)"0D)"0D)"0I\"7T)"0D)"0D)
M"0D)"0D)"GP)"0D)"0D)"0D)"0D)"0I\"49O;RYS<&5E9" Q,BD[("\J('!E
M<F9O<FUS(&%D9&ET:6]N86P ;W!E<F%T:6]N<R`J+PD)"GP)1F]O+FU3:7IE
M(#T ,C([("\J('!E<F9O<FUS(&YO(&%D9&ET:6]N86P ;W!E<F%T:6]N<R`J
M+R`)"GP)"0D)"0D)"0D)"0D*?`D)"0D)"0D)"0D)"0D*?`DB4'5T(&QA<F=E
M<B!D871A('1Y<&5S(&%T('1H92!T;W`L(&%N9"!G<F]U<"!S:6UI;&%R(`H)
M9&%T82!T>7!E<R!T;V=E=&AE<BXB"GP)(`DM(&-L87EA<V%U<G5S("`)"0D)
M"0D)"0D*?`D)"0D)"0D)"0D)"0D)"GP 17AA;7!L93H)"0D)"0D)"0D*?`D)
M"0D)"0D)"0D)"0I\"6-L87-S($9O;PD)"0D)"0D)"GP)>PD)"0D)"0D)"0D)
M"GP)"4UU<VEC6UT ;75S:6,["0D)"0D*?`D)8VAA<EM=(&YA;64[(`D)"0D)
M"0I\"0D "0D)"0D)"0D*?`D)<F5A;"!B;V(["0D)"0D)"GP)"7)E86P 9FQO
M<FED83L "0D)"0D*?`D)9FQO870 8F]B.R`)"0D)"0D*?`D):6YT(&IE;CL)
M"0D)"0D)"0I\"0EB:70 :'5N.R`)"0D)"0D)"0I\"7T)"0D)"0D)"0D)"0D*
M?`D)"0D)"0D)"0D)"0D)"GP)(E1O('!R;W1E8W0 =&AE(&%U=&AO<B!O9B!T
M:&4 8V]D92P 86QL($0 9FEL97, ;F5E9"!A(`H);&ES8V5N<V4 870 =&AE
M('1O<"XB"0I\"0DM(&-L87EA<V%U<G5S"0D)"0D)"0I\"0D)"0D)"0D)"0D)
M"0D*?`E%>&%M<&QE. E)(&-H;V]S92!T;R!U<V4 =&AE(&QI8GHO<&YG(&QI
M<V-E;G-E"0D)"0I\"0D)"0D)"0D)"0D)"0HO*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ
M*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ
M*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ

M<F4 :7, <')O=FED960 )V%S+6ES)RP =VET:&]U="!A;GD 97AP<F5S<R!O
M<B!I;7!L:65D('=A<G)A;G1Y+B!);B!N;R!E=F5N="!W:6QL('1H92!A=71H
M;W)S" EB92!H96QD(&QI86)L92!F;W( 86YY(&1A;6%G97, 87)I<VEN9R!F
M<F]M('1H92!U<V4 ;V8 =&AI<R!S;V9T=V%R92X*" E097)M:7-S:6]N(&ES
M(&=R86YT960 =&\ 86YY;VYE('1O('5S92!T:&ES('-O9G1W87)E(&9O<B!A
M;GD <'5R<&]S92P :6YC;'5D:6YG(&-O;6UE<F-I86P 87!P;&EC871I;VYS
M+`H)86YD('1O(&%L=&5R(&ET(&%N9"!R961I<W1R:6)U=&4 :70 9G)E96QY
M+"!S=6)J96-T('1O('1H92!F;VQL;W=I;F< <F5S=')I8W1I;VYS. H*"0DQ
M+B!4:&4 ;W)I9VEN(&]F('1H:7, <V]F='=A<F4 ;75S="!N;W0 8F4 ;6ES
M<F5P<F5S96YT960[('EO=2!M=7-T(&YO="!C;&%I;2!T:&%T('EO=2!W<F]T
M92!T:&4*"0EO<FEG:6YA;"!S;V9T=V%R92X 268 >6]U('5S92!T:&ES('-O
M9G1W87)E(&EN(&$ <')O9'5C="P 86X 86-K;F]W;&5D9VUE;G0 :6X =&AE
M('!R;V1U8W0*"0ED;V-U;65N=&%T:6]N('=O=6QD(&)E(&%P<')E8VEA=&5D
M(&)U="!I<R!N;W0 <F5Q=6ER960N" H)"3(N($%L=&5R960 <V]U<F-E('9E
M<G-I;VYS(&UU<W0 8F4 <&QA:6YL>2!M87)K960 87, <W5C:"P 86YD(&UU
M<W0 ;F]T(&)E(&UI<W)E<')E<V5N=&5D(&%S(&)E:6YG('1H90H)"6]R:6=I
M;F%L('-O9G1W87)E+ H*"0DS+B!4:&ES(&YO=&EC92!M87D ;F]T(&)E(')E
M;6]V960 ;W( 86QT97)E9"!F<F]M(&%N>2!S;W5R8V4 9&ES=')I8G5T:6]N
M+ HJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ
M*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ
:*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ*BHJ+PH*" HJ
`
end
Aug 01 2004
next sibling parent reply "Jarrett Billingsley" <kb3ctd2 yahoo.com> writes:
hungarian notation must die!  ;)

i hate to say it but your style annoys me.  my style would probably be as
equally annoying to you.  which is why i never really saw the point in
universal coding styles, unless there are several people working on the same
project!
Aug 02 2004
parent Stewart Gordon <smjg_1998 yahoo.com> writes:
Jarrett Billingsley wrote:


 hungarian notation must die!  ;)
 
 i hate to say it but your style annoys me.  my style would probably be as
 equally annoying to you.  which is why i never really saw the point in
 universal coding styles, unless there are several people working on the same
 project!


My department doesn't seem to be able to agree on a style.  Maybe it's 
time to get together.  The only trouble is that there are different code 
editors around - those that use tabs and those (Emacs) that indent by 
two spaces.  And some of the others' styles are already abominable to 
me.  Like economising on spaces, and making every blank like a comment....

(This is in Fortran 90 - it appears that the one bit of coding style in 
the department is to use this!)

Stewart.

-- 
My e-mail is valid but not my primary mailbox.  Please keep replies on 
the 'group where everyone may benefit.
Aug 02 2004
prev sibling parent Andy Friesen <andy ikagames.com> writes:
clayasaurus wrote:

 Hello. I've been working on a project and something that is setting me back
 is to have a good consistent style to code with. 
 
 I've created a style guide for myself and am posting it here for comments
 and critiques. 
 
 Some of you will have differing opinions on things which may be constructive.
 Also, I'm open to any additional ideas.
 
 Thanks all for your time


Bear in mind that this is all purely subjective.  Sticking with a 
standard is more important than what precise standard is used.

So...

I *hate*, loathe, despise, and abhor (in that precise order, no less) 
variable decorations of all description.  Variable names should be 
unique, beautiful little snowflakes.  In particular, locals and 
parameters are never used far from their declaration anyway.

Structs are basically useful for three things: communication with C, 
value type semantics, and as a speed hack.  (remember the first rule of 
optimization: /Don't/)

Keep in mind that the public interface of a class is going to be 
referred to quite a lot more than its internals: put private things at 
the end, public at the top.

And most importantly:

Break your own rules if there's a good enough reason to.  The entire 
point is to write code that's easy to read.

  -- andy
Aug 02 2004