6.8.0

doxygen/Doxyfile

@@ -5,7 +5,7 @@
 #---------------------------------------------------------------------------
 DOXYFILE_ENCODING      = UTF-8
 PROJECT_NAME           = "QP-nano"
-PROJECT_NUMBER         = "6.7.0"
+PROJECT_NUMBER         = "6.8.0"
 PROJECT_BRIEF          =
 PROJECT_LOGO           = images/header_logo_ql.png
 OUTPUT_DIRECTORY       =
@@ -147,7 +147,7 @@ FILE_PATTERNS          = \
     *.lnt
 
 RECURSIVE              = YES
-EXCLUDE                = 
+EXCLUDE                =
 
 EXCLUDE_SYMLINKS       = NO
 EXCLUDE_PATTERNS       =

doxygen/Doxyfile-CHM

@@ -5,7 +5,7 @@
 #---------------------------------------------------------------------------
 DOXYFILE_ENCODING      = UTF-8
 PROJECT_NAME           = "QP-nano"
-PROJECT_NUMBER         = "6.7.0"
+PROJECT_NUMBER         = "6.8.0"
 PROJECT_BRIEF          =
 PROJECT_LOGO           = images/header_logo_ql.png
 OUTPUT_DIRECTORY       =
@@ -147,7 +147,7 @@ FILE_PATTERNS          = \
     *.lnt
 
 RECURSIVE              = YES
-EXCLUDE                = 
+EXCLUDE                =
 
 EXCLUDE_SYMLINKS       = NO
 EXCLUDE_PATTERNS       =

doxygen/history.dox

@@ -1,6 +1,26 @@
 /**
 @page history Revision History
 
+@section qpn_6_8_0 Version 6.8.0, 2020-03-31
+
+Source code changes:
+
+- Fixed inconsistencies between QP API declarations in the .h files and definitions in the .c files, such as different parameter names in declarations and definitions (MISRA-C:2012).
+
+- Removed a lot of excessive type casting of compile-time constants, such as `(uint8_t)0`, which is now coded simply as `0U`
+
+- Introduced #Q_NORETURN macro for Q_onAssert(), which can (if defined) inform the compiler that Q_onAssert() does not return. This can potentially improve the code generation and can improve diagnostics generated by the compiler as well as static code analysis tools.
+
+
+Updated Examples:
+
+Converted most of the examples for ARM-MDK from the no-longer maintained compiler-5 (RVDS) to the new ARM Compiler-6 (ARM-clang). The examples for ARM Compiler-6 are located in the `armclang` sub-directories.
+
+@note
+The older ARM Compiler-5 is still supported, but will be phased out in the future. The only examples for ARM Compiler-5 are for the EK-TM4C123GXL (TivaC LanuchPad) board. These examples are located in the `arm` sub-directories.
+
+
+------------------------------------------------------------------------------
 @section qpn_6_7_0 Version 6.7.0, 2019-12-30
 The main purpose of this release is providing improved compliance with MISRA-C:2012 (including  MISRA-C:2012-Amendment-1) and also to provide support for the [<b>PC-Lint-Plus</b>](https://www.gimpel.com/) static analysis tool (see also feature request [#169](https://sourceforge.net/p/qpc/feature-requests/169/)). Specifically, the QP-nano source code and some examples have been adjusted to comply with MISRA-C:2012-Amendment-1 rules, with all deviations captured in the PC-Lint-Plus configuration files. These PC-Lint-Plus configuration files have been provided in the new "port" to PC-Lint-Plus in the directory qpn/ports/lint-plus/.
 
@@ -27,7 +47,7 @@ Also, this release drops (no longer supports) the following depricated facilitie
 - QActive_disarm() - use QActive_disarmX() instead
 - Q_TIMERSET - define QF_TIMEEVT_USAGE instead
 
-Also, this release updates the Windows-GUI examples with the QWIN Prototyping Toolkit to work with the latest Visual Studio 2019 and specifically with the Resource Editor now available. Specifically here, the Game-GUI example (qpn\examples\arm-cm\game_efm32-slstk3401a\win32-gui) and the DPP-GUI example (qpn\examples\arm-cm\dpp_efm32-slstk3401a\win32-gui) have been updated to build with the Visual Studio 2019.
+Also, this release updates the Windows-GUI examples with the QWIN Prototyping Toolkit to work with the latest Visual Studio 2019 and specifically with the Resource Editor now available. Specifically here, the Game-GUI example (qpn\examples\arm-cm\game_efm32-slstk3401a\win32-gui) and the DPP-GUI example (qpn\examples\arm-cm\dpp_efm32-slstk3401a\win32-gui) have been updated to build with the Visual Studio 2019.
 
 Finally, this release fixes the following bugs:
 - [bug#255 "IAR-ARM "Multi-file Compilation" fails for QK and QXK applications"](https://sourceforg/bugs/255/)

doxygen/make.bat

@@ -1,14 +1,14 @@
 @echo off
 :: ==========================================================================
 :: Product: QP-nano script for generating Doxygen documentation
-:: Last Updated for Version: 6.7.0
-:: Date of the Last Update:  2019-12-30
+:: Last Updated for Version: 6.8.0
+:: Date of the Last Update:  2020-01-17
 ::
 ::                    Q u a n t u m  L e a P s
 ::                    ------------------------
 ::                    Modern Embedded Software
 ::
-:: Copyright (C) Quantum Leaps, LLC. All rights reserved.
+:: Copyright (C) 2005-2020 Quantum Leaps, LLC. All rights reserved.
 ::
 :: This program is open source software: you can redistribute it and/or
 :: modify it under the terms of the GNU General Public License as published
@@ -29,7 +29,7 @@
 :: along with this program. If not, see <http://www.gnu.org/licenses/>.
 ::
 :: Contact information:
-:: <www.state-machine.com>
+:: <www.state-machine.com/licensing>
 :: <[email protected]>
 :: ==========================================================================
 @setlocal
@@ -38,25 +38,23 @@
 @echo make
 @echo make -CHM
 
-@set VERSION=6.7.0
-
 @set DOXHOME="C:\tools\doxygen\bin"
 
-:: Generate Resource Standard Metrics for QP-nano ............................ 
-@set RCMHOME="C:\tools\MSquared\M2 RSM"
+:: Generate Metrics for QP/C++ ..............................................
+@set LIZARD=C:\tools\Python27\python.exe C:\tools\lizard\lizard.py 
 
-@set RSM_OUTPUT=metrics.dox
-@set RSM_INPUT=..\include\*.h ..\src\qfn\*.c ..\src\qkn\*.c ..\src\qvn\*.c
+@set METRICS_INP=..\include ..\src -x ..\src\qs\*
+@set METRICS_OUT=metrics.dox
 
-@echo /** @page metrics Code Metrics > %RSM_OUTPUT%
-@echo.>> %RSM_OUTPUT%
-@echo @code >> %RSM_OUTPUT%
-@echo                    Standard Code Metrics for QP-nano %VERSION% >> %RSM_OUTPUT%
+@echo /** @page metrics Code Metrics > %METRICS_OUT%
+@echo.>> %METRICS_OUT%
+@echo @code{cpp} >> %METRICS_OUT%
+@echo                    Code Metrics for QP-nano >> %METRICS_OUT%
 
-%RCMHOME%\rsm.exe -fd -xNOCOMMAND -xNOCONFIG -u"File cfg rsm_qpn.cfg" %RSM_INPUT% >> %RSM_OUTPUT%
+%LIZARD% -m -L500 -a10 -C20 -V %METRICS_INP% >> %METRICS_OUT%
 
-@echo @endcode >> %RSM_OUTPUT%
-@echo */ >> %RSM_OUTPUT%
+@echo @endcode >> %METRICS_OUT%
+@echo */ >> %METRICS_OUT%
 
 :: Generate Doxygen Documentation ........................................... 
 if "%1"=="-CHM" (