From 357faa5a361db7683b61343bd0039ffc1a752443 Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Tue, 4 Feb 2014 12:19:42 -0700 Subject: mesa: re-wrap, fix-up comment text in formats.h Wrap to 78 columns, fix comment formatting. Trivial. --- src/mesa/main/formats.h | 33 +++++++++++++++++++-------------- 1 file changed, 19 insertions(+), 14 deletions(-) (limited to 'src') diff --git a/src/mesa/main/formats.h b/src/mesa/main/formats.h index 66c01c1c9a2..63d9565e3c6 100644 --- a/src/mesa/main/formats.h +++ b/src/mesa/main/formats.h @@ -41,8 +41,10 @@ extern "C" { #endif -/* OpenGL doesn't have GL_UNSIGNED_BYTE_4_4, so we must define our own type - * for GL_LUMINANCE4_ALPHA4. */ +/** + * OpenGL doesn't have GL_UNSIGNED_BYTE_4_4, so we must define our own type + * for GL_LUMINANCE4_ALPHA4. + */ #define MESA_UNSIGNED_BYTE_4_4 (GL_UNSIGNED_BYTE<<1) @@ -67,18 +69,20 @@ typedef enum * The mesa format name specification is as follows: * * There shall be 3 naming format base types: those for component array - * formats (type A); those for compressed formats (type C); and those for packed - * component formats (type P). With type A formats, color component order does not - * change with endianess. Each format name shall begin with MESA_FORMAT_, - * followed by a component label (from the Component Label list below) for each - * component in the order that the component(s) occur in the format, except for - * non-linear color formats where the first letter shall be 'S'. For type P formats, - * each component label is followed by the number of bits that represent it in the - * fundamental data type used by the format. + * formats (type A); those for compressed formats (type C); and those for + * packed component formats (type P). With type A formats, color component + * order does not change with endianess. Each format name shall begin with + * MESA_FORMAT_, followed by a component label (from the Component Label + * list below) for each component in the order that the component(s) occur + * in the format, except for non-linear color formats where the first + * letter shall be 'S'. For type P formats, each component label is + * followed by the number of bits that represent it in the fundamental + * data type used by the format. * - * Following the listing of the component labels shall be an underscore; a compression - * type followed by an underscore for Type C formats only; a storage type from the list - * below; and a bit with for type A formats, which is the bit width for each array element. + * Following the listing of the component labels shall be an underscore; a + * compression type followed by an underscore for Type C formats only; a + * storage type from the list below; and a bit with for type A formats, + * which is the bit width for each array element. * * * ---------- Format Base Type A: Array ---------- @@ -159,7 +163,8 @@ typedef enum * UINT * SNORM * UNORM - * SRGB - RGB components, or L are UNORMs in sRGB color space. Alpha, if present is linear. + * SRGB - RGB components, or L are UNORMs in sRGB color space. + * Alpha, if present is linear. * * * ---------- Type A Format List (based on format_unpack.c): -- cgit v1.2.3