summaryrefslogtreecommitdiff
path: root/docs/doxygen/other
diff options
context:
space:
mode:
authorTom Rondeau <tom@trondeau.com>2014-09-30 21:37:37 -0400
committerTom Rondeau <tom@trondeau.com>2014-09-30 21:37:37 -0400
commitefd9bcd21d9f36fb1d85c7d3794bae3d6882feb1 (patch)
tree13314c83068ce76feaa42817439c5da44da822e4 /docs/doxygen/other
parent4ecfc89678f69692ca9197f047b9ab245136c8f4 (diff)
docs: Adds a brief explanation about adding and getting items tags inside/outside calls to work.
Addresses issue #699.
Diffstat (limited to 'docs/doxygen/other')
-rw-r--r--docs/doxygen/other/stream_tags.dox5
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/doxygen/other/stream_tags.dox b/docs/doxygen/other/stream_tags.dox
index 851740984e..d48ec1ddee 100644
--- a/docs/doxygen/other/stream_tags.dox
+++ b/docs/doxygen/other/stream_tags.dox
@@ -61,7 +61,10 @@ at <em>nitems_written(0)+i</em> for the 0th output port.
\section stream_tags_api Stream Tags API
The stream tags API consists of four functions, two to add and two to
-get the stream tags. These functions are:
+get the stream tags. These functions are only meant to be accessed
+within a call to general_work/work. While they can be called elsewhere
+in time by a block, the behavior outside of work is undefined without
+exact knowledge of the item counts in the buffers.
\li gr::block::add_item_tag: Adds an item tag to a particular output port using a
gr::tag_t data type.