Как вывести многострочную строку в Bash?

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

echo "usage: up [--level <n>| -n <levels>][--help][--version]"
echo 
echo "Report bugs to: "
echo "up home page: "

Я ищу портативный способ сделать это, используя только встроенные функции Bash.

Здесь документы часто используются для этой цели.

cat << EOF
usage: up [--level <n>| -n <levels>][--help][--version]

Report bugs to: 
up home page:
EOF

Они поддерживаются во всех оболочках Bourne, включая все версии Bash.

или вы можете сделать это:

echo "usage: up [--level <n>| -n <levels>][--help][--version]

Report bugs to: 
up home page: "

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

Во-первых, я определяю использование в переменной, что позволяет мне использовать его в разных контекстах. Формат очень прост, почти WYSIWYG, без необходимости добавлять какие-либо управляющие символы. Это кажется мне достаточно портативным (я запускал его на MacOS и Ubuntu)

__usage="
Usage: $(basename $0) [OPTIONS]

Options:
  -l, --level <n>              Something something something level
  -n, --nnnnn <levels>         Something something something n
  -h, --help                   Something something something help
  -v, --version                Something something something version
"

Тогда я могу просто использовать его как

echo "$__usage"

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

levelN=${2:?"--level: n is required!""${__usage}"}

Используйте -eопцию, тогда вы можете напечатать символ новой строки \nв строке.

Образец (но не уверен, хороший ли он или нет)

Самое интересное, что этот -eпараметр не задокументирован на справочной странице MacOS, но все еще доступен для использования. Это задокументировано на странице руководства Linux .

Поскольку я рекомендовал printfв комментарии, я, вероятно, должен привести несколько примеров его использования (хотя для печати сообщения об использовании я бы с большей вероятностью использовал ответы Денниса или Криса). printfнемного сложнее в использовании, чем echo. Его первый аргумент - это строка формата, в которой экранирование (например \n) всегда интерпретируется; он также может содержать директивы формата, начиная с %которых, которые определяют, где и как любые дополнительные аргументы включаются в него. Вот два разных подхода к его использованию для сообщения об использовании:

Во-первых, вы можете включить все сообщение в строку формата:

printf "usage: up [--level <n>| -n <levels>][--help][--version]\n\nReport bugs to: \nup home page: \n"

Обратите внимание, что в отличие от этого echo, вы должны явно указывать заключительный символ новой строки. Кроме того, если сообщение содержит какие-либо %символы, они должны быть записаны как %%. Если вы хотите включить адреса отчетов об ошибках и домашнюю страницу, их можно добавить совершенно естественно:

printf "usage: up [--level <n>| -n <levels>][--help][--version]\n\nReport bugs to: %s\nup home page: %s\n" "$bugreport" "$homepage"

Во-вторых, вы можете просто использовать строку формата, чтобы она выводила каждый дополнительный аргумент в отдельной строке:

printf "%s\n" "usage: up [--level <n>| -n <levels>][--help][--version]" "" "Report bugs to: " "up home page: "

С этой опцией добавление адресов багрепорта и домашней страницы довольно очевидно:

printf "%s\n" "usage: up [--level <n>| -n <levels>][--help][--version]" "" "Report bugs to: $bugreport" "up home page: $homepage"

Также с отступом исходного кода вы можете использовать <<-(с завершающей чертой), чтобы игнорировать ведущие вкладки (но не ведущие пробелы). Например это:

if [ some test ]; then
    cat <<- xx
        line1
        line2
xx
fi

Выводит текст с отступом без начальных пробелов:

line1
line2

Если вы используете решение из @jorge и обнаружите, что все в одной строке, убедитесь, что вы заключили переменную в кавычки:

echo $__usage

будет печатать все в одной строке, тогда как

echo "$__usage"

сохранит новые строки.