Jak wyprowadzić ciąg multilinii w Bash?

Jak mogę wyprowadzić wieloliniowy ciąg w Bash bez używania wielu wywołań echa, takich jak:

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

Szukam przenośnego sposobu, aby to zrobić, używając tylko wbudowanych wersji Bash.

Tutaj dokumenty są często wykorzystywane do tego celu.

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

Report bugs to: 
up home page:
EOF

Są obsługiwane we wszystkich powłokach pochodnych Bourne'a, w tym we wszystkich wersjach Bash.

lub możesz to zrobić:

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

Report bugs to: 
up home page: "

Zainspirowany wnikliwymi odpowiedziami na tej stronie stworzyłem podejście mieszane, które uważam za najprostsze i bardziej elastyczne. Co myślisz?

Po pierwsze, definiuję użycie w zmiennej, co pozwala mi na ponowne użycie w różnych kontekstach. Format jest bardzo prosty, prawie WYSIWYG, bez potrzeby dodawania żadnych znaków kontrolnych. Wydaje mi się to dość przenośne (uruchomiłem to na MacOS i 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
"

Następnie mogę po prostu użyć go jako

echo "$__usage"

lub nawet lepiej, kiedy parsuję parametry, mogę po prostu echo tam w linijce:

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

Użyj -eopcji, aby wydrukować nowy znak wiersza ze znakiem \n.

Próbka (ale nie jestem pewien, czy jest dobry czy nie)

Zabawne jest to, że -eopcja ta nie jest udokumentowana na stronie podręcznika MacOS ale nadal jest użyteczna. Jest to udokumentowane na stronie man Linuksa .

Ponieważ zaleciłem printfw komentarzu, prawdopodobnie powinienem podać kilka przykładów jego użycia (chociaż w przypadku drukowania komunikatu o użytkowaniu chętniej skorzystam z odpowiedzi Dennisa lub Chrisa). printfjest nieco bardziej skomplikowany w użyciu niż echo. Pierwszym argumentem jest ciąg formatu, w którym znaki specjalne (jak \n) są zawsze interpretowane; może również zawierać dyrektywy formatujące zaczynające się od %, które kontrolują, gdzie i jak mają być uwzględnione dodatkowe argumenty. Oto dwa różne podejścia do używania go w komunikacie użytkowania:

Po pierwsze, możesz dołączyć całą wiadomość do ciągu formatu:

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

Zauważ, że w przeciwieństwie do tego echomusisz wyraźnie dołączyć ostatni znak nowej linii. Ponadto, jeśli wiadomość zawiera jakieś %znaki, należy je zapisać jako %%. Jeśli chcesz dołączyć raport o błędzie i adresy strony głównej, można je dodać całkiem naturalnie:

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

Po drugie, możesz po prostu użyć ciągu formatu, aby wydrukować każdy dodatkowy argument w osobnym wierszu:

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

Dzięki tej opcji dodanie raportu o błędzie i adresu strony głównej jest dość oczywiste:

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

Również z wciętym kodem źródłowym można użyć <<-(z końcowym myślnikiem), aby zignorować wiodące tabulatory (ale nie wiodące spacje). Na przykład to:

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

Wyświetla wcięty tekst bez wiodących białych znaków:

line1
line2

Jeśli skorzystasz z rozwiązania @jorge i stwierdzisz, że wszystko jest w tym samym wierszu, upewnij się, że umieściłeś zmienną w cudzysłowie:

echo $__usage

wypisze wszystko w jednym wierszu, podczas gdy

echo "$__usage"

zachowa nowe linie.