Готовый перевод sed & awk / sed & awk: 5.2 Комментарии

Вы можете использовать комментарии для документации скрипта и описания его возможностей. Начиная с этой главы, наши полные скрипты будут начинаться с комментария. Строка комментария может быть первой строкой в скрипте. В System V версии sed комментарии разрешены только на первой строке. В некоторых версиях, влючая sed на SunOS 4.1.x и GNU sed, можно помещать комментарии в любую часть скрипта, даже в строку после команды. Примеры в этой книге будут следовать более строгому случаю Systev V sed, ограничивая комментарии первой строкой скрипта. Как правило, возможность использовать комментарии для документации скрипта очень ценна и Вам следует ее использовать, если Ваша версия sed это позволяет.

Знак решетки (#) должен быть первым символом строки. Синтаксис комментария следующий:

#[n]

Следующий пример демонстрирует первую строку скрипта:

# wstar.sed: convert WordStar files

Если необходимо, то комментарии могут быть продолжены на несколько строк, добавив в конце строки бекслеш. [2] Для согласованности, Вы можете начинать следующую строку с #, тем самым назначение строки будет очевидным.

[2] Это не работает в GNU sed (версия 2.0.5).

Если следущий символ после # n, то скрипт не будет автоматически производить вывод. Это эквивалентно указанию опции -n в коммандной строке. Остальная часть строки после n, рассматривается как комментарий. По стандартам POSIX, #n должны быть первыми двумя символами в файле.

Внимание! Этот перевод, возможно, ещё не готов.
Его статус: перевод редактируется

Переведено на Нотабеноиде
http://notabenoid.org/book/32181/135456

Переводчики: r0mk