Remove ASCII line divider comments from public headers

Author: sgerbino

include/boost/capy/buffers.hpp

@@ -32,8 +32,6 @@ namespace capy {
 class const_buffer;
 class mutable_buffer;
 
-//------------------------------------------------
-
 /// Tag type for customizing `buffer_size` via `tag_invoke`.
 struct size_tag {};
 
@@ -54,8 +52,6 @@ enum class slice_how
     keep_prefix
 };
 
-//------------------------------------------------
-
 /** A reference to a contiguous region of writable memory.
 
     Represents a pointer and size pair for a modifiable byte range.
@@ -146,8 +142,6 @@ class mutable_buffer
     }
 };
 
-//------------------------------------------------
-
 /** A reference to a contiguous region of read-only memory.
 
     Represents a pointer and size pair for a non-modifiable byte range.
@@ -245,8 +239,6 @@ class const_buffer
     }
 };
 
-//------------------------------------------------
-
 /** Concept for sequences of read-only buffer regions.
 
     A type satisfies `ConstBufferSequence` if it represents one or more
@@ -284,8 +276,6 @@ concept MutableBufferSequence =
         std::ranges::bidirectional_range<T> &&
         std::is_convertible_v<std::ranges::range_value_t<T>, mutable_buffer>);
 
-//------------------------------------------------------------------------------
-
 /** Return an iterator to the first buffer in a sequence.
 
     Handles single buffers and ranges uniformly. For a single buffer,
@@ -342,8 +332,6 @@ constexpr struct end_mrdocs_workaround_t
     }
 } end {};
 
-//------------------------------------------------------------------------------
-
 template<ConstBufferSequence CB>
 std::size_t
 tag_invoke(
@@ -357,8 +345,6 @@ tag_invoke(
     return n;
 }
 
-//------------------------------------------------------------------------------
-
 /** Return the total byte count across all buffers in a sequence.
 
     Sums the `size()` of each buffer in the sequence. This differs
@@ -403,8 +389,6 @@ constexpr struct buffer_empty_mrdocs_workaround_t
     }
 } buffer_empty {};
 
-//-----------------------------------------------
-
 namespace detail {
 
 template<class It>

include/boost/capy/buffers/asio.hpp

@@ -263,8 +263,6 @@ class buffer_sequence_adaptor
 
 } // detail
 
-//------------------------------------------------
-
 /** Adapt a capy buffer sequence for use with Asio.
 
     Returns a wrapper whose iterators dereference to

include/boost/capy/buffers/buffer_array.hpp

@@ -385,8 +385,6 @@ class buffer_array
     }
 };
 
-//------------------------------------------------
-
 /** Alias for buffer_array holding const_buffer.
 
     @tparam N Maximum number of buffers.

include/boost/capy/buffers/make_buffer.hpp

@@ -182,9 +182,7 @@ make_buffer(
         N * sizeof(T) < max_size ? N * sizeof(T) : max_size);
 }
 
-//------------------------------------------------
 // std::array
-//------------------------------------------------
 
 /** Return a buffer from a std::array.
 */
@@ -244,9 +242,7 @@ make_buffer(
             ? data.size() * sizeof(T) : max_size);
 }
 
-//------------------------------------------------
 // std::vector
-//------------------------------------------------
 
 /** Return a buffer from a std::vector.
 */
@@ -308,9 +304,7 @@ make_buffer(
             ? data.size() * sizeof(T) : max_size);
 }
 
-//------------------------------------------------
 // std::basic_string
-//------------------------------------------------
 
 /** Return a buffer from a std::basic_string.
 */
@@ -368,9 +362,7 @@ make_buffer(
             ? data.size() * sizeof(CharT) : max_size);
 }
 
-//------------------------------------------------
 // std::basic_string_view
-//------------------------------------------------
 
 /** Return a buffer from a std::basic_string_view.
 */
@@ -400,9 +392,7 @@ make_buffer(
             ? data.size() * sizeof(CharT) : max_size);
 }
 
-//------------------------------------------------
 // std::span
-//------------------------------------------------
 
 /** Return a buffer from a mutable std::span.
 */
@@ -458,9 +448,7 @@ make_buffer(
         data.size() < max_size ? data.size() : max_size);
 }
 
-//------------------------------------------------
 // Contiguous ranges
-//------------------------------------------------
 
 namespace detail {
 

include/boost/capy/buffers/slice.hpp

@@ -44,8 +44,6 @@ using slice_type = std::conditional_t<
     detail::has_tag_invoke<T>::value,
     T, slice_of<T>>;
 
-//------------------------------------------------
-
 /** A view of a sub-range of a buffer sequence.
 
     This class wraps a buffer sequence and presents a
@@ -410,8 +408,6 @@ class slice_of<BufferSequence>
     }
 };
 
-//------------------------------------------------
-
 // in-place modify  return value
 // -----------------------------
 // keep_prefix*     prefix
@@ -483,8 +479,6 @@ constexpr struct remove_suffix_mrdocs_workaround_t
     }
 } const remove_suffix{};
 
-//------------------------------------------------
-
 /** Return a sequence representing the first `n` bytes of a buffer sequence
 */
 constexpr struct prefix_mrdocs_workaround_t

include/boost/capy/concept/buffer_archetype.hpp

@@ -51,8 +51,6 @@ using const_buffer_archetype = const_buffer;
 using const_buffer_archetype = const_buffer_archetype_;
 #endif
 
-//------------------------------------------------
-
 /** Archetype for MutableBufferSequence concept checking.
 
     This type satisfies @ref MutableBufferSequence but cannot be

include/boost/capy/cond.hpp

@@ -72,8 +72,6 @@ enum class cond
     not_found = 4
 };
 
-//-----------------------------------------------
-
 } // capy
 } // boost
 
@@ -87,8 +85,6 @@ struct is_error_condition_enum<
 namespace boost {
 namespace capy {
 
-//-----------------------------------------------
-
 namespace detail {
 
 struct BOOST_CAPY_SYMBOL_VISIBLE
@@ -109,8 +105,6 @@ BOOST_CAPY_DECL extern cond_cat_type cond_cat;
 
 } // detail
 
-//-----------------------------------------------
-
 /// Create an error_condition from a cond value.
 inline
 std::error_condition

include/boost/capy/error.hpp

@@ -46,8 +46,6 @@ enum class error
     not_found
 };
 
-//-----------------------------------------------
-
 } // capy
 } // boost
 
@@ -61,8 +59,6 @@ struct is_error_code_enum<
 namespace boost {
 namespace capy {
 
-//-----------------------------------------------
-
 namespace detail {
 
 struct BOOST_CAPY_SYMBOL_VISIBLE
@@ -80,8 +76,6 @@ BOOST_CAPY_DECL extern error_cat_type error_cat;
 
 } // detail
 
-//-----------------------------------------------
-
 /// Create an error_code from an error value.
 inline
 std::error_code

include/boost/capy/ex/immediate.hpp

@@ -121,8 +121,6 @@ struct immediate
     }
 };
 
-//----------------------------------------------------------
-
 /** Create an immediate awaitable for a successful io_result.
 
     This helper creates an @ref immediate wrapping an @ref io_result
@@ -198,8 +196,6 @@ ready(T1 t1, T2 t2, T3 t3)
     return {{{}, std::move(t1), std::move(t2), std::move(t3)}};
 }
 
-//----------------------------------------------------------
-
 /** Create an immediate awaitable for a failed io_result.
 
     This helper creates an @ref immediate wrapping an @ref io_result

include/boost/capy/ex/run.hpp

@@ -59,12 +59,6 @@
 
 namespace boost::capy::detail {
 
-//----------------------------------------------------------
-//
-// dispatch_trampoline - cross-executor dispatch
-//
-//----------------------------------------------------------
-
 /** Minimal coroutine that dispatches through the caller's executor.
 
     Sits between the inner task and the parent when executors
@@ -148,12 +142,6 @@ inline dispatch_trampoline make_dispatch_trampoline()
     co_return;
 }
 
-//----------------------------------------------------------
-//
-// run_awaitable_ex - with executor (executor switch)
-//
-//----------------------------------------------------------
-
 /** Awaitable that binds an IoRunnable to a specific executor.
 
     Stores the executor and inner task by value. When co_awaited, the
@@ -265,12 +253,6 @@ struct [[nodiscard]] run_awaitable_ex
     run_awaitable_ex& operator=(run_awaitable_ex&&) = default;
 };
 
-//----------------------------------------------------------
-//
-// run_awaitable - no executor (inherits caller's executor)
-//
-//----------------------------------------------------------
-
 /** Awaitable that runs a task with optional stop_token override.
 
     Does NOT store an executor - the task inherits the caller's executor
@@ -364,12 +346,6 @@ struct [[nodiscard]] run_awaitable
     run_awaitable& operator=(run_awaitable&&) = default;
 };
 
-//----------------------------------------------------------
-//
-// run_wrapper_ex - with executor
-//
-//----------------------------------------------------------
-
 /** Wrapper returned by run(ex, ...) that accepts a task for execution.
 
     @tparam Ex The executor type.
@@ -505,12 +481,6 @@ class [[nodiscard]] run_wrapper_ex<Ex, InheritStopToken, void>
     }
 };
 
-//----------------------------------------------------------
-//
-// run_wrapper - no executor (inherits caller's executor)
-//
-//----------------------------------------------------------
-
 /** Wrapper returned by run(st) or run(alloc) that accepts a task.
 
     @tparam InheritStopToken If true, inherit caller's stop token.
@@ -629,12 +599,6 @@ class [[nodiscard]] run_wrapper<false, void>
 
 namespace boost::capy {
 
-//----------------------------------------------------------
-//
-// run() overloads - with executor
-//
-//----------------------------------------------------------
-
 /** Bind a task to execute on a specific executor.
 
     Returns a wrapper that accepts a task and produces an awaitable.
@@ -736,12 +700,6 @@ run(Ex ex, std::stop_token st, Alloc alloc)
         std::move(ex), std::move(st), std::move(alloc)};
 }
 
-//----------------------------------------------------------
-//
-// run() overloads - no executor (inherits caller's)
-//
-//----------------------------------------------------------
-
 /** Run a task with a custom stop token.
 
     The task inherits the caller's executor. Only the stop token