Logo etsi

ETSI's Bug Tracker

Notice: information submitted on the ETSI issue Tracker may be incorporated in ETSI publication(s) and therefore subject to the ETSI IPR policy.

View Issue Details [ Jump to Notes ]

[ Issue History ] [ Print ]

Project

Category

View Status

Date Submitted

Last Update

0005134

ETSI TTCN-3 Quality Checker

T3Q tool

public

28-04-2009 14:59

02-06-2009 14:11

Reporter

Philip Makedonski

Assigned To

Philip Makedonski

Priority

low

Severity

feature

Reproducibility

N/A

Status

assigned

Resolution

open

Platform

OS Version

Product Version

Target Version

Fixed in Version

Summary

0005134: Discussion: Code Formatting: Parameters

Description

Certain suggestions for the formatting of formal parameters have come up. It remains to be cleared whether they are generally desirable or too project-specific. The formatting style in question suggests that all formal parameters after the first one are placed on a new line and are using the column offset of the first formal parameter.

function f_1(type1 par1,
             type12 par2,
             inout type2 par3){
    //function body

}

Is this correct and is this desirable?

Apart from that, actual parameters, upon another suggestion can be formatted using a similar scheme:

var1 := f_1(a_par1,
            a_par2,
            a_par3);

It is certainly a subjective judgment whether these improve readability or not.

What are the subjective opinions on this improvement suggestion?

Tags

No tags attached.

Attached Files

Relationships

Notes
(0008707) Philip Makedonski (developer) 01-06-2009 11:36	Line-structure shall be preserved if possible. In this context actual parameters are also to be considered. Priority is on line-structure preservation. All other formatting features are of lower priority.

(0008715) user257 02-06-2009 14:11	Difficult to judge right now, let's get back to it later when code formatting will be configurable. New requirements for preserving line structure were already added.

Issue History
Date Modified	Username	Field	Change
28-04-2009 14:59	Philip Makedonski	New Issue
28-04-2009 14:59	Philip Makedonski	Status	new => assigned
28-04-2009 14:59	Philip Makedonski	Assigned To	=> Philip Makedonski
01-06-2009 11:36	Philip Makedonski	Note Added: 0008707
02-06-2009 14:11	user257	Note Added: 0008715

MantisBT 1.2.14 [^]