Improve presentation of file system mapping#3890
Conversation
|
I believe we need to discuss this more - as the PR made me realize that it is currently a bit of a mess. So, the issue is that a .mo file can be:
To me both of the latter ones are part of "structured entity"; i.e, the entire directory from the top-down would be called a structured entity. (Note that we have package.mo both at the top and further down; with similar rules - although only the top-directory may include version.) |
|
Language group: should ideally to re-work to avoid the terms structured and non-structured entity. |
| \end{nonnormative} | ||
|
|
||
| A directory may also contain one or more sub-entities (directories or files). | ||
| A directory may also contain one or more sub-entities (structured or nonstructured, compare \cref{file-system-mapping-of-package-class}). |
There was a problem hiding this comment.
As noted I would only call single files "nonstructured entity", so not call these files "nonstructured entity".
There was a problem hiding this comment.
I tried to look hard at the current specification and it seems to deliberately avoid using the term "nonstructured entity" for files that are part of directories with package.mo:
Specifically,
- A directory is called "structured entity"
- A single file is a "nonstructured entity"
- The other cases are called "sub-entity of an enclosing structured entity"
HansOlsson
left a comment
There was a problem hiding this comment.
The nonstructured entity is a bit of a mess, and this PR doesn't resolve that.
To me it should be reserved for single-file-mapping, and we don't need to define structured and nonstructured entity.
This is a follow-up to #3885 with general cleanup of the the presentation in File System Mapping of Package/Class.
Improvements include: