[groff] 10/12: m4/groff.m4: Recast `SHORT_VERSION` description.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 6d67909c422491fce6c1a0b2421910034e6d8c58
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Nov 19 17:09:22 2024 -0600

    m4/groff.m4: Recast `SHORT_VERSION` description.
    
    Every time I saw it, I misinterpreted it at first.
---
 m4/groff.m4 | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/m4/groff.m4 b/m4/groff.m4
index ee254d981..164c5065a 100644
--- a/m4/groff.m4
+++ b/m4/groff.m4
@@ -18,10 +18,11 @@
 
 # Construct a short form of the groff version string.
 #
-# SHORT_VERSION contains only the number of REVISION before the first
-# '.'; e.g., if REVISION is '3.real.434-5aafd' then SHORT_VERSION is
-# 'x.yy.3', where x and yy are MAJOR_VERSION and MINOR_VERSION,
-# respectively.
+# SHORT_VERSION contains the MAJOR_VERSION, MINOR_VERSION, and a portion
+# of the REVISION, separated by dots.  Only the part of REVISION before
+# the first '.' is used.  For example, if REVISION is
+# '3.real.434-5aafd', then SHORT_VERSION is 'x.yy.3', where x and yy are
+# MAJOR_VERSION and MINOR_VERSION, respectively.
 AC_DEFUN([GROFF_MAKE_SHORT_VERSION], [
   AC_SUBST([SHORT_VERSION],
           m4_bregexp(AC_PACKAGE_VERSION,[^\(\w+\.\w+\.\w+\).*$],[\1]))