[groff] 02/20: tmac/s.tmac: Annotate `DS` macro definition.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c2c85fd2364051cca16ef805a39e6de14ca0b9d8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Oct 18 14:28:19 2024 -0500

    tmac/s.tmac: Annotate `DS` macro definition.
---
 tmac/s.tmac | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tmac/s.tmac b/tmac/s.tmac
index adf18e0c7..c6e9b187c 100644
--- a/tmac/s.tmac
+++ b/tmac/s.tmac
@@ -1071,6 +1071,10 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .el .@error-recover mismatched .DE
 ..
 .de DS
+.\" Break to ensure that we spring the top-of-page trap (at the start of
+.\" a document, this also ensures that important registers like `PS` are
+.\" set).  Also, even if the drawing position is elsewhere and invalid
+.\" nesting occurs, the user will still expect a break.
 .br
 .if '\\n(.z'ds*div' .@error-recover cannot begin display within display
 .nr ds*badarg 0