Put advanced configuration Doxygen comments in their own group.

This commit is contained in:
Wayne Stambaugh 2023-02-18 12:49:42 -05:00
parent 2d843a71d6
commit 12a5c2e037
1 changed files with 17 additions and 7 deletions

View File

@ -1,7 +1,7 @@
/* /*
* 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.
* *
* Copyright (C) 2019-2022 KiCad Developers, see AUTHORS.txt for contributors. * Copyright (C) 2019-2023 KiCad Developers, see AUTHORS.txt for contributors.
* *
* This program is free software; you can redistribute it and/or * This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License * modify it under the terms of the GNU General Public License
@ -27,6 +27,8 @@
class wxConfigBase; class wxConfigBase;
/** /**
* @defgroup advanced_config Advanced Configuration Variables
*
* Class containing "advanced" configuration options. * Class containing "advanced" configuration options.
* *
* Options set here are for developer or advanced users only. If a general user * Options set here are for developer or advanced users only. If a general user
@ -55,6 +57,7 @@ class wxConfigBase;
* config files, and why you might want to set them, see #AC_KEYS * config files, and why you might want to set them, see #AC_KEYS
* *
*/ */
class ADVANCED_CFG class ADVANCED_CFG
{ {
public: public:
@ -66,6 +69,9 @@ public:
*/ */
static const ADVANCED_CFG& GetCfg(); static const ADVANCED_CFG& GetCfg();
///@{
/// \ingroup advanced_config
/** /**
* Distance from an arc end point and the estimated end point, when rotating from the * Distance from an arc end point and the estimated end point, when rotating from the
* start point to the end point. * start point to the end point.
@ -146,7 +152,7 @@ public:
bool m_DrawTriangulationOutlines; bool m_DrawTriangulationOutlines;
/** /**
* When true, adds zone-diaplay-modes for stroking the zone fracture boundaries and the zone * When true, adds zone-display-modes for stroking the zone fracture boundaries and the zone
* triangulation. * triangulation.
*/ */
bool m_ExtraZoneDisplayModes; bool m_ExtraZoneDisplayModes;
@ -197,7 +203,8 @@ public:
/** /**
* Skip reading/writing 3d model memory caches * Skip reading/writing 3d model memory caches
* This ensures 3d models are always reloaded from disk even if we previously opened the 3d viewer. * This ensures 3d models are always reloaded from disk even if we previously opened the 3d
* viewer.
*/ */
bool m_Skip3DModelMemoryCache; bool m_Skip3DModelMemoryCache;
@ -224,21 +231,24 @@ public:
/** /**
* 3D-Viewer, Raytracing * 3D-Viewer, Raytracing
* Bevel height of layer items. Controls the start of curvature normal on the edge. * Bevel height of layer items. Controls the start of curvature normal on the edge.
* Value is in micrometre. Good values should be arround or less than the copper thickness. * Value is in micrometer. Good values should be around or less than the copper thickness.
*/ */
int m_3DRT_BevelHeight_um; int m_3DRT_BevelHeight_um;
/** /**
* 3D-Viewer, Raytracing * 3D-Viewer raytracing factor applied to Extent.z of the item layer.
* Factor applied to Extent.z of the item layer, used on calculation of the bevel's height. *
* This is used on calculation of the bevel's height.
*/ */
double m_3DRT_BevelExtentFactor; double m_3DRT_BevelExtentFactor;
/** /**
* User Clipper2 instead of Clipper1 * Use Clipper2 instead of Clipper1
*/ */
bool m_UseClipper2; bool m_UseClipper2;
///@}
private: private:
ADVANCED_CFG(); ADVANCED_CFG();