Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   indent    ( 1 )

изменяет внешний вид программы C, вставляя или удаляя пробелы (changes the appearance of a C program by inserting or deleting whitespace.)

DISABLING FORMATTING

Formatting of C code may be disabled for portions of a program by
       embedding special control comments in the program.  To turn off
       formatting for a section of a program, place the disabling
       control comment /* *INDENT-OFF* */ on a line by itself just
       before that section.  Program text scanned after this control
       comment is output precisely as input with no modifications until
       the corresponding enabling comment is scanned on a line by
       itself.  The enabling control comment is /* *INDENT-ON* */, and
       any text following the comment on the line is also output
       unformatted.  Formatting begins again with the input line
       following the enabling control comment.

More precisely, indent does not attempt to verify the closing delimiter (*/) for these C comments, and any whitespace on the line is totally transparent.

These control comments also function in their C++ formats, namely // *INDENT-OFF* and // *INDENT-ON*.

It should be noted that the internal state of indent remains unchanged over the course of the unformatted section. Thus, for example, turning off formatting in the middle of a function and continuing it after the end of the function may lead to bizarre results. It is therefore wise to be somewhat modular in selecting code to be left unformatted.

As a historical note, some earlier versions of indent produced error messages beginning with *INDENT**. These versions of indent were written to ignore any input text lines which began with such error messages. I have removed this incestuous feature from GNU indent.