haskal
/
kicad
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix a few doxygen warnings

This commit is contained in:
jean-pierre charras 2017-06-20 08:10:30 +02:00
parent 6733101c6f
commit 70226ecdeb
16 changed files with 32 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
3d-viewer/3d_cache/sg/scenegraph.h
View File

@ -25,7 +25,7 @@
* @file scenegraph.h
* defines the basic data set required to represent a 3D model;
* this model must remain compatible with VRML2.0 in order to
* facilitate VRML export of scene graph data created by avaiable
* facilitate VRML export of scene graph data created by available
* 3D plugins.
*/

5
include/config_map.h
View File

@ -90,11 +90,10 @@ static long GetConfigForVal( const MAP& aMap, CFG_NATIVE_VAL<MAP> aVal )
* The default item is returned if the mapping fails.
*
* @param aMap the value-config mapping table
* @param aVal the config value to look up
* @param aConf the config value to look up
*/
template<typename MAP>
static CFG_NATIVE_VAL<MAP> GetValFromConfig(
const MAP& aMap, long aConf )
static CFG_NATIVE_VAL<MAP> GetValFromConfig( const MAP& aMap, long aConf )
{
// default is first entry
CFG_NATIVE_VAL<MAP> aVal = aMap[0].first;

1
include/gal/graphics_abstraction_layer.h
View File

@ -145,6 +145,7 @@ public:
* @param aRadius is the arc radius.
* @param aStartAngle is the start angle of the arc.
* @param aEndAngle is the end angle of the arc.
* @param aWidth is the thickness of the arc (pen size).
*/
virtual void
DrawArcSegment( const VECTOR2D& aCenterPoint, double aRadius, double aStartAngle,

10
include/gal/stroke_font.h
View File

@ -107,16 +107,18 @@ public:
/**
* Compute the vertical position of an overbar, sometimes used in texts.
* This is the distance between the text base line and the overbar.
* @param aGlyphHeight is the height (vertical size) of the text.
* @param aGlyphThickness is the thickness of the lines used to draw the text.
* @return the relative position of the overbar axis.
*/
double ComputeOverbarVerticalPosition( double aGlyphHeight, double aGlyphThickness ) const;
/**
* @brief Compute the X and Y size of a given text. The text is expected to be
* a only one line text.
* @brief Compute the distance (interline) between 2 lines of text (for multiline texts).
*
* @param aText is the text string (one line).
* @return the text size.
* @param aGlyphHeight is the height (vertical size) of the text.
* @param aGlyphThickness is the thickness of the lines used to draw the text.
* @return the interline.
*/
static double GetInterline( double aGlyphHeight, double aGlyphThickness );

2
include/ki_exception.h
View File

@ -56,7 +56,7 @@ public:
* at the source file of thrower.
*
* @param aThrowersFunction is the function name at the throw site.
* @param aThrowersLineNumber, is the source code line number of the throw.
* @param aThrowersLineNumber is the source code line number of the throw.
*
* Use macro THROW_IO_ERROR() to wrap a call to this constructor at the call site.
*/

2
include/kiface_i.h
View File

@ -72,6 +72,8 @@ public:
* which contains the name of the DSO. Examples: "eeschema", "pcbnew", etc.
* This controls the name of the wxConfigBase established in m_bm,
* so it should be lowercase.
* @param aId is the type of DSO ( FACE_SCH, FACE_PCB, FACE_CVPCB,
* FACE_GERBVIEW, FACE_PL_EDITOR, FACE_PCB_CALCULATOR, FACE_BMP2CMP)
*/
KIFACE_I( const char* aKifaceName, KIWAY::FACE_T aId ) :
m_id( aId ),

1
include/painter.h
View File

@ -71,6 +71,7 @@ public:
* Sets the specified layer as active - it means that it can be drawn in a specific mode
* (eg. highlighted, so it differs from other layers).
* @param aLayerId is a layer number that should be displayed in a specific mode.
* @param aEnabled is the new layer state ( true = active or false = not active).
*/
inline void SetActiveLayer( int aLayerId, bool aEnabled = true )
{

12
include/plugins/3d/3d_plugin.h
View File

@ -122,16 +122,12 @@ KICAD_PLUGIN_EXPORT char const* GetFileFilter( int aIndex );
KICAD_PLUGIN_EXPORT bool CanRender( void );
/**
* Function Load
* reads the model file and creates a generic display structure
* reads a model file and creates a generic display structure
*
* @param aFileName is the full path of the model file
* @param aModel is a handle to a null pointer; on successful
* reading of the model data aModel will point to a representation
* for rendering
* @param returns true if the model was successfully loaded and false
* if there is no rendering support for the model or there were
* problems reading the model
* @return a SCENEGRAPH pointer to the display structure if the model
* was successfully loaded and NULL if there is no rendering support
* for the model or there were problems reading the model
*/
KICAD_PLUGIN_EXPORT SCENEGRAPH* Load( char const* aFileName );

4
pcbnew/dialogs/dialog_fp_lib_table.cpp
View File

@ -751,10 +751,10 @@ void DIALOG_FP_LIB_TABLE::OnClickLibraryWizard( wxCommandEvent& event )
}
int InvokePcbLibTableEditor( wxTopLevelWindow* aParent, FP_LIB_TABLE* aGlobal,
int InvokePcbLibTableEditor( wxTopLevelWindow* aCaller, FP_LIB_TABLE* aGlobal,
FP_LIB_TABLE* aProject )
{
DIALOG_FP_LIB_TABLE dlg( aParent, aGlobal, aProject );
DIALOG_FP_LIB_TABLE dlg( aCaller, aGlobal, aProject );
int dialogRet = dlg.ShowModal(); // returns value passed to EndModal() above

4
pcbnew/dialogs/wizard_3DShape_Libs_downloader.cpp
View File

@ -54,9 +54,9 @@
#define DEFAULT_GITHUB_3DSHAPES_LIBS_URL \
wxT( "https://github.com/KiCad/kicad-library/tree/master/modules/packages3d" )
void Invoke3DShapeLibsDownloaderWizard( wxTopLevelWindow* aParent )
void Invoke3DShapeLibsDownloaderWizard( wxTopLevelWindow* aCaller )
{
WIZARD_3DSHAPE_LIBS_DOWNLOADER wizard( aParent );
WIZARD_3DSHAPE_LIBS_DOWNLOADER wizard( aCaller );
wizard.RunWizard( wizard.GetFirstPage() );
}

2
pcbnew/footprint_wizard_frame.h
View File

@ -173,7 +173,7 @@ private:
void SaveSettings( wxConfigBase* aCfg ) override;
///> @copydoc EDA_DRAW_FRAME::GetHotKeyDescription()
EDA_HOTKEY* GetHotKeyDescription( int ) const override { return NULL; }
EDA_HOTKEY* GetHotKeyDescription( int aCommand ) const override { return NULL; }
/**
* Function OnActivate

4
pcbnew/invoke_pcb_dialog.h
View File

@ -89,7 +89,7 @@ int InvokePcbLibTableEditor( wxTopLevelWindow* aCaller, FP_LIB_TABLE* aGlobal,
* 2 - changes in the project table
* 3 - changes in both tables
*/
int InvokeFootprintWizard( wxTopLevelWindow* aParent, FP_LIB_TABLE* aGlobal,
int InvokeFootprintWizard( wxTopLevelWindow* aCaller, FP_LIB_TABLE* aGlobal,
FP_LIB_TABLE* aProject );
/**
@ -99,7 +99,7 @@ int InvokeFootprintWizard( wxTopLevelWindow* aParent, FP_LIB_TABLE* aGlobal,
*
* @param aCaller is the wxTopLevelWindow which is invoking the dialog.
*/
void Invoke3DShapeLibsDownloaderWizard( wxTopLevelWindow* aParent );
void Invoke3DShapeLibsDownloaderWizard( wxTopLevelWindow* aCaller );
/**

2
pcbnew/module_editor_frame.h
View File

@ -56,7 +56,7 @@ public:
*/
static const wxChar* GetFootprintEditorFrameName();
///> @copydoc PCB_BASE_FRAME::GetModel()
///> @copydoc PCB_BASE_EDIT_FRAME::GetModel()
BOARD_ITEM_CONTAINER* GetModel() const override;
BOARD_DESIGN_SETTINGS& GetDesignSettings() const override;

2
pcbnew/pcb_base_edit_frame.h
View File

@ -46,7 +46,7 @@ public:
/**
* Function GetModel()
* returns the primary data model.
* @return the primary data model.
*/
virtual BOARD_ITEM_CONTAINER* GetModel() const = 0;

8
pcbnew/ratsnest_data.h
View File

@ -484,7 +484,7 @@ public:
/**
* Function GetClosestNode()
* Returns a single node that lies in the shortest distance from a specific node and meets
* selected filter criterion..
* selected filter criterion.
* @param aNode is the node for which the closest node is searched.
* @param aFilter is a functor that filters nodes.
*/
@ -516,7 +516,7 @@ public:
/**
* Function AddSimple()
* Changes drawing mode for an item to simple (i.e. one ratsnest line per node).
* @param aNode is a node that changes its drawing mode.
* @param aItem is the item that changes its drawing mode.
*/
void AddSimple( const BOARD_CONNECTED_ITEM* aItem );
@ -769,9 +769,9 @@ public:
/**
* Function AreConnected()
* Checks if two items are connected with copper.
* @param aThis is the first item.
* @param aItem is the first item.
* @param aOther is the second item.
* @return True if they are connected, false otherwise.
* @return true if they are connected, false otherwise.
*/
bool AreConnected( const BOARD_CONNECTED_ITEM* aItem, const BOARD_CONNECTED_ITEM* aOther );

2
pcbnew/zone_filling_algorithm.cpp
View File

@ -142,7 +142,7 @@ bool ZONE_CONTAINER::BuildFilledSolidAreasPolygons( BOARD* aPcb, SHAPE_POLY_SET*
* It can be used for any angle, if the zone outline to fill is rotated by this angle
* and the result is rotated by -angle
* @param aPolygon = a SHAPE_LINE_CHAIN polygon to fill
* @param aFillSegmList = a std::vector <SEGMENT> which will be populated by filling segments
* @param aFillSegmList = a std::vector\<SEGMENT\> which will be populated by filling segments
* @param aStep = the horizontal grid size
*/
bool fillPolygonWithHorizontalSegments( const SHAPE_LINE_CHAIN& aPolygon,