summaryrefslogtreecommitdiff
path: root/FL
diff options
context:
space:
mode:
authorManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2023-01-15 11:00:48 +0100
committerManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2023-01-15 11:00:48 +0100
commitf54c2b3430b60536f99bb98baa4109f1f6b8566d (patch)
treef1703cf1d1595dfe440fd3b79d70a3ab0d82509b /FL
parent761aa5e485f676a3120a42495beb59e91698e5d1 (diff)
Have files fl_attr.h and names.h visible by Doxygen
For some reason, the \file Doxygen command is absolutely required.
Diffstat (limited to 'FL')
-rw-r--r--FL/fl_attr.h36
-rw-r--r--FL/names.h7
2 files changed, 31 insertions, 12 deletions
diff --git a/FL/fl_attr.h b/FL/fl_attr.h
index e2d6961da..44a402c77 100644
--- a/FL/fl_attr.h
+++ b/FL/fl_attr.h
@@ -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.
diff --git a/FL/names.h b/FL/names.h
index 745ec2133..87bb5178e 100644
--- a/FL/names.h
+++ b/FL/names.h
@@ -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