> Metavariables (stuff the user should fill in) should be in ALL-CAPS. If possible, (like it is here on HN), metavariables should be in ALL_CAPS_AND_ITALICS, b

> Metavariables (stuff the user should fill in) should be in ALL-CAPS. If possible, (like it is here on HN), metavariables should be in ALL_CAPS_AND_ITALICS, because that’s how it’s done in Unix manual pages. If italics is not available, it might be more clear to use the $SHELL_VARIABLE convention, depending on the audience.