Comments inside Curly Brackets

Tags:
Categories:

Never use curly bracket comments. During development, the “Block comment” functionality can be used instead. However, in production code, block comments are not recommended.

Bad code

PeriodTxt: {Period}

Good code

PeriodTxt: // Period

Bad code

PROCEDURE MATRIX_OnAfterGetRecord@10(MATRIX_ColumnOrdinal : Integer);
BEGIN
    {
    IF ShowColumnName THEN
    MatrixHeader := MatrixRecords[MATRIX_ColumnOrdinal].Name
    ELSE
    MatrixHeader := MatrixRecords[MATRIX_ColumnOrdinal].Code;
    }
    MatrixRecord := MatrixRecords[MATRIX_ColumnOrdinal];
    AnalysisValue := CalcAmt(ValueType,TRUE);
    MATRIX_CellData[MATRIX_ColumnOrdinal] := AnalysisValue;
END;

Good code

PROCEDURE MATRIX_OnAfterGetRecord@10(MATRIX_ColumnOrdinal : Integer);
BEGIN
    MatrixRecord := MatrixRecords[MATRIX_ColumnOrdinal];
    AnalysisValue := CalcAmt(ValueType,TRUE);
    MATRIX_CellData[MATRIX_ColumnOrdinal] := AnalysisValue;
END;
Last modified October 9, 2023: Merge pull request #235 from microsoft/dependabot/npm_and_yarn/postcss-8.4.31 (8c58628) by Jeremy Vyska