Способ мышления-Форт



Глава 5. Разработка: элементы Форт-стиля - часть 14


----------------------------------------------------------------

1 пробел между : и именем 2 пробела между именем и его комментарием * 2 пробела или новая строка после комментария до тела определения * 3 пробела между именем и телом определения, если комментарии не используются 1 пробел между словами/числами внутри фразы 2 или 3 пробела между фразами 1 пробел между последним словом и ; 1 пробел между ; и IMMEDIATE (при необходимости)

Не ставить пустых строк между определениями, кроме случаев разграничения существенных групп определений.

* `Часто наблюдаемая альтернатива - 1 пробел между именем и комментарием и 3 - между комментарием и определением. Более либеральный подход использует по 3 пробела до и после комментария. Что бы Вы ни выбрали, твердо этого придерживайтесь.`

Последняя позиция в каждой строке должна быть пуста, кроме случаев, когда:

а) надписи в кавычках продолжаются на следующую строку, или б) это - конец комментария.

Комментарий, начинающийся с \, может продолжаться до правого конца строки. Комментарии, начинающиеся с (, могут также иметь ограничительную ) в последней позиции строки.

Вот некоторые частые ошибки при выполнении отступов и пропусков:

`Плохо` (имя не отделено от тела определения):

: ТОЛКАТЬ ВЗЯТЬСЯ НАЛЕЧЬ ;

`Хорошо:`

: ТОЛКАТЬ ВЗЯТЬСЯ НАЛЕЧЬ ;

`Плохо` (последовательные строки без отступа в три пробела):

: СЛАВА ( то-что-никогда-не-померкнет -- ) НЕ МЕРКНУТЬ НИКОГДА ;

`Хорошо:`

: СЛАВА ( то-что-никогда-не-померкнет -- ) НЕ МЕРКНУТЬ НИКОГДА ;

`Плохо` (нет разбиения на фразы):

: ГЕТТИСБУРГ 4 СЧЕТ 7 ЛЕТ + НАЗАД ;

`Хорошо:`

: ГЕТТИСБУРГ 4 СЧЕТ 7 ЛЕТ + НАЗАД ;

Разбиение на фразы - искуство субъективное; я затрудняюсь предлагать какие-нибудь формальные правила.

СОГЛАШЕНИЯ ПО КОММЕНТАРИЯМ

Правильное составление комментариев обязательно. Имеются пять типов комментариев: комментарии по состоянию стека, по структуре данных, по входному потоку, по цели и повествовательные комментарии.

`Комментарий по стеку` показывает, какие аргументы определение берет со стека, а какие возвращает на стеке (если такие есть).




Содержание  Назад  Вперед