¿Cómo generar una cadena multilínea en Bash?

¿Cómo puedo generar una cadena de varias líneas en Bash sin usar múltiples llamadas de eco de esta manera?

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

Estoy buscando una forma portátil de hacer esto, usando solo los componentes integrados de Bash.

Aquí los documentos se utilizan a menudo para este propósito.

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

Report bugs to: 
up home page:
EOF

Se admiten en todos los shells derivados de Bourne, incluidas todas las versiones de Bash.

o puedes hacer esto:

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

Report bugs to: 
up home page: "

Inspirado por las respuestas perspicaces de esta página, creé un enfoque mixto, que considero el más simple y flexible. ¿Qué piensas?

Primero, defino el uso en una variable, lo que me permite reutilizarlo en diferentes contextos. El formato es muy simple, casi WYSIWYG, sin la necesidad de agregar ningún carácter de control. Esto me parece razonablemente portátil (lo ejecuté en MacOS y 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
"

Entonces simplemente puedo usarlo como

echo "$__usage"

o incluso mejor, cuando analizo los parámetros, puedo repetirlo allí en una sola línea:

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

Use la -eopción, luego puede imprimir un nuevo carácter de línea \nen la cadena.

Muestra (pero no estoy seguro si es buena o no)

Lo divertido es que esa -eopción no está documentada en la página de manual de MacOS mientras todavía se puede usar. Está documentado en la página del manual de Linux .

Como recomendé printfen un comentario, probablemente debería dar algunos ejemplos de su uso (aunque para imprimir un mensaje de uso, es más probable que use las respuestas de Dennis o Chris). printfes un poco más complejo de usar que echo. Su primer argumento es una cadena de formato, en la que los escapes (como \n) siempre se interpretan; también puede contener directivas de formato que comienzan con %, que controlan dónde y cómo se incluyen argumentos adicionales. Aquí hay dos enfoques diferentes para usarlo para un mensaje de uso:

Primero, puede incluir el mensaje completo en la cadena de formato:

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

Tenga en cuenta que echo, a diferencia , debe incluir la nueva línea final explícitamente. Además, si el mensaje contiene %caracteres, deberían escribirse como %%. Si desea incluir el informe de errores y las direcciones de la página de inicio, se pueden agregar de forma natural:

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

En segundo lugar, puede usar la cadena de formato para que imprima cada argumento adicional en una línea separada:

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

Con esta opción, agregar el informe de errores y las direcciones de la página de inicio es bastante obvio:

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

También con el código fuente sangrado puede usar <<-(con un guión final) para ignorar las pestañas iniciales (pero no los espacios iniciales). Por ejemplo esto:

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

Produce texto sangrado sin el espacio en blanco inicial:

line1
line2

Si usa la solución de @jorge y encuentra que todo está en la misma línea, asegúrese de incluir la variable entre comillas:

echo $__usage

imprimirá todo en una línea mientras que

echo "$__usage"

retendrá las nuevas líneas.