Bash: monirivinen kommentti

[AimoE]

Yleensä kun joudun kommentoimaan osan bash-scriptistä, teen sen tyyliin

Koodia: [Valitse]

: ’
ohitettavat
komennot
’
Toinen suositeltu tyyli on

Koodia: [Valitse]

<<SELITE
ohitettavat
komennot
SELITE
’
Tänään tuli kiire tehdä väliaikainen korjaus scriptiin, jossa eräs apukomento ei viime päivityksen jäljeltä toiminutkaan. Halusin tehdä pikapaikkauksen niin, että korvattavan kohdan lisäksi myös korvaava koodi pomppaa silmille, ja koin että tavalliset kommentointitavat eivät ole tarpeeksi selkeitä. Päädyin tekemään paikkauksen tähän tyyliin:

Koodia: [Valitse]

KORJAA_PIAN(){
ohitettavat
komennot
}
POISTA_PIAN(){
väliaikaiset
komennot
}
POISTA_PIAN
’
Bash nimittäin ei välitä siitä, missä kohdassa funktiot määritellään, joten tämän voi sijoittaa vaikka  loopin sisään tai funktion koodiin tai mihin vaan.

Tämä sopii vain lyhytaikaiseen paikkaukseen. Pysyvämpään poiskommentointiin :’’ on parempi.