[so] [Tema 1][General] Sfaturi Coding Style

[Paul Olaru]

2. Funcțiile pe care le folosești într-un singur fișier .c și care nu sunt
interesante celorlalte se fac statice. Restul nu.
6, 7. N-ar trebui să fie neapărat o problemă. Pentru Git e important însă
să dai acces responsabililor, altfel degeaba îl faci. Se recomandă
folosirea structurii de foldere preexistente din repo.

On Wed, Mar 13, 2019, 14:03 Ioan-Florin-Cătălin NIŢU (87674) via so <
so at cursuri.cs.pub.ro> wrote:

> Salut,
>
> Am câteva nelămuriri și întrebări legate de coding style:
>
> 1. Am vazut că în headerul cu funcția compare se folosea #ifndef
> __COMPARE_H_, așa că pentru consecvență si eu mi-am făcut la fel
> define-urile pentru bibliotecile mele (#ifndef __UTILS_H_ de exemplu), dar
> am citit că acest lucru nu e recomandat. Să schimb peste tot (să dau drop
> la __) sau să las așa?
>
> 2. Când știu ce funcții să fac statice? Și cum le organizez în headere?
> Dacă declar o funcție static trebuie să o scriu neaparat in header, dar eu
> nu vreau asta. In headere aș vrea să păstrez doar prototipul funcțiilor.
> Cum e recomandat sa lucrez?
>
> 3. În implementare am folosit ceva gen struct smt *s =
> malloc(sizeof(struct smt)); pot lasă așa sau o să fiu penalizat la notare?
> (nu aș schimba în tot codul să pun struct smt *s = malloc(sizeof(*s)); dar
> dacă e nevoie o fac).
>
> 4. In Kernel coding style am citit că e recomandat să se scrie despre
> fiecare variabila folosită câteva cuvinte, sper ca e okay daca am facut
> asta. Printre altele am pus și #endif /* __UTILS_H */ pentru include-uri,
> tot din recomandari.
>
> 5. Este okay dacă am folosit typedef pentru structuri? Știu că în
> documentația de la Kernel spune că nu e recomandat, dar având în vedere
> scopul temei mi s-a părut mai usor de înțeles/utilizat/lucra așa. Pe viitor
> am să fiu mai atent la abordare.
>
> 6. Este okay dacă scriu README-ul în română? (comentariile din cod le-am
> pus in engleză, dar aș prefera să scriu README-ul în română).
>
> 7. Deși nu are neapărat legătură cu coding style, dacă nu am lucrat pe git
> cu tema, pot să fac un repo simplu în care să pun doar sursele mele și
> atât? Sau să copiez repo-ul vostru și pentru fiecare temă să îmi mai fac eu
> un folder separat de fișierele voastre în care să îmi pun sursele și
> celelalte fișiere utile?
>
> Intreb aceste lucruri pentru ca nu am erori de checkstyle care să mă ajute
> să imi rezolv singur problemele și aș vrea să scap de ambiguități.
>
> Mulțumesc frumos și imi cer scuze de deranj. Știu că poate par puerile
> intrebările mele dar aș vrea să știu cum să procedez.
>
> Seara frumoasa,
>
> Cătălin
> _______________________________________________
> http://ocw.cs.pub.ro/courses/so/info/lista-discutii
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://cursuri.cs.pub.ro/pipermail/so/attachments/20190313/f9153d6c/attachment-0001.html>