Fix a few doxygen errors (no actual code change)

This commit is contained in:
jean-pierre charras 2023-04-19 13:51:26 +02:00
parent 09d7e24b6d
commit 1406341d2d
30 changed files with 36 additions and 50 deletions

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file create_graphic_brd_items.cpp * @file create_3Dgraphic_brd_items.cpp
* @brief This file implements the creation of 2D graphic primitives of pcb items: * @brief This file implements the creation of 2D graphic primitives of pcb items:
* pads, tracks, drawsegments, texts.... * pads, tracks, drawsegments, texts....
* It is based on the function found in the files: * It is based on the function found in the files:

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file c3d_model_viewer.h * @file eda_3d_model_viewer.h
* @brief Implements a model viewer canvas. * @brief Implements a model viewer canvas.
* *
* The purpose of model viewer is to render 3d models that come in the original data from * The purpose of model viewer is to render 3d models that come in the original data from

View File

@ -24,8 +24,7 @@
*/ */
/** /**
* @file c_ogl_3dmodel.cpp * @file 3d_model.cpp
* @brief
*/ */
#include <algorithm> #include <algorithm>
#include <stdexcept> #include <stdexcept>

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file cbvh_pbrt.cpp * @file bvh_pbrt.cpp
* @brief This BVH implementation is based on the source code implementation * @brief This BVH implementation is based on the source code implementation
* from the book "Physically Based Rendering" (v2 and v3) * from the book "Physically Based Rendering" (v2 and v3)
* *

View File

@ -23,8 +23,7 @@
*/ */
/** /**
* @file ccylinder.cpp * @file cylinder_3d.cpp
* @brief
*/ */
#include "3d_fastmath.h" #include "3d_fastmath.h"

View File

@ -23,8 +23,7 @@
*/ */
/** /**
* @file cobject.cpp * @file object_3d.cpp
* @brief
*/ */
#include "object_3d.h" #include "object_3d.h"

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file ctrack_ball.cpp * @file track_ball.cpp
* @brief Implementation of a track ball camera. A track ball is placed in the * @brief Implementation of a track ball camera. A track ball is placed in the
* center of the screen and rotates the camera. * center of the screen and rotates the camera.
*/ */

View File

@ -25,7 +25,7 @@
*/ */
/** /**
* @file eda_3d_viewer.h * @file eda_3d_viewer_frame.h
* @brief Declaration of the eda_3d_viewer class * @brief Declaration of the eda_3d_viewer class
*/ */

View File

@ -22,7 +22,7 @@
*/ */
/** /**
* @file string.cpp * @file string_utils.cpp
* @brief Some useful functions to handle strings. * @brief Some useful functions to handle strings.
*/ */

View File

@ -22,7 +22,7 @@
*/ */
/** /**
* @file listboxes.cpp * @file listbox_base.cpp
* @brief Implementation of class for displaying footprint and symbol lists. * @brief Implementation of class for displaying footprint and symbol lists.
*/ */

View File

@ -22,7 +22,7 @@
*/ */
/** /**
* @file class_components_listbox.cpp * @file symbols_listbox.cpp
*/ */
#include <trace_helpers.h> #include <trace_helpers.h>

View File

@ -24,7 +24,7 @@
*/ */
/** /**
* @file component_references_lister.cpp * @file sch_reference_list.cpp
* @brief functions to create a symbol flat list and to annotate schematic. * @brief functions to create a symbol flat list and to annotate schematic.
*/ */

View File

@ -1,8 +1,3 @@
/**
* @file select_layers_to_pcb.cpp
* @brief Dialog to choose equivalence between gerber layers and pcb layers
*/
/* /*
* This program source code file is part of KiCad, a free EDA CAD application. * This program source code file is part of KiCad, a free EDA CAD application.
* *

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file select_layers_to_pcb.h * @file dialog_layers_select_to_pcb.h
*/ */
#ifndef DIALOG_LAYERS_SELECT_TO_PCB_H_ #ifndef DIALOG_LAYERS_SELECT_TO_PCB_H_

View File

@ -1,7 +1,3 @@
/**
* @file color4Dpickerdlg.h
*/
/* /*
* This program source code file is part of KiCad, a free EDA CAD application. * This program source code file is part of KiCad, a free EDA CAD application.
* *

View File

@ -75,7 +75,7 @@ public:
* a KIWAY_HOLDER mix-in. * a KIWAY_HOLDER mix-in.
* *
* @param aDest is the recipient of \a aKiway pointer. * @param aDest is the recipient of \a aKiway pointer.
* @param aKiway is often from a parent window or from #KIFACE::CreateWindow(). * @param aKiway is often from a parent window or from #KIFACE::CreateKiWindow().
*/ */
void SetKiway( wxWindow* aDest, KIWAY* aKiway ); void SetKiway( wxWindow* aDest, KIWAY* aKiway );

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file class_pcb_group.h * @file pcb_group.h
* @brief Class to handle a set of BOARD_ITEMs. * @brief Class to handle a set of BOARD_ITEMs.
*/ */

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file zoom_control.h * @file zoom_controller.h
* @brief ZOOM_CONTROLLER class definition. * @brief ZOOM_CONTROLLER class definition.
*/ */
@ -135,7 +135,7 @@ private:
/** /**
* A #ZOOM_CONTROLLER that zooms by a fixed factor based only on the magnitude of the scroll * A CONSTANT_ZOOM_CONTROLLER that zooms by a fixed factor based only on the magnitude of the scroll
* wheel rotation. * wheel rotation.
*/ */
class CONSTANT_ZOOM_CONTROLLER : public ZOOM_CONTROLLER class CONSTANT_ZOOM_CONTROLLER : public ZOOM_CONTROLLER

View File

@ -13,7 +13,6 @@
#ifndef _MP_MATHPLOT_H_ #ifndef _MP_MATHPLOT_H_
#define _MP_MATHPLOT_H_ #define _MP_MATHPLOT_H_
/** @file mathplot.h */
/** /**
* wxMathPlot is a framework for mathematical graph plotting in wxWindows. * wxMathPlot is a framework for mathematical graph plotting in wxWindows.
* *
@ -51,6 +50,11 @@
* Jose Luis Blanco, Val Greene.<br> * Jose Luis Blanco, Val Greene.<br>
*/ */
/**
* @file mathplot.h
*/
// this definition uses windows dll to export function. // this definition uses windows dll to export function.
// WXDLLIMPEXP_MATHPLOT definition definition changed to WXDLLIMPEXP_MATHPLOT // WXDLLIMPEXP_MATHPLOT definition definition changed to WXDLLIMPEXP_MATHPLOT
// mathplot_EXPORTS will be defined by cmake // mathplot_EXPORTS will be defined by cmake
@ -2032,6 +2036,4 @@ protected:
double m_min_x, m_max_x, m_min_y, m_max_y; double m_min_x, m_max_x, m_min_y, m_max_y;
}; };
/*@}*/
#endif // _MP_MATHPLOT_H_ #endif // _MP_MATHPLOT_H_

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file PROJECT_TREE_PANE.h * @file project_tree_pane.h
*/ */

View File

@ -19,7 +19,7 @@
*/ */
/** /**
* @file dialog_dielectric_manager.h * @file dialog_dielectric_list_manager.h
*/ */
#ifndef DIALOG_DIELECTRIC_MANAGER_H #ifndef DIALOG_DIELECTRIC_MANAGER_H

View File

@ -28,7 +28,7 @@
#define __dialog_enum_pads__ #define __dialog_enum_pads__
/** /**
* @file Subclass of DIALOG_ENUM_PADS_BASE which is generated by wxFormBuilder. * @file dialog_enum_pads.h
*/ */
#include "dialog_enum_pads_base.h" #include "dialog_enum_pads_base.h"

View File

@ -1,7 +1,3 @@
/**
* @file pcbnew/legacy_netlist_reader.cpp
*/
/* /*
* This program source code file is part of KiCad, a free EDA CAD application. * This program source code file is part of KiCad, a free EDA CAD application.
* *

View File

@ -851,7 +851,7 @@ int PAD::GetSolderMaskExpansion() const
{ {
// Pads defined only on mask layers (and perhaps on other tech layers) use the shape // Pads defined only on mask layers (and perhaps on other tech layers) use the shape
// defined by the pad settings only // defined by the pad settings only
if( !IsOnCopperLayer() ) if( !IsOnCopperLayer() && !HasHole() )
return 0; return 0;
int margin = m_localSolderMaskMargin; int margin = m_localSolderMaskMargin;

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file altium_plugin.cpp * @file altium_circuit_maker_plugin.cpp
* @brief Pcbnew PLUGIN for Altium *.PcbDoc format. * @brief Pcbnew PLUGIN for Altium *.PcbDoc format.
*/ */

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file altium_plugin.cpp * @file altium_circuit_studio_plugin.cpp
* @brief Pcbnew PLUGIN for Altium *.PcbDoc format. * @brief Pcbnew PLUGIN for Altium *.PcbDoc format.
*/ */

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file altium_plugin.cpp * @file altium_designer_plugin.cpp
* @brief Pcbnew PLUGIN for Altium *.PcbDoc format. * @brief Pcbnew PLUGIN for Altium *.PcbDoc format.
*/ */

View File

@ -24,7 +24,7 @@
*/ */
/** /**
* @file pcb_cutout.cpp * @file pcad_cutout.cpp
*/ */
#include <pcad/pcad_cutout.h> #include <pcad/pcad_cutout.h>

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file python_scripting.cpp * @file pcbnew_scripting.cpp
* @brief methods to add scripting capabilities inside pcbnew * @brief methods to add scripting capabilities inside pcbnew
*/ */

View File

@ -23,7 +23,7 @@
*/ */
/** /**
* @file class_zone_settings.h * @file zone_settings.h
* @brief Class ZONE_SETTINGS used to handle zones parameters in dialogs. * @brief Class ZONE_SETTINGS used to handle zones parameters in dialogs.
*/ */