Skip to content

Commit

Permalink
Merge #19200
Browse files Browse the repository at this point in the history
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>
  • Loading branch information
bors[bot] and bergzand authored Jan 26, 2023
2 parents 719787b + 96e37a4 commit 7b75351
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 26 deletions.
1 change: 1 addition & 0 deletions doc/doxygen/riot.doxyfile
Original file line number Diff line number Diff line change
Expand Up @@ -778,6 +778,7 @@ INPUT = ../../doc.txt \
src/changelog.md \
../../LOSTANDFOUND.md \
../../makefiles/pseudomodules.inc.mk \
../../makefiles/blob.inc.mk \
../../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
Expand Down
59 changes: 33 additions & 26 deletions makefiles/blob.inc.mk
Original file line number Diff line number Diff line change
@@ -1,29 +1,36 @@
#
# makes any file in BLOBS available via '#include "blob/<filename>.h"
#
# # Usage:
#
# Add this to an application or module Makefile:
#
# BLOBS += foo.ext
#
# Then include in C file or header:
#
# #include "blob/foo.ext.h"
#
# The blob can then be accessed using the symbols "foo_ext" and "foo_ext_len".
#
# # Subfolders
#
# 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.
#
## @defgroup utils_blob Blob file module
## @ingroup utils
## @brief Include any file content as binary data in a RIOT application
##
## makes any file in BLOBS available via an include directive in the C code.
##
## # Usage:
##
## Add this to an application or module Makefile:
##
## ```
## BLOBS += foo.ext
## ```
##
## Then include in C file or header:
##
## ```
## #include "blob/foo.ext.h"
## ```
##
## The blob can then be accessed using the symbols "foo_ext" and "foo_ext_len".
##
## # Subfolders
##
## 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
# we don't have to add $(BINDIR)/$(MODULE) to the include path.
Expand Down

0 comments on commit 7b75351

Please sign in to comment.