Add Copyright to machine_info class

Init of request
https://qelectrotech.org/bugtracker/view.php?id=195
This is a start will have to be adjusted further.

.gitignore

@@ -1,2 +1,7 @@
 *.snap
 .flatpak-builder
+# Qt build output
+*.user
+# doxygen Doxyfile output
+doc/
+QElectroTech.tag

SingleApplication/singleapplication.cpp

@@ -27,6 +27,7 @@
 #include <QtCore/QSharedMemory>
 #if QT_VERSION < QT_VERSION_CHECK(5, 10, 0)	// ### Qt 6: remove
 #else
+#pragma message("@TODO remove code for QT 5.10 or later")
 #include <QRandomGenerator>
 #endif
 #include "singleapplication.h"
@@ -106,6 +107,7 @@ SingleApplication::SingleApplication( int &argc, char *argv[], bool allowSeconda
 		qsrand( QDateTime::currentMSecsSinceEpoch() % std::numeric_limits<uint>::max() );
 		QThread::sleep( 8 + static_cast <unsigned long>( static_cast <float>( qrand() ) / RAND_MAX * 10 ) );
 #else
+#pragma message("@TODO remove code for QT 5.10 or later")
 		quint32 value = QRandomGenerator::global()->generate();
 		QThread::sleep( 8 + static_cast <unsigned long>( static_cast <float>( value ) / RAND_MAX * 10 ) );
 #endif

elements/10_electric/91_en_60617/en_60617_11/qet_directory

@@ -3,5 +3,7 @@
         <name lang="fr">11- Schémas et plans d'installation, architecturaux et topographiques</name>
         <name lang="es">11- Dibujos y planos arquitectónicos y topográficos</name>
         <name lang="da">11- Bygningsmæssige og topografiske installationstegninger og -skemaer</name>
+        <name lang="en">11- Installation, architectural and topographical diagrams and plans</name>
+        <name lang="be">11- Installatie, bouwkundig en topografische schema's en plannen</name>
     </names>
 </qet-directory>

sources/ElementsCollection/elementscollectionwidget.cpp

@@ -641,6 +641,7 @@ void ElementsCollectionWidget::search()
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList text_list = text.split("+", QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QStringList text_list = text.split("+", Qt::SkipEmptyParts);
 #endif
 	QModelIndexList match_index;

sources/ElementsCollection/elementslocation.cpp

@@ -754,6 +754,7 @@ QDebug operator<< (QDebug debug, const ElementsLocation &location)
 	QDebugStateSaver saver(debug);
 
 #if QT_VERSION >= 0x050400
+#pragma message("@TODO remove code for QT 5.04 or later")
 	debug.noquote();
 #else
 	debug.nospace();

sources/borderproperties.cpp

@@ -27,7 +27,7 @@
 	- 17 columns of 60.0 px wide by 20.0px high
 	- 8    lines of 80.0 px high by 20.0px wide
 
-	Initialise un objet BorderProperties avec les proprietes par
+	\~French Initialise un objet BorderProperties avec les proprietes par
 	defaut suivantes :
 	- 17 colonnes affichees de 60.0 px de large pour 20.0px de haut
 	- 8    lignes affichees de 80.0 px de haut pour 20.0px de large
@@ -53,12 +53,11 @@ BorderProperties::~BorderProperties() {
 
 /**
 	@brief BorderProperties::operator ==
-	@param bp :
+
-	- other BorderProperties container/class
+	\~ @param bp : Other BorderProperties container/class.
-	- autre conteneur BorderProperties
+	\~French Autre conteneur BorderProperties
-	@return
+	\~ @return True if it and this container are identical, false otherwise.
-	- true if it and this container are identical, false otherwise
+	\~French True si ip et ce conteneur sont identiques, false sinon
-	- true si ip et ce conteneur sont identiques, false sinon
 */
 bool BorderProperties::operator==(const BorderProperties &bp) {
 	return(
@@ -75,12 +74,13 @@ bool BorderProperties::operator==(const BorderProperties &bp) {
 
 /**
 	@brief BorderProperties::operator !=
-	@param bp :
+
-	- other BorderProperties container/class
+	\~ @param bp :
-	- autre conteneur BorderProperties
+	Other BorderProperties container/class.
-	@return
+	\~French Autre conteneur BorderProperties
-	- false if it and this container are identical, true otherwise
+	\~ @return
-	- false si bp et ce conteneur sont identiques, true sinon
+	False if it and this container are identical, true otherwise.
+	\~French False si bp et ce conteneur sont identiques, true sinon
 */
 bool BorderProperties::operator!=(const BorderProperties &bp) {
 	return(!(*this == bp));
@@ -88,11 +88,12 @@ bool BorderProperties::operator!=(const BorderProperties &bp) {
 
 /**
 	@brief BorderProperties::toXml
-	- Exports dimensions as XML attributes added to element e.
+	Exports dimensions as XML attributes added to element e.
-	- Exporte les dimensions sous formes d'attributs XML ajoutes a l'element e.
+	\~French Exporte les dimensions sous formes d'attributs XML ajoutes a l'element e.
-	@param e :
+
-	- XML element to which attributes will be added
+	\~ @param e :
-	- Element XML auquel seront ajoutes des attributs
+	XML element to which attributes will be added
+	\~French Element XML auquel seront ajoutes des attributs
 */
 void BorderProperties::toXml(QDomElement &e) const {
 	e.setAttribute("cols",        columns_count);
@@ -105,11 +106,12 @@ void BorderProperties::toXml(QDomElement &e) const {
 
 /**
 	@brief BorderProperties::fromXml
-	- Import dimensions from XML attributes of element e
+	Import dimensions from XML attributes of element e
-	- Importe les dimensions a partir des attributs XML de l'element e
+	\~French Importe les dimensions a partir des attributs XML de l'element e
-	@param e :
+
-	- XML element whose attributes will be read
+	\~ @param e :
-	- Element XML dont les attributs seront lus
+	XML element whose attributes will be read
+	\~French Element XML dont les attributs seront lus
 */
 void BorderProperties::fromXml(QDomElement &e) {
 	if (e.hasAttribute("cols"))        columns_count   = e.attribute("cols").toInt();
@@ -122,14 +124,15 @@ void BorderProperties::fromXml(QDomElement &e) {
 
 /**
 	@brief BorderProperties::toSettings
-	- Export dimensions in a QSettings object.
+	Export dimensions in a QSettings object.
-	- Exporte les dimensions dans une configuration.
+	\~French Exporte les dimensions dans une configuration.
-	@param settings :
+
-	- QSettings object to write
+	\~ @param settings :
-	- Parametres a ecrire
+	QSettings object to write
-	@param prefix :
+	\~French Parametres a ecrire
-	- prefix to be added before the names of the parameters
+	\~ @param prefix :
-	- prefixe a ajouter devant les noms des parametres
+	prefix to be added before the names of the parameters
+	\~French prefixe a ajouter devant les noms des parametres
 */
 void BorderProperties::toSettings(QSettings &settings, const QString &prefix) const {
 	settings.setValue(prefix + "cols",        columns_count);
@@ -142,14 +145,12 @@ void BorderProperties::toSettings(QSettings &settings, const QString &prefix) co
 
 /**
 	@brief BorderProperties::fromSettings
-	- Import dimensions from a QSettings object.
+	Import dimensions from a QSettings object.
-	- Importe les dimensions depuis une configuration.
+	\~French Importe les dimensions depuis une configuration.
-	@param settings :
+	\~ @param settings : QSettings object to read
-	- QSettings object to read
+	\~French Parametres a lire
-	- Parametres a lire
+	\~ @param prefix : prefix to be added before the names of the parameters
-	@param prefix :
+	\~French prefixe a ajouter devant les noms des parametres
-	- prefix to be added before the names of the parameters
-	- prefixe a ajouter devant les noms des parametres
 */
 void BorderProperties::fromSettings(QSettings &settings, const QString &prefix) {
 	columns_count   = settings.value(prefix + "cols",            columns_count).toInt();

sources/bordertitleblock.cpp

@@ -32,9 +32,16 @@
 #define MIN_ROW_HEIGHT 5.0
 
 /**
-	Constructeur simple : construit une bordure en recuperant les dimensions
+	@brief BorderTitleBlock::BorderTitleBlock
+	Simple constructor:
+	build a border by recovering the dimensions
+	in the application configuration.
+
+	\~French Constructeur simple :
+	construit une bordure en recuperant les dimensions
 	dans la configuration de l'application.
-	@param parent QObject parent de ce BorderTitleBlock
+	\~ @param parent :
+	\~French QObject parent de ce BorderTitleBlock
 */
 BorderTitleBlock::BorderTitleBlock(QObject *parent) :
 	QObject(parent)
@@ -61,95 +68,119 @@ BorderTitleBlock::BorderTitleBlock(QObject *parent) :
 }
 
 /**
-	Destructeur - ne fait rien
+	@brief BorderTitleBlock::~BorderTitleBlock
+	\~French Destructeur - ne fait rien
 */
 BorderTitleBlock::~BorderTitleBlock() {
 }
 
 /**
- * @brief BorderTitleBlock::titleBlockRect
+	@brief BorderTitleBlock::titleBlockRect
- * @return the rectangle of the titleblock in scene coordinate.
+	@return the rectangle of the titleblock in scene coordinate.
 */
 QRectF BorderTitleBlock::titleBlockRect() const
 {
 	if (m_edge == Qt::BottomEdge)
-		return QRectF(diagram_rect_.bottomLeft(), QSize(diagram_rect_.width(), m_titleblock_template_renderer -> height()));
+		return QRectF(diagram_rect_.bottomLeft(),
+			      QSize(diagram_rect_.width(),
+				    m_titleblock_template_renderer -> height()
+				    ));
 	else
-		return QRectF(diagram_rect_.topRight(), QSize(m_titleblock_template_renderer -> height(), diagram_rect_.height()));
+		return QRectF(diagram_rect_.topRight(),
+			      QSize(m_titleblock_template_renderer -> height(),
+				    diagram_rect_.height()
+				    ));
 }
 
+/**
+	@brief BorderTitleBlock::titleblockInformation
+	@return
+*/
 DiagramContext BorderTitleBlock::titleblockInformation() const {
 	return m_titleblock_template_renderer->context();
 }
 
 /**
- * @brief BorderTitleBlock::titleBlockRectForQPainter
+	@brief BorderTitleBlock::titleBlockRectForQPainter
- * @return The title block rect to use with the QPainter in the method draw.
+	@return The title block rect to use with the QPainter in the method draw.
- * The returned rect is alway horizontal (like displayed at the bottom of rect) only the top left change of pos
+	The returned rect is alway horizontal
- * according to the edge where the title block need to be displayed.
+	(like displayed at the bottom of rect) only the top left change of pos
- * Rect according to edge:
+	according to the edge where the title block need to be displayed.
- * Bottom : top left is at the bottom left edge of the diagram rect.
+	Rect according to edge:
- * Right : top left is at the bottom right of diagram rect. Befor use this rect you need to rotate the QPainter by -90°
+	Bottom : top left is at the bottom left edge of the diagram rect.
- * for snap the rect at the right edge of diagram.
+	Right : top left is at the bottom right of diagram rect.
+	Befor use this rect you need to rotate the QPainter by -90°
+	for snap the rect at the right edge of diagram.
 */
 QRectF BorderTitleBlock::titleBlockRectForQPainter() const
 {
-	if (m_edge == Qt::BottomEdge) //Rect at bottom have same position and dimension of displayed rect
+	//Rect at bottom have same position and dimension of displayed rect
+	if (m_edge == Qt::BottomEdge)
 		return titleBlockRect();
 	else
-		return QRectF (diagram_rect_.bottomRight(), QSize(diagram_rect_.height(), m_titleblock_template_renderer -> height()));
+		return QRectF (diagram_rect_.bottomRight(),
+			       QSize(diagram_rect_.height(),
+				     m_titleblock_template_renderer -> height()
+				     ));
 
 }
 
 /**
- * @brief BorderTitleBlock::borderAndTitleBlockRect
+	@brief BorderTitleBlock::borderAndTitleBlockRect
- * @return the bounding rectangle of diagram and titleblock.
+	@return the bounding rectangle of diagram and titleblock.
- * It's like unite outsideBorderRect and titleBlockRect.
+	It's like unite outsideBorderRect and titleBlockRect.
- * The rect is in scene coordinate
+	The rect is in scene coordinate
 */
 QRectF BorderTitleBlock::borderAndTitleBlockRect() const {
 	return diagram_rect_ | titleBlockRect();
 }
 
 /**
- * @brief BorderTitleBlock::columnsRect
+	@brief BorderTitleBlock::columnsRect
- * @return The columns rect in scene coordinate.
+	@return The columns rect in scene coordinate.
- * If column is not displayed, return a null QRectF
+	If column is not displayed, return a null QRectF
 */
 QRectF BorderTitleBlock::columnsRect() const
 {
 	if (!display_columns_) return QRectF();
-	return QRectF (Diagram::margin, Diagram::margin, (columns_count_*columns_width_) + rows_header_width_, columns_header_height_);
+	return QRectF (Diagram::margin,
+		       Diagram::margin,
+		       (columns_count_*columns_width_) + rows_header_width_,
+		       columns_header_height_);
 }
 
 /**
- * @brief BorderTitleBlock::rowsRect
+	@brief BorderTitleBlock::rowsRect
- * @return The rows rect in scene coordinate.
+	@return The rows rect in scene coordinate.
- * If row is not displayed, return a null QRectF
+	If row is not displayed, return a null QRectF
 */
 QRectF BorderTitleBlock::rowsRect() const
 {
 	if (!display_rows_) return QRectF();
-	return QRectF (Diagram::margin, Diagram::margin, rows_header_width_, (rows_count_*rows_height_) + columns_header_height_);
+	return QRectF (Diagram::margin,
+		       Diagram::margin,
+		       rows_header_width_,
+		       (rows_count_*rows_height_) + columns_header_height_);
 }
 
 /**
- * @brief BorderTitleBlock::outsideBorderRect
+	@brief BorderTitleBlock::outsideBorderRect
- * @return The rect of outside border (diagram with columns and rows)
+	@return The rect of outside border (diagram with columns and rows)
- * The rect is in scene coordinate
+	The rect is in scene coordinate
 */
 QRectF BorderTitleBlock::outsideBorderRect() const
 {
-	return QRectF (Diagram::margin, Diagram::margin,
+	return QRectF (Diagram::margin,
+		       Diagram::margin,
 		       (columns_width_*columns_count_) + rows_header_width_,
 		       (rows_height_*rows_count_) + columns_header_height_);
 }
 
 /**
- * @brief BorderTitleBlock::insideBorderRect
+	@brief BorderTitleBlock::insideBorderRect
- * @return The rect of the inside border, in other word, the drawing area.
+	@return The rect of the inside border, in other word, the drawing area.
- * This method take care about if rows or columns are displayed or not.
+	This method take care about if rows or columns are displayed or not.
- * The rect is in scene coordinate
+	The rect is in scene coordinate
 */
 QRectF BorderTitleBlock::insideBorderRect() const
 {
@@ -165,6 +196,7 @@ QRectF BorderTitleBlock::insideBorderRect() const
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockToXml
 	Exports the title block current values to XML.
 	@param xml_elmt the XML element attributes will be added to
 */
@@ -173,6 +205,7 @@ void BorderTitleBlock::titleBlockToXml(QDomElement &xml_elmt) {
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockFromXml
 	Reads the title block values from XML.
 	@param xml_elmt the XML element values will be read from
 */
@@ -183,6 +216,7 @@ void BorderTitleBlock::titleBlockFromXml(const QDomElement &xml_elmt) {
 }
 
 /**
+	@brief BorderTitleBlock::borderToXml
 	Exports the border current settings to XML.
 	@param xml_elmt the XML element attributes will be added to
 */
@@ -200,6 +234,7 @@ void BorderTitleBlock::borderToXml(QDomElement &xml_elmt) {
 }
 
 /**
+	@brief BorderTitleBlock::borderFromXml
 	Reads the border settings from XML.
 	@param xml_elmt the XML element values will be read from
 */
@@ -213,7 +248,8 @@ void BorderTitleBlock::borderFromXml(const QDomElement &xml_elmt) {
 	double cols_width = xml_elmt.attribute("colsize").toDouble(&ok);
 	if (ok) setColumnsWidth(cols_width);
 	
-	// backward compatibility: diagrams saved with 0.1 version have a "height" attribute
+	// backward compatibility:
+	//	diagrams saved with 0.1 version have a "height" attribute
 	if (xml_elmt.hasAttribute("rows") && xml_elmt.hasAttribute("rowsize")) {
 		// rows counts
 		int rows_count = xml_elmt.attribute("rows").toInt(&ok);
@@ -236,7 +272,9 @@ void BorderTitleBlock::borderFromXml(const QDomElement &xml_elmt) {
 }
 
 /**
-	@return les proprietes du cartouches
+	@brief BorderTitleBlock::exportTitleBlock
+	@return the properties of the titleblock
+	\~French les proprietes du cartouches
 */
 TitleBlockProperties BorderTitleBlock::exportTitleBlock() {
 	TitleBlockProperties ip;
@@ -260,8 +298,8 @@ TitleBlockProperties BorderTitleBlock::exportTitleBlock() {
 }
 
 /**
- * @brief BorderTitleBlock::importTitleBlock
+	@brief BorderTitleBlock::importTitleBlock
- * @param ip the new properties of titleblock
+	@param ip the new properties of titleblock
 */
 void BorderTitleBlock::importTitleBlock(const TitleBlockProperties &ip) {
 	setAuthor(ip.author);
@@ -282,12 +320,15 @@ void BorderTitleBlock::importTitleBlock(const TitleBlockProperties &ip) {
 	additional_fields_ = ip.context;
 	
 	emit(needFolioData()); // Note: we expect additional data to be provided
-	// through setFolioData(), which in turn calls updateDiagramContextForTitleBlock().
+	// through setFolioData(),
+	// which in turn calls updateDiagramContextForTitleBlock().
 	emit(needTitleBlockTemplate(ip.template_name));
 }
 
 /**
-	@return les proprietes de la bordure
+	@brief BorderTitleBlock::exportBorder
+	@return border properties
+	\~French les proprietes de la bordure
 */
 BorderProperties BorderTitleBlock::exportBorder() {
 	BorderProperties bp;
@@ -303,7 +344,9 @@ BorderProperties BorderTitleBlock::exportBorder() {
 }
 
 /**
-	@param bp les nouvelles proprietes de la bordure
+	@brief BorderTitleBlock::importBorder
+	@param bp : the new properties of the border
+	\~French les nouvelles proprietes de la bordure
 */
 void BorderTitleBlock::importBorder(const BorderProperties &bp) {
 	setColumnsHeaderHeight(bp.columns_header_height);
@@ -317,6 +360,7 @@ void BorderTitleBlock::importBorder(const BorderProperties &bp) {
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockTemplate
 	@return the titleblock template used to render the titleblock
 	@see TitleBlockTemplateRenderer::titleBlockTemplate()
 */
@@ -325,14 +369,19 @@ const TitleBlockTemplate *BorderTitleBlock::titleBlockTemplate() {
 }
 
 /**
-	@param titleblock_template The new titleblock template to use to render the titleblock
+	@brief BorderTitleBlock::setTitleBlockTemplate
+	@param titleblock_template:
+	The new titleblock template to use to render the titleblock
 	@see TitleBlockTemplateRenderer::setTitleBlockTemplate()
 */
-void BorderTitleBlock::setTitleBlockTemplate(const TitleBlockTemplate *titleblock_template) {
+void BorderTitleBlock::setTitleBlockTemplate(
-	m_titleblock_template_renderer -> setTitleBlockTemplate(titleblock_template);
+		const TitleBlockTemplate *titleblock_template) {
+	m_titleblock_template_renderer -> setTitleBlockTemplate(
+				titleblock_template);
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockTemplateName
 	@return The name of the template used to render the titleblock.
 */
 QString BorderTitleBlock::titleBlockTemplateName() const {
@@ -341,10 +390,11 @@ QString BorderTitleBlock::titleBlockTemplateName() const {
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockTemplateChanged
 	This slot may be used to inform this class that the given title block
-	template has changed. The title block-dedicated rendering cache will thus be
+	template has changed.
-	flushed.
+	The title block-dedicated rendering cache will thus be flushed.
-	@param template_name Name of the title block template that has changed
+	@param template_name : Name of the title block template that has changed
 */
 void BorderTitleBlock::titleBlockTemplateChanged(const QString &template_name) {
 	if (titleBlockTemplateName() != template_name) return;
@@ -352,14 +402,18 @@ void BorderTitleBlock::titleBlockTemplateChanged(const QString &template_name) {
 }
 
 /**
+	@brief BorderTitleBlock::titleBlockTemplateRemoved
 	This slot has to be used to inform this class that the given title block
 	template is about to be removed and is no longer accessible. This class
 	will either use the provided optional TitleBlockTemplate or the default
 	title block provided by QETApp::defaultTitleBlockTemplate()
-	@param template_name Name of the title block template that has changed
+	@param removed_template_name :
+	Name of the title block template that has changed
 	@param new_template (Optional) title block template to use instead
 */
-void BorderTitleBlock::titleBlockTemplateRemoved(const QString &removed_template_name, const TitleBlockTemplate *new_template) {
+void BorderTitleBlock::titleBlockTemplateRemoved(
+		const QString &removed_template_name,
+		const TitleBlockTemplate *new_template) {
 	if (titleBlockTemplateName() != removed_template_name) return;
 	
 	if (new_template) {
@@ -370,7 +424,9 @@ void BorderTitleBlock::titleBlockTemplateRemoved(const QString &removed_template
 }
 
 /**
-	@param di true pour afficher le cartouche, false sinon
+	@brief BorderTitleBlock::displayTitleBlock
+	@param di : true to display the title block, false otherwise
+	\~French true pour afficher le cartouche, false sinon
 */
 void BorderTitleBlock::displayTitleBlock(bool di) {
 	bool change = (di != display_titleblock_);
@@ -379,7 +435,9 @@ void BorderTitleBlock::displayTitleBlock(bool di) {
 }
 
 /**
-	@param dc true pour afficher les entetes des colonnes, false sinon
+	@brief BorderTitleBlock::displayColumns
+	@param dc : true to display the column headers, false otherwise
+	\~French true pour afficher les entetes des colonnes, false sinon
 */
 void BorderTitleBlock::displayColumns(bool dc) {
 	bool change = (dc != display_columns_);
@@ -388,7 +446,9 @@ void BorderTitleBlock::displayColumns(bool dc) {
 }
 
 /**
-	@param dr true pour afficher les entetes des lignes, false sinon
+	@brief BorderTitleBlock::displayRows
+	@param dr : true to display line headers, false otherwise
+	\~French true pour afficher les entetes des lignes, false sinon
 */
 void BorderTitleBlock::displayRows(bool dr) {
 	bool change = (dr != display_rows_);
@@ -397,9 +457,13 @@ void BorderTitleBlock::displayRows(bool dr) {
 }
 
 /**
-	@param db true pour afficher la bordure du schema, false sinon
+	@brief BorderTitleBlock::displayBorder
-	Note : si l'affichage de la bordure est ainsi desactivee, les lignes et
+	@param db : true to display the border of the diagram, false otherwise
-	colonnes ne seront pas dessinees.
+	\~French true pour afficher la bordure du schema, false sinon
+	\~ @note : if the border display is deactivated,
+	the rows and columns will not be drawn.
+	\~French si l'affichage de la bordure est ainsi desactivee,
+	les lignes et colonnes ne seront pas dessinees.
 */
 void BorderTitleBlock::displayBorder(bool db) {
 	bool change = (db != display_border_);
@@ -408,29 +472,34 @@ void BorderTitleBlock::displayBorder(bool db) {
 }
 
 /**
- * @brief BorderTitleBlock::slot_setAutoPageNum
+	@brief BorderTitleBlock::slot_setAutoPageNum
- * @param pageAutoNum
+	@param pageAutoNum :
- * Set Page (Folio) Auto Num
+	Set Page (Folio) Auto Num
 */
 void BorderTitleBlock::slot_setAutoPageNum(QString pageAutoNum) {
 	btb_auto_page_num_=std::move(pageAutoNum);
 }
 
 /**
- * @brief BorderTitleBlock::updateRectangles
+	@brief BorderTitleBlock::updateRectangles
- * This method update the diagram rect according to the value of rows and columns (number and size)
+	This method update the diagram rect according
+	to the value of rows and columns (number and size)
 */
 void BorderTitleBlock::updateRectangles()
 {
 	QRectF previous_diagram = diagram_rect_;
-	diagram_rect_ = QRectF(Diagram::margin, Diagram::margin, diagramWidth(), diagramHeight());
+	diagram_rect_ = QRectF(Diagram::margin,
-	if (diagram_rect_ != previous_diagram) emit(borderChanged(previous_diagram, diagram_rect_));
+			       Diagram::margin,
+			       diagramWidth(),
+			       diagramHeight());
+	if (diagram_rect_ != previous_diagram)
+		emit(borderChanged(previous_diagram, diagram_rect_));
 }
 
 /**
- * @brief BorderTitleBlock::draw
+	@brief BorderTitleBlock::draw
- * Draw the border and the titleblock.
+	Draw the border and the titleblock.
- * @param painter, QPainter to use for draw this.
+	@param painter, QPainter to use for draw this.
 */
 void BorderTitleBlock::draw(QPainter *painter)
 {
@@ -464,16 +533,24 @@ void BorderTitleBlock::draw(QPainter *painter)
 	if (display_border_ && display_columns_) {
 		for (int i = 1 ; i <= columns_count_ ; ++ i) {
 			QRectF numbered_rectangle = QRectF(
-				diagram_rect_.topLeft().x() + (rows_header_width_ + ((i - 1) * columns_width_)),
+				diagram_rect_.topLeft().x()
+					+ (rows_header_width_
+					   + ((i - 1) * columns_width_)),
 				diagram_rect_.topLeft().y(),
 				columns_width_,
 				columns_header_height_
 			);
 			painter -> drawRect(numbered_rectangle);
 			if (settings.value("border-columns_0", true).toBool()){
-			painter -> drawText(numbered_rectangle, Qt::AlignVCenter | Qt::AlignCenter, QString("%1").arg(i - 1));
+			painter -> drawText(numbered_rectangle,
+					    Qt::AlignVCenter
+					    | Qt::AlignCenter,
+					    QString("%1").arg(i - 1));
 			}else{
-			painter -> drawText(numbered_rectangle, Qt::AlignVCenter | Qt::AlignCenter, QString("%1").arg(i));
+			painter -> drawText(numbered_rectangle,
+					    Qt::AlignVCenter
+					    | Qt::AlignCenter,
+					    QString("%1").arg(i));
 			}
 		}
 	}
@@ -484,12 +561,19 @@ void BorderTitleBlock::draw(QPainter *painter)
 		for (int i = 1 ; i <= rows_count_ ; ++ i) {
 			QRectF lettered_rectangle = QRectF(
 				diagram_rect_.topLeft().x(),
-				diagram_rect_.topLeft().y() + (columns_header_height_ + ((i - 1) * rows_height_)),
+				diagram_rect_.topLeft().y()
+					+ (
+						columns_header_height_
+						+ ((i - 1)* rows_height_)
+						),
 				rows_header_width_,
 				rows_height_
 			);
 			painter -> drawRect(lettered_rectangle);
-			painter -> drawText(lettered_rectangle, Qt::AlignVCenter | Qt::AlignCenter, row_string);
+			painter -> drawText(lettered_rectangle,
+					    Qt::AlignVCenter
+					    | Qt::AlignCenter,
+					    row_string);
 			row_string = incrementLetters(row_string);
 		}
 	}
@@ -500,14 +584,18 @@ void BorderTitleBlock::draw(QPainter *painter)
 		if (m_edge == Qt::BottomEdge)
 		{
 			painter -> translate(tbt_rect.topLeft());
-			m_titleblock_template_renderer -> render(painter, tbt_rect.width());
+			m_titleblock_template_renderer -> render(
+						painter,
+						tbt_rect.width());
 			painter -> translate(-tbt_rect.topLeft());
 		}
 		else
 		{
 			painter->translate(tbt_rect.topLeft());
 			painter->rotate(-90);
-			m_titleblock_template_renderer -> render(painter, tbt_rect.width());
+			m_titleblock_template_renderer -> render(
+						painter,
+						tbt_rect.width());
 			painter->rotate(90);
 			painter -> translate(-tbt_rect.topLeft());
 		}
@@ -516,7 +604,20 @@ void BorderTitleBlock::draw(QPainter *painter)
 	painter -> restore();
 }
 
-void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QString &file_path, int color) {
+/**
+ * @brief BorderTitleBlock::drawDxf
+ * @param width
+ * @param height
+ * @param keep_aspect_ratio
+ * @param file_path
+ * @param color
+ */
+void BorderTitleBlock::drawDxf(
+		int width,
+		int height,
+		bool keep_aspect_ratio,
+		QString &file_path,
+		int color) {
 	Q_UNUSED (width); Q_UNUSED (height); Q_UNUSED (keep_aspect_ratio);
 
 	// Transform to DXF scale.
@@ -525,6 +626,7 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 	rows_header_width_     *= Createdxf::xScale;
 	columns_width_         *= Createdxf::xScale;
 
+	// draw the empty box that appears as soon as there is a header
 	// dessine la case vide qui apparait des qu'il y a un entete
 	if (display_border_ &&
 		(display_columns_ ||
@@ -533,7 +635,10 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 		Createdxf::drawRectangle(
 			file_path,
 			double(diagram_rect_.topLeft().x()) * Createdxf::xScale,
-			Createdxf::sheetHeight - double(diagram_rect_.topLeft().y()) * Createdxf::yScale - columns_header_height_,
+			Createdxf::sheetHeight
+					- double(diagram_rect_.topLeft().y())
+					* Createdxf::yScale
+					- columns_header_height_,
 			rows_header_width_,
 			columns_header_height_,
 			color
@@ -542,6 +647,7 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 
 	QSettings settings;
 	
+	// draw the numbering of the columns
 	// dessine la numerotation des colonnes
 	if (display_border_ &&
 		display_columns_) {
@@ -549,34 +655,74 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 			double xCoord = diagram_rect_.topLeft().x() +
 					(rows_header_width_ + ((i - 1) *
 					 columns_width_));
-			double yCoord = Createdxf::sheetHeight - diagram_rect_.topLeft().y() - columns_header_height_;
+			double yCoord = Createdxf::sheetHeight
+					- diagram_rect_.topLeft().y()
+					- columns_header_height_;
 			double recWidth = columns_width_;
 			double recHeight = columns_header_height_;
-			Createdxf::drawRectangle(file_path, xCoord, yCoord, recWidth, recHeight, color);
+			Createdxf::drawRectangle(file_path, xCoord, yCoord,
+						 recWidth, recHeight, color);
 			if (settings.value("border-columns_0", true).toBool()){
-			Createdxf::drawTextAligned(file_path, QString::number(i - 1), xCoord,
+			Createdxf::drawTextAligned(file_path,
-									   yCoord + recHeight*0.5, recHeight*0.7, 0, 0, 1, 2, xCoord+recWidth/2, color, 0);
+						   QString::number(i - 1),
+						   xCoord,
+						   yCoord + recHeight*0.5,
+						   recHeight*0.7,
+						   0,
+						   0,
+						   1,
+						   2,
+						   xCoord+recWidth/2,
+						   color,
+						   0);
 			}else{
-			Createdxf::drawTextAligned(file_path, QString::number(i), xCoord,
+			Createdxf::drawTextAligned(file_path,
-									   yCoord + recHeight*0.5, recHeight*0.7, 0, 0, 1, 2, xCoord+recWidth/2, color, 0);
+						   QString::number(i),
+						   xCoord,
+						   yCoord + recHeight*0.5,
+						   recHeight*0.7,
+						   0,
+						   0,
+						   1,
+						   2,
+						   xCoord+recWidth/2,
+						   color,
+						   0);
 			}
 		}
 	}
 
+	// draw line numbering
 	// dessine la numerotation des lignes
-
 	if (display_border_ && display_rows_) {
 		QString row_string("A");
 		for (int i = 1 ; i <= rows_count_ ; ++ i) {
-			double xCoord = diagram_rect_.topLeft().x() * Createdxf::xScale;
+			double xCoord = diagram_rect_.topLeft().x()
-			double yCoord = Createdxf::sheetHeight - diagram_rect_.topLeft().y()*Createdxf::yScale
+					* Createdxf::xScale;
-							- (columns_header_height_ + ((i - 1) * rows_height_))
+			double yCoord = Createdxf::sheetHeight
+					- diagram_rect_.topLeft().y()
+					*Createdxf::yScale
+					- (
+						columns_header_height_
+						+ ((i - 1)
+						   * rows_height_) )
 					- rows_height_;
 			double recWidth = rows_header_width_;
 			double recHeight = rows_height_;
-			Createdxf::drawRectangle(file_path, xCoord, yCoord, recWidth, recHeight, color);
+			Createdxf::drawRectangle(file_path, xCoord, yCoord,
-			Createdxf::drawTextAligned(file_path, row_string, xCoord,
+						 recWidth, recHeight, color);
-									   yCoord + recHeight*0.5, recWidth*0.7, 0, 0, 1, 2, xCoord+recWidth/2, color, 0);
+			Createdxf::drawTextAligned(file_path,
+						   row_string,
+						   xCoord,
+						   yCoord + recHeight*0.5,
+						   recWidth*0.7,
+						   0,
+						   0,
+						   1,
+						   2,
+						   xCoord+recWidth/2,
+						   color,
+						   0);
 			row_string = incrementLetters(row_string);
 		}
 	}
@@ -585,7 +731,10 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 	if (display_titleblock_) {
 		//qp -> translate(titleblock_rect_.topLeft());
 		QRectF rect = titleBlockRect();
-		m_titleblock_template_renderer -> renderDxf(rect, rect.width(), file_path, color);
+		m_titleblock_template_renderer -> renderDxf(rect,
+							    rect.width(),
+							    file_path,
+							    color);
 		//qp -> translate(-titleblock_rect_.topLeft());
 	}
 
@@ -598,11 +747,17 @@ void BorderTitleBlock::drawDxf(int width, int height, bool keep_aspect_ratio, QS
 }
 
 /**
-	Permet de changer le nombre de colonnes.
+	@brief BorderTitleBlock::setColumnsCount
-	Si ce nombre de colonnes est inferieur au minimum requis, c'est ce minimum
+	Allows you to change the number of columns.
-	qui est utilise.
+	If this number of columns is less than the minimum required,
-	@param nb_c nouveau nombre de colonnes
+	it is this minimum which is used.
-	@see minNbColumns()
+
+	\~French Permet de changer le nombre de colonnes.
+	Si ce nombre de colonnes est inferieur au minimum requis,
+	c'est ce minimum qui est utilise.
+	\~ @param nb_c : new number of columns
+	\~French nouveau nombre de colonnes
+	\~ @see minNbColumns()
 */
 void BorderTitleBlock::setColumnsCount(int nb_c) {
 	if (nb_c == columnsCount()) return;
@@ -611,11 +766,17 @@ void BorderTitleBlock::setColumnsCount(int nb_c) {
 }
 
 /**
-	Change la largeur des colonnes.
+	@brief BorderTitleBlock::setColumnsWidth
-	Si la largeur indiquee est inferieure au minimum requis, c'est ce minimum
+	Change the width of the columns.
-	qui est utilise.
+	If the width indicated is less than the minimum required,
-	@param new_cw nouvelle largeur des colonnes
+	it is this minimum which is used.
-	@see minColumnsWidth()
+
+	\~French Change la largeur des colonnes.
+	Si la largeur indiquee est inferieure au minimum requis,
+	c'est ce minimum qui est utilise.
+	\~ @param new_cw : new column width
+	\~French nouvelle largeur des colonnes
+	\~ @see minColumnsWidth()
 */
 void BorderTitleBlock::setColumnsWidth(const qreal &new_cw) {
 	if (new_cw == columnsWidth()) return;
@@ -624,9 +785,14 @@ void BorderTitleBlock::setColumnsWidth(const qreal &new_cw) {
 }
 
 /**
-	Change la hauteur des en-tetes contenant les numeros de colonnes. Celle-ci
+	@brief BorderTitleBlock::setColumnsHeaderHeight
-	doit rester comprise entre 5 et 50 px.
+	Change the height of the headers containing the column numbers.
-	@param new_chh nouvelle hauteur des en-tetes de colonnes
+	This must remain between 5 and 50 px.
+
+	\~French Change la hauteur des en-tetes contenant les numeros de colonnes.
+	Celle-ci doit rester comprise entre 5 et 50 px.
+	\~ @param new_chh : new height of column headers
+	\~French nouvelle hauteur des en-tetes de colonnes
 */
 void BorderTitleBlock::setColumnsHeaderHeight(const qreal &new_chh) {
 	columns_header_height_ = qBound(qreal(5.0), new_chh, qreal(50.0));
@@ -634,11 +800,17 @@ void BorderTitleBlock::setColumnsHeaderHeight(const qreal &new_chh) {
 }
 
 /**
-	Permet de changer le nombre de lignes.
+	@brief BorderTitleBlock::setRowsCount
-	Si ce nombre de lignes est inferieur au minimum requis, cette fonction ne
+	Allows you to change the number of lines.
-	fait rien
+	If this number of lines is lower than the minimum required,
-	@param nb_r nouveau nombre de lignes
+	this function does nothing
-	@see minNbRows()
+
+	\~French Permet de changer le nombre de lignes.
+	Si ce nombre de lignes est inferieur au minimum requis,
+	cette fonction ne fait rien
+	\~ @param nb_r : new number of lines
+	\~French nouveau nombre de lignes
+	\~ @see minNbRows()
 */
 void BorderTitleBlock::setRowsCount(int nb_r) {
 	if (nb_r == rowsCount()) return;
@@ -647,11 +819,17 @@ void BorderTitleBlock::setRowsCount(int nb_r) {
 }
 
 /**
-	Change la hauteur des lignes.
+	@brief BorderTitleBlock::setRowsHeight
-	Si la hauteur indiquee est inferieure au minimum requis, c'est ce minimum
+	Change the height of the lines.
-	qui est utilise.
+	If the indicated height is lower than the minimum required,
-	@param new_rh nouvelle hauteur des lignes
+	it is this minimum which is used.
-	@see minRowsHeight()
+
+	\~French Change la hauteur des lignes.
+	Si la hauteur indiquee est inferieure au minimum requis,
+	c'est ce minimum qui est utilise.
+	\~ @param new_rh : new row height
+	\~French nouvelle hauteur des lignes
+	\~ @see minRowsHeight()
 */
 void BorderTitleBlock::setRowsHeight(const qreal &new_rh) {
 	if (new_rh == rowsHeight()) return;
@@ -660,9 +838,14 @@ void BorderTitleBlock::setRowsHeight(const qreal &new_rh) {
 }
 
 /**
-	Change la largeur des en-tetes contenant les numeros de lignes. Celle-ci
+	@brief BorderTitleBlock::setRowsHeaderWidth
-	doit rester comprise entre 5 et 50 px.
+	Change the width of the headers containing the line numbers.
-	@param new_rhw nouvelle largeur des en-tetes des lignes
+	This must remain between 5 and 50 px.
+
+	\~French Change la largeur des en-tetes contenant les numeros de lignes.
+	Celle-ci doit rester comprise entre 5 et 50 px.
+	\~ @param new_rhw : new width of line headers
+	\~French nouvelle largeur des en-tetes des lignes
 */
 void BorderTitleBlock::setRowsHeaderWidth(const qreal &new_rhw) {
 	rows_header_width_ = qBound(qreal(5.0), new_rhw, qreal(50.0));
@@ -670,19 +853,26 @@ void BorderTitleBlock::setRowsHeaderWidth(const qreal &new_rhw) {
 }
 
 /**
-	Cette methode essaye de se rapprocher le plus possible de la hauteur donnee
+	@brief BorderTitleBlock::setDiagramHeight
-	en parametre en modifiant le nombre de lignes en cours.
+	This method tries to get as close as possible to the given height
+	as a parameter by modifying the number of rows in progress.
+
+	\~French Cette methode essaye de se rapprocher le plus possible de la
+	hauteur donnee en parametre en modifiant le nombre de lignes en cours.
+	\~ @param height :
 */
 void BorderTitleBlock::setDiagramHeight(const qreal &height) {
+	//          size of rows to use = rows_height
 	// taille des lignes a utiliser = rows_height
 	setRowsCount(qRound(ceil(height / rows_height_)));
 }
 
 /**
- * @brief BorderTitleBlock::convertPosition
+	@brief BorderTitleBlock::convertPosition
- * Convert a Point in cartesian coordinate (x : 12.5, 56.9) to a point in grid coordinate (ex : B2)
+	Convert a Point in cartesian coordinate (x : 12.5, 56.9)
- * @param pos : position to convert
+	to a point in grid coordinate (ex : B2)
- * @return the converted point in grid coordinate.
+	@param pos : position to convert
+	@return the converted point in grid coordinate.
 */
 DiagramPosition BorderTitleBlock::convertPosition(const QPointF &pos)
 {
@@ -701,24 +891,24 @@ DiagramPosition BorderTitleBlock::convertPosition(const QPointF &pos)
 }
 
 /**
- * @brief BorderTitleBlock::setAuthor
+	@brief BorderTitleBlock::setAuthor
- * @param author the new value of the "Author" field
+	@param author the new value of the "Author" field
 */
 void BorderTitleBlock::setAuthor(const QString &author) {
 	btb_author_ = author;
 }
 
 /**
- * @brief BorderTitleBlock::setDate
+	@brief BorderTitleBlock::setDate
- * @param date the new value of the "Date" field
+	@param date the new value of the "Date" field
 */
 void BorderTitleBlock::setDate(const QDate &date) {
 	btb_date_ = date;
 }
 
 /**
- * @brief BorderTitleBlock::setTitle
+	@brief BorderTitleBlock::setTitle
- * @param title the new value of the "Title" field
+	@param title the new value of the "Title" field
 */
 void BorderTitleBlock::setTitle(const QString &title)
 {
@@ -730,8 +920,8 @@ void BorderTitleBlock::setTitle(const QString &title)
 }
 
 /**
- * @brief BorderTitleBlock::setFolio
+	@brief BorderTitleBlock::setFolio
- * @param folio the new value of the "Folio" field
+	@param folio the new value of the "Folio" field
 */
 void BorderTitleBlock::setFolio(const QString &folio)
 {
@@ -740,12 +930,14 @@ void BorderTitleBlock::setFolio(const QString &folio)
 }
 
 /**
-	Update the informations given to the titleblock template by regenerating a
+	@brief BorderTitleBlock::updateDiagramContextForTitleBlock
-	DiagramContext object.
+	Update the informations given to the titleblock template
-	@param initial_context Base diagram context that will be overridden by
+	by regenerating a DiagramContext object.
-	diagram-wide values
+	@param initial_context :
+	Base diagram context that will be overridden by diagram-wide values
 */
-void BorderTitleBlock::updateDiagramContextForTitleBlock(const DiagramContext &initial_context) {
+void BorderTitleBlock::updateDiagramContextForTitleBlock(
+		const DiagramContext &initial_context) {
 	// Our final DiagramContext is the initial one (which is supposed to bring
 	// project-wide properties), overridden by the "additional fields" one...
 	DiagramContext context = initial_context;
@@ -755,7 +947,8 @@ void BorderTitleBlock::updateDiagramContextForTitleBlock(const DiagramContext &i
 	
 	// ... overridden by the historical and/or dynamically generated fields
 	context.addValue("author",      btb_author_);
-	context.addValue("date",        btb_date_.toString(Qt::SystemLocaleShortDate));
+	context.addValue("date",        btb_date_.toString(
+				 Qt::SystemLocaleShortDate));
 	context.addValue("title",       btb_title_);
 	context.addValue("filename",    btb_filename_);
 	context.addValue("plant",     btb_plant_);
@@ -772,14 +965,25 @@ void BorderTitleBlock::updateDiagramContextForTitleBlock(const DiagramContext &i
 	m_titleblock_template_renderer -> setContext(context);
 }
 
+/**
+	@brief BorderTitleBlock::incrementLetters
+	increments string with Letters A to Z
+	@param string
+	@return string ++Letters
+	eg:
+	- A-> B
+	- Z -> AA
+*/
 QString BorderTitleBlock::incrementLetters(const QString &string) {
 	if (string.isEmpty()) {
 		return("A");
 	} else {
+		// separate previous digits from last digit
 		// separe les digits precedents du dernier digit
 		QString first_digits(string.left(string.count() - 1));
 		QChar last_digit(string.at(string.count() - 1));
 		if (last_digit != 'Z') {
+			// increments the last digit
 			// incremente le dernier digit
 			last_digit = last_digit.toLatin1() + 1;
 			return(first_digits + QString(last_digit));
@@ -790,17 +994,32 @@ QString BorderTitleBlock::incrementLetters(const QString &string) {
 }
 
 /**
-	@param index numero du schema (de 1 a total)
+	@brief BorderTitleBlock::setFolioData
-	@param total nombre total de schemas dans le projet
+
-	@param project_properties Project-wide properties, to be merged with diagram-wide ones.
+	\~ @param index : schema number (from 1 to total)
+	\~French numero du schema (de 1 a total)
+
+	\~ @param total : total number of diagrams in the project
+	\~French nombre total de schemas dans le projet
+
+	\~ @param autonum :
+
+	\~ @param project_properties : Project-wide properties,
+	to be merged with diagram-wide ones.
 */
-void BorderTitleBlock::setFolioData(int index, int total, const QString& autonum, const DiagramContext &project_properties) {
+void BorderTitleBlock::setFolioData(
+		int index,
+		int total,
+		const QString& autonum,
+		const DiagramContext &project_properties) {
 	if (index < 1 || total < 1 || index > total) return;
 	
+	// memorize information
 	// memorise les informations
 	folio_index_ = index;
 	folio_total_ = total;
 	
+	// regenerate the content of the folio field
 	// regenere le contenu du champ folio
 	btb_final_folio_ = btb_folio_;
 
@@ -811,61 +1030,60 @@ void BorderTitleBlock::setFolioData(int index, int total, const QString& autonum
 	btb_final_folio_.replace("%id",    QString::number(folio_index_));
 	btb_final_folio_.replace("%total", QString::number(folio_total_));
 
-
 	updateDiagramContextForTitleBlock(project_properties);
 }
 
 /**
- * @brief BorderTitleBlock::setPlant
+	@brief BorderTitleBlock::setPlant
- * @param plant the new value of the "plant" field
+	@param plant the new value of the "plant" field
 */
 void BorderTitleBlock::setPlant(const QString &plant) {
 	btb_plant_ = plant;
 }
 
 /**
- * @brief BorderTitleBlock::setLocMach
+	@brief BorderTitleBlock::setLocMach
- * @param locmach the new value of the "locmach" field
+	@param locmach the new value of the "locmach" field
 */
 void BorderTitleBlock::setLocMach(const QString &locmach) {
 	btb_locmach_ = locmach;
 }
 
 /**
- * @brief BorderTitleBlock::setIndicerev
+	@brief BorderTitleBlock::setIndicerev
- * @param indexrev the new value of the "indexrev" field
+	@param indexrev the new value of the "indexrev" field
 */
 void BorderTitleBlock::setIndicerev(const QString &indexrev) {
 	btb_indexrev_ = indexrev;
 }
 
 /**
- * @brief BorderTitleBlock::setFileName
+	@brief BorderTitleBlock::setFileName
- * @param filename the new value of the "filename" field
+	@param filename the new value of the "filename" field
 */
 void BorderTitleBlock::setFileName(const QString &filename) {
 	btb_filename_ = filename;
 }
 
 /**
- * @brief BorderTitleBlock::setVersion
+	@brief BorderTitleBlock::setVersion
- * @param version the new value of the "version" field
+	@param version the new value of the "version" field
 */
 void BorderTitleBlock::setVersion(const QString &version) {
 	btb_version_ = version;
 }
 
 /**
- * @brief BorderTitleBlock::setAutoPageNum
+	@brief BorderTitleBlock::setAutoPageNum
- * @param auto_page_num the new value of the "auto_page_num" field
+	@param auto_page_num the new value of the "auto_page_num" field
 */
 void BorderTitleBlock::setAutoPageNum(const QString &auto_page_num) {
 	btb_auto_page_num_ = auto_page_num;
 }
 
 /**
- * @brief BorderTitleBlock::setPreviousFolioNum
+	@brief BorderTitleBlock::setPreviousFolioNum
- * @param previous the new value of the "previous-folio-num" field
+	@param previous the new value of the "previous-folio-num" field
 */
 void BorderTitleBlock::setPreviousFolioNum(const QString &previous)
 {
@@ -876,8 +1094,8 @@ void BorderTitleBlock::setPreviousFolioNum(const QString &previous)
 }
 
 /**
- * @brief BorderTitleBlock::setNextFolioNum
+	@brief BorderTitleBlock::setNextFolioNum
- * @param next the new value of the "next-folio-num" field
+	@param next the new value of the "next-folio-num" field
 */
 void BorderTitleBlock::setNextFolioNum(const QString &next)
 {

sources/bordertitleblock.h

@@ -29,6 +29,7 @@ class DiagramPosition;
 class TitleBlockTemplate;
 class TitleBlockTemplateRenderer;
 /**
+	@brief The BorderTitleBlock class
 	This class represents the border and the titleblock which frame a
 	particular electric diagram.
 */
@@ -55,9 +56,11 @@ class BorderTitleBlock : public QObject
 		/// @return the columns width, in pixels
 		qreal columnsWidth() const { return(columns_width_); }
 		/// @return the total width of all columns, headers excluded
-		qreal columnsTotalWidth() const { return(columns_count_ * columns_width_); }
+		qreal columnsTotalWidth() const {
+			return(columns_count_ * columns_width_); }
 		/// @return the column headers height, in pixels
-		qreal columnsHeaderHeight() const { return(columns_header_height_); }
+		qreal columnsHeaderHeight() const {
+			return(columns_header_height_); }
 	
 		//ROWS
 		/// @return the number of rows
@@ -65,15 +68,26 @@ class BorderTitleBlock : public QObject
 		/// @return the rows height, in pixels
 		qreal rowsHeight() const { return(rows_height_); }
 		/// @return the total height of all rows, headers excluded
-		qreal rowsTotalHeight() const { return(rows_count_ * rows_height_); }
+		qreal rowsTotalHeight() const {
+			return(rows_count_ * rows_height_); }
 		/// @return la rows header width, in pixels
 		qreal rowsHeaderWidth() const { return(rows_header_width_); }
 	
 		// border - title block = diagram
-			/// @return the diagram width, i.e. the width of the border without title block
+		/**
-		qreal diagramWidth() const { return(columnsTotalWidth() + rowsHeaderWidth()); }
+			@brief diagramWidth
-			/// @return the diagram height, i.e. the height of the border without title block
+			@return the diagram width,
-		qreal diagramHeight() const { return(rowsTotalHeight() + columnsHeaderHeight()); }
+			i.e. the width of the border without title block
+		*/
+		qreal diagramWidth() const {
+			return(columnsTotalWidth() + rowsHeaderWidth()); }
+		/**
+			@brief diagramHeight
+			@return the diagram height,
+			i.e. the height of the border without title block
+		*/
+		qreal diagramHeight() const {
+			return(rowsTotalHeight() + columnsHeaderHeight()); }
 
 		QRectF titleBlockRect () const;
 
@@ -110,7 +124,8 @@ class BorderTitleBlock : public QObject
 		/// @return the value of the title block Additional Fields
 		QString version() const { return(btb_version_); }
 		/// @return the value of the title block Additional Fields
-		DiagramContext additionalFields() const { return (additional_fields_); }
+		DiagramContext additionalFields() const {
+			return (additional_fields_); }
 		/// @return the value of the title block
 		QString autoPageNum() const { return(btb_auto_page_num_); }
 		/// @return the value of the total number of folios
@@ -118,10 +133,13 @@ class BorderTitleBlock : public QObject
 	
 		// methods to get display options
 		/// @return true si le cartouche est affiche, false sinon
-		bool titleBlockIsDisplayed() const { return(display_titleblock_); }
+		bool titleBlockIsDisplayed() const {
-			/// @return true si les entetes des colonnes sont affiches, false sinon
+			return(display_titleblock_); }
+		/// @return true si les entetes des colonnes sont affiches,
+		/// false sinon
 		bool columnsAreDisplayed() const { return(display_columns_); }
-			/// @return true si les entetes des lignes sont affiches, false sinon
+		/// @return true si les entetes des lignes sont affiches,
+		/// false sinon
 		bool rowsAreDisplayed() const { return(display_rows_); }
 		/// @return true si la bordure est affichee, false sinon
 		bool borderIsDisplayed() const { return(display_border_); }
@@ -142,7 +160,8 @@ class BorderTitleBlock : public QObject
 		void setDate(const QDate &date);
 		void setTitle(const QString &title);
 		void setFolio(const QString &folio);
-		void setFolioData(int, int, const QString& = nullptr, const DiagramContext & = DiagramContext());
+		void setFolioData(int, int, const QString& = nullptr,
+				  const DiagramContext & = DiagramContext());
 		void setPlant(const QString &plant);
 		void setLocMach(const QString &locmach);
 		void setIndicerev(const QString &indexrev);
@@ -168,7 +187,9 @@ class BorderTitleBlock : public QObject
 		
 	public slots:
 		void titleBlockTemplateChanged(const QString &);
-		void titleBlockTemplateRemoved(const QString &, const TitleBlockTemplate * = nullptr);
+		void titleBlockTemplateRemoved(
+				const QString &,
+				const TitleBlockTemplate * = nullptr);
 		
 		// methods to set display options
 		void displayTitleBlock(bool);
@@ -179,21 +200,25 @@ class BorderTitleBlock : public QObject
 	
 	private:
 		void updateRectangles();
-		void updateDiagramContextForTitleBlock(const DiagramContext & = DiagramContext());
+		void updateDiagramContextForTitleBlock(
+				const DiagramContext & = DiagramContext());
 		QString incrementLetters(const QString &);
 	
 		signals:
 		/**
+			@brief borderChanged
 			Signal emitted after the border has changed
 			@param old_border Former border
 			@param new_border New border
 		*/
 		void borderChanged(QRectF old_border, QRectF new_border);
 		/**
+			@brief displayChanged
 			Signal emitted after display options have changed
 		*/
 		void displayChanged();
 		/**
+			@brief diagramTitleChanged
 			Signal emitted after the title has changed
 		*/
 		void diagramTitleChanged(const QString &);
@@ -203,48 +228,53 @@ class BorderTitleBlock : public QObject
 		*/
 		void titleBlockFolioChanged(const QString &);
 		/**
-				Signal emitted when the title block requires its data to be updated in order
+			@brief needFolioData
-				to generate the folio field.
+			Signal emitted when the title block
+			requires its data to be updated
+			in order to generate the folio field.
 		*/
 		void needFolioData();
 		/**
-				Signal emitted when this object needs to set a specific title block
+			@brief needTitleBlockTemplate
-				template. This object cannot handle the job since it does not know of
+			Signal emitted when this object needs to
-				its parent project.
+			set a specific title block template.
+			This object cannot handle the job
+			since it does not know of its parent project.
 		*/
 		void needTitleBlockTemplate(const QString &);
 	
 	// attributes
 	private:
 		// titleblock basic data
-		QString btb_author_;
+		QString btb_author_;        ///< titleblock author
-		QDate   btb_date_;
+		QDate   btb_date_;          ///< titleblock date
-		QString btb_title_;
+		QString btb_title_;         ///< titleblock title
-		QString btb_folio_;
+		QString btb_folio_;         ///< titleblock folio
-		QString btb_plant_;
+		QString btb_plant_;         ///< titleblock plant
-		QString btb_locmach_;
+		QString btb_locmach_;       ///< titleblock locmach
-		QString btb_indexrev_;
+		QString btb_indexrev_;      ///< titleblock index rev
-		QString btb_final_folio_;
+		QString btb_final_folio_;   ///< titleblock final folio
-		QString btb_auto_page_num_;
+		QString btb_auto_page_num_; ///< titleblock auto page num
-		int folio_index_;
+		int folio_index_;           ///< titleblock index
-		int folio_total_;
+		int folio_total_;           ///< titleblock total
-		QString btb_filename_;
+		QString btb_filename_;      ///< titleblock filename
-		QString btb_version_;
+		QString btb_version_;       ///< titleblock version
+		/// titleblock additional fields
 		DiagramContext additional_fields_;
-		Qt::Edge m_edge;
+		Qt::Edge m_edge;              ///< titleblock edge
-		QString m_next_folio_num,
+		QString m_next_folio_num;     ///< titleblock next folio num
-				m_previous_folio_num;
+		QString m_previous_folio_num; ///< titleblock previous folio num
 	
 		// border dimensions (rows and columns)
 		// columns: number and dimensions
-		int columns_count_;
+		int columns_count_;           ///< columns count
-		qreal columns_width_;
+		qreal columns_width_;         ///< columns width
-		qreal columns_header_height_;
+		qreal columns_header_height_; ///< columns header height
 	
 		// rows: number and dimensions
-		int rows_count_;
+		int rows_count_;          ///< rows count
-		qreal rows_height_;
+		qreal rows_height_;       ///< rows height
-		qreal rows_header_width_;
+		qreal rows_header_width_; ///< rows header width
 	
 		// title block dimensions
 		qreal titleblock_height_;

sources/conductorautonumerotation.cpp

@@ -1,5 +1,5 @@
 /*
-	Copyright 2006-2014 The QElectroTech team
+	Copyright 2006-2020 The QElectroTech team
 	This file is part of QElectroTech.
 
 	QElectroTech is free software: you can redistribute it and/or modify
@@ -26,16 +26,23 @@
 #include "assignvariables.h"
 
 /**
- * @brief ConductorAutoNumerotation::ConductorAutoNumerotation
+	@brief ConductorAutoNumerotation::ConductorAutoNumerotation
- * Constructor of autonum, after create a class, call numerate to apply the autonum.
+	Constructor of autonum, after create a class,
- * When autonum is applyed, they do with an undo command added to the stack of diagram.
+	call numerate to apply the autonum.
- * If you give a parent_undo at constructor, the undo command create in this class have parent_undo for parent,
+	When autonum is applyed,
- * and wasn't added to the stack of diagram (it's the responsabillty of the parent_undo)
+	they do with an undo command added to the stack of diagram.
- * @param conductor   : the conductor to apply automatic numerotation
+	If you give a parent_undo at constructor,
- * @param diagram     : the diagram of conductor
+	the undo command create in this class have parent_undo for parent,
- * @param parent_undo : parent undo command
+	and wasn't added to the stack of diagram
+	(it's the responsabillty of the parent_undo)
+	@param conductor   : the conductor to apply automatic numerotation
+	@param diagram     : the diagram of conductor
+	@param parent_undo : parent undo command
 */
-ConductorAutoNumerotation::ConductorAutoNumerotation(Conductor *conductor, Diagram *diagram, QUndoCommand *parent_undo) :
+ConductorAutoNumerotation::ConductorAutoNumerotation(
+		Conductor *conductor,
+		Diagram *diagram,
+		QUndoCommand *parent_undo) :
 	m_diagram      (diagram),
 	m_conductor     (conductor),
 	conductor_list (conductor -> relatedPotentialConductors().values()),
@@ -43,18 +50,21 @@ ConductorAutoNumerotation::ConductorAutoNumerotation(Conductor *conductor, Diagr
 {}
 
 /**
- * @brief ConductorAutoNumerotation::numerate
+	@brief ConductorAutoNumerotation::numerate
- * execute the automatic numerotation
+	execute the automatic numerotation
 */
 void ConductorAutoNumerotation::numerate() {
 	if (!m_conductor) return;
 	if (conductor_list.size() >= 1 ) numeratePotential();
-	else if (m_conductor -> properties().type == ConductorProperties::Multi) numerateNewConductor();
+	else if (m_conductor -> properties().type == ConductorProperties::Multi)
+		numerateNewConductor();
 }
 
 /**
- * @brief ConductorAutoNumerotation::applyText
+	@brief ConductorAutoNumerotation::applyText
- * apply the text @t to @conductor_ and all conductors at the same potential
+	apply the text @t to @conductor_
+	and all conductors at the same potential
+	@param t : Conductor text
 */
 void ConductorAutoNumerotation::applyText(const QString& t)
 {
@@ -70,20 +80,36 @@ void ConductorAutoNumerotation::applyText(const QString& t)
 
 	if (m_parent_undo)
 	{
-		new QPropertyUndoCommand(m_conductor, "properties", old_value, new_value, m_parent_undo);
+		new QPropertyUndoCommand(
+					m_conductor,
+					"properties",
+					old_value,
+					new_value,
+					m_parent_undo);
 		undo = m_parent_undo;
 	}
 	else
 	{
 		undo = new QUndoCommand();
-		new QPropertyUndoCommand(m_conductor, "properties", old_value, new_value, undo);
+		new QPropertyUndoCommand(
-		undo->setText(QObject::tr("Modifier les propriétés d'un conducteur", "undo caption"));
+					m_conductor,
+					"properties",
+					old_value,
+					new_value,
+					undo);
+		undo->setText(
+			QObject::tr(
+				"Modifier les propriétés d'un conducteur",
+				"undo caption"));
 	}
 
 	if (!conductor_list.isEmpty())
 	{
 		if (!m_parent_undo)
-			undo->setText(QObject::tr("Modifier les propriétés de plusieurs conducteurs", "undo caption"));
+			undo->setText(
+				QObject::tr(
+					"Modifier les propriétés de plusieurs conducteurs",
+					"undo caption"));
 
 		foreach (Conductor *cond, conductor_list)
 		{
@@ -91,7 +117,12 @@ void ConductorAutoNumerotation::applyText(const QString& t)
 			old_value.setValue(cp2);
 			cp2.text = t;
 			new_value.setValue(cp2);
-			new QPropertyUndoCommand(cond, "properties", old_value, new_value, undo);
+			new QPropertyUndoCommand(
+						cond,
+						"properties",
+						old_value,
+						new_value,
+						undo);
 		}
 	}
 
@@ -100,15 +131,19 @@ void ConductorAutoNumerotation::applyText(const QString& t)
 }
 
 /**
- * @brief ConductorAutoNumerotation::newProperties
+	@brief ConductorAutoNumerotation::newProperties
- * Create a new properties according to the current autonum rule of diagram
+	Create a new properties according to the current autonum rule of diagram
- * @param d
+	@param diagram : Diagram class
- * @param cp
+	@param cp : ConductorProperties
- * @param seq
+	@param seq : sequentialNumbers
 */
-void ConductorAutoNumerotation::newProperties(Diagram *diagram, ConductorProperties &cp, autonum::sequentialNumbers &seq)
+void ConductorAutoNumerotation::newProperties(
+		Diagram *diagram,
+		ConductorProperties &cp,
+		autonum::sequentialNumbers &seq)
 {	
-	NumerotationContext context = diagram->project()->conductorAutoNum(diagram->conductorsAutonumName());
+	NumerotationContext context = diagram->project()->conductorAutoNum(
+				diagram->conductorsAutonumName());
 	if (context.isEmpty()) {
 		return;
 	}
@@ -124,8 +159,8 @@ void ConductorAutoNumerotation::newProperties(Diagram *diagram, ConductorPropert
 }
 
 /**
- * @brief ConductorAutoNumerotation::numeratePotential
+	@brief ConductorAutoNumerotation::numeratePotential
- * Numerate a conductor on an existing potential
+	Numerate a conductor on an existing potential
 */
 void ConductorAutoNumerotation::numeratePotential()
 {
@@ -136,7 +171,8 @@ void ConductorAutoNumerotation::numeratePotential()
 		if (conductor->properties() != cp)
 			properties_equal = false;
 	}
-		//Every properties of the potential is equal, so we apply it to m_conductor
+	// Every properties of the potential is equal,
+	// so we apply it to m_conductor
 	if (properties_equal)
 	{
 		m_conductor->setProperties(cp);
@@ -169,21 +205,25 @@ void ConductorAutoNumerotation::numeratePotential()
 		//the texts isn't identicals
 	else
 	{
-		PotentialSelectorDialog psd(m_conductor, m_parent_undo, m_conductor->diagramEditor());
+		PotentialSelectorDialog psd(
+					m_conductor,
+					m_parent_undo,
+					m_conductor->diagramEditor());
 		psd.exec();
 	}
 }
 
 /**
- * @brief ConductorAutoNumerotation::numerateNewConductor
+	@brief ConductorAutoNumerotation::numerateNewConductor
- * create and apply a new numerotation to @m_conductor
+	create and apply a new numerotation to @m_conductor
 */
 void ConductorAutoNumerotation::numerateNewConductor()
 {
 	if (!m_conductor || m_diagram->conductorsAutonumName().isEmpty())
 		return;
 
-	NumerotationContext context = m_diagram->project()->conductorAutoNum(m_diagram -> conductorsAutonumName());
+	NumerotationContext context = m_diagram->project()->conductorAutoNum(
+				m_diagram -> conductorsAutonumName());
 	if (context.isEmpty())
 		return;
 
@@ -194,10 +234,17 @@ void ConductorAutoNumerotation::numerateNewConductor()
 	cp.m_formula = formula;
 	m_conductor->setProperties(cp);
 
-	autonum::setSequential(formula, m_conductor->rSequenceNum(), context, m_diagram, autoNum_name);
+	autonum::setSequential(formula,
+			       m_conductor->rSequenceNum(),
+			       context,
+			       m_diagram,
+			       autoNum_name);
 
 	NumerotationContextCommands ncc (context, m_diagram);
 	m_diagram->project()->addConductorAutoNum(autoNum_name, ncc.next());
 
-	applyText(autonum::AssignVariables::formulaToLabel(formula, m_conductor->rSequenceNum(), m_diagram));
+	applyText(autonum::AssignVariables::formulaToLabel(
+			  formula,
+			  m_conductor->rSequenceNum(),
+			  m_diagram));
 }

sources/conductorautonumerotation.h

@@ -1,5 +1,5 @@
 /*
-	Copyright 2006-2014 The QElectroTech team
+	Copyright 2006-2020 The QElectroTech team
 	This file is part of QElectroTech.
 
 	QElectroTech is free software: you can redistribute it and/or modify
@@ -26,16 +26,23 @@ class Conductor;
 class QUndoCommand;
 class ConductorProperties;
 
+/**
+	@brief The ConductorAutoNumerotation class
+*/
 class ConductorAutoNumerotation
 {
 	public:
 		//constructors & destructor
-		ConductorAutoNumerotation (Conductor *conductor, Diagram *diagram, QUndoCommand *undo_parent = nullptr);
+		ConductorAutoNumerotation (Conductor *conductor,
+					   Diagram *diagram,
+					   QUndoCommand *undo_parent = nullptr);
 
 		//methods
 		void        numerate       ();
 		void        applyText      (const QString&);
-		static void newProperties(Diagram *diagram, ConductorProperties &cp, autonum::sequentialNumbers &seq);
+		static void newProperties(Diagram *diagram,
+					  ConductorProperties &cp,
+					  autonum::sequentialNumbers &seq);
 
 	private:
 		//methods

sources/conductornumexport.cpp

@@ -70,6 +70,7 @@ bool ConductorNumExport::toCsv()
 #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)	// ### Qt 6: remove
 			stream << wiresNum() << endl;
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 			stream << wiresNum() << &Qt::endl(stream);
 #endif
 		}

sources/conductorproperties.cpp

@@ -331,12 +331,23 @@ void ConductorProperties::fromXml(QDomElement &e)
 	horiz_rotate_text    = e.attribute("horizrotatetext").toDouble();
 	
 	QMetaEnum me = QMetaEnum::fromType<Qt::Alignment>();
-	m_horizontal_alignment = Qt::Alignment(me.keyToValue(e.attribute("horizontal-alignment", "AlignBottom").toStdString().data()));
+	m_horizontal_alignment = Qt::Alignment(
-	m_vertical_alignment = Qt::Alignment(me.keyToValue(e.attribute("vertical-alignment", "AlignRight").toStdString().data()));
+				me.keyToValue(
+					e.attribute(
+						"horizontal-alignment",
+						"AlignBottom"
+						).toStdString().data()));
+	m_vertical_alignment = Qt::Alignment(
+				me.keyToValue(
+					e.attribute(
+						"vertical-alignment",
+						"AlignRight"
+						).toStdString().data()));
 
 	//Keep retrocompatible with version older than 0,4
 	//If the propertie @type is simple (removed since QET 0,4), we set text no visible.
 	//@TODO remove this code for qet 0.6 or later
+#pragma message("@TODO remove this code for qet 0.6 or later")
 	if (e.attribute("type") == "simple") m_show_text = false;
 }
 
@@ -754,6 +765,7 @@ void ConductorProperties::readStyle(const QString &style_string) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList styles = style_string.split(";", QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code QString::SkipEmptyParts for QT 5.14 or later")
 	QStringList styles = style_string.split(";", Qt::SkipEmptyParts);
 #endif
 	

sources/conductorproperties.h

@@ -25,6 +25,7 @@
 class QPainter;
 
 /**
+	@brief The SingleLineProperties class
 	This class represents the properties of a singleline conductor.
 */
 class SingleLineProperties {
@@ -59,6 +60,7 @@ class SingleLineProperties {
 };
 
 /**
+	@brief The ConductorProperties class
 	This class represents the functional properties of a particular conductor,
 	i.e. properties other than path and terminals.
 */
@@ -69,9 +71,10 @@ class ConductorProperties
 		virtual ~ConductorProperties();
 	
 			/**
-			 * @brief The ConductorType enum Represents the kind of a particular conductor:
+				@brief The ConductorType enum Represents
-			 * Single: singleline symbols, no text input
+				the kind of a particular conductor:
-			 * Multi: text input, no symbol
+				Single: singleline symbols, no text input
+				Multi: text input, no symbol
 			*/
 		enum ConductorType { Single, Multi };
 

sources/configdialog.cpp

@@ -15,19 +15,32 @@
 	You should have received a copy of the GNU General Public License
 	along with QElectroTech.  If not, see <http://www.gnu.org/licenses/>.
 */
+#include <QScrollArea>
 #include "configdialog.h"
 #include "configpages.h"
 #include "qetapp.h"
 
+#include "machine_info.h"
+
 /**
 	Constructeur
 	@param parent QWidget parent
 */
 ConfigDialog::ConfigDialog(QWidget *parent) : QDialog(parent) {
+	Machine_info *mymachineinfo= new Machine_info(this);
+	//ScrollArea for low screens
+	QScrollArea *scroll = new QScrollArea(this);
+	scroll->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
+	scroll->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
+
 	// liste des pages
 	pages_list = new QListWidget();
 	pages_list -> setViewMode(QListView::IconMode);
+	if(mymachineinfo->get_max_screen_height()<1000){
+		pages_list -> setIconSize(QSize(64, 64));
+	} else {
 		pages_list -> setIconSize(QSize(128, 128));
+	}
 	pages_list -> setMovement(QListView::Static);
 	pages_list -> setMinimumWidth(168);
 	pages_list -> setMaximumWidth(168);
@@ -36,24 +49,39 @@ ConfigDialog::ConfigDialog(QWidget *parent) : QDialog(parent) {
 
 	// pages
 	pages_widget = new QStackedWidget();
-	
 	// boutons
-	buttons = new QDialogButtonBox(QDialogButtonBox::Ok|QDialogButtonBox::Cancel);
+	buttons = new QDialogButtonBox(
+				QDialogButtonBox::Ok
+				|QDialogButtonBox::Cancel);
+
+
+	QWidget *viewport = new QWidget(this);
+	scroll->setWidget(viewport);
+	scroll->setWidgetResizable(true);
 
 	// layouts
-	QHBoxLayout *hlayout1 = new QHBoxLayout();
+	QHBoxLayout *hlayout1 = new QHBoxLayout(viewport);
+	// add needed widgets to layout "hlayout1"
 	hlayout1 -> addWidget(pages_list);
 	hlayout1 -> addWidget(pages_widget);
 
-	QVBoxLayout *vlayout1 = new QVBoxLayout();
+	//add hlayout1 to widget
-	vlayout1 -> addLayout(hlayout1);
+	viewport->setLayout(hlayout1);
-	vlayout1 -> addWidget(buttons);
+
-	setLayout(vlayout1);
+	// Add a layout for QDialog
+	QVBoxLayout *dialog_layout = new QVBoxLayout(this);
+	dialog_layout->addWidget(scroll); // add scroll to the QDialog's layout
+	dialog_layout -> addWidget(buttons);
+	setLayout(dialog_layout);
 
 	// connexion signaux / slots
 	connect(buttons, SIGNAL(accepted()), this, SLOT(applyConf()));
 	connect(buttons, SIGNAL(rejected()), this, SLOT(reject()));
-	connect(pages_list, SIGNAL(currentRowChanged(int)), pages_widget, SLOT(setCurrentIndex(int)));
+	connect(pages_list, SIGNAL(currentRowChanged(int)),
+		pages_widget, SLOT(setCurrentIndex(int)));
+
+	resize(mymachineinfo->get_max_screen_width(),
+	       mymachineinfo->get_max_screen_height());
 
 #ifdef Q_OS_MACOS
 	if (parent) {

sources/dataBase/ui/elementquerywidget.cpp

@@ -46,6 +46,7 @@ ElementQueryWidget::ElementQueryWidget(QWidget *parent) :
 #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)	// ### Qt 6: remove
 	connect(&m_button_group, static_cast<void (QButtonGroup::*)(int)>(&QButtonGroup::buttonClicked), [this](int id)
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 	connect(&m_button_group, static_cast<void (QButtonGroup::*)(int)>(&QButtonGroup::idClicked), [this](int id)
 #endif
 	{

sources/diagram.cpp

@@ -1141,6 +1141,7 @@ bool Diagram::fromXml(QDomElement &document, QPointF position, bool consider_inf
 		content_ptr -> m_images			    = added_images.toSet();
 		content_ptr -> m_shapes			    = added_shapes.toSet();
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 		content_ptr -> m_text_fields	= QSet<IndependentTextItem *>(
 					added_texts.begin(),
 					added_texts.end());

sources/editor/editorcommands.cpp

@@ -416,6 +416,7 @@ void ChangeZValueCommand::applyRaise(const QList<QGraphicsItem *> &items_list) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 13, 0)	// ### Qt 6: remove
 				my_items_list.swap(i, i + 1);
 #else
+#pragma message("@TODO remove code for QT 5.13 or later")
 				my_items_list.swapItemsAt(i, i + 1);
 #endif
 			}
@@ -438,6 +439,7 @@ void ChangeZValueCommand::applyLower(const QList<QGraphicsItem *> &items_list) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 13, 0)	// ### Qt 6: remove
 				my_items_list.swap(i, i - 1);
 #else
+#pragma message("@TODO remove code for QT 5.13 or later")
 				my_items_list.swapItemsAt(i, i - 1);
 #endif
 			}

sources/editor/graphicspart/customelementgraphicpart.cpp

@@ -498,6 +498,7 @@ void CustomElementGraphicPart::stylesFromXml(const QDomElement &qde)
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList styles = qde.attribute("style").split(";", QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QStringList styles = qde.attribute("style").split(";", Qt::SkipEmptyParts);
 #endif
 	

sources/elementscollectioncache.cpp

@@ -53,6 +53,7 @@ ElementsCollectionCache::ElementsCollectionCache(const QString &database_path, Q
 
 		//TODO This code remove old table with mtime for create table with uuid, created at version 0,5
 		//see to remove this code at version 0,6 or 0,7 when all users will table with uuid.
+#pragma message("@TODO remove this code for qet 0.6 or later")
 		QSqlQuery table_name(cache_db_);
 		if (table_name.exec("PRAGMA table_info(names)"))
 		{

sources/factory/elementpicturefactory.cpp

@@ -559,6 +559,7 @@ void ElementPictureFactory::setPainterStyle(const QDomElement &dom, QPainter &pa
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	const QStringList styles = dom.attribute("style").split(";", QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	const QStringList styles = dom.attribute("style").split(";", Qt::SkipEmptyParts);
 #endif
 	QRegExp rx("^\\s*([a-z-]+)\\s*:\\s*([a-zA-Z-]+)\\s*$");

sources/machine_info.cpp

@@ -0,0 +1,85 @@
+/*
+	Copyright 2006-2020 The QElectroTech Team
+	This file is part of QElectroTech.
+
+	QElectroTech is free software: you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by
+	the Free Software Foundation, either version 2 of the License, or
+	(at your option) any later version.
+
+	QElectroTech is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with QElectroTech.  If not, see <http://www.gnu.org/licenses/>.
+*/
+#include "machine_info.h"
+#include <QScreen>
+#include <QApplication>
+
+/**
+	@brief Machine_info::Machine_info
+	@param parent
+*/
+Machine_info::Machine_info(QObject *parent) : QObject(parent)
+{
+	init_get_Screen_info();
+}
+
+/**
+	@brief Machine_info::init_get_Screen_info
+	Finds the largest screen and saves the values
+*/
+void Machine_info::init_get_Screen_info()
+{
+	const auto screens = qApp->screens();
+	for (int ii = 0; ii < screens.count(); ++ii)
+	{
+		if(
+				Max_screen_width
+				<
+				screens[ii]->geometry().width()
+				*
+				screens[ii]->devicePixelRatio()
+				)
+		{
+			Max_screen_width =
+					screens[ii]->geometry().width()
+					*
+					screens[ii]->devicePixelRatio();
+		}
+		if(
+				Max_screen_height
+				<
+				screens[ii]->geometry().height()
+				*
+				screens[ii]->devicePixelRatio()
+				)
+		{
+			Max_screen_height =
+					screens[ii]->geometry().height()
+					*
+					screens[ii]->devicePixelRatio();
+		}
+	}
+}
+
+/**
+	@brief Machine_info::get_max_screen_width
+	@return max screen width
+ */
+int32_t Machine_info::get_max_screen_width()
+{
+	return Max_screen_width;
+}
+
+/**
+	@brief Machine_info::get_max_screen_height
+	@return max screen height
+*/
+int32_t Machine_info::get_max_screen_height()
+{
+	return Max_screen_height;
+}

sources/machine_info.h

@@ -0,0 +1,45 @@
+/*
+	Copyright 2006-2020 The QElectroTech Team
+	This file is part of QElectroTech.
+
+	QElectroTech is free software: you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by
+	the Free Software Foundation, either version 2 of the License, or
+	(at your option) any later version.
+
+	QElectroTech is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with QElectroTech.  If not, see <http://www.gnu.org/licenses/>.
+*/
+#ifndef MACHINE_INFO_H
+#define MACHINE_INFO_H
+
+#include <QObject>
+
+/**
+	@brief The Machine_info class
+	This class hold information from your PC.
+*/
+class Machine_info : public QObject
+{
+	Q_OBJECT
+public:
+	explicit Machine_info(QObject *parent = nullptr);
+	int32_t get_max_screen_width();
+	int32_t get_max_screen_height();
+
+signals:
+
+private:
+	void init_get_Screen_info();
+	int32_t Max_screen_width;
+	int32_t Max_screen_height;
+
+
+};
+
+#endif // MACHINE_INFO_H

sources/main.cpp

@@ -22,11 +22,13 @@
 #include <QStyleFactory>
 
 /**
- * @brief main
+	@brief main
- * Main function of QElectroTech
+	Main function of QElectroTech
- * @param argc : number of paramètres
+	@param argc : number of parameters
- * @param argv : paramètres
+	\~French number of paramètres
- * @return
+	\~ @param argv : parameters
+	\~French paramètres
+	\~ @return exit code
 */
 int main(int argc, char **argv)
 {
@@ -37,6 +39,7 @@ int main(int argc, char **argv)
 	//Creation and execution of the application
 	//HighDPI
 #if QT_VERSION >= QT_VERSION_CHECK(5, 6, 0)
+#pragma message("@TODO remove code for QT 5.6 or later")
 	QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
 #else
 	qputenv("QT_DEVICE_PIXEL_RATIO", QByteArray("auto"));
@@ -56,14 +59,16 @@ int main(int argc, char **argv)
 		//Remove the first argument, it's the binary file
 		arg_list.takeFirst();
 		QETArguments qetarg(arg_list);
-		QString message = "launched-with-args: " + QET::joinWithSpaces(QStringList(qetarg.arguments()));
+		QString message = "launched-with-args: " + QET::joinWithSpaces(
+					QStringList(qetarg.arguments()));
 		app.sendMessage(message.toUtf8());
 		return 0;
 	}
 	
 	QETApp qetapp;
 	QETApp::instance()->installEventFilter(&qetapp);
-	QObject::connect(&app, &SingleApplication::receivedMessage, &qetapp, &QETApp::receiveMessage);
+	QObject::connect(&app, &SingleApplication::receivedMessage,
+			 &qetapp, &QETApp::receiveMessage);
 	
 	return app.exec();
 }

sources/nomenclature.cpp

@@ -69,6 +69,7 @@ bool nomenclature::saveToCSVFile()
 #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)	// ### Qt 6: remove
 			stream << getNomenclature() << endl;
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 			stream << getNomenclature() << &Qt::endl(stream);
 #endif
 		}

sources/properties/propertiesinterface.cpp

@@ -17,6 +17,16 @@
 */
 #include "propertiesinterface.h"
 
+/**
+	@brief PropertiesInterface::PropertiesInterface
+*/
 PropertiesInterface::PropertiesInterface()
 {
 }
+/**
+	@brief PropertiesInterface::~PropertiesInterface
+*/
+PropertiesInterface::~PropertiesInterface()
+{
+
+}

sources/properties/propertiesinterface.h

@@ -23,18 +23,44 @@
 #include <QDomElement>
 
 /**
- * @brief The PropertiesInterface class
+	@brief The PropertiesInterface class
- * This class is an interface for have common way to use properties in QElectroTech
+	This class is an interface for have common way
+	to use properties in QElectroTech
 */
 class PropertiesInterface
 {
 	public:
 		PropertiesInterface();
-	// Save/load properties to setting file. QString is use for prefix a word befor the name of each paramètre
+		virtual ~PropertiesInterface();
-	virtual void toSettings	  (QSettings &settings, const QString = QString()) const =0;
+		/**
-	virtual void fromSettings (const QSettings &settings, const QString = QString()) =0;
+			@brief toSettings
-	// Save/load properties to xml element
+			Save properties to setting file.
+			@param settings : is use for prefix a word
+			befor the name of each paramètre
+		*/
+		virtual void toSettings (QSettings &settings,
+					 const QString = QString()) const =0;
+		/**
+			@brief fromSettings
+			load properties to setting file.
+			@param settings : is use for prefix a word
+			befor the name of each paramètre
+		*/
+		virtual void fromSettings (const QSettings &settings,
+					   const QString = QString()) =0;
+		/**
+			@brief toXml
+			Save properties to xml element
+			@param xml_document
+			@return QDomElement
+		*/
 		virtual QDomElement toXml (QDomDocument &xml_document) const =0;
+		/**
+			@brief fromXml
+			load properties to xml element
+			@param xml_element
+			@return true / false
+		*/
 		virtual bool fromXml (const QDomElement &xml_element) =0;
 };
 

sources/properties/reportproperties.h

@@ -20,6 +20,9 @@
 
 #include <QString>
 
+/**
+	@brief The ReportProperties class
+*/
 class ReportProperties
 {
 	public:

sources/properties/terminaldata.cpp

@@ -23,44 +23,89 @@ TerminalData::~TerminalData()
 
 }
 
+/**
+	@brief TerminalData::setParent
+	@param parent
+*/
 void TerminalData::setParent(QGraphicsObject* parent)
 {
 	q = parent;
 }
 
+/**
+	@brief TerminalData::toSettings
+	Save properties to setting file.
+
+	QString is use for prefix a word befor the name of each paramètre
+	@param settings UNUSED
+*/
 void TerminalData::toSettings(QSettings &settings, const QString) const
 
 {
 	Q_UNUSED(settings);
 }
 
+/**
+	@brief TerminalData::fromSettings
+	load properties to setting file.
+
+	QString is use for prefix a word befor the name of each paramètre
+	@param settings UNUSED
+*/
 void TerminalData::fromSettings(const QSettings &settings, const QString)
 {
 	Q_UNUSED(settings);
 }
 
+/**
+	@brief TerminalData::toXml
+	Save properties to xml element
+	write the name, number, position and orientation of the terminal
+	to xml_element
+
+	@note This method is only called from the PartTerminal
+	and should never called from the Terminal class
+	@param xml_document
+	@return xml_element : DomElement with
+	the name, number, position and orientation of the terminal
+*/
 QDomElement TerminalData::toXml(QDomDocument &xml_document) const
 {
 	QDomElement xml_element = xml_document.createElement("terminal");
 
+	// write the position of the terminal
 	// ecrit la position de la borne
 	xml_element.setAttribute("x", QString("%1").arg(q->scenePos().x()));
 	xml_element.setAttribute("y", QString("%1").arg(q->scenePos().y()));
 
-
+	// Write name and number to XML
 	xml_element.setAttribute("uuid", m_uuid.toString());
 	xml_element.setAttribute("name", m_name);
 
+	// write the orientation of the terminal
 	// ecrit l'orientation de la borne
-    xml_element.setAttribute("orientation", Qet::orientationToString(m_orientation));
+	xml_element.setAttribute("orientation",
-    // Write name and number to XML
+				 Qet::orientationToString(m_orientation));
 
 	return(xml_element);
 }
+
+/**
+	@brief TerminalData::fromXml
+	load properties to xml element
+
+	@note This method is only called from the PartTerminal
+	and should never called from the Terminal class
+	@param xml_element
+	@return true if succeeded / false if the attribute is not real
+*/
 bool TerminalData::fromXml (const QDomElement &xml_element)
 {
+	qreal term_x = 0.0;
+	qreal term_y = 0.0;
+
+	// reads the position of the terminal
 	// lit la position de la borne
-    qreal term_x = 0.0, term_y = 0.0;
 	if (!QET::attributeIsAReal(xml_element, "x", &term_x))
 		return false;
 
@@ -72,16 +117,20 @@ bool TerminalData::fromXml (const QDomElement &xml_element)
 	//emit posFromXML(QPointF(term_x, term_y));
 
 	QString uuid = xml_element.attribute("uuid");
-    // update part and add uuid, which is used in the new version to connect terminals together
+	// update part and add uuid, which is used in the new version
-    // if the attribute not exists, means, the element is created with an older version of qet. So use the legacy approach
+	// to connect terminals together
+	// if the attribute not exists, means, the element is created with an
+	// older version of qet. So use the legacy approach
 	// to identify terminals
 	if (!uuid.isEmpty())
 	m_uuid = QUuid(uuid);
 
 	m_name = xml_element.attribute("name");
 
+	// read the orientation of the terminal
 	// lit l'orientation de la borne
-    m_orientation = Qet::orientationFromString(xml_element.attribute("orientation"));
+	m_orientation = Qet::orientationFromString(
+				xml_element.attribute("orientation"));
 
 	return true;
 }

sources/properties/terminaldata.h

@@ -26,50 +26,58 @@ public:
 		void init();
 
 		void setParent(QGraphicsObject* parent);
-
+		void toSettings(QSettings &settings,
-    // Save/load properties to setting file. QString is use for prefix a word befor the name of each paramètre
+				const QString = QString()) const override;
-    void toSettings(QSettings &settings, const QString = QString()) const override;
+		void fromSettings(const QSettings &settings,
-    void fromSettings(const QSettings &settings, const QString = QString()) override;
+				  const QString = QString()) override;
-    // Save/load properties to xml element
-    // This method is only called from the PartTerminal and should never called from the Terminal class
 		QDomElement toXml(QDomDocument &xml_element) const override;
 		bool fromXml(const QDomElement &xml_element) override;
 
-    // must be public, because this class is a private member of PartTerminal/Terminal and they must
+	// must be public, because this class is a private member
-    // access this data
+	// of PartTerminal/Terminal and they must access this data
 	public:
-    /*!
+		/**
-     * \brief m_orientation
+			@brief m_orientation
-     * Orientation of the terminal
+			Orientation of the terminal
 		*/
 		Qet::Orientation m_orientation;
-    /*!
+		/**
-     * \brief second_point
+			@brief second_point
-     * Position of the second point of the terminal in scene coordinates
+			Position of the second point of the terminal
+			in scene coordinates
 		*/
 		QPointF second_point;
-    /*!
+		/**
-     * \brief m_uuid
+			@brief m_uuid
-     * Uuid of the terminal.
+			Uuid of the terminal.
-     *
+
-     * In elementscene.cpp an element gets a new uuid when saving the element. In the current state
+			In elementscene.cpp an element gets a new uuid when
-     * each connection is made by using the local position of the terminal and a dynamic id. In the new
+			saving the element. In the current state
-     * case, each terminal should have it's own uuid to identify it uniquely. When changing each time this
+			each connection is made by using the local position
-     * uuid, the conductor after updating the part is anymore valid. So if in the loaded document a uuid exists,
+			of the terminal and a dynamic id. In the new
-     * use this one and don't create a new one.
+			case, each terminal should have it's own uuid to
+			identify it uniquely. When changing each time this
+			uuid, the conductor after updating the part is anymore
+			valid. So if in the loaded document a uuid exists,
+			use this one and don't create a new one.
 		*/
 		QUuid m_uuid;
-    /*!
+		/**
-     * \brief m_name
+			@brief m_name
-     * Name of the element. It can be used to create wiring harness tables
+			Name of the element.
+			It can be used to create wiring harness tables
 		*/
 		QString m_name;
 
-    /*!
+		/**
-     * \brief m_pos
+			@brief m_pos
-     * Position of the terminal. The second point is calculated from this position and the orientation
+			Position of the terminal. The second point is calculated
-     * Important: this variable is only updated during read from xml and not during mouse move!
+			from this position and the orientation
-     * It is used to store the initial position so that PartTerminal and Terminal have access to it.
+			@note
+			Important: this variable is only updated during read
+			from xml and not during mouse move!
+			It is used to store the initial position so that
+			PartTerminal and Terminal have access to it.
 		*/
 		QPointF m_pos;
 	private:

sources/qet.cpp

@@ -176,6 +176,7 @@ bool QET::orthogonalProjection(const QPointF &point, const QLineF &line, QPointF
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)
 	QLineF::IntersectType it = line.intersect(perpendicular_line, &intersection_point); // ### Qt 6: remove
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QLineF::IntersectType it = line.intersects(perpendicular_line, &intersection_point);
 #endif
 	
@@ -450,6 +451,7 @@ QStringList QET::splitWithSpaces(const QString &string) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList escaped_strings = string.split(QRegExp("[^\\]?(?:\\\\)* "), QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QStringList escaped_strings = string.split(QRegExp("[^\\]?(?:\\\\)* "), Qt::SkipEmptyParts);
 #endif
 

sources/qetdiagrameditor.cpp

@@ -2220,19 +2220,19 @@ void QETDiagramEditor::generateTerminalBlock()
 		success = process->startDetached("qet_tb_generator", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached("qet_tb_generator");
+		success = process->startDetached("qet_tb_generator", {("")});
 	}
 	if (openedProjects().count()){
 		success = process->startDetached(QDir::homePath() + "/Application Data/qet/qet_tb_generator.exe", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached(QDir::homePath() + "/Application Data/qet/qet_tb_generator.exe");
+		success = process->startDetached(QDir::homePath() + "/Application Data/qet/qet_tb_generator.exe", {("")});
 	}
 	if (openedProjects().count()){
 		success = process->startDetached(QDir::homePath() + "/qet_tb_generator.exe", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached(QDir::homePath() + "/qet_tb_generator.exe");
+		success = process->startDetached(QDir::homePath() + "/qet_tb_generator.exe", {("")});
 	}
 
 #elif  defined(Q_OS_MAC)
@@ -2240,13 +2240,13 @@ void QETDiagramEditor::generateTerminalBlock()
 		success = process->startDetached("/Library/Frameworks/Python.framework/Versions/3.8/bin/qet_tb_generator", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached("/Library/Frameworks/Python.framework/Versions/3.8/bin/qet_tb_generator");
+		success = process->startDetached("/Library/Frameworks/Python.framework/Versions/3.8/bin/qet_tb_generator", {("")});
 	}
 		if (openedProjects().count()){
 		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator.app", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator.app");
+		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator.app", {("")});
 	}
 	
 #else
@@ -2254,13 +2254,13 @@ void QETDiagramEditor::generateTerminalBlock()
 		success = process->startDetached("qet_tb_generator", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached("qet_tb_generator");
+		success = process->startDetached("qet_tb_generator", {("")});
 	}
 	if (openedProjects().count()){
 		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator", {(QETDiagramEditor::currentProjectView()->project()->filePath())});
 	}
 	else  {
-		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator");
+		success = process->startDetached(QDir::homePath() + "/.qet/qet_tb_generator", {("")});
 	}
 	
 #endif

sources/qetgraphicsitem/ViewItem/projectdbmodel.cpp

@@ -309,8 +309,6 @@ void ProjectDBModel::dataBaseUpdated()
 	auto new_record = m_record;
 	m_record = original_record;
 	
-	//This a very special case, if this nomenclature model is added
-	//befor any element, column count return 0, so in this case we emit column inserted
 	if (new_record.size() != m_record.size())
 	{
 		emit beginResetModel();

sources/qetgraphicsitem/ViewItem/qetgraphicstableitem.cpp

@@ -61,6 +61,56 @@ void QetGraphicsTableItem::adjustTableToFolio(QetGraphicsTableItem *table, QMarg
 	table->setDisplayNRow(int(floor(available_height/min_row_height))); //Convert a double to int, but max_row_to_display is already rounded an integer so we assume everything is ok
 }
 
+/**
+ * @brief QetGraphicsTableItem::checkInsufficientRowsCount
+ * Check if the number of rows of @table + linked table is enough to display all
+ * content of the model, if not open a dialog to advise user what to do.
+ * @param table
+ */
+void QetGraphicsTableItem::checkInsufficientRowsCount(QetGraphicsTableItem *table)
+{
+	if (!table->diagram() || !table->model()) {
+		return;
+	}
+
+	auto first_table = table;
+	while (first_table->previousTable())
+		first_table = first_table->previousTable();
+
+	if (first_table->displayNRow() <= 0) //displayed rows is unlimited
+		return;
+
+	int count_ = first_table->displayNRow();
+	bool several_table = false;
+	while (first_table->nextTable())
+	{
+		several_table = true;
+		first_table = first_table->nextTable();
+		if (first_table->displayNRow() <= 0) { //displayed rows is unlimited
+			return;
+		} else {
+			count_ += first_table->displayNRow();
+			first_table->displayNRowOffset();
+		}
+	}
+
+	if (count_ < first_table->model()->rowCount())
+	{
+		QWidget *parent = first_table->diagram()->views().first() ? first_table->diagram()->views().first() : nullptr;
+
+		QString text;
+		if (several_table) {
+			text = tr("Les information à afficher sont supérieurs à la quantité maximal pouvant être affiché par les tableaux.\n"
+					  "Veuillez ajouter un nouveau tableau ou regler les tableaux existant afin d'afficher l'integralité des informations.");
+		} else {
+			text = tr("Les information à afficher sont supérieurs à la quantité maximal pouvant être affiché par le tableau.\n"
+					  "Veuillez ajouter un nouveau tableau ou regler le tableau existant afin d'afficher l'integralité des informations.");
+		}
+		QMessageBox::information(parent, tr("Limitation de tableau"), text);
+	}
+
+}
+
 /**
  * @brief QetGraphicsTableItem::QetGraphicsTableItem
  * Default constructor
@@ -601,6 +651,10 @@ QVariant QetGraphicsTableItem::itemChange(QGraphicsItem::GraphicsItemChange chan
 void QetGraphicsTableItem::modelReseted() {
 	dataChanged(m_model->index(0,0), m_model->index(0,0), QVector<int>());
 	setToMinimumHeight();
+
+	if (!previousTable()) { //this is the head table
+		checkInsufficientRowsCount(this);
+	}
 }
 
 /**

sources/qetgraphicsitem/ViewItem/qetgraphicstableitem.h

@@ -48,6 +48,7 @@ class QetGraphicsTableItem : public QetGraphicsItem
 
 	public :
 		static void adjustTableToFolio(QetGraphicsTableItem *table, QMargins margins = QMargins(20,20,20,0));
+		static void checkInsufficientRowsCount(QetGraphicsTableItem *first_table);
 
     public:
         QetGraphicsTableItem(QGraphicsItem *parent= nullptr);

sources/qetgraphicsitem/ViewItem/ui/graphicstablepropertieseditor.cpp

@@ -52,6 +52,8 @@ GraphicsTablePropertiesEditor::GraphicsTablePropertiesEditor(QetGraphicsTableIte
 	if (table) {
 		setTable(table);
 	}
+
+	ui->m_info_label->setStyleSheet("QLabel {color : red; }");
 }
 
 /**
@@ -281,6 +283,8 @@ void GraphicsTablePropertiesEditor::updateUi()
 		}
 	}
 
+	updateInfoLabel();
+
 	auto margin = QETUtils::marginsFromString(m_table_item->model()->headerData(0, Qt::Horizontal, Qt::UserRole+1).toString());
 	ui->m_header_top_margin   ->setValue(margin.top());
 	ui->m_header_left_margin  ->setValue(margin.left());
@@ -306,6 +310,38 @@ void GraphicsTablePropertiesEditor::updateUi()
 	setUpEditConnection();
 }
 
+void GraphicsTablePropertiesEditor::updateInfoLabel()
+{
+	auto table_ = m_table_item;
+	while (table_->previousTable()) { table_ = table_->previousTable();}
+
+	int count_ = 0;
+	bool infinite = false;
+	if (table_->displayNRow() <= 0) {
+		infinite = true;
+	} else {
+		count_ = table_->displayNRow();
+	}
+
+	while (table_->nextTable())
+	{
+		table_ = table_->nextTable();
+		if (table_->displayNRow() <= 0) {
+			infinite = true;
+		} else {
+			count_ += table_->displayNRow();
+		}
+	}
+
+	auto value = m_table_item->model()->rowCount() - count_;
+	if (value > 0 && !infinite) {
+		ui->m_info_label->setText(tr("<center>ATTENTION :</center>\n il manque %1 lignes afin d'afficher l'intégralité des informations").arg(value));
+		ui->m_info_label->show();
+	} else {
+		ui->m_info_label->hide();
+	}
+}
+
 /**
  * @brief GraphicsTablePropertiesEditor::setUpEditConnection
  */
@@ -333,10 +369,12 @@ void GraphicsTablePropertiesEditor::setUpEditConnection()
 		m_edit_connection << connect(m_table_button_group,       QOverload<int>::of(&QButtonGroup::buttonClicked), this, &GraphicsTablePropertiesEditor::apply);
 		m_edit_connection << connect(m_header_button_group,      QOverload<int>::of(&QButtonGroup::buttonClicked), this, &GraphicsTablePropertiesEditor::apply);
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 		m_edit_connection << connect(m_table_button_group,       QOverload<int>::of(&QButtonGroup::idClicked), this, &GraphicsTablePropertiesEditor::apply);
 		m_edit_connection << connect(m_header_button_group,      QOverload<int>::of(&QButtonGroup::idClicked), this, &GraphicsTablePropertiesEditor::apply);
 #endif
 		m_edit_connection << connect(ui->m_display_n_row_sb,     QOverload<int>::of(&QSpinBox::valueChanged),      this, &GraphicsTablePropertiesEditor::apply);
+		m_edit_connection << connect(ui->m_display_n_row_sb,     QOverload<int>::of(&QSpinBox::valueChanged),      this, &GraphicsTablePropertiesEditor::updateInfoLabel);
 	}
 }
 

sources/qetgraphicsitem/ViewItem/ui/graphicstablepropertieseditor.h

@@ -52,6 +52,7 @@ class GraphicsTablePropertiesEditor : public PropertiesEditorWidget
 		void on_m_header_font_pb_clicked();
 		void on_m_table_font_pb_clicked();
 		virtual void updateUi() override;
+		void updateInfoLabel();
 		void on_m_table_name_le_textEdited(const QString &arg1);
 		void on_m_previous_table_cb_activated(int index);
 		void on_m_previous_pb_clicked();

sources/qetgraphicsitem/ViewItem/ui/graphicstablepropertieseditor.ui

@@ -7,7 +7,7 @@
     <x>0</x>
     <y>0</y>
     <width>524</width>
-    <height>600</height>
+    <height>623</height>
    </rect>
   </property>
   <property name="windowTitle">
@@ -40,40 +40,17 @@
           <string>Géometrie et lignes</string>
          </property>
          <layout class="QGridLayout" name="gridLayout_2" columnstretch="0,0,0,0,0,0,0,0">
-          <item row="0" column="6">
-           <widget class="QPushButton" name="m_apply_geometry_to_linked_table_pb">
-            <property name="toolTip">
-             <string>Appliquer la géometrie à tous les tableaux liée à celui-ci</string>
-            </property>
-            <property name="text">
-             <string/>
-            </property>
-            <property name="icon">
-             <iconset resource="../../../../qelectrotech.qrc">
-              <normaloff>:/ico/22x22/all_pages.png</normaloff>:/ico/22x22/all_pages.png</iconset>
-            </property>
-           </widget>
-          </item>
-          <item row="1" column="2">
-           <widget class="QSpinBox" name="m_y_pos">
-            <property name="maximum">
-             <number>10000</number>
-            </property>
-           </widget>
-          </item>
           <item row="1" column="4">
-           <widget class="QComboBox" name="m_previous_table_cb">
+           <widget class="QSpinBox" name="m_display_n_row_sb">
-            <property name="insertPolicy">
+            <property name="specialValueText">
-             <enum>QComboBox::InsertAtBottom</enum>
+             <string>Toutes</string>
             </property>
-            <item>
+            <property name="maximum">
-             <property name="text">
+             <number>999</number>
-              <string>Aucun</string>
             </property>
-            </item>
            </widget>
           </item>
-          <item row="1" column="6">
+          <item row="2" column="6">
            <widget class="QPushButton" name="m_next_pb">
             <property name="enabled">
              <bool>true</bool>
@@ -93,14 +70,19 @@
             </property>
            </widget>
           </item>
-          <item row="0" column="2">
+          <item row="2" column="4">
-           <widget class="QSpinBox" name="m_x_pos">
+           <widget class="QComboBox" name="m_previous_table_cb">
-            <property name="maximum">
+            <property name="insertPolicy">
-             <number>10000</number>
+             <enum>QComboBox::InsertAtBottom</enum>
             </property>
+            <item>
+             <property name="text">
+              <string>Aucun</string>
+             </property>
+            </item>
            </widget>
           </item>
-          <item row="0" column="0">
+          <item row="1" column="0">
            <spacer name="horizontalSpacer">
             <property name="orientation">
              <enum>Qt::Horizontal</enum>
@@ -113,20 +95,7 @@
             </property>
            </spacer>
           </item>
-          <item row="1" column="7">
+          <item row="1" column="5">
-           <spacer name="horizontalSpacer_2">
-            <property name="orientation">
-             <enum>Qt::Horizontal</enum>
-            </property>
-            <property name="sizeHint" stdset="0">
-             <size>
-              <width>40</width>
-              <height>20</height>
-             </size>
-            </property>
-           </spacer>
-          </item>
-          <item row="0" column="5">
            <widget class="QPushButton" name="m_auto_geometry_pb">
             <property name="toolTip">
              <string>Ajuster le tableau au folio</string>
@@ -140,7 +109,47 @@
             </property>
            </widget>
           </item>
-          <item row="2" column="1" colspan="6">
+          <item row="2" column="7">
+           <spacer name="horizontalSpacer_2">
+            <property name="orientation">
+             <enum>Qt::Horizontal</enum>
+            </property>
+            <property name="sizeHint" stdset="0">
+             <size>
+              <width>40</width>
+              <height>20</height>
+             </size>
+            </property>
+           </spacer>
+          </item>
+          <item row="2" column="1">
+           <widget class="QLabel" name="label_7">
+            <property name="text">
+             <string>Y :</string>
+            </property>
+            <property name="alignment">
+             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
+            </property>
+           </widget>
+          </item>
+          <item row="1" column="1">
+           <widget class="QLabel" name="label_8">
+            <property name="text">
+             <string>X :</string>
+            </property>
+            <property name="alignment">
+             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
+            </property>
+           </widget>
+          </item>
+          <item row="1" column="2">
+           <widget class="QSpinBox" name="m_x_pos">
+            <property name="maximum">
+             <number>10000</number>
+            </property>
+           </widget>
+          </item>
+          <item row="4" column="1" colspan="6">
            <widget class="QWidget" name="widget_3" native="true">
             <layout class="QHBoxLayout" name="horizontalLayout_3">
              <property name="leftMargin">
@@ -158,47 +167,7 @@
             </layout>
            </widget>
           </item>
-          <item row="0" column="3">
+          <item row="2" column="5">
-           <widget class="QLabel" name="label">
-            <property name="text">
-             <string>Lignes à afficher :</string>
-            </property>
-            <property name="alignment">
-             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
-            </property>
-           </widget>
-          </item>
-          <item row="0" column="1">
-           <widget class="QLabel" name="label_8">
-            <property name="text">
-             <string>X :</string>
-            </property>
-            <property name="alignment">
-             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
-            </property>
-           </widget>
-          </item>
-          <item row="0" column="4">
-           <widget class="QSpinBox" name="m_display_n_row_sb">
-            <property name="specialValueText">
-             <string>Toutes</string>
-            </property>
-            <property name="maximum">
-             <number>999</number>
-            </property>
-           </widget>
-          </item>
-          <item row="1" column="3">
-           <widget class="QLabel" name="label_3">
-            <property name="text">
-             <string>Tableau précédent :</string>
-            </property>
-            <property name="alignment">
-             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
-            </property>
-           </widget>
-          </item>
-          <item row="1" column="5">
            <widget class="QPushButton" name="m_previous_pb">
             <property name="enabled">
              <bool>true</bool>
@@ -218,16 +187,60 @@
             </property>
            </widget>
           </item>
-          <item row="1" column="1">
+          <item row="2" column="2">
-           <widget class="QLabel" name="label_7">
+           <widget class="QSpinBox" name="m_y_pos">
+            <property name="maximum">
+             <number>10000</number>
+            </property>
+           </widget>
+          </item>
+          <item row="1" column="6">
+           <widget class="QPushButton" name="m_apply_geometry_to_linked_table_pb">
+            <property name="toolTip">
+             <string>Appliquer la géometrie à tous les tableaux liée à celui-ci</string>
+            </property>
             <property name="text">
-             <string>Y :</string>
+             <string/>
+            </property>
+            <property name="icon">
+             <iconset resource="../../../../qelectrotech.qrc">
+              <normaloff>:/ico/22x22/all_pages.png</normaloff>:/ico/22x22/all_pages.png</iconset>
+            </property>
+           </widget>
+          </item>
+          <item row="2" column="3">
+           <widget class="QLabel" name="label_3">
+            <property name="text">
+             <string>Tableau précédent :</string>
             </property>
             <property name="alignment">
              <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
             </property>
            </widget>
           </item>
+          <item row="1" column="3">
+           <widget class="QLabel" name="label">
+            <property name="text">
+             <string>Lignes à afficher :</string>
+            </property>
+            <property name="alignment">
+             <set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
+            </property>
+           </widget>
+          </item>
+          <item row="3" column="1" colspan="6">
+           <widget class="QLabel" name="m_info_label">
+            <property name="text">
+             <string>TextLabel</string>
+            </property>
+            <property name="textFormat">
+             <enum>Qt::RichText</enum>
+            </property>
+            <property name="scaledContents">
+             <bool>false</bool>
+            </property>
+           </widget>
+          </item>
          </layout>
         </widget>
        </item>

sources/qetgraphicsitem/conductor.cpp

@@ -1675,6 +1675,7 @@ QSet<Conductor *> Conductor::relatedPotentialConductors(const bool all_diagram,
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 			other_conductors += other_conductors_list_t.toSet();
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 			other_conductors += QSet<Conductor*>(other_conductors_list_t.begin(),other_conductors_list_t.end());
 #endif
 		}

sources/qetgraphicsitem/element.cpp

@@ -826,6 +826,7 @@ bool Element::fromXml(QDomElement &e, QHash<int, Terminal *> &table_id_adr, bool
 		 * this mean the label was made before commit 4791 (0.51 dev). So we swap the value stored in "label" to "formula" as expected.
 		 * @TODO remove this code at version 0.7 or more (probably useless).
 		 */
+#pragma message("@TODO remove this code for qet 0.7 or later")
 	if (dc["label"].toString().contains("%") && dc["formula"].toString().isNull())
 	{
 		dc.addValue("formula", dc["label"]);

sources/qetxml.cpp

@@ -23,11 +23,12 @@
 #include <QFont>
 
 /**
- * @brief QETXML::penToXml
+	@brief QETXML::penToXml
- * Write attribute of a QPen in xml element
+	Write attribute of a QPen in xml element
- * @param parent_document : parent document for create the QDomElement
+	@param parent_document : parent document for create the QDomElement
- * @param pen : the pen to store
+	@param pen : the pen to store
- * @return : A QDomElement with the attribute stored. The tagName of QDomeElement is "pen".
+	@return : A QDomElement with the attribute stored.
+	The tagName of QDomeElement is "pen".
 */
 QDomElement QETXML::penToXml(QDomDocument &parent_document,const QPen& pen)
 {
@@ -52,11 +53,11 @@ QDomElement QETXML::penToXml(QDomDocument &parent_document,const QPen& pen)
 }
 
 /**
- * @brief QETXML::penFromXml
+	@brief QETXML::penFromXml
- * Build a QPen from a xml description
+	Build a QPen from a xml description
- * @param element, The QDomElement that describe the pen
+	@param element, The QDomElement that describe the pen
- * @return the created pen. If @element is null or tagName isn't "pen"
+	@return the created pen. If @element is null or tagName isn't "pen"
- * return a default constructed QPen
+	return a default constructed QPen
 */
 QPen QETXML::penFromXml(const QDomElement &element)
 {
@@ -86,13 +87,15 @@ QPen QETXML::penFromXml(const QDomElement &element)
 }
 
 /**
- * @brief QETXML::brushToXml
+	@brief QETXML::brushToXml
- * Write attribute of a QBrush in xml element
+	Write attribute of a QBrush in xml element
- * @param parent_document : parent document for create the QDomElement
+	@param parent_document : parent document for create the QDomElement
- * @param brush : the brush to store
+	@param brush : the brush to store
- * @return A QDomElement with the attribute stored. The tagName of QDomeElement is "brush".
+	@return A QDomElement with the attribute stored.
+	The tagName of QDomeElement is "brush".
 */
-QDomElement QETXML::brushToXml(QDomDocument &parent_document, const QBrush& brush)
+QDomElement QETXML::brushToXml(QDomDocument &parent_document,
+			       const QBrush& brush)
 {
 	QDomElement element = parent_document.createElement("brush");
 
@@ -123,11 +126,11 @@ QDomElement QETXML::brushToXml(QDomDocument &parent_document, const QBrush& brus
 }
 
 /**
- * @brief QETXML::brushFromXml
+	@brief QETXML::brushFromXml
- * Build a QBrush from a xml description
+	Build a QBrush from a xml description
- * @param element, the QDomElement that describe the pen
+	@param element, the QDomElement that describe the pen
- * @return the created brush. If @element is null or tagName isn't "brush"
+	@return the created brush. If @element is null or tagName isn't "brush"
- * return a default constructed QBrush
+	return a default constructed QBrush
 */
 QBrush QETXML::brushFromXml(const QDomElement &element)
 {
@@ -158,15 +161,20 @@ QBrush QETXML::brushFromXml(const QDomElement &element)
 }
 
 /**
- * @brief QETXML::fileSystemDirToXmlCollectionDir
+	@brief QETXML::fileSystemDirToXmlCollectionDir
- * @param document : owner document of returned QDomElement, use to create the QDomElement.
+	@param document : owner document of returned QDomElement,
- * @param dir : file system direcory to convert to QDomElement directory
+	use to create the QDomElement.
- * @param rename : by default the attribute "name" of the returned QDomElement is the same name of @dir
+	@param dir : file system direcory to convert to QDomElement directory
- * but we can override itwith @rename
+	@param rename : by default the attribute "name" of the returned
- * @return A file system directory converted to a QDomElement directory ready to be inserted into a XmlElementCollection.
+	QDomElement is the same name of @dir
- * If the QDomElement can't be created, return a null QDomElement.
+	but we can override itwith @rename
+	@return A file system directory converted to a QDomElement directory
+	ready to be inserted into a XmlElementCollection.
+	If the QDomElement can't be created, return a null QDomElement.
 */
-QDomElement QETXML::fileSystemDirToXmlCollectionDir(QDomDocument &document, const QDir &dir, const QString& rename)
+QDomElement QETXML::fileSystemDirToXmlCollectionDir(QDomDocument &document,
+						    const QDir &dir,
+						    const QString& rename)
 {
 	if (!dir.exists()) return QDomElement();
 
@@ -175,7 +183,9 @@ QDomElement QETXML::fileSystemDirToXmlCollectionDir(QDomDocument &document, cons
 
 		//Get the traduction of this directory
 	QFile qet_dir(dir.filePath("qet_directory"));
-	if (qet_dir.exists() && qet_dir.open(QIODevice::ReadOnly | QIODevice::Text))
+	if (qet_dir.exists() && qet_dir.open(
+				QIODevice::ReadOnly
+				| QIODevice::Text))
 	{
 			//Get the content of the file
 		QDomDocument trad_document;
@@ -196,15 +206,21 @@ QDomElement QETXML::fileSystemDirToXmlCollectionDir(QDomDocument &document, cons
 }
 
 /**
- * @brief QETXML::fileSystemElementToXmlCollectionElement
+	@brief QETXML::fileSystemElementToXmlCollectionElement
- * @param document : owner document of returned QDomElement, use to create the QDomElement.
+	@param document : owner document of returned QDomElement,
- * @param file : file system element file to convert to QDomElement;
+	use to create the QDomElement.
- * @param rename : by default the attribute "name" of the returned QDomElement is the same name of @file
+	@param file : file system element file to convert to QDomElement;
- * but we can override itwith @rename
+	@param rename : by default the attribute "name" of
- * @return A file system element converted to a QDomElement ready to be inserted into a XmlElementCollection
+	the returned QDomElement is the same name of @file
- * If the QDomElement can't be created, return a null QDomElement
+	but we can override itwith @rename
+	@return A file system element converted to a QDomElement
+	ready to be inserted into a XmlElementCollection
+	If the QDomElement can't be created, return a null QDomElement
 */
-QDomElement QETXML::fileSystemElementToXmlCollectionElement(QDomDocument &document, QFile &file, const QString& rename)
+QDomElement QETXML::fileSystemElementToXmlCollectionElement(
+		QDomDocument &document,
+		QFile &file,
+		const QString& rename)
 {
 	if (file.exists() && file.open(QIODevice::ReadOnly | QIODevice::Text))
 	{
@@ -229,14 +245,18 @@ QDomElement QETXML::fileSystemElementToXmlCollectionElement(QDomDocument &docume
 }
 
 /**
- * @brief QETXML::writeXmlFile
+	@brief QETXML::writeXmlFile
- * 	Export an XML document to an UTF-8 text file indented with 4 spaces, with LF end of lines and no BOM.
+	Export an XML document to an UTF-8 text file indented with 4 spaces,
- * @param xml_document : An XML document to be exported
+	with LF end of lines and no BOM.
- * @param file_path : Path to the file to be written
+	@param xml_document : An XML document to be exported
- * @param error_message : If non-zero, will contain an error message explaining what happened when this function returns false.
+	@param file_path : Path to the file to be written
- * @return false if an error occurred, true otherwise
+	@param error_message : If non-zero, will contain an error message
+	explaining what happened when this function returns false.
+	@return false if an error occurred, true otherwise
 */
-bool QETXML::writeXmlFile(const QDomDocument &xml_document, const QString &file_path, QString *error_message)
+bool QETXML::writeXmlFile(const QDomDocument &xml_document,
+			  const QString &file_path,
+			  QString *error_message)
 {
 	QFile file(file_path);
 
@@ -246,7 +266,9 @@ bool QETXML::writeXmlFile(const QDomDocument &xml_document, const QString &file_
 	{
 		if (error_message)
 		{
-			*error_message = QString(QObject::tr("Impossible d'ouvrir le fichier %1 en écriture, erreur %2 rencontrée.",
+			*error_message = QString(
+						QObject::tr(
+							"Impossible d'ouvrir le fichier %1 en écriture, erreur %2 rencontrée.",
 							 "error message when attempting to write an XML file")
 							 ).arg(file_path).arg(file.error());
 		}
@@ -263,14 +285,17 @@ bool QETXML::writeXmlFile(const QDomDocument &xml_document, const QString &file_
 }
 
 /**
- * @brief QETXML::textToDomElement
+	@brief QETXML::textToDomElement
- * Return a QDomElement, created from @document, with tag name @tag_name and text @value.
+	Return a QDomElement, created from @document,
- * @param document
+	with tag name @tag_name and text @value.
- * @param tag_name
+	@param document
- * @param value
+	@param tag_name
- * @return
+	@param value
+	@return a QDomElement, created from @document
 */
-QDomElement QETXML::textToDomElement(QDomDocument &document, const QString& tag_name, const QString& value)
+QDomElement QETXML::textToDomElement(QDomDocument &document,
+				     const QString& tag_name,
+				     const QString& value)
 {
 	QDomElement element = document.createElement(tag_name);
 	QDomText text = document.createTextNode(value);
@@ -280,15 +305,19 @@ QDomElement QETXML::textToDomElement(QDomDocument &document, const QString& tag_
 }
 
 /**
- * @brief QETXML::directChild
+	@brief QETXML::directChild
- * @param element
+	@param element
- * @param tag_name
+	@param tag_name
- * @return All direct child of @element  with the tag name @tag_name
+	@return All direct child of @element  with the tag name @tag_name
 */
-QVector<QDomElement> QETXML::directChild(const QDomElement &element, const QString &tag_name)
+QVector<QDomElement> QETXML::directChild(const QDomElement &element,
+					 const QString &tag_name)
 {
 	QVector<QDomElement> return_list;
-	for (QDomNode node = element.firstChild() ; !node.isNull() ; node = node.nextSibling())
+	for (
+	     QDomNode node = element.firstChild() ;
+	     !node.isNull() ;
+	     node = node.nextSibling())
 	{
 		if (!node.isElement()) continue;
 		QDomElement element = node.toElement();
@@ -300,25 +329,34 @@ QVector<QDomElement> QETXML::directChild(const QDomElement &element, const QStri
 }
 
 /**
- * @brief QETXML::subChild
+	@brief QETXML::subChild
- * @param element
+	@param element
- * @param parent_tag_name
+	@param parent_tag_name
- * @param children_tag_name
+	@param children_tag_name
- * @return When given an xml dom element @element,
+	@return When given an xml dom element @element,
- * returns a vector of all children dom_elements tagged @children_tag_name
+	returns a vector of all children dom_elements tagged @children_tag_name
- * nested in the parent dom elements tagged parent_tag_name, themselves children of the dom element @element.
+	nested in the parent dom elements tagged parent_tag_name,
+	themselves children of the dom element @element.
 */
-QVector<QDomElement> QETXML::subChild(const QDomElement &element, const QString parent_tag_name, const QString &children_tag_name)
+QVector<QDomElement> QETXML::subChild(const QDomElement &element,
+				      const QString parent_tag_name,
+				      const QString &children_tag_name)
 {
 	QVector<QDomElement> return_list;
 
-	for (QDomNode child = element.firstChild() ; !child.isNull() ; child = child.nextSibling())
+	for (
+	     QDomNode child = element.firstChild() ;
+	     !child.isNull() ;
+	     child = child.nextSibling())
 	{
 		QDomElement parents = child.toElement();
 		if (parents.isNull() || parents.tagName() != parent_tag_name)
 			continue;
 
-		for (QDomNode node_children = parents.firstChild() ; !node_children.isNull() ; node_children = node_children.nextSibling())
+		for (
+		     QDomNode node_children = parents.firstChild() ;
+		     !node_children.isNull() ;
+		     node_children = node_children.nextSibling())
 		{
 			QDomElement n_children = node_children.toElement();
 			if (!n_children.isNull() && n_children.tagName() == children_tag_name)
@@ -330,28 +368,33 @@ QVector<QDomElement> QETXML::subChild(const QDomElement &element, const QString
 }
 
 /**
- * @brief QETXML::marginsToXml
+	@brief QETXML::marginsToXml
- * Save a QMargins to xml. the xml tag name is 'margins'
+	Save a QMargins to xml. the xml tag name is 'margins'
- * @param parent_document
+	@param parent_document
- * @param margins
+	@param margins
- * @return
+	@return
 */
-QDomElement QETXML::marginsToXml(QDomDocument &parent_document, const QMargins &margins)
+QDomElement QETXML::marginsToXml(QDomDocument &parent_document,
+				 const QMargins &margins)
 {
 	auto dom_ = parent_document.createElement("margins");
-	auto text_ = parent_document.createTextNode(QString::number(margins.left())  + QString(";") +
+	auto text_ = parent_document.createTextNode(
-												QString::number(margins.top())   + QString(";") +
+				QString::number(margins.left())
-												QString::number(margins.right()) + QString(";") +
+				+ QString(";")
-												QString::number(margins.bottom()));
+				+ QString::number(margins.top())
+				+ QString(";")
+				+ QString::number(margins.right())
+				+ QString(";")
+				+ QString::number(margins.bottom()));
 	dom_.appendChild(text_);
 	return  dom_;
 }
 
 /**
- * @brief QETXML::marginsFromXml
+	@brief QETXML::marginsFromXml
- * @param element
+	@param element
- * @return a QMargins from an xml description.
+	@return a QMargins from an xml description.
- * The tag name must ne 'margins'
+	The tag name must ne 'margins'
 */
 QMargins QETXML::marginsFromXml(const QDomElement &element)
 {
@@ -361,22 +404,35 @@ QMargins QETXML::marginsFromXml(const QDomElement &element)
 
 	auto margins_ = element.text().split(";");
 	if (margins_.size() == 4) {
-		return QMargins(margins_.at(0).toInt(), margins_.at(1).toInt(), margins_.at(2).toInt(), margins_.at(3).toInt());
+		return QMargins(
+					margins_.at(0).toInt(),
+					margins_.at(1).toInt(),
+					margins_.at(2).toInt(),
+					margins_.at(3).toInt());
 	} else {
 		return QMargins();
 	}
 }
 
 /**
- * @brief QETXML::modelHeaderDataToXml
+	@brief QETXML::modelHeaderDataToXml
- * Save to xml element all header data specified by @horizontal_section_role and @vertical_section_role
+	Save to xml element all header data specified
- * @param parent_document
+	by @horizontal_section_role and @vertical_section_role
- * @param model
+	@param parent_document
- * @param horizontal_section_role : key as header section and value as list of roles to save in xml
+	@param model
- * @param vertical_section_role :key as header section and value as list of roles to save in xml
+	@param horizontal_section_role : key as header section and value
- * @return
+	as list of roles to save in xml
+	@param vertical_section_role :key as header section and value
+	as list of roles to save in xml
+	@return
 */
-QDomElement QETXML::modelHeaderDataToXml(QDomDocument &parent_document, const QAbstractItemModel *model, QHash<int, QList<int>> horizontal_section_role, QHash<int, QList<int>> vertical_section_role)
+QDomElement QETXML::modelHeaderDataToXml(
+		QDomDocument &parent_document,
+		const QAbstractItemModel *model,
+		QHash<int,
+		QList<int>> horizontal_section_role,
+		QHash<int,
+		QList<int>> vertical_section_role)
 {
 	auto dom_element = parent_document.createElement("header_data");
 
@@ -401,7 +457,11 @@ QDomElement QETXML::modelHeaderDataToXml(QDomDocument &parent_document, const QA
 					dom_data.setAttribute("role", meta_enum_role.valueToKey(role));
 
 					auto text_node = parent_document.createTextNode("");
-					if (role == Qt::DisplayRole || role == Qt::EditRole || role == Qt::ToolTipRole || role == Qt::StatusTipRole || role == Qt::WhatsThisRole)
+					if (role == Qt::DisplayRole
+						|| role == Qt::EditRole
+						|| role == Qt::ToolTipRole
+						|| role == Qt::StatusTipRole
+						|| role == Qt::WhatsThisRole)
 					{
 						text_node.setData(variant.toString());
 					}
@@ -433,12 +493,13 @@ QDomElement QETXML::modelHeaderDataToXml(QDomDocument &parent_document, const QA
 }
 
 /**
- * @brief QETXML::modelHeaderDataFromXml
+	@brief QETXML::modelHeaderDataFromXml
- * Restore from xml modele header data
+	Restore from xml modele header data
- * @param element
+	@param element
- * @param model
+	@param model
 */
-void QETXML::modelHeaderDataFromXml(const QDomElement &element, QAbstractItemModel *model)
+void QETXML::modelHeaderDataFromXml(const QDomElement &element,
+				    QAbstractItemModel *model)
 {
 	if (element.tagName() != "header_data")
 		return;
@@ -449,12 +510,25 @@ void QETXML::modelHeaderDataFromXml(const QDomElement &element, QAbstractItemMod
 	for (auto child : QETXML::directChild(element, "data"))
 	{
 		auto section_ = child.attribute("section", "-1").toInt();
-		auto orientation_ = Qt::Orientation(meta_enum_orientation.keyToValue(child.attribute("orientation", "Horizontal").toStdString().data()));
+		auto orientation_ = Qt::Orientation(
-		auto role_ = meta_enum_role.keyToValue(child.attribute("role", "DisplayRole").toStdString().data());
+					meta_enum_orientation.keyToValue(
+						child.attribute(
+							"orientation",
+							"Horizontal"
+							).toStdString().data()));
+		auto role_ = meta_enum_role.keyToValue(
+					child.attribute(
+						"role",
+						"DisplayRole"
+						).toStdString().data());
 		auto text_ = child.text();
 		QVariant data_;
 
-		if (role_ == Qt::DisplayRole || role_ == Qt::EditRole || role_ == Qt::ToolTipRole || role_ == Qt::StatusTipRole || role_ == Qt::WhatsThisRole) {
+		if (role_ == Qt::DisplayRole
+				|| role_ == Qt::EditRole
+				|| role_ == Qt::ToolTipRole
+				|| role_ == Qt::StatusTipRole
+				|| role_ == Qt::WhatsThisRole) {
 			data_ = text_;
 		}
 		else if (role_ == Qt::FontRole)

sources/qetxml.h

@@ -34,24 +34,45 @@ namespace QETXML
 	QDomElement penToXml(QDomDocument &parent_document, const QPen& pen);
 	QPen penFromXml (const QDomElement &element);
 
-	QDomElement brushToXml (QDomDocument &parent_document, const QBrush& brush);
+	QDomElement brushToXml (QDomDocument &parent_document,
+				const QBrush& brush);
 	QBrush brushFromXml (const QDomElement &element);
 
-	QDomElement fileSystemDirToXmlCollectionDir (QDomDocument &document, const QDir &dir, const QString& rename = QString());
+	QDomElement fileSystemDirToXmlCollectionDir (
-	QDomElement fileSystemElementToXmlCollectionElement (QDomDocument &document, QFile &file, const QString& rename = QString());
+			QDomDocument &document,
+			const QDir &dir,
+			const QString& rename = QString());
+	QDomElement fileSystemElementToXmlCollectionElement (
+			QDomDocument &document,
+			QFile &file,
+			const QString& rename = QString());
 
-	bool writeXmlFile(const QDomDocument &xml_document, const QString &file_path, QString *error_message = nullptr);
+	bool writeXmlFile(const QDomDocument &xml_document,
+			  const QString &file_path,
+			  QString *error_message = nullptr);
 
-	QDomElement textToDomElement (QDomDocument &document, const QString& tag_name, const QString& value);
+	QDomElement textToDomElement (QDomDocument &document,
+				      const QString& tag_name,
+				      const QString& value);
 
-	QVector <QDomElement> directChild(const QDomElement &element, const QString &tag_name);
+	QVector <QDomElement> directChild(const QDomElement &element,
-	QVector <QDomElement> subChild(const QDomElement &element, const QString parent_tag_name, const QString &children_tag_name);
+					  const QString &tag_name);
+	QVector <QDomElement> subChild(const QDomElement &element,
+				       const QString parent_tag_name,
+				       const QString &children_tag_name);
 
-	QDomElement marginsToXml (QDomDocument &parent_document, const QMargins &margins);
+	QDomElement marginsToXml (QDomDocument &parent_document,
+				  const QMargins &margins);
 	QMargins marginsFromXml(const QDomElement &element);
 
-	QDomElement modelHeaderDataToXml(QDomDocument &parent_document, const QAbstractItemModel *model, QHash<int, QList<int>> horizontal_section_role, QHash<int, QList<int>> vertical_section_role);
+	QDomElement modelHeaderDataToXml(QDomDocument &parent_document,
-	void modelHeaderDataFromXml(const QDomElement &element, QAbstractItemModel *model);
+					 const QAbstractItemModel *model,
+					 QHash<int,
+					 QList<int>> horizontal_section_role,
+					 QHash<int,
+					 QList<int>> vertical_section_role);
+	void modelHeaderDataFromXml(const QDomElement &element,
+				    QAbstractItemModel *model);
 }
 
 #endif // QETXML_H

sources/richtext/richtexteditor.cpp

@@ -739,6 +739,7 @@ QString RichTextEditor::text(Qt::TextFormat format) const
 			break;
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 		case Qt::MarkdownText: //This enum value was added in Qt 5.14.
 			break;
 #endif

sources/titleblocktemplate.cpp

@@ -338,6 +338,7 @@ void TitleBlockTemplate::parseRows(const QString &rows_string) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList rows_descriptions = rows_string.split(QChar(';'), QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QStringList rows_descriptions = rows_string.split(QChar(';'), Qt::SkipEmptyParts);
 #endif
 	foreach (QString rows_description, rows_descriptions) {
@@ -365,6 +366,7 @@ void TitleBlockTemplate::parseColumns(const QString &cols_string) {
 #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)	// ### Qt 6: remove
 	QStringList cols_descriptions = cols_string.split(QChar(';'), QString::SkipEmptyParts);
 #else
+#pragma message("@TODO remove code for QT 5.14 or later")
 	QStringList cols_descriptions = cols_string.split(QChar(';'), Qt::SkipEmptyParts);
 #endif
 	foreach (QString cols_description, cols_descriptions) {

sources/ui/aboutqetdialog.cpp

@@ -21,7 +21,13 @@
 
 #include <QThread>
 #include <QDate>
+#include <QScreen>
+#include <QProcess>
 
+/**
+	@brief AboutQETDialog::AboutQETDialog
+	@param parent
+*/
 AboutQETDialog::AboutQETDialog(QWidget *parent) :
 	QDialog(parent),
 	ui(new Ui::AboutQETDialog)
@@ -36,11 +42,17 @@ AboutQETDialog::AboutQETDialog(QWidget *parent) :
 	setLicence();
 }
 
+/**
+	@brief AboutQETDialog::~AboutQETDialog
+*/
 AboutQETDialog::~AboutQETDialog()
 {
 	delete ui;
 }
 
+/**
+	@brief AboutQETDialog::setAbout
+*/
 void AboutQETDialog::setAbout()
 {
 
@@ -55,6 +67,9 @@ void AboutQETDialog::setAbout()
 	ui->m_about_label->setText(str);
 }
 
+/**
+	@brief AboutQETDialog::setAuthors
+*/
 void AboutQETDialog::setAuthors()
 {
 	addAuthor(ui->m_author_label, "Benoît Ansieau",     "benoit@qelectrotech.org",     tr("Idée originale"));
@@ -66,6 +81,9 @@ void AboutQETDialog::setAuthors()
 	addAuthor(ui->m_author_label, "Abhishek Bansal",    "abhishek@qelectrotech.org",   tr("Développement"));
 }
 
+/**
+	@brief AboutQETDialog::setTranslators
+*/
 void AboutQETDialog::setTranslators()
 {
 	addAuthor(ui->m_translators_label, "Alfredo Carreto",                           "electronicos_mx@yahoo.com.mx",   tr("Traduction en espagnol"));
@@ -94,6 +112,9 @@ void AboutQETDialog::setTranslators()
 	addAuthor(ui->m_translators_label, "Gábor Gubányi",                             "gubanyig@gmail.com",             tr("Traduction en hongrois"));
 }
 
+/**
+	@brief AboutQETDialog::setContributors
+*/
 void AboutQETDialog::setContributors()
 {
 	addAuthor(ui->m_contrib_label, "Remi Collet",         "remi@fedoraproject.org",              tr("Paquets Fedora et Red Hat"));
@@ -117,6 +138,9 @@ void AboutQETDialog::setContributors()
 	addAuthor(ui->m_contrib_label, "Maximilian Federle",   "",                                   tr("Paquets Snap"));
 }
 
+/**
+	@brief AboutQETDialog::setVersion
+*/
 void AboutQETDialog::setVersion()
 {
 	QString str = "<span style=\"font-weight:bold;font-size:16pt;\">QElectroTech V " + QET::displayedVersion + "</span>";
@@ -129,6 +153,12 @@ void AboutQETDialog::setVersion()
 	compilation_info += " : " + QString(__TIME__);
 	compilation_info += " <br>Run with Qt "+ QString(qVersion());
 	compilation_info += " using" + QString(" %1 thread(s)").arg(QThread::idealThreadCount());
+	QProcess macoscpuinfo;
+	macoscpuinfo.start("bash", QStringList() << "-c" << "sysctl -n machdep.cpu.brand_string");
+	macoscpuinfo.waitForFinished();
+	QString macosOutput = macoscpuinfo.readAllStandardOutput();
+	compilation_info +=  "<br>"" CPU : " + QString(macosOutput.toLocal8Bit().constData());
+
 	compilation_info += "<br>" "  OS : " +  QString(QSysInfo::kernelType());
 	compilation_info += "  -   " + QString(QSysInfo::currentCpuArchitecture());
 	compilation_info += " -  Version :    " + QString(QSysInfo::prettyProductName());
@@ -140,15 +170,61 @@ void AboutQETDialog::setVersion()
 	compilation_info += " : " + QString(__TIME__);
 	compilation_info += " <br>Run with Qt "+ QString(qVersion());
 	compilation_info += " using" + QString(" %1 thread(s)").arg(QThread::idealThreadCount());
+	
+	QString OSName = QSysInfo::kernelType();
+	if (OSName == "linux")
+	{
+	QProcess linuxcpuinfo;
+	linuxcpuinfo.start("bash", QStringList() << "-c" << "cat /proc/cpuinfo |grep 'model name' | uniq");
+	linuxcpuinfo.waitForFinished();
+	QString linuxOutput = linuxcpuinfo.readAllStandardOutput();
+	compilation_info +=  "<br>"" CPU : " + QString(linuxOutput.toLocal8Bit().constData());
+	
+	QProcess p;
+	p.start("awk", QStringList() << "/MemTotal/ { print $2 }" << "/proc/meminfo");
+	p.waitForFinished();
+	QString memory = p.readAllStandardOutput();
+	compilation_info += "<br>" + QString("RAM Total : %1 MB").arg(memory.toLong() / 1024);
+	p.close();
+	
+	QProcess qp;
+	qp.start("awk", QStringList() << "/MemAvailable/ {print $2}" << "/proc/meminfo");
+	qp.waitForFinished();
+	QString AvailableMemory = qp.readAllStandardOutput();
+	compilation_info += "<br>" + QString("RAM Available : %1 MB").arg(AvailableMemory.toLong() / 1024);
+	qp.close();
+	
+	QProcess linuxgpuinfo;
+	linuxgpuinfo.start("bash", QStringList() << "-c" << "lspci | grep VGA | cut -d : -f 3");
+	linuxgpuinfo.waitForFinished();
+	QString linuxGPUOutput = linuxgpuinfo.readAllStandardOutput();
+	compilation_info += "<br>"" GPU : " + QString(linuxGPUOutput.toLocal8Bit().constData());
+	
+	}
+	
 	compilation_info += "<br>" "  OS : " +  QString(QSysInfo::kernelType());
 	compilation_info += "  -   " + QString(QSysInfo::currentCpuArchitecture());
 	compilation_info += " -  Version :    " + QString(QSysInfo::prettyProductName());
 	compilation_info += "</br>" " -  Kernel :     " + QString(QSysInfo::kernelVersion());
 #endif
 #endif
+	compilation_info += "<br>  *** Qt screens *** </br>";
+	const auto screens = qApp->screens();
+	for (int ii = 0; ii < screens.count(); ++ii) {
+	  compilation_info += "<br> ( "
+			  + QString::number(ii + 1)
+			  + " : "
+			  + QString::number(screens[ii]->geometry().width() * screens[ii]->devicePixelRatio())
+			  + " x "
+			  + QString::number(screens[ii]->geometry().height() * screens[ii]->devicePixelRatio())
+			  + " ) </br>";
+	}
 	ui->m_version_label->setText(str + compilation_info);
 }
 
+/**
+	@brief AboutQETDialog::setLibraries
+*/
 void AboutQETDialog::setLibraries()
 {
 	addLibrary(ui->m_libraries_label, "KDE lib",            "https://api.kde.org");
@@ -156,18 +232,21 @@ void AboutQETDialog::setLibraries()
 	addLibrary(ui->m_libraries_label, "pugixml",            "https://pugixml.org");
 }
 
+/**
+	@brief AboutQETDialog::setLicence
+*/
 void AboutQETDialog::setLicence()
 {
 	ui->m_license_text_edit->setPlainText(QET::license());
 }
 
 /**
- * @brief AboutQETDialog::addAuthor
+	@brief AboutQETDialog::addAuthor
- * Adds a person to the list of authors
+	Adds a person to the list of authors
- * @param label : QLabel which will add the person
+	@param label : QLabel which will add the person
- * @param name : Name of person
+	@param name : Name of person
- * @param email : E-mail address of the person
+	@param email : E-mail address of the person
- * @param work : Function / work done by the person
+	@param work : Function / work done by the person
 */
 void AboutQETDialog::addAuthor(QLabel *label, const QString &name, const QString &email, const QString &work)
 {
@@ -180,6 +259,12 @@ void AboutQETDialog::addAuthor(QLabel *label, const QString &name, const QString
 	label->setText(new_text);
 }
 
+/**
+	@brief AboutQETDialog::addLibrary
+	@param label
+	@param name
+	@param link
+*/
 void AboutQETDialog::addLibrary(QLabel *label, const QString &name, const QString &link)
 {
 	QString new_text = label->text();

sources/ui/aboutqetdialog.h

@@ -26,6 +26,9 @@ namespace Ui {
 	class AboutQETDialog;
 }
 
+/**
+	@brief The AboutQETDialog class
+*/
 class AboutQETDialog : public QDialog
 {
 	Q_OBJECT
@@ -42,8 +45,13 @@ class AboutQETDialog : public QDialog
 		void setVersion();
 		void setLibraries();
 		void setLicence();
-		void addAuthor(QLabel *label, const QString &name, const QString &email, const QString &work);
+		void addAuthor(QLabel *label,
-		void addLibrary(QLabel *label, const QString &name, const QString &link);
+			       const QString &name,
+			       const QString &email,
+			       const QString &work);
+		void addLibrary(QLabel *label,
+				const QString &name,
+				const QString &link);
 
 	private:
 		Ui::AboutQETDialog *ui;

sources/ui/bomexportdialog.cpp

@@ -61,6 +61,7 @@ BOMExportDialog::BOMExportDialog(QETProject *project, QWidget *parent) :
 #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)	// ### Qt 6: remove
 	connect(&m_button_group, static_cast<void (QButtonGroup::*)(int)>(&QButtonGroup::buttonClicked), [this](int id)
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 	connect(&m_button_group, static_cast<void (QButtonGroup::*)(int)>(&QButtonGroup::idClicked), [this](int id)
 #endif
 	{
@@ -154,6 +155,7 @@ int BOMExportDialog::exec()
 #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)	// ### Qt 6: remove
 				stream << getBom() << endl;
 #else
+#pragma message("@TODO remove code for QT 5.15 or later")
 				stream << getBom() << &Qt::endl(stream);
 #endif
 			}

sources/ui/compositetexteditdialog.cpp

@@ -16,6 +16,7 @@ CompositeTextEditDialog::CompositeTextEditDialog(DynamicElementTextItem *text, Q
 	m_default_text = m_text->compositeText();
 	ui->m_plain_text_edit->setPlainText(m_default_text);
 #if QT_VERSION >= 0x050300
+#pragma message("@TODO remove code for QT 5.3 or later")
 	ui->m_plain_text_edit->setPlaceholderText(tr("Entrée votre texte composé ici, en vous aidant des variables disponible"));
 #endif
 	setUpComboBox();
@@ -29,6 +30,7 @@ CompositeTextEditDialog::CompositeTextEditDialog(QString text, QWidget *parent)
 	m_default_text = std::move(text);
 	ui->m_plain_text_edit->setPlainText(m_default_text);
 #if QT_VERSION >= 0x050300
+#pragma message("@TODO remove code for QT 5.3 or later")
 	ui->m_plain_text_edit->setPlaceholderText(tr("Entrée votre texte composé ici, en vous aidant des variables disponible"));
 #endif
 	setUpComboBox();

sources/ui/masterpropertieswidget.cpp

@@ -25,10 +25,10 @@
 #include <linkelementcommand.h>
 
 /**
- * @brief MasterPropertiesWidget::MasterPropertiesWidget
+	@brief MasterPropertiesWidget::MasterPropertiesWidget
- * Default constructor
+	Default constructor
- * @param elmt
+	@param elmt
- * @param parent
+	@param parent
 */
 MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
 	AbstractElementPropertiesEditorWidget(parent),
@@ -43,10 +43,16 @@ MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
 	QStringList list;
 	QSettings settings;
 	if (settings.value("genericpanel/folio", false).toBool()) {
-		list << tr("Vignette") << tr("Label de folio") << tr("Titre de folio") << tr("Position");
+		list << tr("Vignette")
+		     << tr("Label de folio")
+		     << tr("Titre de folio")
+		     << tr("Position");
 	}
 	else {
-		list << tr("Vignette") << tr("N° de folio") << tr("Titre de folio") << tr("Position");
+		list << tr("Vignette")
+		     << tr("N° de folio")
+		     << tr("Titre de folio")
+		     << tr("Position");
 	}
 	ui->m_free_tree_widget->setHeaderLabels(list);
 	ui->m_link_tree_widget->setHeaderLabels(list);
@@ -58,15 +64,22 @@ MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
 	m_show_element  = new QAction(tr("Montrer l'élément maître"), this);
 	m_save_header_state = new QAction(tr("Enregistrer la disposition"), this);
 	
-	connect(ui->m_free_tree_widget, &QTreeWidget::itemDoubleClicked, this, &MasterPropertiesWidget::showElementFromTWI);
+	connect(ui->m_free_tree_widget, &QTreeWidget::itemDoubleClicked,
-	connect(ui->m_link_tree_widget, &QTreeWidget::itemDoubleClicked, this, &MasterPropertiesWidget::showElementFromTWI);
+		this, &MasterPropertiesWidget::showElementFromTWI);
+	connect(ui->m_link_tree_widget, &QTreeWidget::itemDoubleClicked,
+		this, &MasterPropertiesWidget::showElementFromTWI);
 	
-	connect(ui->m_free_tree_widget, &QTreeWidget::customContextMenuRequested, [this](QPoint point) {this->customContextMenu(point, 1);});
+	connect(ui->m_free_tree_widget, &QTreeWidget::customContextMenuRequested,
-	connect(ui->m_link_tree_widget, &QTreeWidget::customContextMenuRequested, [this](QPoint point) {this->customContextMenu(point, 2);});
+		[this](QPoint point) {this->customContextMenu(point, 1);});
+	connect(ui->m_link_tree_widget, &QTreeWidget::customContextMenuRequested,
+		[this](QPoint point) {this->customContextMenu(point, 2);});
 	
-	connect(m_link_action,   &QAction::triggered, this, &MasterPropertiesWidget::on_link_button_clicked);
+	connect(m_link_action,   &QAction::triggered,
-	connect(m_unlink_action, &QAction::triggered, this, &MasterPropertiesWidget::on_unlink_button_clicked);
+		this, &MasterPropertiesWidget::on_link_button_clicked);
-	connect(m_show_qtwi,     &QAction::triggered, [this]() {this->showElementFromTWI(this->m_qtwi_at_context_menu,0);});
+	connect(m_unlink_action, &QAction::triggered,
+		this, &MasterPropertiesWidget::on_unlink_button_clicked);
+	connect(m_show_qtwi,     &QAction::triggered,
+		[this]() {this->showElementFromTWI(this->m_qtwi_at_context_menu,0);});
 	
 	connect(m_show_element,  &QAction::triggered, [this]()
 	{
@@ -78,7 +91,8 @@ MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
 	
 	QHeaderView *qhv = ui->m_free_tree_widget->header();
 	qhv->setContextMenuPolicy(Qt::CustomContextMenu);
-	connect(qhv, &QHeaderView::customContextMenuRequested, this, &MasterPropertiesWidget::headerCustomContextMenuRequested);
+	connect(qhv, &QHeaderView::customContextMenuRequested,
+		this, &MasterPropertiesWidget::headerCustomContextMenuRequested);
 	connect(m_save_header_state, &QAction::triggered, [qhv]()
 	{
 		QByteArray qba = qhv->saveState();
@@ -90,8 +104,8 @@ MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
 }
 
 /**
- * @brief MasterPropertiesWidget::~MasterPropertiesWidget
+	@brief MasterPropertiesWidget::~MasterPropertiesWidget
- * Destructor
+	Destructor
 */
 MasterPropertiesWidget::~MasterPropertiesWidget()
 {
@@ -105,9 +119,9 @@ MasterPropertiesWidget::~MasterPropertiesWidget()
 }
 
 /**
- * @brief MasterPropertiesWidget::setElement
+	@brief MasterPropertiesWidget::setElement
- * Set the element to be edited
+	Set the element to be edited
- * @param element
+	@param element
 */
 void MasterPropertiesWidget::setElement(Element *element)
 {
@@ -123,32 +137,37 @@ void MasterPropertiesWidget::setElement(Element *element)
 		m_element->setHighlighted(false);
 	
 	if (m_project)
-		disconnect(m_project, SIGNAL(diagramRemoved(QETProject*,Diagram*)), this, SLOT(diagramWasdeletedFromProject()));
+		disconnect(m_project, SIGNAL(diagramRemoved(QETProject*,Diagram*)),
+			   this, SLOT(diagramWasdeletedFromProject()));
 
 	if(Q_LIKELY(element->diagram() && element->diagram()->project()))
 	{
 		m_project = element->diagram()->project();
-		connect(m_project, SIGNAL(diagramRemoved(QETProject*,Diagram*)), this, SLOT(diagramWasdeletedFromProject()));
+		connect(m_project, SIGNAL(diagramRemoved(QETProject*,Diagram*)),
+			this, SLOT(diagramWasdeletedFromProject()));
 	}
 	else
 		m_project = nullptr;
 
 	//Keep up to date this widget when the linked elements of m_element change
 	if (m_element)
-		disconnect(m_element.data(), &Element::linkedElementChanged, this, &MasterPropertiesWidget::updateUi);
+		disconnect(m_element.data(), &Element::linkedElementChanged,
+			   this, &MasterPropertiesWidget::updateUi);
 	
 	m_element = element;
-	connect(m_element.data(), &Element::linkedElementChanged, this, &MasterPropertiesWidget::updateUi);
+	connect(m_element.data(), &Element::linkedElementChanged,
+		this, &MasterPropertiesWidget::updateUi);
 
 	updateUi();
 }
 
 /**
- * @brief MasterPropertiesWidget::apply
+	@brief MasterPropertiesWidget::apply
- * If link betwen edited element and other change,
+	If link betwen edited element and other change,
- * apply the change with a QUndoCommand (got with method associatedUndo)
+	apply the change with a QUndoCommand (got with method associatedUndo)
- * pushed to the stack of element project.
+	pushed to the stack of element project.
- * Return true if link change, else false
+	Return true if link change, else false
+	@note is void no Return ???
  */
 void MasterPropertiesWidget::apply() {
 	if (QUndoCommand *undo = associatedUndo())
@@ -156,8 +175,8 @@ void MasterPropertiesWidget::apply() {
 }
 
 /**
- * @brief MasterPropertiesWidget::reset
+	@brief MasterPropertiesWidget::reset
- * Reset curent widget, clear eveything and rebuild widget.
+	Reset curent widget, clear eveything and rebuild widget.
 */
 void MasterPropertiesWidget::reset()
 {
@@ -169,11 +188,11 @@ void MasterPropertiesWidget::reset()
 }
 
 /**
- * @brief MasterPropertiesWidget::associatedUndo
+	@brief MasterPropertiesWidget::associatedUndo
- * If link between the edited element and other change,
+	If link between the edited element and other change,
- * return a QUndoCommand with this change.
+	return a QUndoCommand with this change.
- * If no change return nullptr.
+	If no change return nullptr.
- * @return
+	@return
 */
 QUndoCommand* MasterPropertiesWidget::associatedUndo() const
 {
@@ -207,10 +226,10 @@ QUndoCommand* MasterPropertiesWidget::associatedUndo() const
 }
 
 /**
- * @brief MasterPropertiesWidget::setLiveEdit
+	@brief MasterPropertiesWidget::setLiveEdit
- * @param live_edit = true : live edit is enable
+	@param live_edit = true : live edit is enable
- * else false : live edit is disable.
+	else false : live edit is disable.
- * @return always true because live edit is handled by this editor widget
+	@return always true because live edit is handled by this editor widget
 */
 bool MasterPropertiesWidget::setLiveEdit(bool live_edit)
 {
@@ -219,8 +238,8 @@ bool MasterPropertiesWidget::setLiveEdit(bool live_edit)
 }
 
 /**
- * @brief MasterPropertiesWidget::updateUi
+	@brief MasterPropertiesWidget::updateUi
- * Build the interface of the widget
+	Build the interface of the widget
 */
 void MasterPropertiesWidget::updateUi()
 {
@@ -245,17 +264,24 @@ void MasterPropertiesWidget::updateUi()
 		if(settings.value("genericpanel/folio", false).toBool())
 		{
 			autonum::sequentialNumbers seq;
-			QString F =autonum::AssignVariables::formulaToLabel(elmt->diagram()->border_and_titleblock.folio(), seq, elmt->diagram(), elmt);
+			QString F =autonum::AssignVariables::formulaToLabel(
+						elmt->diagram()->border_and_titleblock.folio(),
+						seq,
+						elmt->diagram(),
+						elmt);
 			qtwi->setText(1, F);
 		}
 		else
 		{
-			qtwi->setText(1, QString::number(elmt->diagram()->folioIndex() + 1));
+			qtwi->setText(1, QString::number(
+					      elmt->diagram()->folioIndex()
+					      + 1));
 		}
 		
 
 		qtwi->setText(2, elmt->diagram()->title());
-		qtwi->setText(4, elmt->diagram()->convertPosition(elmt->scenePos()).toString());
+		qtwi->setText(4, elmt->diagram()->convertPosition(
+				      elmt->scenePos()).toString());
 		items_list.append(qtwi);
 		m_qtwi_hash.insert(qtwi, elmt);
 	}
@@ -273,16 +299,23 @@ void MasterPropertiesWidget::updateUi()
 		if(settings.value("genericpanel/folio", false).toBool())
 		{
 			autonum::sequentialNumbers seq;
-			QString F =autonum::AssignVariables::formulaToLabel(elmt->diagram()->border_and_titleblock.folio(), seq, elmt->diagram(), elmt);
+			QString F =autonum::AssignVariables::formulaToLabel(
+						elmt->diagram()->border_and_titleblock.folio(),
+						seq,
+						elmt->diagram(),
+						elmt);
 			qtwi->setText(1, F);
 		}
 		else
 		{
-			qtwi->setText(1, QString::number(elmt->diagram()->folioIndex() + 1));
+			qtwi->setText(1, QString::number(
+					      elmt->diagram()->folioIndex()
+					      + 1));
 		}
 
 		qtwi->setText(2, elmt->diagram()->title());
-		qtwi->setText(3, elmt->diagram()->convertPosition(elmt->scenePos()).toString());
+		qtwi->setText(3, elmt->diagram()->convertPosition(
+				      elmt->scenePos()).toString());
 		items_list.append(qtwi);
 		m_qtwi_hash.insert(qtwi, elmt);
 	}
@@ -298,6 +331,10 @@ void MasterPropertiesWidget::updateUi()
 	}
 }
 
+/**
+	@brief MasterPropertiesWidget::headerCustomContextMenuRequested
+	@param pos
+*/
 void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
 {
 	m_context_menu->clear();
@@ -306,8 +343,8 @@ void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
 }
 
 /**
- * @brief MasterPropertiesWidget::on_link_button_clicked
+	@brief MasterPropertiesWidget::on_link_button_clicked
- * move curent item in the free_list to linked_list
+	move curent item in the free_list to linked_list
 */
 void MasterPropertiesWidget::on_link_button_clicked()
 {
@@ -315,7 +352,8 @@ void MasterPropertiesWidget::on_link_button_clicked()
 	QTreeWidgetItem *qtwi = ui->m_free_tree_widget->currentItem();
 	if (qtwi)
 	{
-		ui->m_free_tree_widget->takeTopLevelItem(ui->m_free_tree_widget->indexOfTopLevelItem(qtwi));
+		ui->m_free_tree_widget->takeTopLevelItem(
+					ui->m_free_tree_widget->indexOfTopLevelItem(qtwi));
 		ui->m_link_tree_widget->insertTopLevelItem(0, qtwi);
 		
 		if(m_live_edit)
@@ -324,8 +362,8 @@ void MasterPropertiesWidget::on_link_button_clicked()
 }
 
 /**
- * @brief MasterPropertiesWidget::on_unlink_button_clicked
+	@brief MasterPropertiesWidget::on_unlink_button_clicked
- * move curent item in linked_list to free_list
+	move curent item in linked_list to free_list
 */
 void MasterPropertiesWidget::on_unlink_button_clicked()
 {
@@ -333,7 +371,8 @@ void MasterPropertiesWidget::on_unlink_button_clicked()
 	QTreeWidgetItem *qtwi = ui->m_link_tree_widget->currentItem();
 	if(qtwi)
 	{
-		ui->m_link_tree_widget->takeTopLevelItem(ui->m_link_tree_widget->indexOfTopLevelItem(qtwi));
+		ui->m_link_tree_widget->takeTopLevelItem(
+					ui->m_link_tree_widget->indexOfTopLevelItem(qtwi));
 		ui->m_free_tree_widget->insertTopLevelItem(0, qtwi);
 
 		if(m_live_edit)
@@ -342,17 +381,18 @@ void MasterPropertiesWidget::on_unlink_button_clicked()
 }
 
 /**
- * @brief MasterPropertiesWidget::showElementFromTWI
+	@brief MasterPropertiesWidget::showElementFromTWI
- * Show the element corresponding to the given QTreeWidgetItem
+	Show the element corresponding to the given QTreeWidgetItem
- * @param qtwi
+	@param qtwi
- * @param column
+	@param column
 */
 void MasterPropertiesWidget::showElementFromTWI(QTreeWidgetItem *qtwi, int column)
 {
 	Q_UNUSED(column);
 	if (m_showed_element)
 	{
-		disconnect(m_showed_element, SIGNAL(destroyed()), this, SLOT(showedElementWasDeleted()));
+		disconnect(m_showed_element, SIGNAL(destroyed()),
+			   this, SLOT(showedElementWasDeleted()));
 		m_showed_element -> setHighlighted(false);
 	}
 	if (m_element)
@@ -361,39 +401,44 @@ void MasterPropertiesWidget::showElementFromTWI(QTreeWidgetItem *qtwi, int colum
 	m_showed_element = m_qtwi_hash[qtwi];
 	m_showed_element->diagram()->showMe();
 	m_showed_element->setHighlighted(true);
-	connect(m_showed_element, SIGNAL(destroyed()), this, SLOT(showedElementWasDeleted()));
+	connect(m_showed_element, SIGNAL(destroyed()),
+		this, SLOT(showedElementWasDeleted()));
 }
 
 /**
- * @brief MasterPropertiesWidget::showedElementWasDeleted
+	@brief MasterPropertiesWidget::showedElementWasDeleted
- * Set to nullptr the current showed element when he was deleted
+	Set to nullptr the current showed element when he was deleted
 */
 void MasterPropertiesWidget::showedElementWasDeleted() {
 	m_showed_element = nullptr;
 }
 
 /**
- * @brief MasterPropertiesWidget::diagramWasdeletedFromProject
+	@brief MasterPropertiesWidget::diagramWasdeletedFromProject
- * This slot is called when a diagram is removed from the parent project of edited element
+	This slot is called when a diagram is removed from the parent project
- * to update the content of this widget
+	of edited element to update the content of this widget
 */
 void MasterPropertiesWidget::diagramWasdeletedFromProject()
 {
-		//We use a timer because if the removed diagram contain slave element linked to the edited element
+	// We use a timer because if the removed diagram
-		//we must to wait for this elements be unlinked, else the linked list provide deleted elements.
+	// contain slave element linked to the edited element
+	// we must to wait for this elements be unlinked,
+	// else the linked list provide deleted elements.
 	QTimer::singleShot(10, this, SLOT(updateUi()));
 }
 
 /**
- * @brief MasterPropertiesWidget::customContextMenu
+	@brief MasterPropertiesWidget::customContextMenu
- * Display a context menu
+	Display a context menu
- * @param pos
+	@param pos
- * @param i : the tree widget where the context menu was requested.
+	@param i : the tree widget where the context menu was requested.
 */
 void MasterPropertiesWidget::customContextMenu(const QPoint &pos, int i)
 {
-		//add the size of the header to display the topleft of the QMenu at the position of the mouse.
+	// add the size of the header to display the topleft of the QMenu
-		//See doc about QWidget::customContextMenuRequested section related to QAbstractScrollArea 
+	// at the position of the mouse.
+	// See doc about QWidget::customContextMenuRequested
+	// section related to QAbstractScrollArea
 	QPoint point = pos;
 	point.ry()+=ui->m_free_tree_widget->header()->height();
 	

sources/ui/masterpropertieswidget.h

@@ -35,24 +35,30 @@ namespace Ui {
 }
 
 /**
- * @brief The MasterPropertiesWidget class
+	@brief The MasterPropertiesWidget class
- * This class is a widget for make link between a master element with several slave element.
+	This class is a widget for make link between a master element
- * This class embenddedthe undo/redo command when apply new connection.
+	with several slave element.
+	This class embenddedthe undo/redo command when apply new connection.
 */
-
 class MasterPropertiesWidget : public AbstractElementPropertiesEditorWidget
 {
 	Q_OBJECT
 
 	public:
-		explicit MasterPropertiesWidget(Element *elmt, QWidget *parent = nullptr);
+		explicit MasterPropertiesWidget(Element *elmt,
+						QWidget *parent = nullptr);
 		~MasterPropertiesWidget() override;
 
 		void setElement (Element *element) override;
 		void apply() override;
 		void reset() override;
 		QUndoCommand *associatedUndo () const override;
-		QString title() const override {return tr("Référence croisée (maître)");}
+		/**
+		 * @brief title
+		 * @return QString title
+		 */
+		QString title() const override {
+			return tr("Référence croisée (maître)");}
 		bool setLiveEdit(bool live_edit) override;
 
 	public slots:

sources/undocommand/rotatetextscommand.cpp

@@ -77,6 +77,7 @@ m_diagram(diagram)
 #if QT_VERSION >= 0x050900
 	else
 		setObsolete(true);
+#pragma message("@TODO remove code for QT 5.9 or later")
 #endif
 	
 }
@@ -135,6 +136,7 @@ void RotateTextsCommand::openDialog()
 #if QT_VERSION >= 0x050900
 	else
 		setObsolete(true);
+#pragma message("@TODO remove code for QT 5.9 or later")
 #endif
 }