Path: csiph.com!xmission!news.snarked.org!news.linkpendium.com!news.linkpendium.com!panix!usenet.stanford.edu!not-for-mail
From: Dave <INVALID.NOREPLY@gnu.org>
Newsgroups: gnu.groff.bug
Subject: [bug #58746] [PATCH] doc/groff.texi: Mention that .ds with only one argument defines an empty string
Date: Sat, 11 Jul 2020 06:26:11 -0400 (EDT)
Lines: 61
Approved: bug-groff@gnu.org
Message-ID: <mailman.86.1594463173.2306.bug-groff@gnu.org>
References: <20200711-052608.sv93119.49054@savannah.gnu.org>
NNTP-Posting-Host: lists.gnu.org
Mime-Version: 1.0
Content-Type: text/plain;charset=UTF-8
X-Trace: usenet.stanford.edu 1594463173 21287 209.51.188.17 (11 Jul 2020 10:26:13 GMT)
X-Complaints-To: action@cs.stanford.edu
To: Dave <saint.snit@gmail.com>, bug-groff@gnu.org
Envelope-to: bug-groff@gnu.org
X-PHP-Originating-Script: 1001:sendmail.php
X-Savane-Server: savannah.gnu.org:443 [2001:470:142::72]
X-Savane-Project: groff
X-Savane-Tracker: bugs
X-Savane-Item-ID: 58746
User-Agent: Mozilla/5.0 (X11; Linux i686; rv:45.0) Gecko/20100101 Firefox/45.0
X-Apparently-From: 2605:a601:ab42:5b00:d79a:70a3:b6a4:34bf (Savane authenticated user barx)
In-Reply-To: 
X-BeenThere: bug-groff@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "Bug reports for the GNU version of nroff, troff et al" <bug-groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-groff>, <mailto:bug-groff-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-groff>
List-Post: <mailto:bug-groff@gnu.org>
List-Help: <mailto:bug-groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-groff>, <mailto:bug-groff-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID: <20200711-052608.sv93119.49054@savannah.gnu.org>
Xref: csiph.com gnu.groff.bug:1895

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

                 Summary: [PATCH] doc/groff.texi: Mention that .ds with only
one argument defines an empty string
                 Project: GNU troff
            Submitted by: barx
            Submitted on: Sat 11 Jul 2020 05:26:08 AM CDT
                Category: Core
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

This is easy to figure out, but the manual may as well spell it out.

As a real-world use case, I recently had need to build up a roff string inside
a loop, each iteration appending to the string, a la:

.while CONDITION .ds mystring \\*[mystring] and then some

To avoid a warning, I had to initialize "mystring" before the loop.  I first
looked in the manual to find out how to define an empty string; finding no
answer there, I tried the obvious thing, and it worked.

"The obvious thing" having such a spotty track record in *roff syntax in
general, it's probably worth documenting that this one actually does do what
you would hope.  Suggested patch attached.



    _______________________________________________________

File Attachments:


-------------------------------------------------------
Date: Sat 11 Jul 2020 05:26:08 AM CDT  Name: empty_string.patch  Size: 1KiB  
By: barx
doc/groff.texi: add one sentence, improve nearby punctuation
<http://savannah.gnu.org/bugs/download.php?file_id=49462>

    _______________________________________________________

Reply to this item at:

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

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