Skip to content

doc: clarify protocol-tag family/type/protocol return values#273

Open
mvandeberg wants to merge 1 commit into
cppalliance:developfrom
mvandeberg:pr/255-protocol-tag-return-values
Open

doc: clarify protocol-tag family/type/protocol return values#273
mvandeberg wants to merge 1 commit into
cppalliance:developfrom
mvandeberg:pr/255-protocol-tag-return-values

Conversation

@mvandeberg

Copy link
Copy Markdown
Contributor

The family()/type()/protocol() members on the protocol tags returned bare platform constants documented as "the protocol (0)", which read as one entry in an unlisted corosio enumeration (#255).

Explain at the class level that these three members produce the (family, type, protocol) triple passed to the OS socket() call and that the values are platform-defined constants, and expand local_stream/local_datagram protocol() to state that 0 selects the default (and only) protocol rather than indexing a list. Clarify the socket/acceptor type aliases across all four tags.

Documentation only; no API or behavior change.

The family()/type()/protocol() members on the protocol tags returned
bare platform constants documented as "the protocol (0)", which read
as one entry in an unlisted corosio enumeration (cppalliance#255).

Explain at the class level that these three members produce the
(family, type, protocol) triple passed to the OS socket() call and
that the values are platform-defined constants, and expand
local_stream/local_datagram protocol() to state that 0 selects the
default (and only) protocol rather than indexing a list. Clarify the
socket/acceptor type aliases across all four tags.

Documentation only; no API or behavior change.
@cppalliance-bot

Copy link
Copy Markdown

An automated preview of the documentation is available at https://273.corosio.prtest3.cppalliance.org/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-06-11 16:17:11 UTC

@codecov

codecov Bot commented Jun 11, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.73%. Comparing base (4bd1735) to head (3edff38).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff            @@
##           develop     #273   +/-   ##
========================================
  Coverage    77.73%   77.73%           
========================================
  Files           96       96           
  Lines         7234     7234           
  Branches      1764     1764           
========================================
  Hits          5623     5623           
  Misses        1102     1102           
  Partials       509      509           
Files with missing lines Coverage Δ
include/boost/corosio/tcp.hpp 100.00% <ø> (ø)

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4bd1735...3edff38. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@cppalliance-bot

Copy link
Copy Markdown

GCOVR code coverage report https://273.corosio.prtest3.cppalliance.org/gcovr/index.html
LCOV code coverage report https://273.corosio.prtest3.cppalliance.org/genhtml/index.html
Coverage Diff Report https://273.corosio.prtest3.cppalliance.org/diff-report/index.html

Build time: 2026-06-11 16:37:49 UTC

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants