Lines in a program's comment block usually start with one or more special characters, like:
It can be a hassle to add more text to one of the comment lines in a block because the line can get too long, which requires you to fold that line onto the next line, which means you have to work around the leading comment character(s).
Theprogram neatens lines of a text file. But the standard fmt won't help you "neaten" blocks of comments in a program: it mixes the comment characters from the starts of lines with the words. (If your fmt has the -p option, it handles this problem; there's an example below.) The recomment script is fmt for comment blocks. It's for people who write shell, awk , C, or almost any other kind of program with comment blocks several lines long.
I usually use recomment from inside vi , withcommands like:
!}recomment reformat to the next blank line 5!!recomment reformat this line and the next 4
Normally, recomment lets fmt choose the width of the comment block (72 characters, typically). To get another width, you can either:
recomment isn't perfect, but it's usually much better than nothing! Here's the part of the script that does the work. The first two commands get the comment character(s) and count their length. The next three commands strip the comment characters, clean up the remaining comment text, and add the same comment characters to the start of all reformatted lines:
cut -c`expr $cwidth + 1`- < $temp | # STRIP OFF COMMENT LEADER
That makes a command like
Some versions of
(like the one on the CD-ROM) have
option that does the same thing.
Unlike the automatic system in
, you have to tell
what the prefix characters are.
For example, here's the start of a C program.
The prefix character is