doxygen: add newline after \file

While \file doesn't need an argument, it can't have another doxy
command after it.
This commit is contained in:
2019-02-18 08:08:12 +11:00
parent 3316853323
commit de13d0a80c
2994 changed files with 6288 additions and 3339 deletions

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines the '_bpy' module which is used by python's 'bpy' package
* to access C defined builtin functions.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines a 'PyStructSequence' accessed via 'bpy.app', mostly
* exposing static applications variables such as version and buildinfo

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_H__

View File

@@ -17,7 +17,8 @@
* All rights reserved.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -17,7 +17,8 @@
* All rights reserved.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_ALEMBIC_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_BUILD_OPTIONS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_FFMPEG_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines a 'PyStructSequence' accessed via 'bpy.app.handlers',
* which exposes various lists that the script author can add callback

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_HANDLERS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* Runtime defined icons.
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_ICONS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_OCIO_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_OIIO_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_OPENSUBDIV_H__

View File

@@ -17,7 +17,8 @@
* All rights reserved.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -17,7 +17,8 @@
* All rights reserved.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_OPENVDB_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_SDL_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include <Python.h>

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_TIMERS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines a singleton py object accessed via 'bpy.app.translations',
* which exposes various data and functions useful in i18n work.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_APP_TRANSLATIONS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file contains Blender/Python utility functions to help implementing API's.
* This is not related to a particular module.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_CAPI_UTILS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines the 'BPY_driver_exec' to execute python driver expressions,
* called by the animation system, there are also some utility functions

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_DRIVER_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file is so Python can define widget-group's that C can call into.
* The generic callback functions for Python widget-group are defines in

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_GIZMO_WRAP_H__

View File

@@ -16,7 +16,8 @@
* Chris Keith, Chris Want, Ken Hughes, Campbell Barton
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file deals with embedding the python interpreter within blender,
* starting and stopping python and exposing blender/python modules so they can

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file inserts an exit callback into pythons 'atexit' module.
* Without this sys.exit() can crash because blender is not properly closing

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* Store python versions of strings frequently used for python lookups
* to avoid converting, creating the hash and freeing every time as

View File

@@ -17,7 +17,8 @@
#ifndef __BPY_INTERN_STRING_H__
#define __BPY_INTERN_STRING_H__
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
void bpy_intern_string_init(void);

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_LIBRARY_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file exposed blend file library appending/linking to python, typically
* this would be done via RNA api but in this case a hand written python api

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* Python API for writing a set of data-blocks into a file.
* Useful for writing out asset-libraries, defines: `bpy.data.libraries.write(...)`.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
* This file defines '_bpy_msgbus' module, exposed as 'bpy.msgbus'.
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_MSGBUS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines '_bpy.ops', an internal python module which gives python
* the ability to inspect and call both C and Python defined operators.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_OPERATOR_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file is so python can define operators that C can call into.
* The generic callback functions for python operators are defines in

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_OPERATOR_WRAP_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines '_bpy_path' module, Some 'C' functionality used by 'bpy.path'
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines 'bpy.props' module used so scripts can define their own
* rna properties for use with python operators or adding new properties to

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file is the main interface between python and blenders data api (RNA),
* exposing RNA to python so blender data can be accessed in a python like way.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_RNA_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines the animation related methods used in bpy_rna.c
*/

View File

@@ -17,7 +17,8 @@
#ifndef __BPY_RNA_ANIM_H__
#define __BPY_RNA_ANIM_H__
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
extern char pyrna_struct_keyframe_insert_doc[];

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file deals with array access for 'BPy_PropertyArrayRNA' from bpy_rna.c
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file currently exposes callbacks for interface regions but may be
* extended later.

View File

@@ -17,7 +17,8 @@
#ifndef __BPY_RNA_CALLBACK_H__
#define __BPY_RNA_CALLBACK_H__
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
struct BPy_StructRNA;

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines utility functions that use the RNA API, from PyDrivers.
*/

View File

@@ -17,7 +17,8 @@
#ifndef __BPY_RNA_DRIVER_H__
#define __BPY_RNA_DRIVER_H__
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
struct ChannelDriver;

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* .
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_RNA_GIZMO_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file adds some helpers related to ID/Main handling, that cannot fit well in RNA itself.
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_RNA_ID_COLLECTION_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file contains utility functions for getting data from a python stack
* trace.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines a singleton py object accessed via 'bpy.utils.previews',
* which exposes low-level API for custom previews/icons.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_UTILS_PREVIEWS_H__

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*
* This file defines a singleton py object accessed via 'bpy.utils.units',
* which exposes various data and functions useful in units handling.

View File

@@ -14,7 +14,8 @@
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#ifndef __BPY_UTILS_UNITS_H__

View File

@@ -17,7 +17,8 @@
* All rights reserved.
*/
/** \file \ingroup pythonintern
/** \file
* \ingroup pythonintern
*/
#include "BLI_utildefines.h"