groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 01/02: groff_tmac(5): Remove .tm prefix from example


From: Ingo Schwarze
Subject: [groff] 01/02: groff_tmac(5): Remove .tm prefix from example
Date: Mon, 12 Oct 2020 10:06:57 -0400 (EDT)

schwarze pushed a commit to branch master
in repository groff.

commit d5042f97eb2923bce6e4f9c5d127772d5cbc1c81
Author: ivan tkachenko <me@ratijas.tk>
AuthorDate: Mon Oct 12 15:29:04 2020 +0300

    groff_tmac(5): Remove .tm prefix from example
    
    .tm request sends anything to stderr. I found it confusing to be used
    in these examples because:
     1. it further complicates things by introducing extra entity;
     2. it doesn't even work, since stderr won't be formatted with \f[I].
    
    This solution sacrifices line break before the arguments list. I found
    that single dot (.) line does not work without leading spaces in
    surrounding lines; and introducing .br request would be like swapping
    one extra complexity for another. After all, the implied-but-missing
    line break is not as noticable as the missing \f* formatting.
    
    Via: https://savannah.gnu.org/bugs/index.php?59251
---
 man/groff_tmac.5.man | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 0e9054a..d94380d 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -960,8 +960,8 @@ say.
 .EX
 \&.ds midpart was called with the following
 \&.de print_args
-\&.\ \ tm\ \*[@1]\ \[rs]*[midpart]\ \[rs]\[rs]n[.$]\ \*[@2]
-\&.\ \ tm\ \[rs]\[rs]$*
+\&\*[@1]\ \[rs]*[midpart]\ \[rs]\[rs]n[.$]\ \*[@2]
+\&\[rs]\[rs]$*
 \&..
 .EE
 .rm @1
@@ -1044,8 +1044,8 @@ For example, the code above can be written in a simpler 
way by
 \&.eo
 \&.ds midpart was called with the following
 \&.de print_args
-\&.\ \ tm\ \*[@1]\ \[rs]*[midpart]\ \[rs]n[.$]\ \*[@2]
-\&.\ \ tm\ \[rs]$*
+\&\*[@1]\ \[rs]*[midpart]\ \[rs]n[.$]\ \*[@2]
+\&\[rs]$*
 \&..
 \&.ec
 .EE



reply via email to

[Prev in Thread] Current Thread [Next in Thread]