Script styles
[1/6] from: andrew:martin:colenso:school at: 24-Dec-2003 22:45
Volker wrote (in another thread):
> Hmm, eventually rebol.org could mark RT-style-scripts so people can
look up "official" examples when in doubt?
Perhaps this could be a declaration in the header? For example:
Style: 'Rebol-Official
People who prefer different styles could then propose different style
standards which they think might be better or just different, like:
Style: 'Cobol-Like
Style: 'Natural
Style: none
Style: Andrew ; :)
After all, with out variation in style, how can it improve?
What do people think?
Andrew J Martin
Attendance Officer
High-Evolutionary.
Colenso High School
Arnold Street, Napier.
Tel: 64-6-8310180 ext 826
Fax: 64-6-8336759
http://colenso.net/scripts/Wiki.r?AJM
http://www.colenso.school.nz/
DISCLAIMER: Colenso High School and its Board of Trustees is not responsible (or legally
liable) for materials distributed to or acquired from user e-mail accounts. You can report
any
misuse of an e-mail account to our ICT Manager and the complaint will be investigated.
(Misuse can come in many forms, but can be viewed as any material sent/received that
indicate or suggest pornography, unethical or illegal solicitation, racism, sexism, inappropriate
language and/or other issues described in our Acceptable Use Policy.)
All outgoing messages are certified virus-free by McAfee GroupShield Exchange 5.10.285.0
Phone: +64 6 843 5095 or Fax: +64 6 833 6759 or E-mail: [postmaster--colenso--school--nz]
[2/6] from: tim:johnsons-web at: 9-Nov-2003 17:46
* Andrew Martin <[andrew--martin--colenso--school--nz]> [031109 17:09]:
> Volker wrote (in another thread):
> > Hmm, eventually rebol.org could mark RT-style-scripts so people can
<<quoted lines omitted: 7>>
> Style: none
> Style: Andrew ; :)
IMHO, the most important part of any style is that it be consistent.
Different programmers have different needs and work in different
venues. I for instance program also in python, and I like a style
that (sort of) emulates python block outline approach, so I like
to indent block delimiters, which differs from pretty-print.
I think that the cobol-like (or lisp-or-scheme-like) approach is one
of the most readable. *However* I might divert from that when I am
working with mysql, because then I like to use underscores, since
I am likely to want to use rebol words that use the same characters
acceptable to mysql column naming convention.
Pragmatism trumps arbitrary convention and there are pretty-print
scripts out there, right?
tim
> After all, with out variation in style, how can it improve?
> What do people think?
<<quoted lines omitted: 18>>
> To unsubscribe from this list, just send an email to
> [rebol-request--rebol--com] with unsubscribe as the subject.
--
Tim Johnson <[tim--johnsons-web--com]>
http://www.alaska-internet-solutions.com
[3/6] from: lmecir:mbox:vol:cz at: 11-Nov-2003 18:41
Hi Andrew,
>Volker wrote (in another thread):
>>Hmm, eventually rebol.org could mark RT-style-scripts so people can
<<quoted lines omitted: 11>>
>After all, with out variation in style, how can it improve?
>What do people think?
Sorry, I don't like this idea.
-L
[4/6] from: maximo:meteorstudios at: 11-Nov-2003 12:56
> -----Original Message-----
> From: Ladislav Mecir [mailto:[lmecir--mbox--vol--cz]]
<<quoted lines omitted: 8>>
> >
> Sorry, I don't like this idea.
I second the motion.
there is a style guide and anyone should at least try to make their shared code similar
to it, if he is sharing code at large. I know many programmers have extensive backgrounds(habits)
in other languages which make it harder to adapt their reflexed coding habits to a different
form, but it does make your code more usefull in any case if it looks similar enough
so that others can read it without squinting.
enabling a feature that goes against the style guide defeats its purpose.
-MAx
[5/6] from: tim:johnsons-web at: 11-Nov-2003 10:43
* Maxim Olivier-Adlhoch <[maximo--meteorstudios--com]> [031111 09:39]:
> > -----Original Message-----
> > From: Ladislav Mecir [mailto:[lmecir--mbox--vol--cz]]
<<quoted lines omitted: 18>>
> different form, but it does make your code more usefull in any case if
> it looks similar enough so that others can read it without squinting.
I agree whole-heartedly. Even tho' I don't like to use rebol' pretty-print
myself, I would certainly follow whatever guidlines that were agreed
upon for a library/resource submission. And I believe that Carl has
written a pretty-printify script that could take care of that...
And I'm really in favor of docstrings.
MTCW
tim
> enabling a feature that goes against the style guide defeats its purpose.
>
> -MAx
>
> --
> To unsubscribe from this list, just send an email to
> [rebol-request--rebol--com] with unsubscribe as the subject.
--
Tim Johnson <[tim--johnsons-web--com]>
http://www.alaska-internet-solutions.com
[6/6] from: nitsch-lists:netcologne at: 11-Nov-2003 21:20
When proposing RT-style-marks i meant not only indentation,
but names, style of modularisation and such too.
Start with Carls scripts as typical and mark such which are
styled similar.
Its not meant to be a dogma, but to get a "typical use".
So if i where in doubt about
zipzap: func[str][]
zipzap: func[str[string!]][]
i could read some RT-style-examples and see in wich cases Carl adds
argument-types. or how he does error-handling. or something.
I think everyone can have its own style. But peoples searching style should
learn it from RT-examples first. and have some help to decide "is it RT or
not?" so the flag.
-Volker
Am Dienstag, 11. November 2003 18:41 schrieb Ladislav Mecir:
Notes
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted