You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Nie mamy spisanych zasad dla Makefile, i wyłapałem właśnie w review kilka kosmetycznych problemów, których można by łatwo uniknąć, więc proponuję dodać kilka zasad do wiki:
Spacje i wcięcia
W Makefile używamy spacji poza przypadkami, gdzie taby są wymagane składniowo.
Taby wymagane są jedynie wewnątrz definicji targetów.
Wcięcia powinny mieć długość 4 spacji (jak w całej reszcie naszego kodu).
Przykład
Miejsca gdzie wystepują taby zastąpione zostały znakami »»»».
Ten wariant jest dozwolony w sytuacjach gdy edytor nie pozwala nam łatwo wyrównać kontynuacji albo gdy edytujemy w sytuacji gdy znaki nie mają stałej szerokości.
Wariant pierwszy jest mimo wszystko mocno preferowany.
Kontynuacje linijek dodają trochę zbędnego wizualnego szumu do definicji, a większość edytorów spokojnie poradzi sobie z wygodną edycją wariantu 1.
... ale nie aż tyle, żeby odstępy były schowane poza krawędzią ekranu.
Granica nie jest sztywno określona - po prostu w razie wątpliwości lepiej dać mniejszy odstęp niż większy.
\ po powoduje po prostu sklejenie ze sobą kolejnych linijek, bez żadnej spacji między nimi. Żeby uniknąć uzyskana jednego, długiego ciągu znaków, bez żadnych przerw musimy sami zadbać, aby dodać jakiś odstęp. Samo wcięcie już ten odstęp zapewnia, ale są sytuacje w których kolejne linijki nie mają wcięcia. Z tego powodu dobrze jest zadbać żeby mimo wszystko zawsze tuż przed znakiem \ była co najmniej jedna spacja. Poprawia to też trochę czytelność.
The text was updated successfully, but these errors were encountered:
Nie mamy spisanych zasad dla
Makefile
, i wyłapałem właśnie w review kilka kosmetycznych problemów, których można by łatwo uniknąć, więc proponuję dodać kilka zasad do wiki:Spacje i wcięcia
Makefile
używamy spacji poza przypadkami, gdzie taby są wymagane składniowo.Przykład
Miejsca gdzie wystepują taby zastąpione zostały znakami
»»»»
.Kontynuacje linii
Preferowane:
Ten wariant jest najczytelniejszy i zalecany.
Dozwolone:
Ten wariant jest dozwolony w sytuacjach gdy edytor nie pozwala nam łatwo wyrównać kontynuacji albo gdy edytujemy w sytuacji gdy znaki nie mają stałej szerokości.
Wariant pierwszy jest mimo wszystko mocno preferowany.
Kontynuacje linijek dodają trochę zbędnego wizualnego szumu do definicji, a większość edytorów spokojnie poradzi sobie z wygodną edycją wariantu 1.
Dozwolone:
Aby uniknąć zbyt częstego przesuwania kontynuacji można dodać trochę więcej odstępu...
Zabronione:
... ale nie aż tyle, żeby odstępy były schowane poza krawędzią ekranu.
Granica nie jest sztywno określona - po prostu w razie wątpliwości lepiej dać mniejszy odstęp niż większy.
Zabronione:
Wszystkie kontynuacje powinny być na tym samym poziomie. Powinny też być wyrównane wyłącznie za pomocą spacji.
Zabronione:
\
po powoduje po prostu sklejenie ze sobą kolejnych linijek, bez żadnej spacji między nimi. Żeby uniknąć uzyskana jednego, długiego ciągu znaków, bez żadnych przerw musimy sami zadbać, aby dodać jakiś odstęp. Samo wcięcie już ten odstęp zapewnia, ale są sytuacje w których kolejne linijki nie mają wcięcia. Z tego powodu dobrze jest zadbać żeby mimo wszystko zawsze tuż przed znakiem\
była co najmniej jedna spacja. Poprawia to też trochę czytelność.The text was updated successfully, but these errors were encountered: