multilinea bash commento etiquette (# +)

Question

Il Advanced Bash-Scripting Guide fa ampio uso di commenti su più righe negli esempi, nella forma:

echo ls -l | sh 
# Passes the output of "echo ls -l" to the shell, 
#+ with the same result as a simple "ls -l". 

(trovato nella spiegazione per il tubo | simbolo). Altri commenti multilinea sono:

#!/bin/bash 
# rpm-check.sh 

# Queries an rpm file for description, listing, 
#+ and whether it can be installed. 
# Saves output to a file. 
# 
# This script illustrates using a code block. 

(esempio 3.2 nella pagina collegata).

Qual è il ratonale per l'uso di #+? Alcuni commenti su più righe sembrano indicare che il commento continua nella riga successiva, ma altri no.
Esiste un'etichetta di commento "bash-scripting" che dovrei (tentare di) seguire nei miei script?

Answer 1

Sembra che l'autore della Guida avanzata di Bash Scripting utilizzi quella linea che continua una frase dalla riga precedente.

Questa non è una scelta stilistica standard; questo sembra essere una peculiarità stilistica dell'autore della Advanced Bash Scripting Guide.

Noterò che mentre vi sono alcune buone informazioni tecniche nella Guida avanzata di scripting di Bash, lo stile di codifica è piuttosto non standard. Non lo userei come esempio di quali sono le buone pratiche di codifica Bash. Una risorsa un po 'migliore è la Bash FAQ.