Correction de la documentation : noms de variables ignores ou non mentionnes

Correction d'un probleme de compilation si les options QET_ALLOW_OVERRIDE_CED_OPTION et/ou QET_ALLOW_OVERRIDE_CD_OPTION n'etaient pas actives.


git-svn-id: svn+ssh://svn.tuxfamily.org/svnroot/qet/qet/trunk@782 bfdf4180-ca20-0410-9c96-a3a8aa849046

sources/borderinset.cpp

@@ -118,7 +118,7 @@ BorderProperties BorderInset::exportBorder() {
 }
 
 /**
-	@param ip les nouvelles proprietes de la bordure
+	@param bp les nouvelles proprietes de la bordure
 */
 void BorderInset::importBorder(const BorderProperties &bp) {
 	setColumnsHeaderHeight(bp.columns_header_height);
@@ -373,7 +373,7 @@ void BorderInset::setNbRows(int nb_r) {
 	Change la hauteur des lignes.
 	Si la hauteur indiquee est inferieure au minimum requis, c'est ce minimum
 	qui est utilise.
-	@param rh nouvelle hauteur des lignes
+	@param new_rh nouvelle hauteur des lignes
 	@see minRowsHeight()
 */
 void BorderInset::setRowsHeight(const qreal &new_rh) {

sources/conductor.cpp

@@ -192,7 +192,9 @@ void Conductor::segmentsToPath() {
 	@param p2 Coordonnees du point d'amarrage de la borne 2
 	@param o2 Orientation de la borne 2
 */
-void Conductor::priv_modifieConductor(const QPointF &p1, QET::Orientation, const QPointF &p2, QET::Orientation) {
+void Conductor::priv_modifieConductor(const QPointF &p1, QET::Orientation o1, const QPointF &p2, QET::Orientation o2) {
+	Q_UNUSED(o1);
+	Q_UNUSED(o2);
 	
 	ConductorProfile &conductor_profile = conductor_profiles[currentPathType()];
 	
@@ -447,7 +449,8 @@ QPointF Conductor::extendTerminal(const QPointF &terminal, QET::Orientation term
 	@param options Les options de style pour le conducteur
 	@param qw Le QWidget sur lequel on dessine 
 */
-void Conductor::paint(QPainter *qp, const QStyleOptionGraphicsItem *options, QWidget */*qw*/) {
+void Conductor::paint(QPainter *qp, const QStyleOptionGraphicsItem *options, QWidget *qw) {
+	Q_UNUSED(qw);
 	qp -> save();
 	qp -> setRenderHint(QPainter::Antialiasing, false);
 	
@@ -764,6 +767,7 @@ QPainterPath Conductor::shape() const {
 	@param tobound valeur a borner
 	@param bound1 borne 1
 	@param bound2 borne 2
+	@param space marge interne ajoutee
 	@return La valeur bornee
 */
 qreal Conductor::conductor_bound(qreal tobound, qreal bound1, qreal bound2, qreal space) {

sources/conductorproperties.cpp

@@ -140,7 +140,8 @@ void SingleLineProperties::drawGround(QPainter *painter, QET::ConductorSegmentTy
 	@param center centre du cercle
 	@param size diametre du cercle
 */
-void SingleLineProperties::drawNeutral(QPainter *painter, QET::ConductorSegmentType, QPointF center, qreal size) {
+void SingleLineProperties::drawNeutral(QPainter *painter, QET::ConductorSegmentType direction, QPointF center, qreal size) {
+	Q_UNUSED(direction);
 	painter -> save();
 	
 	// prepare le QPainter

sources/customelement.cpp

@@ -255,7 +255,6 @@ void CustomElement::paint(QPainter *qp, const QStyleOptionGraphicsItem *options)
 	formes peuvent avoir un attribut style. @see setPainterStyle
 	@param e L'element XML a analyser
 	@param qp Le QPainter a utiliser pour dessiner l'element perso
-	@param s Le schema sur lequel sera affiche l'element perso
 	@return true si l'analyse reussit, false sinon
 */
 bool CustomElement::parseElement(QDomElement &e, QPainter &qp) {

sources/diagramcommands.cpp

@@ -556,6 +556,8 @@ void ChangeInsetCommand::redo() {
 /**
 	Constructeur
 	@param dia Schema modifie
+	@param old_bp Anciennes proprietes du cadre du schema
+	@param new_bp Nouvelles proprietes du cadre du schema
 	@param parent QUndoCommand parent
 */
 ChangeBorderCommand::ChangeBorderCommand(Diagram *dia, const BorderProperties &old_bp, const BorderProperties &new_bp, QUndoCommand *parent) :

sources/diagramcontent.cpp

@@ -135,9 +135,10 @@ QString DiagramContent::sentence(int filter) const {
 /**
 	Permet de debugger un contenu de schema
 	@param d Object QDebug a utiliser pour l'affichage des informations de debug
-	@param c Contenu de schema a debugger
+	@param content Contenu de schema a debugger
 */
-QDebug &operator<<(QDebug d, DiagramContent &) {
+QDebug &operator<<(QDebug d, DiagramContent &content) {
+	Q_UNUSED(content);
 	d << "DiagramContent {" << "\n";
 	/*
 	FIXME Le double-heritage QObject / QGraphicsItem a casse cet operateur

sources/diagramprintdialog.cpp

@@ -25,8 +25,7 @@
 
 /**
 	Constructeur
-	@param dia     Schema a imprimer
+	@param project Schema a imprimer
-	@param printer Imprimante a utiliser
 	@param parent  Widget parent du dialogue
 */
 DiagramPrintDialog::DiagramPrintDialog(QETProject *project, QWidget *parent) :
@@ -137,13 +136,13 @@ void DiagramPrintDialog::exec() {
 	print(
 		dc -> selectedDiagrams(),
 		preview_dialog.fitDiagramsToPages(),
-		preview_dialog.exportProperties(),
+		preview_dialog.exportProperties()
-		printer_
 	);
 }
 
 /**
-	@param fullPage true pour utiliser toute la feuille dans le calcul
+	@param diagram Schema a imprimer
+	@param fullpage true pour utiliser toute la feuille dans le calcul
 	@return Le nombre de pages necessaires pour imprimer le schema
 	avec l'orientation et le format papier utilise dans l'imprimante en cours.
 */
@@ -152,7 +151,8 @@ int DiagramPrintDialog::pagesCount(Diagram *diagram, bool fullpage) const {
 }
 
 /**
-	@param fullPage true pour utiliser toute la feuille dans le calcul
+	@param diagram Schema a imprimer
+	@param fullpage true pour utiliser toute la feuille dans le calcul
 	@return La largeur du "poster" en nombre de pages pour imprimer le schema
 	avec l'orientation et le format papier utilise dans l'imprimante en cours.
 */
@@ -166,7 +166,8 @@ int DiagramPrintDialog::horizontalPagesCount(Diagram *diagram, bool fullpage) co
 }
 
 /**
-	@param fullPage true pour utiliser toute la feuille dans le calcul
+	@param diagram Schema a imprimer
+	@param fullpage true pour utiliser toute la feuille dans le calcul
 	@return La largeur du "poster" en nombre de pages pour imprimer le schema
 	avec l'orientation et le format papier utilise dans l'imprimante en cours.
 */
@@ -329,9 +330,8 @@ void DiagramPrintDialog::browseFilePrintTypeDialog() {
 	@param fit_page Booleen indiquant s'il faut adapter les schemas aux pages
 	ou non
 	@param options Options de rendu
-	@param printer L'imprimante a utiliser
 */
-void DiagramPrintDialog::print(const QList<Diagram *> &diagrams, bool fit_page, const ExportProperties options, QPrinter */*printer*/) {
+void DiagramPrintDialog::print(const QList<Diagram *> &diagrams, bool fit_page, const ExportProperties options) {
 	//qDebug() << "Demande d'impression de " << diagrams.count() << "schemas.";
 	
 	// QPainter utiliser pour effectuer le rendu
@@ -356,6 +356,7 @@ void DiagramPrintDialog::print(const QList<Diagram *> &diagrams, bool fit_page,
 	Imprime un schema
 	@param diagram Schema a imprimer
 	@param fit_page True pour  adapter les schemas aux pages, false sinon
+	@param options Options de rendu a appliquer pour l'impression
 	@param qp QPainter a utiliser (deja initialise sur printer)
 	@param printer Imprimante a utiliser
 */

sources/diagramprintdialog.h

@@ -53,7 +53,7 @@ class DiagramPrintDialog : public QWidget {
 	void saveReloadDiagramParameters(Diagram *, const ExportProperties, bool);
 	
 	private slots:
-	void print(const QList<Diagram *> &, bool, const ExportProperties, QPrinter *);
+	void print(const QList<Diagram *> &, bool, const ExportProperties);
 	void printDiagram(Diagram *, bool, const ExportProperties, QPainter *, QPrinter * = 0);
 	void updatePrintTypeDialog();
 	void acceptPrintTypeDialog();

sources/diagramview.cpp

@@ -34,6 +34,7 @@
 
 /**
 	Constructeur
+	@param diagram Schema a afficher ; si diagram vaut 0, un nouveau Diagram est utilise
 	@param parent Le QWidget parent de cette vue de schema
 */
 DiagramView::DiagramView(Diagram *diagram, QWidget *parent) : QGraphicsView(parent), is_adding_text(false) {
@@ -140,7 +141,8 @@ void DiagramView::dragEnterEvent(QDragEnterEvent *e) {
 	Gere les dragleaveevent
 	@param e le QDragEnterEvent correspondant au drag'n drop sortant
 */
-void DiagramView::dragLeaveEvent(QDragLeaveEvent *) {
+void DiagramView::dragLeaveEvent(QDragLeaveEvent *e) {
+	Q_UNUSED(e);
 }
 
 /**
@@ -924,8 +926,6 @@ void DiagramView::mouseDoubleClickEvent(QMouseEvent *e) {
 	Cette methode ajoute l'element deisgne par l'emplacement location a la
 	position pos. Si necessaire, elle demande l'integration de l'element au
 	projet.
-	@param location emplacement d'un element a ajouter sur le schema
-	@param pos position voulue de l'element sur le schema
 	@see mustIntegrateElement
 */
 void DiagramView::addDroppedElement() {

sources/editor/editorcommands.cpp

@@ -62,8 +62,8 @@ void DeletePartsCommand::redo() {
 /*** CutPartsCommand ***/
 /**
 	Constructeur
-	@param scene ElementScene concernee
+	@param view ElementView concernee
-	@param parts Liste des parties collees
+	@param c Liste des parties collees
 	@param parent QUndoCommand parent
 */
 PastePartsCommand::PastePartsCommand(

sources/editor/elementscene.cpp

@@ -427,9 +427,10 @@ void ElementScene::drawBackground(QPainter *p, const QRectF &r) {
 /**
 	Dessine l'arriere-plan de l'editeur, cad l'indicateur de hotspot.
 	@param p Le QPainter a utiliser pour dessiner
-	@param r Le rectangle de la zone a dessiner
+	@param rect Le rectangle de la zone a dessiner
 */
-void ElementScene::drawForeground(QPainter *p, const QRectF &) {
+void ElementScene::drawForeground(QPainter *p, const QRectF &rect) {
+	Q_UNUSED(rect);
 	p -> save();
 	
 	// desactive tout antialiasing, sauf pour le texte
@@ -448,7 +449,7 @@ void ElementScene::drawForeground(QPainter *p, const QRectF &) {
 	A partir d'un evenement souris, cette methode regarde si la touche shift est
 	enfoncee ou non. Si oui, elle laisse le comportement en cours (cercle,
 	texte, polygone, ...). Si non, elle repasse en mode normal / selection.
-	@param e objet decrivant l'evenement souris
+	@param event objet decrivant l'evenement souris
 */
 void ElementScene::endCurrentBehavior(const QGraphicsSceneMouseEvent *event) {
 	if (!(event -> modifiers() & Qt::ShiftModifier)) {
@@ -473,8 +474,8 @@ int ElementScene::yGrid() const {
 }
 
 /**
-	@param x_grid Taille horizontale de la grille
+	@param x_g Taille horizontale de la grille
-	@param y_grid Taille verticale de la grille
+	@param y_g Taille verticale de la grille
 */
 void ElementScene::setGrid(int x_g, int y_g) {
 	x_grid = x_g ? x_g : 1;
@@ -483,7 +484,7 @@ void ElementScene::setGrid(int x_g, int y_g) {
 
 /**
 	Exporte l'element en XML
-	@param diagram Booleen (a vrai par defaut) indiquant si le XML genere doit
+	@param all_parts Booleen (a vrai par defaut) indiquant si le XML genere doit
 	representer tout l'element ou seulement les elements selectionnes
 	@return un document XML decrivant l'element
 */
@@ -1102,7 +1103,8 @@ ElementContent ElementScene::loadContent(const QDomDocument &xml_document, QStri
 	different de 0, un message d'erreur sera stocke dedans si necessaire
 	@return Le contenu ajoute
 */
-ElementContent ElementScene::addContent(const ElementContent &content, QString */*error_message*/) {
+ElementContent ElementScene::addContent(const ElementContent &content, QString *error_message) {
+	Q_UNUSED(error_message);
 	foreach(QGraphicsItem *part, content) {
 		addItem(part);
 	}
@@ -1117,7 +1119,8 @@ ElementContent ElementScene::addContent(const ElementContent &content, QString *
 	different de 0, un message d'erreur sera stocke dedans si necessaire
 	@return Le contenu ajoute
 */
-ElementContent ElementScene::addContentAtPos(const ElementContent &content, const QPointF &pos, QString */*error_message*/) {
+ElementContent ElementScene::addContentAtPos(const ElementContent &content, const QPointF &pos, QString *error_message) {
+	Q_UNUSED(error_message);
 	// calcule le boundingRect du contenu a ajouter
 	QRectF bounding_rect = elementContentBoundingRect(content);
 	

sources/editor/partarc.cpp

@@ -48,7 +48,8 @@ PartArc::~PartArc() {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartArc::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartArc::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	applyStylesToQPainter(*painter);
 	// enleve systematiquement la couleur de fond
 	painter -> setBrush(Qt::NoBrush);

sources/editor/partcircle.cpp

@@ -43,7 +43,8 @@ PartCircle::~PartCircle() {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartCircle::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartCircle::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	applyStylesToQPainter(*painter);
 	QPen t = painter -> pen();
 	t.setCosmetic(options && options -> levelOfDetail < 1.0);

sources/editor/partellipse.cpp

@@ -43,7 +43,8 @@ PartEllipse::~PartEllipse() {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartEllipse::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartEllipse::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	applyStylesToQPainter(*painter);
 	QPen t = painter -> pen();
 	t.setCosmetic(options && options -> levelOfDetail < 1.0);

sources/editor/partline.cpp

@@ -65,7 +65,8 @@ uint PartLine::requiredLengthForEndType(const QET::EndType &end_type) {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartLine::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget */*w*/) {
+void PartLine::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	// inutile de dessiner une ligne nulle
 	if (line().p1() == line().p2()) return;
 	applyStylesToQPainter(*painter);

sources/editor/partpolygon.cpp

@@ -94,7 +94,8 @@ const QDomElement PartPolygon::toXml(QDomDocument &xml_document) const {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartPolygon::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartPolygon::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	applyStylesToQPainter(*painter);
 	QPen t = painter -> pen();
 	t.setCosmetic(options && options -> levelOfDetail < 1.0);

sources/editor/partrectangle.cpp

@@ -43,7 +43,8 @@ PartRectangle::~PartRectangle() {
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartRectangle::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartRectangle::paint(QPainter *painter, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	applyStylesToQPainter(*painter);
 	QPen t = painter -> pen();
 	t.setCosmetic(options && options -> levelOfDetail < 1.0);

sources/editor/partterminal.cpp

@@ -86,11 +86,12 @@ QWidget *PartTerminal::elementInformations() {
 
 /**
 	Dessine la borne
-	@param painter QPainter a utiliser pour rendre le dessin
+	@param p QPainter a utiliser pour rendre le dessin
 	@param options Options pour affiner le rendu
 	@param widget Widget sur lequel le rendu est effectue
 */
-void PartTerminal::paint(QPainter *p, const QStyleOptionGraphicsItem *options, QWidget *) {
+void PartTerminal::paint(QPainter *p, const QStyleOptionGraphicsItem *options, QWidget *widget) {
+	Q_UNUSED(widget);
 	p -> save();
 	
 	// annulation des renderhints

sources/element.cpp

@@ -188,7 +188,8 @@ bool Element::setOrientation(QET::Orientation o) {
 	@param painter Le QPainter a utiliser pour dessiner les axes
 	@param options Les options de style a prendre en compte
 */
-void Element::drawAxes(QPainter *painter, const QStyleOptionGraphicsItem *) {
+void Element::drawAxes(QPainter *painter, const QStyleOptionGraphicsItem *options) {
+	Q_UNUSED(options);
 	painter -> setPen(Qt::blue);
 	painter -> drawLine(0, 0, 10, 0);
 	painter -> drawLine(7,-3, 10, 0);
@@ -203,10 +204,11 @@ void Element::drawAxes(QPainter *painter, const QStyleOptionGraphicsItem *) {
 
 /**
 	Dessine le cadre de selection de l'element de maniere systematiquement non antialiasee.
-	@param qp Le QPainter a utiliser pour dessiner les bornes.
+	@param painter Le QPainter a utiliser pour dessiner les bornes.
 	@param options Les options de style a prendre en compte
  */
-void Element::drawSelection(QPainter *painter, const QStyleOptionGraphicsItem *) {
+void Element::drawSelection(QPainter *painter, const QStyleOptionGraphicsItem *options) {
+	Q_UNUSED(options);
 	painter -> save();
 	// Annulation des renderhints
 	painter -> setRenderHint(QPainter::Antialiasing,          false);

sources/elementdefinition.cpp

@@ -231,7 +231,8 @@ bool ElementDefinition::equals(ElementDefinition &other) {
 	@param deep_copy Argument ignore - une copie "recursive" n'a pas de sens pour un element
 	@return La copie de l'element ou 0 si le processus a echoue
 */
-ElementsCollectionItem *ElementDefinition::copy(ElementsCategory *target_category, MoveElementsHandler *handler, bool) {
+ElementsCollectionItem *ElementDefinition::copy(ElementsCategory *target_category, MoveElementsHandler *handler, bool deep_copy) {
+	Q_UNUSED(deep_copy);
 	if (!target_category) return(0);
 	
 	// echec si le path name de cet element est vide

sources/elementdefinition.h

@@ -51,7 +51,7 @@ class ElementDefinition : public ElementsCollectionItem {
 		@param xml_element Nouvelle definition XML de l'element
 		@return true si l'operation s'est bien passee, false sinon
 	*/
-	virtual bool setXml(const QDomElement &) = 0;
+	virtual bool setXml(const QDomElement &xml_element) = 0;
 	
 	/**
 		@return true si la definition n'est pas disponible

sources/elementscategorieslist.cpp

@@ -100,7 +100,7 @@ QTreeWidgetItem *ElementsCategoriesList::addCollection(QTreeWidgetItem *qtwi_par
 	Methode privee permettant d'ajouter une categorie
 	@param qtwi_parent QTreeWidgetItem parent sous lequel sera insere la categorie
 	@param category Categorie d'elements a inserer
-	@param name Parametre facultatif permettant de forcer le nom affiche
+	@param cat_name Parametre facultatif permettant de forcer le nom affiche
 	S'il n'est pas precise, la methode utilise le nom declare par la categorie.
 	@param icon Icone a utiliser pour l'affichage de la categorie
 	Si elle n'est pas precisee, une icone par defaut est utilisee
@@ -133,9 +133,9 @@ QTreeWidgetItem *ElementsCategoriesList::addCategory(QTreeWidgetItem *qtwi_paren
 	Methode privee permettant d'ajouter un element
 	@param qtwi_parent QTreeWidgetItem parent sous lequel sera insere l'element
 	@param element Element a inserer
-	@param name Parametre facultatif permettant de forcer le nom affiche
+	@param elmt_name Parametre facultatif permettant de forcer le nom affiche
 	S'il n'est pas precise, la methode utilise le nom declare par la categorie.
-	Une icone sera generee a partir de l'element.
+	@param icon Icone a utiliser pour l'affichage de l'element
 	@return Le QTreeWidgetItem insere
 */
 QTreeWidgetItem *ElementsCategoriesList::addElement(QTreeWidgetItem *qtwi_parent, ElementDefinition *element, const QString &elmt_name, const QIcon &icon) {
@@ -197,7 +197,8 @@ bool ElementsCategoriesList::selectLocation(const ElementsLocation &location) {
 	@param current  QTreeWidgetItem selectionne
 	@param previous QTreeWidgetItem precedemment selectionne
 */
-void ElementsCategoriesList::selectionChanged(QTreeWidgetItem *current, QTreeWidgetItem */*previous*/) {
+void ElementsCategoriesList::selectionChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous) {
+	Q_UNUSED(previous);
 	ElementsLocation emited_location;
 	if (current) {
 		emited_location = locations_[current];

sources/elementscategory.cpp

@@ -460,7 +460,7 @@ ElementsCollectionItem *ElementsCategory::move(ElementsCategory *target_category
 /**
 	Methode privee effectuant le deplacement de cette categorie a partir d'une
 	description du mouvement
-	@param mvt_dsc Description du mouvement
+	@param mvt_desc Description du mouvement
 */
 void ElementsCategory::move(MoveElementsDescription *mvt_desc) {
 	// quelques pointeurs pour simplifier l'ecriture de la methode

sources/elementscollectionitem.h

@@ -149,7 +149,7 @@ class ElementsCollectionItem : public QObject {
 		@param other_item Autre item
 		@return true si other_item est parent (direct ou indirect) de other_item, false sinon
 	*/
-	virtual bool isChildOf(ElementsCollectionItem *) = 0;
+	virtual bool isChildOf(ElementsCollectionItem *other_item) = 0;
 	/**
 		@return le nom de cet item dans l'arborescence
 	*/

sources/elementspanel.cpp

@@ -406,7 +406,8 @@ void ElementsPanel::dropEvent(QDropEvent *e) {
 	Gere le debut des drag'n drop
 	@param supportedActions Les actions supportees
 */
-void ElementsPanel::startDrag(Qt::DropActions) {
+void ElementsPanel::startDrag(Qt::DropActions supportedActions) {
+	Q_UNUSED(supportedActions);
 	// recupere l'emplacement selectionne
 	ElementsLocation location = selectedLocation();
 	if (location.isNull()) return;
@@ -488,7 +489,6 @@ QTreeWidgetItem *ElementsPanel::addProject(QTreeWidgetItem *qtwi_parent, QETProj
 	Methode permettant d'ajouter un schema au panel d'elements.
 	@param qtwi_parent QTreeWidgetItem parent sous lequel sera insere le schema
 	@param diagram Schema a inserer dans le panel d'elements
-	@param diagram_name Nom a utiliser pour le projet
 	@return Le QTreeWidgetItem insere le plus haut
 */
 QTreeWidgetItem *ElementsPanel::addDiagram(QTreeWidgetItem *qtwi_parent, Diagram *diagram) {
@@ -546,7 +546,7 @@ QTreeWidgetItem *ElementsPanel::addCollection(QTreeWidgetItem *qtwi_parent, Elem
 	@param qtwi_parent QTreeWidgetItem parent sous lequel sera insere la categorie
 	@param category Categorie d'elements a inserer - si category vaut 0, cette
 	methode retourne 0.
-	@param name Parametre facultatif permettant de forcer le nom affiche
+	@param cat_name Parametre facultatif permettant de forcer le nom affiche
 	S'il n'est pas precise, la methode utilise le nom declare par la categorie.
 	@param icon Icone a utiliser pour l'affichage de la categorie
 	Si elle n'est pas precisee, une icone par defaut est utilisee
@@ -585,8 +585,8 @@ QTreeWidgetItem *ElementsPanel::addCategory(QTreeWidgetItem *qtwi_parent, Elemen
 	Methode privee permettant d'ajouter un element au panel d'elements
 	@param qtwi_parent QTreeWidgetItem parent sous lequel sera insere l'element
 	@param element Element a inserer
-	@param name Parametre facultatif permettant de forcer le nom affiche
+	@param elmt_name Parametre facultatif permettant de forcer le nom affiche
-	S'il n'est pas precise, la methode utilise le nom declare par la categorie.
+	S'il n'est pas precise, la methode utilise le nom declare par l'element.
 	Une icone sera generee a partir de l'element.
 	@return Le QTreeWidgetItem insere
 */
@@ -943,8 +943,8 @@ QString ElementsPanel::diagramTitleToDisplay(Diagram *diagram) const {
 }
 
 /**
-	@param une liste de QTreeWidgetItem pour lesquels il faut s'assurer que eux
+	@param items une liste de QTreeWidgetItem pour lesquels il faut s'assurer
-	et leurs parents sont visibles
+	que eux et leurs parents sont visibles
 */
 void ElementsPanel::ensureHierarchyIsVisible(QList<QTreeWidgetItem *> items) {
 	// remonte l'arborescence pour lister les categories contenant les elements filtres

sources/elementspanelwidget.cpp

@@ -515,7 +515,7 @@ void ElementsPanelWidget::launchElementEditor(const ElementsLocation &location)
 
 /**
 	Lance l'editeur de categorie pour la categorie path
-	@param path Emplacement de la categorie a editer
+	@param location Emplacement de la categorie a editer
 */
 void ElementsPanelWidget::launchCategoryEditor(const ElementsLocation &location) {
 	ElementsCategoryEditor ece(location, true);

sources/fileelementdefinition.cpp

@@ -22,6 +22,7 @@
 /**
 	Constructeur
 	@param uri Chemin du fichier contenant la definition de l'element
+	@param category Categorie parente
 	@param collection collection parente
 */
 FileElementDefinition::FileElementDefinition(const QString &uri, FileElementsCategory *category, FileElementsCollection *collection) :

sources/fileelementscategory.cpp

@@ -198,7 +198,7 @@ QList<ElementDefinition *> FileElementsCategory::elements() {
 
 /**
 	@return l'element correspondant au chemin virtuel elmt_path, ou 0 en cas d'echec
-	@param cat_path Chemin virtuel de l'element voulu
+	@param elmt_path Chemin virtuel de l'element voulu
 */
 ElementDefinition *FileElementsCategory::element(const QString &elmt_path) {
 	// recupere les differentes parties du chemin

sources/integrationmoveelementshandler.cpp

@@ -94,7 +94,8 @@ QString IntegrationMoveElementsHandler::newNameForElement(const ElementDefinitio
 	@param dst Element cible
 	@return la reponse de l'utilisateur
 */
-QET::Action IntegrationMoveElementsHandler::askUser(ElementDefinition */*src*/, ElementDefinition *dst) {
+QET::Action IntegrationMoveElementsHandler::askUser(ElementDefinition *src, ElementDefinition *dst) {
+	Q_UNUSED(src);
 	initDialog();
 	int result = integ_dialog_ -> exec();
 	if (result == QDialog::Accepted) {

sources/projectview.cpp

@@ -125,7 +125,7 @@ DiagramView *ProjectView::currentDiagram() const {
 
 /**
 	Gere la fermeture du schema.
-	@param event Le QCloseEvent decrivant l'evenement
+	@param qce Le QCloseEvent decrivant l'evenement
 */
 void ProjectView::closeEvent(QCloseEvent *qce) {
 	// si la vue n'est pas liee a un projet, on ferme directement
@@ -361,7 +361,7 @@ void ProjectView::removeDiagram(DiagramView *diagram_view) {
 
 /**
 	Enleve un schema du ProjectView
-	@param diagram_view Schema a enlever
+	@param diagram Schema a enlever
 */
 void ProjectView::removeDiagram(Diagram *diagram) {
 	if (!diagram) return;

sources/qetapp.cpp

@@ -30,8 +30,12 @@
 #define QUOTE(x) STRINGIFY(x)
 #define STRINGIFY(x) #x
 
+#ifdef QET_ALLOW_OVERRIDE_CED_OPTION
 QString QETApp::common_elements_dir = QString();
+#endif
+#ifdef QET_ALLOW_OVERRIDE_CD_OPTION
 QString QETApp::config_dir = QString();
+#endif
 QString QETApp::lang_dir = QString();
 FileElementsCollection *QETApp::common_collection = 0;
 FileElementsCollection *QETApp::custom_collection = 0;
@@ -684,7 +688,7 @@ void QETApp::openFiles(const QETArguments &args) {
 	Sinon, le premier editeur de schemas existant venu devient visible et est
 	utilise. S'il n'y a aucun editeur de schemas ouvert, un nouveau est cree et
 	utilise.
-	@param files Fichiers a ouvrir
+	@param files_list Fichiers a ouvrir
 */
 void QETApp::openProjectFiles(const QStringList &files_list) {
 	if (files_list.isEmpty()) return;
@@ -721,7 +725,7 @@ void QETApp::openProjectFiles(const QStringList &files_list) {
 /**
 	Ouvre les fichiers elements passes en parametre. Si un element est deja
 	ouvert, la fentre qui l'edite est activee.
-	@param files Fichiers a ouvrir
+	@param files_list Fichiers a ouvrir
 */
 void QETApp::openElementFiles(const QStringList &files_list) {
 	if (files_list.isEmpty()) return;

sources/qetarguments.cpp

@@ -156,14 +156,18 @@ void QETArguments::clear() {
 	element_files_.clear();
 	options_.clear();
 	unknown_options_.clear();
+#ifdef QET_ALLOW_OVERRIDE_CED_OPTION
 	common_elements_dir_.clear();
+#endif
+#ifdef QET_ALLOW_OVERRIDE_CD_OPTION
 	config_dir_.clear();
+#endif
 }
 
 /**
 	Analyse des arguments et les retient dans cet objet.
 	Si cet objet contenait deja des arguments, ceux-ci sont oublies.
-	@param args Arguments a analyser
+	@param arguments Arguments a analyser
 */
 void QETArguments::parseArguments(const QList<QString> &arguments) {
 	// oublie les eventuels arguments precedents

sources/qetdiagrameditor.cpp

@@ -1654,7 +1654,8 @@ void QETDiagramEditor::diagramIsAboutToBeRemoved(DiagramView *dv) {
 	Gere le retrait d'un schema dans un projet apres que le retrait soit effectif
 	@param dv DiagramView concerne
 */
-void QETDiagramEditor::diagramWasRemoved(DiagramView *) {
+void QETDiagramEditor::diagramWasRemoved(DiagramView *dv) {
+	Q_UNUSED(dv);
 	can_update_actions = true;
 }
 

sources/qetprintpreviewdialog.cpp

@@ -24,8 +24,10 @@
 
 /**
 	Constructeur
+	@param project Projet a imprimer
 	@param printer Imprimante a utiliser pour
 	@param widget  Widget parent
+	@param f       Flags passes au constructeur de QDialog puis QWidget
 */
 QETPrintPreviewDialog::QETPrintPreviewDialog(QETProject *project, QPrinter *printer, QWidget *widget, Qt::WindowFlags f) :
 	QDialog(widget, f),
@@ -124,7 +126,8 @@ void QETPrintPreviewDialog::useFullPage(bool full_page) {
 	Fait tenir ou non chaque schema sur une page
 	@param fit_diagram true pour adapter chaque schema sur une page, false sinon
 */
-void QETPrintPreviewDialog::fitDiagramToPage(bool /*fit_diagram*/) {
+void QETPrintPreviewDialog::fitDiagramToPage(bool fit_diagram) {
+	Q_UNUSED(fit_diagram);
 	preview_ -> updatePreview();
 	updateZoomList();
 }

sources/qetprintpreviewdialog.h

@@ -25,8 +25,7 @@ class ExportPropertiesWidget;
 class QETProject;
 /**
 	Cette classe represente un dialogue permettant d'affiner les options
-	d'impression d'un schema a l'aide d'un apercu de ce qu'elle donnerait sur
+	d'impression d'un projet a l'aide d'un apercu du resultat sur papier.
-	papier.
 */
 class QETPrintPreviewDialog : public QDialog {
 	Q_OBJECT

sources/qetproject.cpp

@@ -392,7 +392,7 @@ bool QETProject::isReadOnly() const {
 }
 
 /**
-	@param bool read_only true pour passer le projet (schemas et collection)
+	@param read_only true pour passer le projet (schemas et collection)
 	en mode Read Only, false sinon.
 */
 void QETProject::setReadOnly(bool read_only) {
@@ -468,7 +468,7 @@ ElementsCategory *QETProject::integrationCategory() const {
 	integrateElement(const QString &, MoveElementsHandler *, QString &)
 	en lui passant un MoveElementsHandler approprie.
 	@param elmt_location Emplacement de l'element a integrer
-	@param error_message Reference vers une chaine de caractere qui contiendra
+	@param error_msg Reference vers une chaine de caractere qui contiendra
 	eventuellement un message d'erreur
 	@return L'emplacement de l'element apres integration, ou une chaine vide si
 	l'integration a echoue.
@@ -713,7 +713,7 @@ void QETProject::readProjectXml() {
 		
 		setTitle(root_elmt.attribute("title"));
 	} else if (root_elmt.tagName() == "diagram") {
-		/// @todo gerer l'ouverture de fichiers <diagram />
+		/// @todo gerer l'ouverture de fichiers dont la racine est un element \<diagram\>
 	} else {
 		state_ = ProjectParsingFailed;
 	}

sources/qetregexpvalidator.cpp

@@ -19,7 +19,7 @@
 
 /**
 	Constructeur
-	@param object QObject parent
+	@param parent QObject parent
 */
 QETRegExpValidator::QETRegExpValidator(QObject *parent) : QRegExpValidator(parent) {
 }
@@ -27,7 +27,7 @@ QETRegExpValidator::QETRegExpValidator(QObject *parent) : QRegExpValidator(paren
 /**
 	Constructeur
 	@param regexp Expression reguliere a valider
-	@param object QObject parent
+	@param parent QObject parent
 */
 QETRegExpValidator::QETRegExpValidator(const QRegExp &regexp, QObject *parent) : QRegExpValidator(regexp, parent) {
 }

sources/qettabbar.cpp

@@ -251,8 +251,6 @@ bool QETTabBar::mustMoveTab(int src_tab, int dst_tab, const QPoint &pos) const {
 	Deplace un onglet.
 	@param src_tab Index de l'onglet de depart
 	@param dst_tab Index de l'onglet de destination
-	@param pos Position de la souris dans le cadre du deplacement de l'onglet
-	@return 
 */
 void QETTabBar::moveTab(int src_tab, int dst_tab) {
 	// sauvegarde les caracteristiques de l'onglet deplace

sources/xmlelementscategory.cpp

@@ -212,7 +212,7 @@ QList<ElementDefinition *> XmlElementsCategory::elements() {
 
 /**
 	@return l'element correspondant au chemin virtuel elmt_path, ou 0 en cas d'echec
-	@param cat_path Chemin virtuel de l'element voulu
+	@param elmt_path Chemin virtuel de l'element voulu
 */
 ElementDefinition *XmlElementsCategory::element(const QString &elmt_path) {
 	// recupere les differentes parties du chemin
@@ -418,7 +418,7 @@ void XmlElementsCategory::componentWritten() {
 
 /**
 	Gere le fait qu'une sous-categorie ou un element ait ete supprime
-	@param item Element ou categorie supprime
+	@param path Chemin de l'element ou de la categorie supprime(e)
 */
 void XmlElementsCategory::componentRemoved(const QString &path) {
 	if (elements_.contains(path)) {