View Issue Details

IDProjectCategoryView StatusLast Update
0001800Issue 8 draftsBase Definitions and Headerspublic2024-06-11 09:12
Reportersteffen Assigned To 
PrioritynormalSeverityEditorialTypeError
Status ClosedResolutionAccepted As Marked 
Product VersionDraft 4 
Namesteffen
Organization
User Reference
Sectionsystem interfaces
Page Number
Line Number
Final Accepted Text0001800:0006644
Summary0001800: be*toh() have no entries
DescriptionWhereas there is

  le16toh, le32toh, le64toh — convert values between host and specified byte order

on page 1327, no such section exists for the big indian series.

P.S.:
This is a main master miss, as not all indians are litte, white black gender politically very delicate, and the traffic light has all the rights of the world to turn yellow red. Imho.
Desired ActionPlease add an entry

NAME
be16toh, be32toh, be64toh — convert values between host and specified byte order
SYNOPSIS
        #include <endian.h>
        uint16_t be16toh(uint16_t big_endian_16bits);
        uint32_t be32toh(uint32_t big_endian_32bits);
option uint64_t be64toh(uint64_t big_endian_64bits);
DESCRIPTION
Refer to le16toh( ).
Tagsapplied_after_i8d4, issue8

Activities

geoffclare

2024-01-25 10:06

manager   bugnote:0006639

The requested change makes no sense. The be16toh() page is where all of these functions are described. There are "pointer" pages for htobe16() and le16toh() to allow finding those descriptions when looking alphabetically for the htobe*() and le*toh() functions.

Pointer pages to pointer pages are never used.

This request should either be withdrawn (if the submitter agrees to it) or be rejected.

steffen

2024-01-25 21:29

reporter   bugnote:0006640

No it should not.
There is the very same thing for the le*toh() series, please see draft 4, page 1327. I am only asking for the very same thing for the be*toh() series.

steffen

2024-01-25 21:34

reporter   bugnote:0006641

Hm. But i agree that the le*toh() series actually links to the non-existent be*toh() series. Maybe they should all point to ... hmmm...

You are right. The entry on page 660 actually *is* the description for the be*toh() series, even though it starts with htobe16() and appears like an endian.h overview as such, but that in turn is on page 240.

So that is a false issue that i withdraw. (I would resort the functions alphabetically at least, with an empty line in between the series even.)

geoffclare

2024-01-26 09:54

manager   bugnote:0006644

Last edited: 2024-01-26 09:55

Suggested changes...

On page 660 line 23128-23139 section be16toh() SYNOPSIS, re-sort the lines into alphabetic order (to match the NAME section), grouped as follows:

be*toh()
blank line
htobe*()
blank line
htole*()
blank line
le*toh()

Cross-volume changes to XBD...

On page 240 line 8454-8465 section <endian.h>, re-sort the lines containing function prototypes into the same order and grouping as above.

Since these are purely editorial changes they can probably be made in Issue 8 despite not meeting the narrowing-down rules for draft 4 review. (The alternative is to wait for TC1.)

Issue History

Date Modified Username Field Change
2024-01-23 22:36 steffen New Issue
2024-01-23 22:36 steffen Name => steffen
2024-01-23 22:36 steffen Section => system interfaces
2024-01-25 10:06 geoffclare Note Added: 0006639
2024-01-25 21:29 steffen Note Added: 0006640
2024-01-25 21:34 steffen Note Added: 0006641
2024-01-26 09:54 geoffclare Note Added: 0006644
2024-01-26 09:55 geoffclare Note Edited: 0006644
2024-01-26 09:56 geoffclare Product Version => Draft 4
2024-02-01 16:19 geoffclare Final Accepted Text => 0001800:0006644
2024-02-01 16:19 geoffclare Status New => Resolved
2024-02-01 16:19 geoffclare Resolution Open => Accepted As Marked
2024-02-01 16:20 geoffclare Tag Attached: issue8
2024-02-05 10:52 geoffclare Status Resolved => Applied
2024-02-05 10:52 geoffclare Tag Attached: applied_after_i8d4
2024-06-11 09:12 agadmin Status Applied => Closed