SPF4 src styling

4 messages Options
Embed this post
Permalink
Ruvim Pinka

SPF4 src styling

Reply Threaded More More options
Print post
Permalink
Привет всем!

В SPF4 сложился определенный стиль исходников, прошу по возможности
поддерживать его в пределах каталога src.
В частности, ";" обычно располагается на отдельной строке, или в той
же строке, где и имя.

Собственный опыт: меня часто напрягает пунктуация си-подобных языков.
Например, запятая, как разделитель элементов списка, — делает один
элемент (первый или последний) особым с точки зрения генерации текста:
он не имеет своей запятой, в отличии от остальных. Стоит переставить
строки местами, что-то добавить, и эта иррегулярность вылезает боком.
Эти запятые — самая частая запинка при модификации SQL-запросов и
причина путанных довесков в код, генерирующий такие списки. В XSL
обычно используется просто пробельный символ в перечислениях. В Ruby
для этого используется запятая, но, меня очень порадовало, что
"лишнюю" запятую в конце списка он воспринимает как опциональную,
позволяя создавать регулярный код. Значит, далеко не только меня
достает иррегулярность этой "глупой" пунктуации ;)

Собственно говоря, к чему я это. Особое слово ";" в конце последней
строки кода определения делает эту строку особой, отличающейся от
остальных строк в определении, тем самым нарушая их регулярность и
мешая поддержке. Многим западным фортерам такой стиль почему-то
нравится.

--
Ruvim
Aleksej Saushev

Re: SPF4 src styling

Reply Threaded More More options
Print post
Permalink
  Здравствуй!

"Ruvim Pinka" <[hidden email]> writes:

> Привет всем!
>
> В SPF4 сложился определенный стиль исходников, прошу по возможности
> поддерживать его в пределах каталога src.
> В частности, ";" обычно располагается на отдельной строке, или в той
> же строке, где и имя.
>
> Собственный опыт: меня часто напрягает пунктуация си-подобных языков.
> Например, запятая, как разделитель элементов списка, — делает один
> элемент (первый или последний) особым с точки зрения генерации текста:
> он не имеет своей запятой, в отличии от остальных. Стоит переставить
> строки местами, что-то добавить, и эта иррегулярность вылезает боком.
> Эти запятые — самая частая запинка при модификации SQL-запросов и
> причина путанных довесков в код, генерирующий такие списки. В XSL
> обычно используется просто пробельный символ в перечислениях. В Ruby
> для этого используется запятая, но, меня очень порадовало, что
> "лишнюю" запятую в конце списка он воспринимает как опциональную,
> позволяя создавать регулярный код. Значит, далеко не только меня
> достает иррегулярность этой "глупой" пунктуации ;)
>
> Собственно говоря, к чему я это. Особое слово ";" в конце последней
> строки кода определения делает эту строку особой, отличающейся от
> остальных строк в определении, тем самым нарушая их регулярность и
> мешая поддержке. Многим западным фортерам такой стиль почему-то
> нравится.

По-моему, это просто надуманно. Терять лишнюю строку на
завершение слова вообще просто неразумно, тем более, что от
этого страдает читаемость кода, поскольку код получается более
рыхлым.  А отсылки на Ruby вообще не показательны, при некотором
желании закрывающую скобку тоже можно сделать необязательной,
и не только закрывающую скобку.

Да и ссылка на какую-то "регулярность"!
Чем удаление пробела и вставка перевода строки в конце каждого
определения её увеличивает?

Кстати, о "западном" стиле. Читать западный код на порядок
удобнее именно из-за стиля, там реже встречаются повторяющиеся
столбцы "HERE SWAP DUP ALLOT MOVE 0 C," и поддерживается
грамотный человеческий стиль написания определений, когда точка
ставится в конце предложения, а не отделена от него переводом
строки.  Я думаю, что постоянный "довесок" к коду, создающему
списки появляется из-за того же, из-за чего появляются столбцы
"HERE SWAP DUP ALLOT MOVE 0 C," - это не "Forth style".
Ruvim Pinka

Re: SPF4 src styling

Reply Threaded More More options
Print post
Permalink
On 4/2/07, Aleksej Saushev <[hidden email]> wrote:

> > В SPF4 сложился определенный стиль исходников, прошу по возможности
> > поддерживать его в пределах каталога src.

> По-моему, это просто надуманно. Терять лишнюю строку на
> завершение слова вообще просто неразумно,

Алексей, я прошу лишь о каталоге src SPF4. У каждого автора свой
стиль, и это хорошо. А у каталога src тоже свой сложившийся давно
стиль, я призываю (соавторов ядра SPF4, к вам это пока отношения не
имеет) его поддерживать, чтобы там не было разброда стилей.


--
Ruvim
yGREK Heretix

Re: SPF4 src styling

Reply Threaded More More options
Print post
Permalink
In reply to this post by Ruvim Pinka

> В SPF4 сложился определенный стиль исходников, прошу по возможности
> поддерживать его в пределах каталога src.
> В частности, ";" обычно располагается на отдельной строке, или в той
> же строке, где и имя.

Ок. Исправил.

--
ygrek


attachment0 (187 bytes) Download Attachment