Have files fl_attr.h and names.h visible by Doxygen

For some reason, the \file Doxygen command is absolutely required.
This commit is contained in:
ManoloFLTK 2023-01-15 11:00:48 +01:00
parent 761aa5e485
commit f54c2b3430
2 changed files with 31 additions and 12 deletions

View File

@ -1,7 +1,7 @@
/*
* Function attribute declarations for the Fast Light Tool Kit (FLTK).
*
* Copyright 1998-2021 by Bill Spitzak and others.
* Copyright 1998-2023 by Bill Spitzak and others.
*
* This library is free software. Distribution and use rights are outlined in
* the file "COPYING" which should have been included with this file. If this
@ -14,9 +14,33 @@
* https://www.fltk.org/bugs.php
*/
/**
\file fl_attr.h
This file defines compiler-specific macros
*/
#ifndef _FL_fl_attr_h_
#define _FL_fl_attr_h_
#ifdef FL_DOXYGEN
/**
This macro makes it safe to use the C++11 keyword \c override with
older compilers.
*/
#define FL_OVERRIDE override
/** To be used in prototypes with a variable list of arguments.
This macro helps detection of mismatches between format string and
argument list at compilation time.
Usage example: FL/fl_ask.H
*/
#define __fl_attr(x)
#else
/*
The GNUC-specific attribute appearing below in prototypes with a variable
list of arguments helps detection of mismatches between format string and
@ -32,16 +56,6 @@
#endif
#ifdef FL_DOXYGEN
/**
This macro makes it safe to use the C++11 keyword \c override with
older compilers.
*/
#define FL_OVERRIDE override
#else
#ifdef __cplusplus
// Visual Studio defines __cplusplus = '199711L' which is not helpful.

View File

@ -1,7 +1,7 @@
//
// Event names header file for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2016 by Bill Spitzak and others.
// Copyright 1998-2023 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
@ -16,6 +16,11 @@
// Thanks to Greg Ercolano for this addition.
/**
\file names.h
This file defines arrays of human readable names for FLTK symbolic constants.
*/
#ifndef FL_NAMES_H
#define FL_NAMES_H