Rework sysfn list #656
Rework sysfn list #656
Conversation
abrudz
commented
Nov 26, 2025
abrudz
commented
- Pushed categories down a level so the orthogonal "System Variables" gets more prominent
- Added Syntax column
- Split some categories
- Moved some entries to more appropriate categories
- Created list of archaic/deprecated features
language-reference-guide/docs/system-functions/system-functions-by-category.md
Outdated
Show resolved
Hide resolved
language-reference-guide/docs/system-functions/system-functions-by-category.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
I'm not convinced that "Syntax" is the correct label for the third column in these tables. Let's discuss.
language-reference-guide/docs/system-functions/system-functions-by-category.md
Outdated
Show resolved
Hide resolved
language-reference-guide/docs/system-functions/system-functions-by-category.md
Outdated
Show resolved
Hide resolved
| ### System Constants | ||
|
|
||
| ## System Constants | ||
| These constants are convenient names for commonly used values that would otherwise be tedious or errorprone to type out or produce. |
There was a problem hiding this comment.
| These constants are convenient names for commonly used values that would otherwise be tedious or errorprone to type out or produce. | |
| These constants simplify calling commonly-used values. |
There was a problem hiding this comment.
Calling isn't the right word here. You can't call a value. Maybe "access to"?
language-reference-guide/docs/system-functions/system-functions-by-category.md
Show resolved
Hide resolved
language-reference-guide/docs/system-functions/system-functions-by-category.md
Outdated
Show resolved
Hide resolved
|
|
||
| These are outdated facilites that have newer and better alternatives. | ||
|
|
||
| |Name |Description |Syntax|Alternative| |
There was a problem hiding this comment.
Four of the entries do not have alternative suggestions – for completeness and to justify their place in this table, can something be added for them please.
There was a problem hiding this comment.
Added for ⎕XT but ⎕EXPORT and ⎕PATH have no current alternative. We're working on the design of a module system that will eventually provide an alternative.
There was a problem hiding this comment.
If there is no current alternative then it's hard to justify having them in this list!
There was a problem hiding this comment.
No,this is the list for archaic features, and the documentation for ⎕PATH and ⎕EXPORT have since 18.0 (i.e. beyond all supported versions) said "⎕PATH/⎕EXPORT may therefore be considered an archaic feature."
…s-by-category.md Co-authored-by: FionaDyalog <[email protected]>
…s-by-category.md Co-authored-by: FionaDyalog <[email protected]>
…s-by-category.md Co-authored-by: FionaDyalog <[email protected]>
…s-by-category.md Co-authored-by: FionaDyalog <[email protected]>
…m-functions' of https://github.com/Dyalog/documentation into 594-langref-rework-the-page-for-categorisation-of-system-functions
