fixed some style issues, added tooling for docs

docs/hosts/mgmt_msg.md

@@ -0,0 +1,19 @@
+# hosts/mgmt_msg.h
+
+## class MgmtMsg — public interface
+
+### `virtual ~MgmtMsg() = default;`
+
+## class HeartbeatMsg — public interface
+
+### `: subscriber_id(sid), status(st), generated_at(t) { ... }`
+### `MgmtKind kind() const noexcept override { ... }`
+
+## class JobFinishedMsg — public interface
+
+### `: flow_id(fid), finished_at(t) { ... }`
+### `MgmtKind kind() const noexcept override { ... }`
+
+## class EndSimulationMsg — public interface
+
+### `MgmtKind kind() const noexcept override { ... }`

docs/hosts/policies.md

@@ -0,0 +1,20 @@
+# hosts/policies.h
+
+## class PubBasePolicy — public interface
+
+### `virtual ~PubBasePolicy() = default;`
+
+## class PubRRPolicy — public interface
+
+### `: _ranges(std::move(ranges)) { ... }`
+### `validate_and_build();`
+### `PacketGroups select_multicast_groups(PacketGroups update_groups_mask) override { ... }`
+### `for (auto const& r : _ranges) { ... }`
+
+## class SubBasePolicy — public interface
+
+### `virtual ~SubBasePolicy() = default;`
+
+## class SubDummyPolicy — public interface
+
+### `~SubDummyPolicy() override = default;`

docs/hosts/publisher.md

@@ -0,0 +1,10 @@
+# hosts/publisher.h
+
+## class Publisher — public interface
+
+### `void recv_update(Bytes size, PacketGroups update_groups_mask) noexcept;`
+### `void set_status(NodeStatus s, Time new_latency = Time{}) noexcept;`
+### `virtual void recv_mgmt_msg(MgmtMsgPtr msg) noexcept override;`
+### `virtual void recv_frame(const Packet& frame) override;`
+### `uint64_t updates_in() const noexcept { ... }`
+### `uint64_t bytes_out() const noexcept { ... }`

docs/hosts/subscriber.md

@@ -0,0 +1,8 @@
+# hosts/subscriber.h
+
+## class Publisher — public interface
+
+### `virtual void recv_mgmt_msg(MgmtMsgPtr msg) noexcept override;`
+### `void recv_frame(const Packet& frame) override;`
+### `void set_status(NodeStatus s) noexcept;`
+### `void set_publisher(Publisher* p) noexcept { ... }`