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


         

пробела или новая строка


----------------------------------------------------------------
1 пробел между : и именем 2 пробела между именем и его комментарием * 2 пробела или новая строка после комментария до тела определения * 3 пробела между именем и телом определения, если комментарии не используются 1 пробел между словами/числами внутри фразы 2 или 3 пробела между фразами 1 пробел между последним словом и ; 1 пробел между ; и IMMEDIATE (при необходимости)
Не ставить пустых строк между определениями, кроме случаев разграничения существенных групп определений.
* `Часто наблюдаемая альтернатива - 1 пробел между именем и комментарием и 3 - между комментарием и определением. Более либеральный подход использует по 3 пробела до и после комментария. Что бы Вы ни выбрали, твердо этого придерживайтесь.`
Последняя позиция в каждой строке должна быть пуста, кроме случаев, когда:
а) надписи в кавычках продолжаются на следующую строку, или б) это - конец комментария.
Комментарий, начинающийся с \, может продолжаться до правого конца строки. Комментарии, начинающиеся с (, могут также иметь ограничительную ) в последней позиции строки.
Вот некоторые частые ошибки при выполнении отступов и пропусков:
`Плохо` (имя не отделено от тела определения):
: ТОЛКАТЬ ВЗЯТЬСЯ НАЛЕЧЬ ;
`Хорошо:`
: ТОЛКАТЬ ВЗЯТЬСЯ НАЛЕЧЬ ;
`Плохо` (последовательные строки без отступа в три пробела):
: СЛАВА ( то-что-никогда-не-померкнет -- ) НЕ МЕРКНУТЬ НИКОГДА ;
`Хорошо:`
: СЛАВА ( то-что-никогда-не-померкнет -- ) НЕ МЕРКНУТЬ НИКОГДА ;
`Плохо` (нет разбиения на фразы):
: ГЕТТИСБУРГ 4 СЧЕТ 7 ЛЕТ + НАЗАД ;
`Хорошо:`
: ГЕТТИСБУРГ 4 СЧЕТ 7 ЛЕТ + НАЗАД ;
Разбиение на фразы - искуство субъективное; я затрудняюсь предлагать какие-нибудь формальные правила.
СОГЛАШЕНИЯ ПО КОММЕНТАРИЯМ
Правильное составление комментариев обязательно. Имеются пять типов комментариев: комментарии по состоянию стека, по структуре данных, по входному потоку, по цели и повествовательные комментарии.
`Комментарий по стеку` показывает, какие аргументы определение берет со стека, а какие возвращает на стеке (если такие есть).

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





Forekc.ru
Рефераты, дипломы, курсовые, выпускные и квалификационные работы, диссертации, учебники, учебные пособия, лекции, методические пособия и рекомендации, программы и курсы обучения, публикации из профильных изданий