1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
19200: blobs: include documentation in doxygen r=kaspar030 a=bergzand

### Contribution description

This PR changes the blob makefile documentation to be included in the doxygen output. I ~~didn't~~ slightly change the documentation itself to satisfy doxygen, just added another # and the doxygen boiler plating .
 

### Testing procedure

Take a look at the docs


### Issues/PRs references

None


Co-authored-by: Koen Zandberg <koen@bergzand.net>
This commit is contained in:
bors[bot] 2023-01-26 08:36:33 +00:00 committed by GitHub
commit 7b75351bdd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 34 additions and 26 deletions

View File

@ -778,6 +778,7 @@ INPUT = ../../doc.txt \
src/changelog.md \ src/changelog.md \
../../LOSTANDFOUND.md \ ../../LOSTANDFOUND.md \
../../makefiles/pseudomodules.inc.mk \ ../../makefiles/pseudomodules.inc.mk \
../../makefiles/blob.inc.mk \
../../sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c ../../sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c
# This tag can be used to specify the character encoding of the source files # This tag can be used to specify the character encoding of the source files

View File

@ -1,29 +1,36 @@
# ## @defgroup utils_blob Blob file module
# makes any file in BLOBS available via '#include "blob/<filename>.h" ## @ingroup utils
# ## @brief Include any file content as binary data in a RIOT application
# # Usage: ##
# ## makes any file in BLOBS available via an include directive in the C code.
# Add this to an application or module Makefile: ##
# ## # Usage:
# BLOBS += foo.ext ##
# ## Add this to an application or module Makefile:
# Then include in C file or header: ##
# ## ```
# #include "blob/foo.ext.h" ## BLOBS += foo.ext
# ## ```
# The blob can then be accessed using the symbols "foo_ext" and "foo_ext_len". ##
# ## Then include in C file or header:
# # Subfolders ##
# ## ```
# It is possible to add files from subfolders to BLOBS: ## #include "blob/foo.ext.h"
# ## ```
# BLOBS += subfolder/my_file.foo ##
# ## The blob can then be accessed using the symbols "foo_ext" and "foo_ext_len".
# The subfolder will be part of the generated header's path, but *not* of the ##
# generated symbols. E.g., above blob would be made available by including ## # Subfolders
# "blobs/subfolder/my_file.ext.h", which would define the symbols "my_file_ext" ##
# and "my_file_ext_len". Beware possible symbol name clashes. ## It is possible to add files from subfolders to BLOBS:
# ##
## BLOBS += subfolder/my_file.foo
##
## The subfolder will be part of the generated header's path, but *not* of the
## generated symbols. E.g., above blob would be made available by including
## "blobs/subfolder/my_file.ext.h", which would define the symbols "my_file_ext"
## and "my_file_ext_len". Beware possible symbol name clashes.
##
# use "blobs/blob" so the headers can be included as "blob/foo.h", but # use "blobs/blob" so the headers can be included as "blob/foo.h", but
# we don't have to add $(BINDIR)/$(MODULE) to the include path. # we don't have to add $(BINDIR)/$(MODULE) to the include path.