Comment sortir une chaîne multiligne dans Bash?

Comment puis-je sortir une chaîne multipline dans Bash sans utiliser plusieurs appels d'écho comme ceci:

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

Je suis à la recherche d'un moyen portable de le faire, en utilisant uniquement les modules internes Bash.

Ici, les documents sont souvent utilisés à cette fin.

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

Report bugs to: 
up home page:
EOF

Ils sont pris en charge dans tous les shells dérivés de Bourne, y compris toutes les versions de Bash.

ou vous pouvez le faire:

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

Report bugs to: 
up home page: "

Inspiré par les réponses perspicaces de cette page, j'ai créé une approche mixte, que je considère comme la plus simple et la plus flexible. Qu'est-ce que tu penses?

Tout d'abord, je définis l'utilisation dans une variable, ce qui me permet de la réutiliser dans différents contextes. Le format est très simple, presque WYSIWYG, sans avoir besoin d'ajouter de caractères de contrôle. Cela me semble raisonnablement portable (je l'ai exécuté sur MacOS et 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
"

Ensuite, je peux simplement l'utiliser comme

echo "$__usage"

ou encore mieux, lors de l'analyse des paramètres, je peux simplement y faire écho dans une ligne:

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

Utilisez l' -eoption, puis vous pouvez imprimer un nouveau caractère de ligne avec \ndans la chaîne.

Échantillon (mais je ne sais pas s'il est bon ou non)

Ce qui est amusant, c'est que cette -eoption n'est pas documentée dans la page de manuel de MacOS alors qu'elle est toujours utilisable. Il est documenté dans la page de manuel de Linux .

Comme je l'ai recommandé printfdans un commentaire, je devrais probablement donner quelques exemples de son utilisation (bien que pour imprimer un message d'utilisation, je serais plus susceptible d'utiliser les réponses de Dennis ou Chris). printfest un peu plus complexe à utiliser que echo. Son premier argument est une chaîne de format, dans laquelle les échappements (comme \n) sont toujours interprétés; il peut également contenir des directives de format commençant par %, qui contrôlent où et comment tous les arguments supplémentaires y sont inclus. Voici deux approches différentes pour l'utiliser pour un message d'utilisation:

Tout d'abord, vous pouvez inclure l'intégralité du message dans la chaîne de format:

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

Notez que contrairement à echo, vous devez inclure explicitement la nouvelle ligne finale. De plus, si le message contient des %caractères, ils doivent être écrits sous la forme %%. Si vous souhaitez inclure les adresses de rapport de bug et de page d'accueil, vous pouvez les ajouter tout naturellement:

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

Deuxièmement, vous pouvez simplement utiliser la chaîne de format pour lui faire imprimer chaque argument supplémentaire sur une ligne distincte:

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

Avec cette option, l'ajout des adresses de rapport de bogue et de page d'accueil est assez évident:

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

De plus, avec le code source en retrait, vous pouvez utiliser <<-(avec un tiret de fin) pour ignorer les tabulations en tête (mais pas les espaces en tête). Par exemple ceci:

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

Génère du texte en retrait sans le premier espace blanc:

line1
line2

Si vous utilisez la solution de @jorge et constatez que tout est sur la même ligne, assurez-vous de placer la variable entre guillemets:

echo $__usage

imprimera tout sur une seule ligne alors que

echo "$__usage"

conservera les nouvelles lignes.