Если они не длинных конвейеров , вам не нужно комментировать, просто комментируйте сверху:
# Find all my VNC sessions.
# xargs does something.
# sed does something else
# the second xargs destroys the universe.
# :
# and so on.
ls -t $HOME/.vnc/*.pid \
| xargs -n1 \
| sed 's|\.pid$||; s|^.*\.vnc/||g' \
| xargs -P50 --replace /opt/tools/bin/restrict_resources -T1 \
-- vncconfig -display {} -get desktop 2>/dev/null \
| grep "($USER)" \
| awk '{print $1}' \
| xargs -n1 xdpyinfo -display \
| egrep "^name|dimensions|depths"
Пока комментарии относительно локализованы, это нормально. Поэтому я не стал бы помещать их в верхнюю часть файла (если, конечно, ваш файл не был первым в файле) или записывал на туалетной бумаге и запирал на рабочем столе.
Но первое, что я делаю при просмотре блока, - это поиск комментариев, непосредственно предшествующих блоку. Даже в коде C я не комментирую каждую строку, так как цель комментариев - в основном показать why
и высокоуровневый how
.