Готовый перевод bash Cookbook / bash: Сборник рецептов: A Note About Code Examples / Кратко о примерах кода

Когда мы хотим показать кусок исполняемого скрипта оболочки в этой книге, мы обычно помещаем его в область с отступами, вот так:

$ ls
a.out cong.txt def.conf file.txt more.txt zebra.list
$

Первый символ обычно знак доллара ($), который обозначает, что команда была напечатана в приглашении оболочки bash. (Помните, что вы можете поменять приглашение, как показано в Секции 16.2, "Изменяем Приглашение Системы", так что ваше приглашение может выглядеть совсем иначе.) Приглашение выводится оболочкой; вы печатаете оставшуюся часть строки. Так же последняя строка в примере часто приглашение (снова $), чтобы показать, что команда закончила выполнение и управление было возвращено оболочке.

Знак фунта или решетка (#) немного хитрее. В большинстве Uinx или Linux файлов, включая скрипты оболочки bash, решетка в начале строки обозначает комментарий и мы будем использовать его для этого в некоторых примерах кода. Но как символ окончания в приглашении оболочки bash (вместо $) знак решетки обозначает, что вы вошли в систему как root. У нас есть только один пример,в котором что-либо запускает пользователь root, так что это не должно вас запутать, но это важно для понимания.

Когда вы видите пример без строки приглашения, это означает, что мы показываем содержание скрипта оболочки. В нескольких больших примерах мы пронумеруем строки скрипта, тем не менее числа не будут являться частью скрипта.

Мы также можем изредка показывать примеры как запись сессии или серию команд. В некоторых случаях мы можем использовать команду cat для одного или нескольких файлов, для того, чтобы вы могли увидеть скрипт и/или данные, которые мы будем использовать в примерах или в результатах нашего действия.

$ cat data_file
static header line1
static header line2
1 foo
2 bar
3 baz

Множество длинных скриптов и функций доступны для скачивания. Подробнее об этом смотрите в конце Предисловия. Мы выбрали использование #!/usr/bin/env bash для этих примеров где это применимо, так как это более переносимый вариант, чем #!/bin/bash в Linux или Mac. Для подробностей сморите Раздел 15.1, "Нахождим bash Переносимо для #!".

Так же вы можете заметить в некоторых примерах кода что-то вроде этого:

# cookbook filename: snippet_name

Это означает, что код,который вы читаете доступен для скачивания с нашего сайта (http://www.bashcookbook.com). Архив (.tgz или .zip) документирован, однако вы найдете код в ./chXX/snippet_name, где chXX - глава, а snippet_name - имя файла.

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

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