Fix a few doxygen warnings

This commit is contained in:
jean-pierre charras 2017-06-26 09:11:21 +02:00
parent 5774fd284e
commit 3c3ee9b8c3
6 changed files with 18 additions and 21 deletions

View File

@ -321,7 +321,7 @@ bool BOM_TABLE_GROUP::TestField( BOM_COLUMN* aField, BOM_TABLE_COMPONENT* aCompo
/**
* Add a new component to the group.
* It is assumed at this stage that the component is a good match for the group.
* @param aCmp is the new component to add
* @param aComponent is the new component to add
*/
bool BOM_TABLE_GROUP::AddComponent( BOM_TABLE_COMPONENT* aComponent )
{

View File

@ -6,8 +6,8 @@
/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 1992-2012 jean-pierre Charras <jean-pierre.charras@ujf-grenoble.fr>
* Copyright (C) 1992-2012 Kicad Developers, see change_log.txt for contributors.
* Copyright (C) 1992-2017 jean-pierre Charras jp.charras at wanadoo.fr
* Copyright (C) 1992-2017 Kicad Developers, see AUTHORS.txt for contributors.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
@ -45,10 +45,9 @@
class wxConfigBase;
namespace {
/**
* Class DIALOG_ANNOTATE
* Class DIALOG_ANNOTATE: a dialog to set/clear reference designators,
* of a schematic hierarchy, with different options
*/
class DIALOG_ANNOTATE: public DIALOG_ANNOTATE_BASE
{
@ -98,8 +97,6 @@ private:
}
};
} // anonymous namespace
DIALOG_ANNOTATE::DIALOG_ANNOTATE( SCH_EDIT_FRAME* parent, wxString message )
: DIALOG_ANNOTATE_BASE( parent )

View File

@ -85,13 +85,13 @@ SCH_EDIT_FRAME* DIALOG_EESCHEMA_OPTIONS::GetParent()
}
void DIALOG_EESCHEMA_OPTIONS::SetUnits( const wxArrayString& units, int select )
void DIALOG_EESCHEMA_OPTIONS::SetUnits( const wxArrayString& aUnits, int aSelect )
{
wxASSERT( units.GetCount() > 0
&& ( select >= 0 && (size_t) select < units.GetCount() ) );
wxASSERT( aUnits.GetCount() > 0
&& ( aSelect >= 0 && (size_t) aSelect < aUnits.GetCount() ) );
m_choiceUnits->Append( units );
m_choiceUnits->SetSelection( select );
m_choiceUnits->Append( aUnits );
m_choiceUnits->SetSelection( aSelect );
}

View File

@ -101,12 +101,12 @@ public:
* Function SetUnits
* Set the unit options
*
* @param units The array of strings representing the unit options
* @param select The unit to select from the unit options
* @param aUnits The array of strings representing the unit options
* @param aSelect The unit to select from the unit options
*
* Appends the @a units options to the list of unit options and selects the @a aSelect option
*/
void SetUnits( const wxArrayString& units, int aSelect = 0 );
void SetUnits( const wxArrayString& aUnits, int aSelect = 0 );
/**
* Function GetGridSelection

View File

@ -41,7 +41,7 @@ public:
* Constructor
* This dialog asks the user which rescuable, cached parts he wants to rescue.
* Any rejects will be pruned from aCandidates.
* @param aCaller - the SCH_EDIT_FRAME calling this
* @param aParent - the SCH_EDIT_FRAME calling this
* @param aRescuer - the active RESCUER instance
* @param aAskShowAgain - if true, a "Never Show Again" button will be included
*/

View File

@ -34,14 +34,14 @@
*
* To extract pretty footprints library list, this plugin simply reads in
* a zip file of the repo and unzips it from RAM as needed.
* Therefore this "Github" plugin is <b>read only for accessing remote
* at https:////api.github.com//orgs//KiCad//repos
* Therefore this "Github" plugin is <b>read only</b> for accessing remote
* at "https://api.github.com/orgs/KiCad/repos"
*
* To extract 3D shapes libraries list (.3dshapes folders) we cannot use api.github.com
* to read this list, becuse it is in a subdirectory of https://github.com/KiCad.
* to read this list, because it is in a subdirectory of "https://github.com/KiCad".
* The corresponding html page of the server is read, and URLs of all .3dshapes folders
* are extracted.
* files are then read from https://raw.githubusercontent.com/<lib path>, but not zipped
* files are then read from "https://raw.githubusercontent.com/<lib path>", but not zipped
* because they are not accessible in zipped form.
*/
class GITHUB_GETLIBLIST