in reply to flower box comments

Like indentation, I think they are a matter of local style. The advantage is they make an easily spotted pattern for documentation of a function in code that is intended to be desk-checked. The baroque kind of framing you show is trained into many eyeballs, in variations for dozens of languages.

IMO, pod makes more sense for perl. Going directly from code comments to documentation is a fine thing.

After Compline,