From 33c6a208a9e2512a174c99c224a933a59f091bc2 Mon Sep 17 00:00:00 2001 From: Jon Atack Date: Thu, 23 Sep 2021 17:22:15 +0200 Subject: [PATCH] span, doc: provide span.h context and explain lifetimebound definition --- src/span.h | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/span.h b/src/span.h index 830164514b9..c4562aebffa 100644 --- a/src/span.h +++ b/src/span.h @@ -30,7 +30,11 @@ /** A Span is an object that can refer to a contiguous sequence of objects. * - * It implements a subset of C++20's std::span. + * This file implements a subset of C++20's std::span. It can be considered + * temporary compatibility code until C++20 and is designed to be a + * self-contained abstraction without depending on other project files. For this + * reason, Clang lifetimebound is defined here instead of including + * , which also defines it. * * Things to be aware of when writing code that deals with Spans: * @@ -60,7 +64,7 @@ * types that expose a data() and size() member function), functions that * accept a Span as input parameter can be called with any compatible * range-like object. For example, this works: -* + * * void Foo(Span arg); * * Foo(std::vector{1, 2, 3}); // Works