<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html lang="en" style="--code-editor-font: var(--default-mono-font, "GitLab Mono"), JetBrains Mono, Menlo, DejaVu Sans Mono, Liberation Mono, Consolas, Ubuntu Mono, Courier New, andale mono, lucida console, monospace;">
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
<title>
GitLab
</title>
<style data-premailer="ignore" type="text/css">
a { color: #1068bf; }
</style>
<style>img {
max-width: 100%; height: auto;
}
body {
font-size: .875rem;
}
body {
-webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px;
}
body {
font-family: "GitLab Sans",-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji"; font-size: inherit;
}
</style>
</head>
<body style="font-size: inherit; -webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px; font-family: "GitLab Sans",-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";">
<div class="content">
<p style="color: #777777;">
<a href="https://gitlab.rtems.org/joel">Joel Sherrill</a>
<a href="https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1081#note_143586">commented</a>:
</p>
<div class="md" style="position: relative; z-index: 1; color: #3a383f; word-wrap: break-word;">
<p dir="auto" style="color: #3a383f; margin: 0 0 1rem;" align="initial">Ignoring that the changes posted are too large as a single change as well as touch readme files that shouldn't be touched, I can only find <a href="https://gitlab.rtems.org/rtems/rtos/rtems/-/issues/4852" title="Deprecated Functions" class="gfm gfm-issue" data-original="https://gitlab.rtems.org/rtems/rtos/rtems/-/issues/4852" data-link="false" data-link-reference="true" data-issue="27441" data-project="26" data-iid="4852" data-namespace-path="rtems/rtos/rtems" data-project-path="rtems/rtos/rtems" data-issue-type="issue" data-container="body" data-placement="top" data-reference-type="issue" style="margin-top: 0;">#4852</a> that mentions deprecating this function. The RTEMS Project has a deprecation <a href="https://docs.rtems.org/docs/6.1/eng/coding-deprecating.html" rel="nofollow noreferrer noopener" target="_blank">process</a> that includes:</p>
<ul dir="auto" style="text-align: initial; list-style-type: disc; margin: 0 0 1rem; padding: 0;">
<li style="margin-top: 0; line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Announce deprecation in one major release (e.g 7.1)</li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Remove before the next major release (e.g. 8.1)</li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Both announcement and removal require issues targeting the appropriate release</li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Must be mentioned in the release notes (e.g. 7.1 and 8.1)</li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Documentation must be updated. This would be the Classic API Users Guide. There is a pattern for how deprecated methods are documented. See <a href="https://docs.rtems.org/docs/6.2/c-user/task/deprecated-directives.html" rel="nofollow noreferrer noopener" target="_blank" style="margin-top: 0;">https://docs.rtems.org/docs/6.2/c-user/task/deprecated-directives.html</a>
</li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;">Marking to deprecated to show up in Doxygen (see <a href="https://docs.rtems.org/doxygen/branches/4.11/deprecated.html" rel="nofollow noreferrer noopener" target="_blank" style="margin-top: 0;">https://docs.rtems.org/doxygen/branches/4.11/deprecated.html</a>)</li>
</ul>
<p dir="auto" style="color: #3a383f; margin: 0 0 1rem;" align="initial">This MR is jumping all the way to the end without following the process. At this point, you could just mark it deprecated and eliminate all uses. But the release notes, documentation, examples, and other repositories would need to be changed.</p>
<p dir="auto" style="color: #3a383f; margin: 0;" align="initial">As far as I can tell, you can only announce the deprecation now, document the deprecation, eliminate its use in RTEMS owned code, etc.. But you <strong style="font-weight: 600; margin-top: 0;">CANNOT</strong> remove the method yet because deprecation was never announced publicly. A comment in a corner of an odd file is not actionable for direct removal.</p>
</div>
</div>
<div class="footer" style="margin-top: 10px;">
<p style="font-size: small; color: #626168;">
—
<br>
<a href="https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1081#note_143586">View it on GitLab</a>.
<br>
You're receiving this email because of your account on <a target="_blank" rel="noopener noreferrer" href="https://gitlab.rtems.org">gitlab.rtems.org</a>. <a href="https://gitlab.rtems.org/-/sent_notifications/2-73nnog1skwvcv5g8ew5kovdwm/unsubscribe" target="_blank" rel="noopener noreferrer">Unsubscribe</a> from this thread · <a href="https://gitlab.rtems.org/-/profile/notifications" target="_blank" rel="noopener noreferrer" class="mng-notif-link">Manage all notifications</a> · <a href="https://gitlab.rtems.org/help" target="_blank" rel="noopener noreferrer" class="help-link">Help</a>
<span style="color: transparent; font-size: 0; display: none; overflow: hidden; opacity: 0; width: 0; height: 0; max-width: 0; max-height: 0;">
Notification message regarding https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1081#note_143586 at 1772134693
</span>
<script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","action":{"@type":"ViewAction","name":"View Merge request","url":"https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1081#note_143586"}}</script>
</p>
</div>
</body>
</html>