Austin Group Defect Tracker

Aardvark Mark IV


Viewing Issue Simple Details Jump to Notes ] Issue History ] Print ]
ID Category Severity Type Date Submitted Last Update
0001800 [Issue 8 drafts] Base Definitions and Headers Editorial Error 2024-01-23 22:36 2024-02-05 10:52
Reporter steffen View Status public  
Assigned To
Priority normal Resolution Accepted As Marked  
Status Applied   Product Version Draft 4
Name steffen
Organization
User Reference
Section system interfaces
Page Number
Line Number
Final Accepted Text Note: 0006644
Summary 0001800: be*toh() have no entries
Description Whereas 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 Action Please 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( ).
Tags applied_after_i8d4, issue8
Attached Files

- Relationships

-  Notes
(0006639)
geoffclare (manager)
2024-01-25 10:06

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.
(0006640)
steffen (reporter)
2024-01-25 21:29

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.
(0006641)
steffen (reporter)
2024-01-25 21:34

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.)
(0006644)
geoffclare (manager)
2024-01-26 09:54
edited on: 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 version => Draft 4
2024-02-01 16:19 geoffclare Final Accepted Text => Note: 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


Mantis 1.1.6[^]
Copyright © 2000 - 2008 Mantis Group
Powered by Mantis Bugtracker