-
Notifications
You must be signed in to change notification settings - Fork 56
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Correct reference to character limit #1524
base: main
Are you sure you want to change the base?
Conversation
@@ -93,7 +93,7 @@ described by the following :index:`rules <rules; naming>`: | |||
^[a-zA-Z0-9_]([a-zA-Z0-9_.]*[a-zA-Z0-9_])?$ | |||
|
|||
The length should be limited to no more than | |||
63 characters (imposed by the HDF5 :index:`rules <rules; HDF5>` for names). | |||
63 characters (imposed by the HDF4 :index:`rules <rules; HDF>` for names). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I found this
The max size of an SD dataset name in HDF4 (from HDF4 documentation) is 64.
But in in the wild we have encountered longer names. As long as the HDF4 name is not greater than NC_MAX_NAME, our code will be OK.
I could not find it in the HDF4 specs: https://doi.org/10.5281/zenodo.13310722
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, there's no such limit in HDF5.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
HDF4 library truncates to VSNAMELENMAX
(a preprocessor symbol that is 64 by default) for in-memory names. See hlimits.h#L55-L64
Didn't we drop support for HDF4? If so, no need to reference it now.
…On Thu, Dec 19, 2024, 9:38 AM Peter Chang ***@***.***> wrote:
***@***.**** commented on this pull request.
------------------------------
In manual/source/datarules.rst
<#1524 (comment)>
:
> @@ -93,7 +93,7 @@ described by the following :index:`rules <rules; naming>`:
^[a-zA-Z0-9_]([a-zA-Z0-9_.]*[a-zA-Z0-9_])?$
The length should be limited to no more than
- 63 characters (imposed by the HDF5 :index:`rules <rules; HDF5>` for names).
+ 63 characters (imposed by the HDF4 :index:`rules <rules; HDF>` for names).
HDF4 library truncates to VSNAMELENMAX (a preprocessor symbol that is 64
by default) for in-memory names. See hlimits.h#L55-L64
<https://github.com/HDFGroup/hdf4/blob/ae94aece1220dfa2393be65d0f44fd3234307625/hdf/src/hlimits.h#L55-L64>
—
Reply to this email directly, view it on GitHub
<#1524 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AARMUMAUXC7U65DOF4ORJA32GLSALAVCNFSM6AAAAABT4OMT7GVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZDKMJVGI3TMNBVHA>
.
You are receiving this because your review was requested.Message ID:
***@***.***>
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The guidance is only "should". Even if we no longer maintain hdf4 bindings, it has historically been a supported target and it does little harm to acknowledge that.
@@ -93,7 +93,7 @@ described by the following :index:`rules <rules; naming>`: | |||
^[a-zA-Z0-9_]([a-zA-Z0-9_.]*[a-zA-Z0-9_])?$ | |||
|
|||
The length should be limited to no more than | |||
63 characters (imposed by the HDF5 :index:`rules <rules; HDF5>` for names). | |||
63 characters (imposed by the HDF4 :index:`rules <rules; HDF>` for names). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
63 characters (imposed by the HDF4 :index:`rules <rules; HDF>` for names). | |
63 characters (historically imposed by the HDF4 :index:`rules <rules; HDF>` for names). |
No description provided.