Skip to content

Commit

Permalink
Documentation tweaks and sub-minor version bump
Browse files Browse the repository at this point in the history
  • Loading branch information
xross committed Oct 14, 2024
1 parent 3e6d86b commit 85eec00
Show file tree
Hide file tree
Showing 5 changed files with 15 additions and 7 deletions.
5 changes: 5 additions & 0 deletions CHANGELOG.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
lib_logging change log
======================

3.3.1
-----

* CHANGED: Documentation updates

3.3.0
-----

Expand Down
7 changes: 5 additions & 2 deletions doc/rst/logging.rst → doc/rst/lib_logging.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ or disabled via configuration defines. Code can be declared to be
within a "debug unit" (usually a library or application source base)
and prints can be enabled/disabled per debug unit.

``lib_logging`` is intended to be used with the `XCommon CMake <https://www.xmos.com/file/xcommon-cmake-documentation/?version=latest>`_
, the `XMOS` application build and dependency management system.

***
API
***
Expand All @@ -21,7 +24,7 @@ To use this module, include ``lib_logging`` in the application's
.. doxygenfunction:: debug_printf

***********
Debug Units
Debug units
***********

A source file can be added to a debug unit by defining the ``DEBUG_UNIT`` macro before inclusion of ``debug_print.h``. For example::
Expand All @@ -37,7 +40,7 @@ convenient to do it in the ``lib_build_info.cmake`` file of the module e.g.::
If no ``DEBUG_UNIT`` is defined then the default debug unit is ``APPLICATION``.

*****************
Enabling Printing
Enabling printing
*****************

By default, debug printing is turned *off*. To enable printing you
Expand Down
2 changes: 1 addition & 1 deletion lib_logging/lib_build_info.cmake
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
set(LIB_NAME lib_logging)
set(LIB_VERSION 3.3.0)
set(LIB_VERSION 3.3.1)
set(LIB_INCLUDES api)
set(LIB_COMPILER_FLAGS -Os)
set(LIB_DEPENDENT_MODULES "")
Expand Down
2 changes: 1 addition & 1 deletion lib_logging/module_build_info
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
VERSION = 3.3.0
VERSION = 3.3.1

DEPENDENT_MODULES =

Expand Down
6 changes: 3 additions & 3 deletions settings.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@
lib_name: lib_logging
project: '{{lib_name}}'
title: '{{lib_name}}: Debug Printing'
version: 3.3.0
version: 3.3.1

documentation:
exclude_patterns_path: doc/exclude_patterns.inc
root_doc: doc/rst/logging.rst
root_doc: doc/rst/lib_logging.rst
linkcheck_ignore_regex: ['']
cognidox_part_number: XM-006383-UG
doxygen_projects:
lib_logging:
doxyfile_path: doc/Doxyfile.inc
pdfs:
doc/rst/logging.rst:
doc/rst/lib_logging.rst:
pdf_title: '{{title}}'
pdf_filename: '{{lib_name}}_v{{version}}'
README.rst:
Expand Down

0 comments on commit 85eec00

Please sign in to comment.