usr.bin/indent/lsym_comment.c

6  * C11 distinguishes block comments and end-of-line comments.  Indent further
27  * - end-of-line comment starting with '//'
28  * - end-of-line comment starting with '//x', so without leading space
31  * - block/end-of-line comment to the right of a label
32  * - block/end-of-line comment to the right of code
33  * - block/end-of-line comment to the right of label with code
78 	 * The default maximum line length for comments is 78, and the 'kk' at
79 	 * the end makes the line exactly 78 bytes long.
85 	 * Old indent unnecessarily removed the star comment continuation on the next line.
109 	 * The default maximum line length for comments is 78, and the 'kk' at
110 	 * the end makes the line exactly 78 bytes long.
117 	 * the next line.
210  * XXX: The second line of the above comment contains 11 spaces in a row,
217 	if (0)/*-first line            |
218 	   second line                 |*/
225 	if (0)			/*-first line            |
226 			     second line                 |*/
253 	if(0)/*-first line
254 123456789ab second line           |*/
261 	if (0)			/*-first line
262 		   123456789ab second line           |*/
271  * preserved since the second line already starts in column 1.
295  * preserved since the second line already starts in column 1.
299 	if(0)					    /*-|first line
311 	if (0)			/*-|first line
342  * The following comments test line breaking when the comment ends with a
372  * When determining whether the comment fits in a single line, only the first
401  * The following comments test line breaking when the comment does not end
402  * with a space. Since indent adds a trailing space to a single-line comment,
403  * this space has to be taken into account when computing the line length.
406 /* x		. line length 35*/
407 /* x		.. line length 36*/
408 /* x		... line length 37*/
409 /* x		.... line length 38*/
410 /* x		..... line length 39*/
411 /* x		...... line length 40*/
412 /* x		....... line length 41*/
413 /* x		........ line length 42*/
417 /* x		. line length 35 */
418 /* x		.. line length 36 */
419 /* x		... line length 37 */
420 /* x		.... line length 38 */
422  * x		..... line length 39
425  * x		...... line length 40
428  * x		....... line length 41
431  * x		........ line length 42
443 // This is a C99 line comment.
446  * This is a box comment since its first line (the one above this line) is
470 // This is a C99 line comment.
473  * This is a box comment since its first line (the one above this line) is
558 			 * multi-line
562 	int decl;	/* long single-line declaration comment that is longer than the allowed line width */
564 	int decl;	/* long multi-line declaration comment
566  * the allowed line width */
591 	int decl;		/* short multi-line declaration comment */
593 	int decl;		/* long single-line declaration comment that
594 				 * is longer than the allowed line width */
596 	int decl;		/* long multi-line declaration comment that is
597 				 * longer than the allowed line width */
609 // $ right margin.  The allowed line length is increased to the starting
630 	code();			/* code comment _________ to line length 78 */
631 	code();			/* code comment __________ to line length 79 */
632 	code();			/* code comment ___________ to line length 80 */
633 	code();			/* code comment ____________ to line length 81 */
634 	code();			/* code comment _____________ to line length 82 */
636 /* $ In the following comments, the line length is measured after formatting. */
637 	code();			/* code comment _________ to line length 78*/
638 	code();			/* code comment __________ to line length 79*/
639 	code();			/* code comment ___________ to line length 80*/
640 	code();			/* code comment ____________ to line length 81*/
641 	code();			/* code comment _____________ to line length 82*/
644 				 * multi-line
648 	code();			/* long single-line code comment that is longer than the allowed line width */
650 	code();			/* long multi-line code comment
652  * the allowed line width */
655 	code();			// C99 code comment ________ to line length 78
656 	code();			// C99 code comment _________ to line length 79
657 	code();			// C99 code comment __________ to line length 80
658 	code();			// C99 code comment ___________ to line length 81
659 	code();			// C99 code comment ____________ to line length 82
675 	code();			/* code comment _________ to line length 78 */
676 	code();			/* code comment __________ to line length 79
678 	code();			/* code comment ___________ to line length 80
680 	code();			/* code comment ____________ to line length 81
682 	code();			/* code comment _____________ to line length
685 /* $ In the following comments, the line length is measured after formatting. */
686 	code();			/* code comment _________ to line length 78 */
687 	code();			/* code comment __________ to line length 79
689 	code();			/* code comment ___________ to line length 80
691 	code();			/* code comment ____________ to line length 81
693 	code();			/* code comment _____________ to line length
696 	code();			/* short multi-line code comment */
698 	code();			/* long single-line code comment that is
699 				 * longer than the allowed line width */
701 	code();			/* long multi-line code comment that is longer
702 				 * than the allowed line width */
708 	code();			// C99 code comment ________ to line length 78
709 	code();			// C99 code comment _________ to line length 79
710 	code();			// C99 code comment __________ to line length 80
711 	code();			// C99 code comment ___________ to line length 81
712 	code();			// C99 code comment ____________ to line length 82
774  * line only contains a single word, the maximum allowed line width is
775  * extended such that each comment line may contain 22 characters.
796  * Demonstrates handling of line-end '//' comments.
814 // Note: removing one of these line-end comments affected the formatting
837 // Note: removing one of these line-end comments affected the formatting
885 // end-of-line comment at the end of the file
928  * A completely empty line in a box comment must be copied unmodified to the
931  * but the trailing space is discarded, resulting in an empty line.
963 /* The comment is too long to fit in a single line. */
976 /* The comment fits in a single line. */
989  * a line comment. Before NetBSD pr_comment.c 1.96 from 2021-11-04, indent
995 // line comment /* still a line comment */ still a line comment
1033 /* line 1
1036 line 4 */
1041  * line 1
1044  * line 4
1054 line 1
1057 line 4
1124  * line; they cannot be continued in the next lines.
1127 int line;	// comment line 1
1128 		// comment line 2
1129 int block;	/* comment line 1
1130 		 * comment line 2
1135 int line;			// comment line 1
1136 // $ XXX: This comment was probably intended to continue 'comment line 1'.
1137 // comment line 2
1138 int block;			/* comment line 1 comment line 2 */