[bug #62339] [doc]: Add a remark about a pitfall using \s0

[Bjarni Ingi Gislason]

URL:
  <https://savannah.gnu.org/bugs/?62339>

                 Summary: [doc]: Add a remark about a pitfall using \s0
                 Project: GNU troff
            Submitted by: bjarniig
            Submitted on: Thu 21 Apr 2022 01:02:59 AM UTC
                Category: General
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

Subject: [doc]: Add a remark about a pitfall using \s0

  Using two type size changes around a string can cause malformed
changes if the string (with the size changes) is surrounded by a size
change.

  Example from gcc(1), which uses (pod2man):

.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'

  or simplified

.ds C+ C\s-2+\s0

  and uses

\s-1ISO \*(C+\s0

  So it is actually:

\s-1...\s-2...\s0...\s0

  which results in a sum of \s-1.

  So, when defining a string that contains local type size changes
(\s), absolute size changes should be used (\s+n...\s-n; \s-n...\s+n),
not \s0.

  See also bug #40793.





    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?62339>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/