From MAILER-DAEMON Mon May 01 11:46:38 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5DX4-0001NN-RM
	for mharc-groff@gnu.org; Mon, 01 May 2017 11:46:38 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39599)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5DX2-0001N1-Jz
	for groff@gnu.org; Mon, 01 May 2017 11:46:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5DX1-0004JW-NR
	for groff@gnu.org; Mon, 01 May 2017 11:46:36 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:44704)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5DX1-0004JL-HC
	for groff@gnu.org; Mon, 01 May 2017 11:46:35 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5DWx-0002Xs-8M; Mon, 01 May 2017 17:46:32 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5DWw-0002qe-HL; Mon, 01 May 2017 17:46:30 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5DWw-000116-Ct; Mon, 01 May 2017 17:46:30 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 28b31fb9;
	Mon, 1 May 2017 17:46:30 +0200 (CEST)
Date: Mon, 1 May 2017 17:46:30 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170501154630.GA28290@athene.usta.de>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 15:46:37 -0000

Hi Branden,

G. Branden Robinson wrote on Sun, Apr 30, 2017 at 07:51:26PM -0400:

> some of these categories are going to be hard to recognize without
> a standalone *roff parser, which I don't think exists.

I'm working on that in mandoc, albeit rather slowly.

Mandoc is a four-phase program.  The order of the phases is always
the same, but command line options may cause individual phases to be
skipped:

  phase 1: file selection (e.g. database or file system search)
           [skipped in "man -l"]
  loop over selected files
    phase 2: parser (for roff, mdoc, man, tbl, eqn)
             [skipped in "man -k" unless "-a" is given]
    phase 3: formatter (ascii, utf8, html, ps, pdf, man, markdown)
             [skipped in "man -Tlint"]
  phase 4: pager (usually more(1) or less(1))
           [skipped in "man -c"]

The output of phase 2 that is passed as input to phase 3 is an
abstract syntax tree, either an mdoc(7) AST or a man(7) AST.

Phase 2 currently consists of three sub-phases:

  phase 2.1: roff(7) prepocessor
             input: roff(7) text file
             output: mdoc(7) or man(7) text file
               no longer containing any low-level roff(7) elements;
               for example, all register, string, and macro
               definitions and interpolations are evaluated
               and expanded, etc.
  phase 2.2: mdoc(7) or man(7) parser
             generating the raw AST
  phase 2.3: mdoc(7) or man(7) normalizing validator
             modifying the AST

During the last about two years, i already unified all the data
structures and node handling utility functions and i'm now near the
point where the roff(7) preprocessor can slowly begin to evolve
into a real pre-parser: that is, where it can begin to add low-level
roff(7) nodes to the AST parse tree in addition to preprocessing
the input.

Even in an intermediate state where only some roff constructs will
be parsed into the AST, that concept may start to become useful for
syntactic and semantic analysis of mixed roff(7)/mdoc(7) and mixed
roff(7)/man(7) sources.

Roff nodes in the AST are not available yet, though.  So far, i
only established the technological foundation to build them on, as
described above.

Yours,
  Ingo


From MAILER-DAEMON Mon May 01 12:11:52 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5DvU-00087d-Ks
	for mharc-groff@gnu.org; Mon, 01 May 2017 12:11:52 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:46543)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5DvT-00087W-6X
	for groff@gnu.org; Mon, 01 May 2017 12:11:52 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5DvO-0002uG-9A
	for groff@gnu.org; Mon, 01 May 2017 12:11:51 -0400
Received: from mail-yw0-x22f.google.com ([2607:f8b0:4002:c05::22f]:32842)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5DvO-0002tP-4t
	for groff@gnu.org; Mon, 01 May 2017 12:11:46 -0400
Received: by mail-yw0-x22f.google.com with SMTP id 203so57008972ywe.0
	for <groff@gnu.org>; Mon, 01 May 2017 09:11:46 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:mime-version:content-disposition
	:user-agent; bh=t47GrutkhquzB2awK23EFOfdHL7TqIYo0dO1ARpeQCg=;
	b=PLr50lgHtK/pMPUr1ZtN1131z4O4eXkuJ7V80amg3j41p5iZsKDZP38L1DjXWwgQrX
	N4R48HJtm38v+MvDOFEvfQZyX6AtH6na8qEqVK8ef93Y7RcnSU+FPMFV1RhsuHg2KBRk
	VJYYtPVyeUoZU3O1OTooxDbzhRXnPenEYrgRy9Z/+ZJ2v4V5vO9UnS5sX38Mz+eN+IUn
	E9e+VW3rqNuVzBTCCLHVFh0elkzp18JEzCKBvO/8QGoOK6v3FVJov/qoCsH9pcZyMOEa
	FnpU7hXlh+mf2uU0h6BHMmYe1+/wrx9cnF3IJaicFYrzO/0JJlZ29pC6quRcwfRTYbFs
	QMpg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:mime-version
	:content-disposition:user-agent;
	bh=t47GrutkhquzB2awK23EFOfdHL7TqIYo0dO1ARpeQCg=;
	b=o/BcV5C9yDiDEc4t+tcDSBG0pWKbokBHUVKl6W22zBQnGFIr/w4Dy+3jW1KQhfVZRL
	aHoLpz5bsXpPKqnCIc7ohegeJpqH2TeaF7Phb48dowxQAZj6fS/agJiPr6aXvU3dmPre
	cYv/KhvZGhtcUuVLvf5Q5mX8ifZngCQVcaCdYRcsV3YkwaHZ4oIGPTrkIAnrMpI9KAlY
	+fflqB41TCXfL9Ycb+it5J1kwVznW0N7aVqqsJUnVwO51hqqFj7SQd1GqtQO3GYMPcte
	f2zw7HaK4TziajfEGB91gFpr5K5j2Is8YqIRiHsEYplhtAr18lImY6Q1X/eFVB9/zlq9
	zNwA==
X-Gm-Message-State: AN3rC/5JZaR1an0ZcrMJvvt1GaJz46w0GsluxMV5ZulLq16V7lqXR6pY
	33UjNZKaQCgf2pp/VgU=
X-Received: by 10.13.225.87 with SMTP id k84mr21846871ywe.83.1493655105114;
	Mon, 01 May 2017 09:11:45 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	c128sm6858680ywh.2.2017.05.01.09.11.43 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 01 May 2017 09:11:43 -0700 (PDT)
Date: Mon, 1 May 2017 12:11:41 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170501161139.apjddsbej3lbtrfy@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="eldpzkn3hdyd6yjr"
Content-Disposition: inline
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::22f
Subject: [Groff] [PATCH] bring grog(1) a bit more up-to-date
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 16:11:52 -0000


--eldpzkn3hdyd6yjr
Content-Type: multipart/mixed; boundary="rxhsi4naxhckpuje"
Content-Disposition: inline


--rxhsi4naxhckpuje
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hi folks,

Please review the attached patch.

It does basically three things:

1. Fixes a sentence fragment when describing the groff options that grog
   deduces;
2. Undocuments groff's -J flag, which is not documented in groff's own
   man page and cannot be expected to work because gideal does not exist
   yet.
3. Removes a discussion of the shell version of grog(1), which is not in
   the source tree and seems to have been dead for a while.

	commit a91eccd2a62b6f7f3de4cd35b308849a92cab4aa
	Author: Bernd Warken <groff-bernd.warken-72@web.de>
	Date:   Fri Apr 12 14:19:02 2013 +0000

	    grog: remove shell version. Add file perl_test.pl for testing the
	    available Perl version.

Regards,
Branden

--rxhsi4naxhckpuje
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="grog.man.diff"

diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index e920f958..48461a45 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -211,11 +211,13 @@ options are required for running the input under
 .BR \-g ,
 .BR \-G ,
 .BR \-j ,
-.BR \-J ,
+.\" gideal is not implemented yet.
+.\" .BR \-J ,
 .BR \-p ,
 .BR \-R ,
 .BR \-s ,
-.BR \-t .
+.B \-t
+(preprocessors); and
 .BR \-man ,
 .BR \-mdoc,
 .BR \-mdoc-old,
@@ -223,7 +225,8 @@ options are required for running the input under
 .BR \-mm ,
 .BR \-mom ,
 and
-.BR \-ms .
+.B \-ms
+(macro packages).
 .
 .
 .P
@@ -309,39 +312,6 @@ program heavily depends on a working
 .BR grog .
 .
 .
-.P
-The
-.B grog
-source contains two files written in different programming languages:
-.
-.ft CB
-grog.pl
-.ft R
-is the
-.I Perl
-version, while
-.ft CB
-grog.sh
-.ft R
-is a shell script using
-.BR awk (1).
-During the run of
-.BR make (1),
-it is determined whether the system contains a suitable version of
-.BR perl (1).
-If so,
-.ft CB
-grog.pl
-.ft R
-is transformed into
-.BR grog ;
-otherwise
-.ft CB
-grog.sh
-.ft R
-is used instead.
-.
-.
 .\" --------------------------------------------------------------------
 .SH EXAMPLES
 .\" --------------------------------------------------------------------

--rxhsi4naxhckpuje--

--eldpzkn3hdyd6yjr
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkHXjMACgkQ0Z6cfXEm
bc5wPw/+JwlOmFvBEoXFdOmJCyYEekxZ+jDxrgDHtXYalFsTogP7oEQ2b5Drt0b4
o/YTpoA3qSuZhW4d00AeMn4Gcm+Tn6sLrk4dIISPL21L3nj3U97gjlid3BPMibWB
ouuH/uTDhQOl2fuKf9gORc3DJXUuPyPuT+Eqa4TzwBA6S7ywDlERMw7NZhJjavQV
mPiqzwBqNeyOcf/+QnEXUzBwKaD8jAvndmBWxk2DdkArSRwL+DVthOPjRCnE62A/
/6JKHRPcm/mFnx/sBB/2mWbWmQOFR9kkiTvNeC/eANNf2C0biXGYiV+WGEBuoNMj
+/5JHoJhqvx4fV1RMiGYdalHksgpIUAabpr0E2qZj6dEyLWeNtV3+5V3ft8Qhe+j
TJwy6pCOF4r+HWU53eoyTYT8iafDh9RBulRsy8E8aWPr5+lQNDWJzj7zuqOGzUn6
Y4n78x15jpP0xQN3G8k0HQMsWJ3dgAMpSzZcLrrS2QwV26C5gXKdKuvH5EpY6Sng
6ZCDJGb7A9NUWVp/sBg8w4qb2r/RWWNurQt81i6ZpuDe3bUiSW98Dj+aDbSNWU+O
WzNLGby2uBuoVCVbF5Xf66oVa3GyK9Wqvlmbv2gJrTun2UZlAOzoKCei8iJIIw5X
lmMmkrc6oclfiOYkWYQVqcHHWp1cGX491mvhVXVG/uhFcj2IJ7E=
=KAWy
-----END PGP SIGNATURE-----

--eldpzkn3hdyd6yjr--


From MAILER-DAEMON Mon May 01 12:16:13 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5Dzh-0000Cx-Ii
	for mharc-groff@gnu.org; Mon, 01 May 2017 12:16:13 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47311)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5Dzf-0000Cc-5T
	for groff@gnu.org; Mon, 01 May 2017 12:16:12 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5Dza-0003zB-40
	for groff@gnu.org; Mon, 01 May 2017 12:16:11 -0400
Received: from mail-qk0-x241.google.com ([2607:f8b0:400d:c09::241]:33699)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5DzZ-0003yl-Vw
	for groff@gnu.org; Mon, 01 May 2017 12:16:06 -0400
Received: by mail-qk0-x241.google.com with SMTP id o85so17818198qkh.0
	for <groff@gnu.org>; Mon, 01 May 2017 09:16:05 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=G4JNI6IGIbSCg1Rqg/LQ1Rtlu2+jAozsAtPxFW91OsM=;
	b=i2ZY3f2+YhEBjJB8O66AYFSFqk8Vf3j4EB9mGgjfCYGdUvb9MmmYR9taQrGp6b94yy
	6M/VAy6KVaKbuxIAcRaDZ6ola5l3vDE7eTQKUi0lC6xsU2iLVnt97Nz/GR7owBd25ckh
	Czndu/8Hg/bax6KkN0rgREL3QCx9Vwd8mTxdA34vsbkLouEpsuvrGCpn+FC4WudlULmg
	X6DD3EwVrS8Ho/kh+NA1qhg+98MMmWPbcfRVLzoLaV+wdZvPIGV615VN4bgZpCRqkCpY
	O499CH3pnMGuuwIxO2LAQpLPz5TCCzVnyE/y+cEFdTPLm3OZWUYqd2PgE5YlE+0RkDqw
	UbQw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=G4JNI6IGIbSCg1Rqg/LQ1Rtlu2+jAozsAtPxFW91OsM=;
	b=oAOB8P55n9eF62/0mbFJb5z4YARBSDpKZSiPtx1Egzl2win0lBUg0KqqogZH6ow8zo
	l4/e4D8sA4C/e4Fa0iC2vw74CSe3pw9n6aXWeDJDDIqE5sCmzQ2TsIsB2wsTCWy80Vrw
	6c0t99Ug4a1Dzghk5DVbA4fx42+tik5nrhP1wB7U4HCz3LtSEI24XW5ppgW2VKxgcoX+
	d4wGzRAwBCIAt1zFVUlXfzOVS2Vr/T3Vv0qbEN4w+tLouJz61l1JeXUqQhw5FKzHNXRC
	MtkHUczisNy3xKMQWaJDICFSUmUTOUPkZEEiYzAFpMGBr9SHbwjUbuBkTq8HuBZ4sj75
	bEog==
X-Gm-Message-State: AN3rC/4Ockx9dt7C2uXxVZfF777XcnkHByfWdRF6KYmkovpP3Luw0azb
	tVSo5CFmgK5AcRlr8q0=
X-Received: by 10.55.90.2 with SMTP id o2mr23400771qkb.251.1493655365190;
	Mon, 01 May 2017 09:16:05 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	s23sm11096561qki.14.2017.05.01.09.16.02 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 01 May 2017 09:16:02 -0700 (PDT)
Date: Mon, 1 May 2017 12:15:55 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="2wb35iodgisnmj5i"
Content-Disposition: inline
In-Reply-To: <20170501154630.GA28290@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::241
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 16:16:12 -0000


--2wb35iodgisnmj5i
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-01T17:46:30+0200, Ingo Schwarze wrote:
> G. Branden Robinson wrote on Sun, Apr 30, 2017 at 07:51:26PM -0400:
>=20
> > some of these categories are going to be hard to recognize without
> > a standalone *roff parser, which I don't think exists.
>=20
> I'm working on that in mandoc, albeit rather slowly.

Nice!  I wish groff could emit its AST itself, though.

You mentioned deroff(1); GNU roff does not provide its own
implementation of it, and Debian doesn't offer one.

Web searches aren't much help, mostly turning up man pages for deroff
but not an actual source tree, or stuff about some European footballer.

Oh, and pointers to a site that times out:

http://www.moria.de/~michael/deroff

Regards,
Branden

--2wb35iodgisnmj5i
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkHXzkACgkQ0Z6cfXEm
bc7uvg/+P+YvKZmNfOqfAj4jNgnjpzLhjGtVzbDLkIyztlV+xPFiG1Lx5+XlCUGV
II/etb53GGESd8LpL5Opm7dPq+oJ8DKHWvKXX5Lq47laHq3lkcD2+NpCrjBuNZk7
eIjAQgJGJrL/dsx8cgLf55J8cQUPj61cY3W92+rEGh0BwR4VnjVBv0W5lueJhy2a
3okl+1SWtMRxfn5G8cNfZuj0wV2xCjuSkFcbWwrbC+gYt7yf99Rg2sNwopO2EkuV
KQ6cR+7iI5hrh8LPj9RIkC7GL6LGlnGjH938qy2qKYGUcgBxIwXLSpmHtRo47k9d
GQbMA1bNVKslJ5gVgywYqIjk7ZWovnCqHjs+oENCmmG2fkHdqMEefsuwp9ececSR
inYxEMBTCaF+q0LKx2Entxb854T/pKZ5ikNs3EkTwT+VFupwKZuFBrFXJgVxu2ZR
lUh/O7ESrQ3JOEDAqHBTOuBeJLe4or8wCiSnEQoNctJTr8e0Hajt+ySjyvVtigkv
C01b2awyoy3Kvt/eiTlZ7lyeZyn7svmuRlQjUzB3L3wa6fFcLgG8GJDqs9zbiHmF
x3ZNvHfTqmBsP2pxMYMXsw69rTKlqo+56CLl+xlMA0HFzl3pXrtl9xmyBmiANuEE
2Y47wnxnn19Wah0N0gZRdnKZVl6IBbYPNrrbeEVrAv16+suLkfM=
=u1Z2
-----END PGP SIGNATURE-----

--2wb35iodgisnmj5i--


From MAILER-DAEMON Mon May 01 12:23:19 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5E6Z-0001cJ-Eh
	for mharc-groff@gnu.org; Mon, 01 May 2017 12:23:19 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:49165)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d5E6W-0001bj-R0
	for groff@gnu.org; Mon, 01 May 2017 12:23:17 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d5E6V-00060y-Gf
	for groff@gnu.org; Mon, 01 May 2017 12:23:16 -0400
Received: from mail-yw0-x242.google.com ([2607:f8b0:4002:c05::242]:36626)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d5E6V-00060I-Aq
	for groff@gnu.org; Mon, 01 May 2017 12:23:15 -0400
Received: by mail-yw0-x242.google.com with SMTP id j9so9786227ywj.3
	for <groff@gnu.org>; Mon, 01 May 2017 09:23:15 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc; bh=0fjZN4gIHr9N89RINGE1xIT6wSH1KCs6e6dj71vVizY=;
	b=U1OrxsyN2EwmSXDKflpU14QOFatDTYc7WyQYmoKxFD26qfxKlZ4P6Hd3S9YP8xesrw
	yvrY+TItpGMJLzzKTOVTxrzf4P5Qqqji7BVlCxeGRJHiJsx+hUgqozH09Vhp+bChIYBf
	4qR4k95ciG8iqB98mAhYexqisqtWlNy7f6TS23khekYhF9uJMyqWAN8cPr5tLn2YHLZ6
	akZlpMNXIwkwRXYg05qBo0mgufj8pocU8vBXgit9HYcCMyQHE9CbEDO1VT9IkRq+ousC
	FOpPA73RY6akAPUvIdCd4hvUPcWIjK8SV469xmC/SapfTALMnyjWzi7vxiKEv1EHtcic
	oKEA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to:cc;
	bh=0fjZN4gIHr9N89RINGE1xIT6wSH1KCs6e6dj71vVizY=;
	b=mXjiE8NQ6hng4+JcK+DmL1hNNAL7WNV35aQgXzHK3e5A/oLcYjeuPE7DWHer1wiWnL
	bPDPru4++Cb3zVojk0HpnNg5yKYpzBss/e972cQ6c0WeaR86b5g9uWNmTLAIFUmx8RsS
	zEYsOpgmqKyrkMqU0C6fA60AwwsAxvjLYhrq9Uxes4PVax9YzVEieftOaukLQXjQsAvS
	LKk715CbtK8Qpn8gj5VEMDJ9PIEEaXPAiOtrNkiqM/vOzvlVzj20PyfvujEnMwAULc1R
	1iXOKvFyPJ/Z7CVX/GcMhbgkteploefBfMUN0QxmRKd4DBDwduvRfykYkLhs1lhLcvZo
	9uVg==
X-Gm-Message-State: AN3rC/4edn9qdeDTt0xQRNYdQs7TIT7ssRCxMxMx2gBndRW2osLFc6ef
	CX4VZNklREOar45nN2qEgzWsg8dyJg==
X-Received: by 10.13.236.199 with SMTP id v190mr20597491ywe.65.1493655794615; 
	Mon, 01 May 2017 09:23:14 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Mon, 1 May 2017 09:22:59 -0700 (PDT)
In-Reply-To: <20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
	<20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
From: John Gardner <gardnerjohng@gmail.com>
Date: Tue, 2 May 2017 02:22:59 +1000
Message-ID: <CAGcdajfHm4q=RyXH8h0NKOOO1H+ff5saO2WMOTbqjyVMVpEpvg@mail.gmail.com>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::242
Content-Type: text/plain; charset=UTF-8
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 16:23:18 -0000

>
> Oh, and pointers to a site that times out:


Strange, the site loaded perfectly fine for me.

There's not much on the page, though:

*Deroff 2.0*



Deroff removes roff constructs from documents for the purpose of indexing,
> spell checking etc. My own implementation is a little smarter than
> traditional implementations, because it knows about certain -man and -mm
> macros. It is able to generate a word list for spell checking tools or omit
> headers for sentence analysis tools.



The source is available as a GNU zipped tape archive
> <http://www.moria.de/~michael/deroff/deroff-2.0.tar.gz>. A win32 port is
> available from gnuwin32.sourceforge.net.


The gzip link works too. If you're having troubles accessing it, I can
email it to you if you're interested.

On 2 May 2017 at 02:15, G. Branden Robinson <g.branden.robinson@gmail.com>
wrote:

> At 2017-05-01T17:46:30+0200, Ingo Schwarze wrote:
> > G. Branden Robinson wrote on Sun, Apr 30, 2017 at 07:51:26PM -0400:
> >
> > > some of these categories are going to be hard to recognize without
> > > a standalone *roff parser, which I don't think exists.
> >
> > I'm working on that in mandoc, albeit rather slowly.
>
> Nice!  I wish groff could emit its AST itself, though.
>
> You mentioned deroff(1); GNU roff does not provide its own
> implementation of it, and Debian doesn't offer one.
>
> Web searches aren't much help, mostly turning up man pages for deroff
> but not an actual source tree, or stuff about some European footballer.
>
> Oh, and pointers to a site that times out:
>
> http://www.moria.de/~michael/deroff
>
> Regards,
> Branden
>

From MAILER-DAEMON Mon May 01 13:06:22 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5EmE-0007Pc-2E
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:06:22 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:60990)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5EmB-0007PU-7N
	for groff@gnu.org; Mon, 01 May 2017 13:06:20 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5Em9-0002X2-Uv
	for groff@gnu.org; Mon, 01 May 2017 13:06:19 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:50546)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5Em9-0002VJ-Lt
	for groff@gnu.org; Mon, 01 May 2017 13:06:17 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5Em6-0002we-1f; Mon, 01 May 2017 19:06:15 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5Em5-0006HM-Cz; Mon, 01 May 2017 19:06:13 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5Em5-0002Kn-8W; Mon, 01 May 2017 19:06:13 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id e210423d;
	Mon, 1 May 2017 19:06:13 +0200 (CEST)
Date: Mon, 1 May 2017 19:06:13 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170501170613.GB28290@athene.usta.de>
References: <20170424115017.4wb5k6wn2vvedm6h@crack.deadbeast.net>
	<20170424120817.2EF71201ED@orac.inputplus.co.uk>
	<20170424121826.qb734iy72burofyx@crack.deadbeast.net>
	<20170424143915.GA47874@athene.usta.de>
	<20170426145026.E9BD12038D@orac.inputplus.co.uk>
	<20170426155418.u6fm3in46apw6qct@crack.deadbeast.net>
	<20170430140715.63A3D1FACE@orac.inputplus.co.uk>
	<20170430192140.r3ucb3vtj3zqrv5w@crack.deadbeast.net>
	<20170430200612.CEC3B1FACE@orac.inputplus.co.uk>
	<20170430233601.3iujbjvzoqvup2jn@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170430233601.3iujbjvzoqvup2jn@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] ASCII Minus Sign in man Pages.
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:06:20 -0000

Hi Branden,

G. Branden Robinson wrote on Sun, Apr 30, 2017 at 07:36:03PM -0400:

> I'm working up a man(7) style guide that is sure to be completely
> uncontroversial.  <beat>
> 
> Here is the relevant material from it.
> 
> Note that this is related to but independent of Ingo's proposal.
> My preference is not to refer to \- as a minus sign at all,

I actually agree with that.  If you want a real minus sign (in
particular in mathematical formulae as opposed to in programming
language source code), \- is not a good choise.  And \- is
commonly used for many purposes that are not really minus signs:
command line flags, hyphens inside program names, command modifiers,
ASCII file names, and so on.

> but that bears on documentation, not his proposed mapping per se.

Right.  The above seems right even without either of the two parts
of my proposal (to always map "-" to \(hy and to always map "\-"
to U+002D).

> Hyphens, dashes, and minus signs
[...]

What i snipped seems good to me.

> Finally, use \- to represent the much-overloaded
> hyphen-minus at code point decimal 45 in the ASCII,
> ISO 8859, and Unicode character sets.  It is best to
> think of \- as a piece of meta-punctuation that has only
> technical and contextual meaning, usually in textual
> human/computer interface discussions (programming
> languages, Unix-style command-line options, and so on).

With my proposal, that becomes strictly true.  Even if my proposal
should be shot down, even in the current state of affairs, that
advice seems much better to me than the widespread and confusing
and inaccurate statement "\- is a minus sign".

> Two important use cases for \- are (1) to separate the
> name of a man page from its summary in the Name section

That ought to be "NAME section" (all caps).

But i would probably delete this example case for three reasons.
(1) It doesn't matter at all.  Nobody will cut and paste this.
(2) Semantically, it doesn't make sense at all.  This is not
    a syntax element in any programming language.  It is a
    purely typographical question, and the intended function
    of that dash in the title line is \(em.
(3) It isn't fully true.  For example, groff_mdoc(7) does indeed
    use the ideal \(em for this purpose.  Mandoc mdoc(7) uses
    \(en for not very convincing historical reasons (OpenBSD
    developers did not like "--" in -Tascii output).
(4) Historical practice is highly volative.
    Version 3 AT&T UNIX (written in pure roff(7)) used "--"
      (in the input!)
    Version 4 to 6 AT&T UNIX and 1BSD (written using the archaic
      man macro set which is very different from the v7 man(7)
      macros some still use today, and which is sometimes called
      "man6") used the predefined string \*- defined in man/man0/naa
      (for nroff) as ".ds - -" and in man/man0/taa (for troff) as
      ".ds - \(mi"
    Version 7 AT&T UNIX and 2BSD (written in the final man(7))
      started using \-, and that practice stuck until 4.4BSD
      (even in early versions of mdoc(7))
    In groff_mdoc(7), Werner Lemberg changed if from \- to \(em
      on May 2, 2003, released with groff-1.19.1 in May 2004.
    In OpenBSD, Jason McIntyre changed it from \- to \(en
      on July 14, 2009, released with OpenBSD 4.7 in Nov. 2009

> and (2) to indicate the hyphen-minus character as
> terminal input or output in Unix command names or
> command-line options.

Sure.  that final sentence might be considered a mere repetition,
though.  The term "hyphen-minus" is already introduced two sentences
before, and "command-line options" is already listed in the
sentence right before.  Maybe "terminal input and out", "Unix
command names", and "programming language syntax elements" can be
better integrated into the previous sentence.

Yours,
  Ingo

P.S.
Regarding my proposal, in addition to the support from Ralph,
i privately got support from one FreeBSD developer who has been
maintaining part of the FreeBSD manual page formatting tools for
some years.  I'm still waiting for feeback from the OpenBSD and
NetBSD camps, but at least the reaction wasn't immediate and
fierce opposition when i sent this out to a couple of people who
have shown interest in related questions in the past, even though
i know that at least one of them values simplicity even more than
i do and dislikes \- in general (and stuff like \(hy and \(mi even
more) for that reason.


From MAILER-DAEMON Mon May 01 13:19:09 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5Eyb-00087u-0L
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:19:09 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34835)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5EyX-00087n-VN
	for groff@gnu.org; Mon, 01 May 2017 13:19:07 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5EyT-0006do-0H
	for groff@gnu.org; Mon, 01 May 2017 13:19:05 -0400
Received: from mail-qt0-x22f.google.com ([2607:f8b0:400d:c0d::22f]:33264)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5EyS-0006dG-Pe
	for groff@gnu.org; Mon, 01 May 2017 13:19:00 -0400
Received: by mail-qt0-x22f.google.com with SMTP id m36so93667751qtb.0
	for <groff@gnu.org>; Mon, 01 May 2017 10:19:00 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:mime-version:content-disposition
	:user-agent; bh=9vsROurAuGG0z6N3PhI0kThtRcCcw/GpTh9qS1qNpbs=;
	b=eQTrDGEOnIdB/n8lY/Gk2YWaDOCwOkR5ZWimYGvpngW4cfk2rhIYdaX5bxIb1tzWnt
	/MEpSC3asTWEwnpbs9Rofmhlr6jx4sbOz0IwFowKepq4BuRhbCihb473DBaAZtlBav0r
	rjOHaNAwWvumxmI+gTPeuKMRXt8q71iZqYATsZpcLYRX7wDgyRiGue2GawsZDZqFAfWS
	ODKCi7EM/WZD4IceiUwOYza6B91l6H7qoy0rkzx05R3/OKsbB72TRi7iEPWTxtg1LTUc
	QjQwpFG3Y9XMqxQmf+oREVq0jjxtC+BIHVT4ZFH8/thvbN91VqNxFERRRZpqL3yLv4yu
	AcAA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:mime-version
	:content-disposition:user-agent;
	bh=9vsROurAuGG0z6N3PhI0kThtRcCcw/GpTh9qS1qNpbs=;
	b=fVmnno/yGE4MZQFhoCx283KnM7A/iP8Xjs5vaWXb+bmVYBlaEbZBmXwsKhNuJR5jZE
	5ptXysu4mhFyQ8r8XAN24SPJD+kc2LwnHNcfUfNuq2lUbeEXAns7vYAH7CRLaXUg1dPP
	+U7w9hE1gYXDLfpcWInmSHSUan3i8teiXiIeTzDqOUcZaHDuL+R6CexBLQOQ2zLiMOYh
	tSl2ku3EG5c4vRNpOrp5akaJXtm6OcHKWMMic8IywcEAjNtiDdiojMJ+6Kgg4ZftnCdr
	9HJ8rCzkZPOCw3NAqJZ5vqzYxhSrBd/dx+Qv42f5SNO1l01LrBwJ+cYWomblX/NchtL9
	UAKQ==
X-Gm-Message-State: AN3rC/5/PSqQXxCeZa+xbU1lxieV9BzhUkf9Dxa7rAtJodn4ROkbHHVv
	IeuZNj0ndV6uITl348w=
X-Received: by 10.200.37.16 with SMTP id 16mr24535478qtm.293.1493659139945;
	Mon, 01 May 2017 10:18:59 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	r46sm11091109qtc.1.2017.05.01.10.18.58 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 01 May 2017 10:18:58 -0700 (PDT)
Date: Mon, 1 May 2017 13:18:56 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170501171854.h23xh4duksmodrn3@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="wav374iqysybyzg7"
Content-Disposition: inline
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c0d::22f
Subject: [Groff] [PATCH] correct some \c-related markup
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:19:07 -0000


--wav374iqysybyzg7
Content-Type: multipart/mixed; boundary="ne2fdiiycparjrko"
Content-Disposition: inline


--ne2fdiiycparjrko
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Please find a patch attached.

I took some before-and-after screenshots depicting the impact of each
"hunk" of the diff.  (An earlier attempt to submit this patch with this
illustrative support was thwarted by the attachment size limit.)

You can find the screenshots here:

https://www.dropbox.com/s/glbb7uhyu3fi1dm/groff-backslash-c-corrections.tar.gz?dl=0

Regards,
Branden

--ne2fdiiycparjrko
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="groff-backslash-c-corrections.diff"

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 3aa0d827..9f03b5a3 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -124,13 +124,13 @@ command:
 .LP
 .I XXX
 is the name of the register,
-.I n\c
-\~is the value to be assigned, and
-.I i\c
-\~is the increment value for auto-increment.
+.IR n \~is
+the value to be assigned, and
+.IR i \~is
+the increment value for auto-increment.
 .
-.I n\c
-\~can have a plus or minus sign as a prefix if an increment
+.IR n \~can
+have a plus or minus sign as a prefix if an increment
 or decrement of the current value is wanted.
 .
 (Auto-increment or auto-decrement occurs if the number register is
@@ -179,10 +179,10 @@ Set the format with
 .
 .
 .LP
-.I R\c
-\~is the name of the register,
-.I c\c
-\~is the format.
+.IR R \~is
+the name of the register,
+.IR c \~is
+the format.
 .
 .RS
 .LP
@@ -208,12 +208,11 @@ A@0, A, B, C, .\|.\|., Z, AA, AB, .\|.\|.
 In
 .BR m@TMAC_M_PREFIX@m ,
 the fonts (or rather, font styles)
-.B R\c
-\~(normal),
-.B I\c
-\~(italic), and
-.B B\c
-\~(bold) are hardwired to font positions
+.BR R \~(normal),
+.BR I \~(italic),
+and
+.BR B \~(bold)
+are hardwired to font positions
 .BR 1 ,
 .BR 2 ,
 and\~\c
@@ -1221,8 +1220,8 @@ directly after\~\c
 .B H
 is ignored.
 .
-.B H\c
-\~takes care of spacing and indentation.
+.BR H \~takes
+care of spacing and indentation.
 .
 .IP
 .B Page ejection before heading
@@ -2305,8 +2304,8 @@ Does not output an empty page if currently at the top of an odd page.
 .BI P\  \fR[\fPtype\fR]\fP
 Begin new paragraph.
 .
-.B P\c
-\~without argument produces left\-justified text,
+.BR P \~without
+argument produces left\-justified text,
 even the first line of the paragraph.
 .
 This is the same as setting
@@ -3907,8 +3906,8 @@ and
 are specified through
 .BR .WA / .WB .
 .
-.I n\c
-\~is the counter, 1-max, and
+.IR n \~is
+the counter, 1-max, and
 .I flag
 is true for the last name.
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index fd093bff..50adbf0e 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -275,7 +275,7 @@ mounted at font positions 1 to\ 4.
 The fonts are grouped into families
 .B T
 and
-.B H\ \c
+.B H
 having members in each of these styles:
 .
 .RS
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 5901dbe3..2d42b64b 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -231,8 +231,8 @@ is when the equation is encountered.
 .TP
 .BI \-p n
 This says that subscripts and superscripts should be
-.I n\~\c
-points smaller than the surrounding text.
+.IR n \~points
+smaller than the surrounding text.
 .
 This option is deprecated.
 .
@@ -313,7 +313,9 @@ Possible types are:
 .
 .RS
 .TP \w'punctuation'u+2n
-an ordinary character such as \[oq]1\[cq] or \[oq]\fIx\fP\[cq];
+ordinary
+an ordinary character such as \[oq]1\[cq] or
+.RI \[oq] x \[cq];
 .
 .TP
 operator
@@ -805,8 +807,8 @@ This sets parameter\~\c
 .I p
 to value\~\c
 .IR n ;
-.I n\~\c
-is an integer.
+.IR n \~is
+an integer.
 .
 For example,
 .
@@ -1133,8 +1135,8 @@ is between 1 and\~9, is replaced by the
 .IR n-th
 argument if the macro is called with arguments;
 if there are fewer than
-.I n\~\c
-arguments, it is replaced by nothing.
+.IR n \~arguments,
+it is replaced by nothing.
 .
 A word containing a left parenthesis where the part of the word
 before the left parenthesis has been defined using the
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 53d868a7..cdc96940 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -517,8 +517,8 @@ The argument
 .I xx
 is either a numeric argument to indicate the
 level of the heading, or
-.I S\ xx\ xx\ \c
-".\|.\|."
+.B S\~\c
+.IR "xx\~xx\~" .\|.\|.\&
 to set the section number explicitly.
 .
 If you specify heading levels out of sequence,

--ne2fdiiycparjrko--

--wav374iqysybyzg7
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkHbfUACgkQ0Z6cfXEm
bc6DQg//VqVcsjVBqLjqNdn2gHDU2o4Xc19rv4E0/o1bq9juT2uQPV2KLvKjJRSM
jEWHsFvwF/5Wp4t2r6Wt/cG6wNzl2JYqyKF3eN6u8QJIvRinNqkSHZOrPu8TCJ2h
gM0IUpxa/zOiLyRKc1KztXJRVXmt+Bh0iOhPpceas4rpzPxm9YplbEiu+26GEwfh
2h43q14XMYQ9Jrwh+fx2KPAdUpalCrD+6Y3oHAtODHvxbCKuaGyXaT3i1R5j40I2
OUb55HqvsKdOMYg728bH8jwntloVWqHPREUCU/zYUQOYr0KZBxHS56SuDBOAxspZ
z45R1JCC/tc6Kx+4MIFkfieb2LEx9qA1/Znlydp9gYQTLyoPT+R/77OAz7Czww0T
y4rzpaKPPu1liFe7j33OXoQnHKdpFRi0kEaXOkNCVoBlMLSWy4Y5DRW9j38LBX5A
9vL8iqBW8c4VSUyqDiL0Y+awib/U385xSXsSueacvwK79juD/SdI5toRz0Txcph8
zhZsGtgOLm1tzKalJuLJT6vkOzkMKoCyd77Fop6jO4h+3NabJrUydCCYYmJ3IvKX
rxrcoubdEHYzooPa17r7qhW2k6jJwnMiC73LLMOjGv6tRpgwmKg5NBqis3HGmiqk
6DzrYEKs0gskV7cui4TYIPsznWafXpV7SdQjHTLu7S279KlJ6b0=
=Fin1
-----END PGP SIGNATURE-----

--wav374iqysybyzg7--


From MAILER-DAEMON Mon May 01 13:21:05 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5F0T-0008KW-A5
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:21:05 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35149)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5F0P-0008KO-Is
	for groff@gnu.org; Mon, 01 May 2017 13:21:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5F0J-00088m-S2
	for groff@gnu.org; Mon, 01 May 2017 13:21:01 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:44432)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5F0J-000880-LT
	for groff@gnu.org; Mon, 01 May 2017 13:20:55 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5F0D-00069g-GK; Mon, 01 May 2017 19:20:54 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5F0D-00072Z-4H; Mon, 01 May 2017 19:20:49 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5F0D-0002aS-0H; Mon, 01 May 2017 19:20:49 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id e5dfcc5b;
	Mon, 1 May 2017 19:20:48 +0200 (CEST)
Date: Mon, 1 May 2017 19:20:48 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170501172048.GC28290@athene.usta.de>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
	<20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:21:04 -0000

Hi Branden,

G. Branden Robinson wrote on Mon, May 01, 2017 at 12:15:55PM -0400:

> You mentioned deroff(1); GNU roff does not provide its own
> implementation of it, and Debian doesn't offer one.

Hugh?  Then what does the spell(1) utility call that is contained
in whatever base operating system you use?  I'm a bit surprised
that such basic tools might be missing anywhere, causing people to
search in the woods.

> Web searches aren't much help,

If you are desperate, try using the OpenBSD implementation,
it is very old, not under active development, and likely more
or less portable after you #define away the pledge(2) calls:

  https://cvsweb.openbsd.org/cgi-bin/cvsweb/src/usr.bin/deroff/
  https://cvsweb.openbsd.org/cgi-bin/cvsweb/src/usr.bin/spell/

Or you can use the mandoc implementation, contained in the
portable mandoc releases, called "demandoc(1)":

  http://mdocml.bsd.lv/
  http://mdocml.bsd.lv/ports.html
  http://mdocml.bsd.lv/man/demandoc.1.html
  http://mdocml.bsd.lv/snapshots/mdocml.tar.gz

It ought to be more or less compatible with deroff(1).

Yours,
  Ingo


From MAILER-DAEMON Mon May 01 13:29:22 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5F8U-0001bY-Gn
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:29:22 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36759)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5F8P-0001Z0-Ns
	for groff@gnu.org; Mon, 01 May 2017 13:29:21 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5F8L-0001j2-JD
	for groff@gnu.org; Mon, 01 May 2017 13:29:17 -0400
Received: from sdaoden.eu ([217.144.132.164]:39216)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5F8L-0001iW-DG
	for groff@gnu.org; Mon, 01 May 2017 13:29:13 -0400
Received: by sdaoden.eu (Postfix, from userid 1000)
	id 69B0816056; Mon,  1 May 2017 19:29:11 +0200 (CEST)
Date: Mon, 01 May 2017 19:30:02 +0200
From: Steffen Nurpmeso <steffen@sdaoden.eu>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170501173002.NbXvk%steffen@sdaoden.eu>
References: <20170501171854.h23xh4duksmodrn3@crack.deadbeast.net>
In-Reply-To: <20170501171854.h23xh4duksmodrn3@crack.deadbeast.net>
Mail-Followup-To: groff@gnu.org,
	"G. Branden Robinson" <g.branden.robinson@gmail.com>
User-Agent: s-nail v14.9.0-pre4-37-gf921ae51
OpenPGP: id=232C220BCB5690A37BD22FFDEB66022795F382CE;
	url=https://www.sdaoden.eu/downloads/steffen.asc
BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in
	the world can make no bugs.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 217.144.132.164
Subject: Re: [Groff] [PATCH] correct some \c-related markup
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:29:21 -0000

"G. Branden Robinson" <g.branden.robinson@gmail.com> wrote:
 |Please find a patch attached.

Ordinary an ordinary, is that true.
I for one always found those one/two/one/two/.. macros very
suspicious, but now i see actual use cases.

--steffen
|Soylent Green is people!


From MAILER-DAEMON Mon May 01 13:36:33 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5FFR-0002ic-Kk
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:36:33 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39188)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5FFP-0002iV-51
	for groff@gnu.org; Mon, 01 May 2017 13:36:32 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5FFL-0004fa-7B
	for groff@gnu.org; Mon, 01 May 2017 13:36:31 -0400
Received: from mail-qk0-x234.google.com ([2607:f8b0:400d:c09::234]:33144)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5FFL-0004fB-2V
	for groff@gnu.org; Mon, 01 May 2017 13:36:27 -0400
Received: by mail-qk0-x234.google.com with SMTP id u68so14013468qkd.0
	for <groff@gnu.org>; Mon, 01 May 2017 10:36:26 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=DqJOPFEZfQR4wNZ9EZoCYgz7BiH7UbGfYtir1W5LSL8=;
	b=Om6VkB4OB4ejiHd7xXIaZUg+kewT3PVEuMtrBdvldO7i8tzKvRq5Ww3v2d5qGz0UHT
	NbPzdqCYYyGEh8a57B9V/cwA7Y+lTHWkYD7om7atdt8uDxeZgYtNSxy9+d51JsHXU98G
	MqhkHR7nf/qMqjCXsKUOnVr6tTprrFGc2ojSbiwMmhVhGxmPAyHSkRZJKtv7E/DhcaLr
	wv4qfKxOPWfd5U+BQl4ll7OOwKOMKIpH6s/nhbM6qKXlKXduA9oQT2kpvp8i4zY9iiuW
	yJZtF2wuOhkD3c2DKaLPgLDKO4JGyciSx5fThJKqYrv7vokpsd0OgAurd/9gZb13nqm5
	MhPA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=DqJOPFEZfQR4wNZ9EZoCYgz7BiH7UbGfYtir1W5LSL8=;
	b=QH0WL86nfGrvuZ1knc22gzyr7M2QTUbXkzEdFh7lfxuykfa71VaMJ9xGLH30jNLAtj
	zxiotsnBRt+5zRwvViwNjt2/RZA4NaBzDWS5eWK4uS4KHsiLpEOx9IsYrNALHSt9G2QO
	MM3Rf1y7eXK/NiF5dIV/hRMVkd9e1Zz0vwKlVjc6wopHpRjyDmzXwWSYsXOtEPGH+Xai
	j1XhIzBS6gq5o3X079XJTfM9diJBVf93e2ymfgyBM5S1clXFNAREC3KbmP2o7ZMdmq9B
	uqeOrOvbz4B2Wc5YwO14TBU3nndnEA/t+T5gxcd9rwQF1HdiP2oGZcY+hMo1vr3OhYVP
	Uhlg==
X-Gm-Message-State: AN3rC/4ks0mEo0L5gAxJTaLDAkXTXaNM36UbYlFwxtOc1unH1CAFx2Wl
	K790Vw2+vCx2U8ASufI=
X-Received: by 10.55.163.20 with SMTP id m20mr69381qke.265.1493660186258;
	Mon, 01 May 2017 10:36:26 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	i19sm11225629qte.31.2017.05.01.10.36.24 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 01 May 2017 10:36:25 -0700 (PDT)
Date: Mon, 1 May 2017 13:36:22 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170501173621.73xbr65avp76avxs@crack.deadbeast.net>
References: <20170501171854.h23xh4duksmodrn3@crack.deadbeast.net>
	<20170501173002.NbXvk%steffen@sdaoden.eu>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="hoswgmjn73ztqwgg"
Content-Disposition: inline
In-Reply-To: <20170501173002.NbXvk%steffen@sdaoden.eu>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::234
Subject: Re: [Groff] [PATCH] correct some \c-related markup
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:36:32 -0000


--hoswgmjn73ztqwgg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-01T19:30:02+0200, Steffen Nurpmeso wrote:
> "G. Branden Robinson" <g.branden.robinson@gmail.com> wrote:
>  |Please find a patch attached.
>=20
> Ordinary an ordinary, is that true.

That was a tagged paragraph without a tag, so I gave it one.

Without a tag, I don't understand the point of calculating an indent
(\w'punctuation'u+2n) for the non-tagged lines of the paragraph, of
which there were none in the original.

> I for one always found those one/two/one/two/.. macros very
> suspicious, but now i see actual use cases.

One of the advantages of some of them is that, if people think to use
them, they relieve the writer of having to remember to supply italic
corrections:

       \/     Increases the width of the preceding glyph so that the
              spacing between that glyph and the following glyph is
              correct if the following glyph is a roman glyph.
       \,     Modifies the spacing of the following glyph so that the
              spacing between that glyph and the preceding glyph is
              correct if the preceding glyph is a roman glyph.

Regards,
Branden

--hoswgmjn73ztqwgg
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkHcg4ACgkQ0Z6cfXEm
bc5GRBAAlARwUenJW0nIWlw9gKHSk3lRGRD3RrmWmtFN6oyi6VN2bohjT43qjdRg
pn5HOesKVybozlS4cCIE6rmovhHp1DsKV4Vjxe27+vr1fGVmmj3V5yR0IP/0ChqU
IsOGnkbgQ1bckBqzUcVH4i9hVLJazVtiGIxN75KAoPNBb1M2lxvqg/7Z3PQKKmdn
F+6fAlCoCMHuR/uHb0+Rn7I1W2iYNEv4fI29+5+tYihzkBkTx3iQz5ihiNEzugcn
triTDuzPYsQgzHDsCoFWNsri8L6g9yEDAg0fz1BUsCvtH6VeBe7mYK+SkofjAMZQ
cL2loXu9ZqXD0lkJo5fF32Jt4URswaJ7xG5ATCO/3qWFULxmn7YUx5iUmXNjEVE1
DRXSbHZR45OaiVKzKbWzaW1LbVk3bOk+chmrSXHiL/LHJ53pbMm7ymdWm+honFB4
1Q/QjHe2f5nKNs0g5n++Qa7Eiu7Wq03cSJHuCBx/a1LZwVL9OHMDjMfwJJIWJluR
EbfV9K7UOjaZvtOLtAie79vum+BrHKQXJpNabpwvTYfDV/FXgX6EigHxrX+Hq7MZ
WvP4j83sVMwJ+/VD8DhCxpSRmS5OI9tjvmL+FaQmdrQXHsL8t1z5buSWdHprtBRx
B8SpWE1wWKrnkdHk6gmtNFX9MeCOWoXi8t1DlZ+CoTDPr6oahZc=
=4EaE
-----END PGP SIGNATURE-----

--hoswgmjn73ztqwgg--


From MAILER-DAEMON Mon May 01 13:38:12 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5FH2-0002zR-Sm
	for mharc-groff@gnu.org; Mon, 01 May 2017 13:38:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39548)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5FH1-0002zK-8C
	for groff@gnu.org; Mon, 01 May 2017 13:38:12 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5FGy-0005L7-3W
	for groff@gnu.org; Mon, 01 May 2017 13:38:11 -0400
Received: from mail-qt0-x243.google.com ([2607:f8b0:400d:c0d::243]:32895)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5FGx-0005Kz-Vw
	for groff@gnu.org; Mon, 01 May 2017 13:38:08 -0400
Received: by mail-qt0-x243.google.com with SMTP id c45so17190185qtb.0
	for <groff@gnu.org>; Mon, 01 May 2017 10:38:07 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=gBo+opLSo9WGIk7Ir3Jdn0SCBdfZaEKVfx3zOjnsP3w=;
	b=bdq4FGcKyHv84P7KlxY0uG0PTp5ewGvESg5tkVSjZf6l/HOy2BZWt4P30EWTa7GiQF
	Fa0nRmylS0bwD8u2iXHCagb/sUfDcFgD+aUzEhK8B9QeCoawETOmtBdYlG6Ngh2nM22N
	OIm7fR5v7k+/mqrKq/r3MDRkyGk5quUTxcZhjsu125ZxhPsX61uCsO4ErYYWi1dET6aC
	hEpQrYWiAmPVnr/ruHbfF8vvfi7Br9KIDrqwYzxX/r/CLI1+ttBUfDklokbk/mXYq2VE
	lmvRAOvXTzBE1qMwdO0ITMJ37uC80diTJiuDd+DcKxg1VzSSMlTf+vbTg4/vUbMTHoHV
	c2lA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=gBo+opLSo9WGIk7Ir3Jdn0SCBdfZaEKVfx3zOjnsP3w=;
	b=gpU6M5cQJUKrbvjbmyM+W5jaC00YV/4j/9bNEX9raSNJcGOfWgt2Krtpgs3JdGG20V
	Q9Kf0EjMj/nNBxOVO9XZ1Oajv7YGmnBmp9toqgIeNvcI4hjMhvgtZOsfQ8DAdxq6q2Wk
	olbzsfmdPB0282lyuPNC/UX//SHmD9lNAyV2btXhe2RRzotQM1v6Nf6MzRY96XLC0WdS
	BrTLAv1/6n9DwdIeraD/NC8mXDKkbSri175SLKguzTzY5EVFzljtRyhwU8sj6MwNRIwS
	7k8AC6zvxigvntFD+bKX1E6njzV+4Z4pamos7Mf+CI65Ye6iHOQ+GSrcRvLp9uVxSLm8
	xrPg==
X-Gm-Message-State: AN3rC/5VNx+x82vTPv2sbTISv4+TLw/UF1cVg1pdymuOVPssNNtvlD2s
	Hrm0uWb2PKFxPTXbj5A=
X-Received: by 10.200.53.220 with SMTP id l28mr21759989qtb.49.1493660287141;
	Mon, 01 May 2017 10:38:07 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	a2sm11152593qte.64.2017.05.01.10.38.05 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 01 May 2017 10:38:05 -0700 (PDT)
Date: Mon, 1 May 2017 13:38:03 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170501173801.sj4krb7sd5cscsmg@crack.deadbeast.net>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
	<20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
	<20170501172048.GC28290@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="i4i6jk3fef4xtejv"
Content-Disposition: inline
In-Reply-To: <20170501172048.GC28290@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c0d::243
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 17:38:12 -0000


--i4i6jk3fef4xtejv
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-01T19:20:48+0200, Ingo Schwarze wrote:
> G. Branden Robinson wrote on Mon, May 01, 2017 at 12:15:55PM -0400:
> > You mentioned deroff(1); GNU roff does not provide its own
> > implementation of it, and Debian doesn't offer one.
>=20
> Hugh?  Then what does the spell(1) utility call that is contained
> in whatever base operating system you use?  I'm a bit surprised
> that such basic tools might be missing anywhere, causing people to
> search in the woods.

Don't know--I use only Vim's spell checker, and don't even have a
spell(1) installed.

Regards,
Branden

--i4i6jk3fef4xtejv
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkHcnkACgkQ0Z6cfXEm
bc4B4w/9G88phU0v73UOKsANyRi5/l1PvaGsr8XB8OdGjWJD6CLvg/FbEQc45hKa
mB9lIa8uRyBCHiTx5wjkvLMajxzMIvkOvj73srAX+HY8i1I4HLFEvTQTysp0uTaX
gc3PwUHmJ2rfY66HvUipVhd+lJ98lWyiaA6xyzkpUUlaMVbSrCWEJXsz70bLhxI6
Q20tTf6xlO+FYcuhJ9ahKLVvVhlbUgbvwf/HaELO7i3OaFLPca/V0gKGo1egok1F
0FRJ5k+V2z3Ooc+I5Ckyvfqc38cZhfbrdunOYXe0B6MvxbNKJoDhpkIFhUBsnKgk
GTmWUdgobptRGXoKC0a5yRJqJLJgxqe4amEHy84XyO3bpJ1i7WHAFvPc+x1v22Y8
dZ/d48iZnm4Q+yByyLOgo8L4oyvZaTeViFVEt8RSbpC8FwaOb568w40Pq3l//Q3t
CKb2U8PC4JIBy7z8/8ctnuy/JD35oAvkW+sIr8YVu+uIfwxp6fqm6RJyTi8e6g+6
+cf1SLBB56HAqK+aWKr6GNcKkzAFedHR+u9JZrh2X75itzdBSVeZPYEiterlU6Zj
qjyMyiaFmJXwVDSIHmJFxk/SMft6OGO8kXu3dCevHMnBVWZdfhSdoyTHCZB1aS95
YYgGfwAfv/dZt1IVdEqsa9HyJBLyPt6dosru+tyH+KRJYH4bNh0=
=5BcY
-----END PGP SIGNATURE-----

--i4i6jk3fef4xtejv--


From MAILER-DAEMON Mon May 01 15:17:25 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5Gp3-00083n-Ng
	for mharc-groff@gnu.org; Mon, 01 May 2017 15:17:25 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36985)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5Gp2-00083h-CJ
	for groff@gnu.org; Mon, 01 May 2017 15:17:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5Gp1-0001qj-L9
	for groff@gnu.org; Mon, 01 May 2017 15:17:24 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:55220)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5Gp1-0001qC-FF
	for groff@gnu.org; Mon, 01 May 2017 15:17:23 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5Goy-0002zX-0W; Mon, 01 May 2017 21:17:21 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5Gox-0006uN-Kg; Mon, 01 May 2017 21:17:19 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5Gox-0004Xh-E7; Mon, 01 May 2017 21:17:19 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id b4d5a3e5;
	Mon, 1 May 2017 21:17:19 +0200 (CEST)
Date: Mon, 1 May 2017 21:17:19 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170501191719.GA27195@athene.usta.de>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
	<20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 19:17:25 -0000

Hi Branden,

G. Branden Robinson wrote on Mon, May 01, 2017 at 12:15:55PM -0400:

> I wish groff could emit its AST itself, though.

That desire feels understandable.  Then again, if you intend to ask
the current implementation whether it wants to help, brace yourself
for an answer that might seem less than enthusiastic.

I'd expect feeback roughly along the lines of:  "Look, i'm an
interpreter, not a lumberjack, so i'm confused why you suddenly
start talking about trees to me."

Yours,
  Ingo


From MAILER-DAEMON Mon May 01 17:22:13 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5Ilp-0000a3-D4
	for mharc-groff@gnu.org; Mon, 01 May 2017 17:22:13 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34476)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5IkO-0000XC-U3
	for groff@gnu.org; Mon, 01 May 2017 17:20:45 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5IkL-0004WC-Hs
	for groff@gnu.org; Mon, 01 May 2017 17:20:44 -0400
Received: from relay01.pair.com ([209.68.5.15]:60411)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d5IkL-0004Uz-7T
	for groff@gnu.org; Mon, 01 May 2017 17:20:41 -0400
Received: from orac.inputplus.co.uk (144.33.189.80.dyn.plus.net
	[80.189.33.144])
	by relay01.pair.com (Postfix) with ESMTP id D367DD00B67
	for <groff@gnu.org>; Mon,  1 May 2017 17:20:36 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 2A494201EC
	for <groff@gnu.org>; Mon,  1 May 2017 22:20:36 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170501172048.GC28290@athene.usta.de>
References: <201704252300.v3PN0QCi009878@coolidge.cs.Dartmouth.EDU>
	<20170426124342.3mjnds74yvuu2pcj@crack.deadbeast.net>
	<20170426235742.7bp5elajil34itiw@crack.deadbeast.net>
	<20170430161130.3CAA51FACE@orac.inputplus.co.uk>
	<20170430235124.5nk33cmexj6i6lnl@crack.deadbeast.net>
	<20170501154630.GA28290@athene.usta.de>
	<20170501161554.wb53nzkjntltejp4@crack.deadbeast.net>
	<20170501172048.GC28290@athene.usta.de>
Date: Mon, 01 May 2017 22:20:36 +0100
Message-Id: <20170501212036.2A494201EC@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
X-Mailman-Approved-At: Mon, 01 May 2017 17:22:11 -0400
Subject: Re: [Groff] Applications of \c in man pages in the wild [LONG]
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 21:20:46 -0000

Hi Ingo,

> Hugh?

Who Hugh?

> Then what does the spell(1) utility call that is contained in whatever
> base operating system you use?

aspell(1) has a -n option for nroff input.
Arch Linux's pkgfile(1) doesn't know of a /usr/bin/spell.
I've a ~/bin/spell that's ad hoc for my needs;  based on the typical
`fgrep -vxf'.

> "demandoc(1)":

I thought that was an LD_PRELOAD to tweak format strings to `%o'?

Cheers, Ralph.


From MAILER-DAEMON Mon May 01 18:55:26 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5KE2-0002Tn-2A
	for mharc-groff@gnu.org; Mon, 01 May 2017 18:55:26 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:52897)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5KE0-0002Th-I2
	for groff@gnu.org; Mon, 01 May 2017 18:55:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5KDx-00065b-Hg
	for groff@gnu.org; Mon, 01 May 2017 18:55:24 -0400
Received: from mail.cs.dartmouth.edu ([129.170.212.100]:60108)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <doug@cs.dartmouth.edu>)
	id 1d5KDx-00065X-DW
	for groff@gnu.org; Mon, 01 May 2017 18:55:21 -0400
Received: from tahoe.cs.Dartmouth.EDU (tahoe.cs.dartmouth.edu [129.170.212.20])
	by mail.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTPS id v41MtJps009522
	(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
	Mon, 1 May 2017 18:55:19 -0400
Received: from tahoe.cs.Dartmouth.EDU (localhost.localdomain [127.0.0.1])
	by tahoe.cs.Dartmouth.EDU (8.15.2/8.14.3) with ESMTP id v41MtJfa022191; 
	Mon, 1 May 2017 18:55:19 -0400
Received: (from doug@localhost)
	by tahoe.cs.Dartmouth.EDU (8.15.2/8.15.2/Submit) id v41MtJ6k022190;
	Mon, 1 May 2017 18:55:19 -0400
From: Doug McIlroy <doug@cs.dartmouth.edu>
Message-Id: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
Date: Mon, 01 May 2017 18:55:19 -0400
To: groff@gnu.org, g.branden.robinson@gmail.com
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 129.170.212.100
Subject: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 22:55:25 -0000

>  If you want a real minus sign (in particular in mathematical
> formular as opposed to in programming language source code),
> \- is not a good choise.

This statement baffles me. That is exactly what \- is supposed
to mean: the mathematical minus sign. In particular it is supposed
to match + in width and weight. Are you saying that it no longer
has that property and something else does?

Doug


From MAILER-DAEMON Mon May 01 19:16:25 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5KYL-0004YE-HX
	for mharc-groff@gnu.org; Mon, 01 May 2017 19:16:25 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56361)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5KYI-0004Xo-JO
	for groff@gnu.org; Mon, 01 May 2017 19:16:23 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5KYH-0002Ko-OI
	for groff@gnu.org; Mon, 01 May 2017 19:16:22 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:54189)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5KYH-0002KB-IR
	for groff@gnu.org; Mon, 01 May 2017 19:16:21 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5KYE-0006ZI-3u; Tue, 02 May 2017 01:16:19 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5KYC-0003hr-IW; Tue, 02 May 2017 01:16:16 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5KYC-00011j-Dw; Tue, 02 May 2017 01:16:16 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id a541e832;
	Tue, 2 May 2017 01:16:16 +0200 (CEST)
Date: Tue, 2 May 2017 01:16:16 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: Doug McIlroy <doug@cs.dartmouth.edu>
Cc: groff@gnu.org, g.branden.robinson@gmail.com
Message-ID: <20170501231616.GH28290@athene.usta.de>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 23:16:23 -0000

Hi Doug,

Doug McIlroy wrote on Mon, May 01, 2017 at 06:55:19PM -0400:
> Ingo Schwarze wrote:

>>  If you want a real minus sign (in particular in mathematical
>> formular as opposed to in programming language source code),
>> \- is not a good choise.

> This statement baffles me. That is exactly what \- is supposed
> to mean: the mathematical minus sign. In particular it is supposed
> to match + in width and weight. Are you saying that it no longer
> has that property and something else does?

Exactly.  Rendering of \- varies depending on software suite,
software version, macro set, and output device.

For example, in manual pages on -Tutf8 and -Tpdf output devices 
with modern groff, it renders as U+002D HYPHEN-MINUS, not as
U+2212 MINUS SIGN.

The character escape sequence \(mi always renders as U+2212 MINUS
SIGN on all implementations i'm aware of, as long as the selected
output device supports it; otherwise, it might of course fall back
to whatever the device provides.

In classical typesetting, it only mattered how the output looked.
Today, it also matters which Unicode codepoints you get.  Semantics
may differ even if the glyphs are almost indistinguishable.  U+002D
HYPHEN-MINUS and U+2212 MINUS SIGN will look very similar in many
fonts, but they are distinct characters.

Yours,
  Ingo


From MAILER-DAEMON Mon May 01 19:58:02 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5LCc-0007LD-Dc
	for mharc-groff@gnu.org; Mon, 01 May 2017 19:58:02 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33481)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5LCZ-0007L4-KA
	for groff@gnu.org; Mon, 01 May 2017 19:58:00 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5LCY-0005gZ-NA
	for groff@gnu.org; Mon, 01 May 2017 19:57:59 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:34841)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5LCY-0005g1-HP
	for groff@gnu.org; Mon, 01 May 2017 19:57:58 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>) id 1d5LCV-0002vO-4p
	for groff@gnu.org; Tue, 02 May 2017 01:57:56 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>) id 1d5LCU-0000og-Qz
	for groff@gnu.org; Tue, 02 May 2017 01:57:54 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>) id 1d5LCU-0001ir-LJ
	for groff@gnu.org; Tue, 02 May 2017 01:57:54 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 8795d123
	for <groff@gnu.org>; Tue, 2 May 2017 01:57:54 +0200 (CEST)
Date: Tue, 2 May 2017 01:57:54 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20170501235754.GI28290@athene.usta.de>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2017 23:58:00 -0000

Purely FYI:

Given that the man(7) .TP .itc hack got committed to groff,
as promised, i adjusted mandoc(1), both in OpenBSD and in the
portable version, to handle .TP heads with \c the same way.

Of course, i still don't recommend actually using it, because
that would make your manual page misrender on groff <= 1.22.3,
on mandoc <= 1.14.1, and on any version of anything else.



CVSROOT:	/cvs
Module name:	src
Changes by:	schwarze@cvs.openbsd.org	2017/05/01 17:27:23

Modified files:
	usr.bin/mandoc : man.c 

Log message:
A few days ago, a patch from <G dot Branden dot Robinson at gmail dot com>
got committed to groff which changed .TP from using .it to using .itc,
such that groff now supports more than one man(7) macro line in the .TP
head if all but the last line in the head end with \c.

Of course, relying on that behaviour is utterly non-portable, but if
authors are reckless enough to use that idiom, let's do what they want.



Index: man.c
===================================================================
RCS file: /cvs/src/usr.bin/mandoc/man.c,v
retrieving revision 1.118
diff -U8 -p -r1.118 man.c
--- man.c	29 Apr 2017 12:43:55 -0000	1.118
+++ man.c	1 May 2017 22:55:22 -0000
@@ -194,12 +194,26 @@ man_pmacro(struct roff_man *man, int ln,
 	/*
 	 * Some macros break next-line scopes; otherwise, remember
 	 * whether we are in next-line scope for a block head.
 	 */
 
 	man_breakscope(man, tok);
 	bline = man->flags & MAN_BLINE;
 
+	/*
+	 * If the line in next-line scope ends with \c, keep the
+	 * next-line scope open for the subsequent input line.
+	 * That is not at all portable, only groff >= 1.22.4
+	 * does it, but *if* this weird idiom occurs in a manual
+	 * page, that's very likely what the author intended.
+	 */
+
+	if (bline) {
+		cp = strchr(buf + offs, '\0') - 2;
+		if (cp >= buf && cp[0] == '\\' && cp[1] == 'c')
+			bline = 0;
+	}
+
 	/* Call to handler... */
 
 	assert(man_macros[tok].fp);
 	(*man_macros[tok].fp)(man, tok, ln, ppos, &offs, buf);



schwarze@isnote $ mandoc      
.TH TEST 1 2017-05-01
.SH NAME 
name \- descr
.SH DESCRIPTION
initial text
.TP
.B -S \c
.IR var [= val ]
indented
.br
text
^D
TEST(1)                     General Commands Manual                    TEST(1)

NAME
       name - descr

DESCRIPTION
       initial text

       -S var[=val]
              indented
              text

                                  2017-05-01                           TEST(1)


From MAILER-DAEMON Mon May 01 22:06:52 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5NDF-0000VQ-Hw
	for mharc-groff@gnu.org; Mon, 01 May 2017 22:06:49 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:38810)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5NDD-0000VI-6p
	for groff@gnu.org; Mon, 01 May 2017 22:06:48 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5ND8-0008AC-8t
	for groff@gnu.org; Mon, 01 May 2017 22:06:47 -0400
Received: from mail.cs.dartmouth.edu ([129.170.212.100]:42846)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <doug@cs.dartmouth.edu>)
	id 1d5ND8-00089v-4p
	for groff@gnu.org; Mon, 01 May 2017 22:06:42 -0400
Received: from coolidge.cs.Dartmouth.EDU (coolidge.cs.dartmouth.edu
	[129.170.213.217])
	by mail.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTPS id v4226dp1030581
	(version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO);
	Mon, 1 May 2017 22:06:39 -0400
Received: from coolidge.cs.Dartmouth.EDU (localhost.localdomain [127.0.0.1])
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTP id
	v4226dN5025885; Mon, 1 May 2017 22:06:39 -0400
Received: (from doug@localhost)
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2/Submit) id v4226cps025884; 
	Mon, 1 May 2017 22:06:38 -0400
From: Doug McIlroy <doug@cs.dartmouth.edu>
Message-Id: <201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
Date: Mon, 01 May 2017 22:06:38 -0400
To: schwarze@usta.de, doug@cs.dartmouth.edu
Cc: groff@gnu.org, g.branden.robinson@gmail.com
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
In-Reply-To: <20170501231616.GH28290@athene.usta.de>
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 129.170.212.100
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 02:06:48 -0000

Originally \(pl and \(mi came from a fixed font (S) while + and \-
came from the current font. As I understand your comment, groff
has reversed this troff convention. Additionally groff interprets - as
a compromise HYPHEN-MINUS.

man groff_char, however, tells the original state of affairs.  What is
one to believe?

Doug


From MAILER-DAEMON Tue May 02 05:49:45 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5URE-0002uJ-WD
	for mharc-groff@gnu.org; Tue, 02 May 2017 05:49:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51622)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5URA-0002u9-B3
	for groff@gnu.org; Tue, 02 May 2017 05:49:41 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5UR7-00055j-9q
	for groff@gnu.org; Tue, 02 May 2017 05:49:40 -0400
Received: from sdaoden.eu ([217.144.132.164]:39252)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5UR7-00054y-37
	for groff@gnu.org; Tue, 02 May 2017 05:49:37 -0400
Received: by sdaoden.eu (Postfix, from userid 1000)
	id B723716051; Tue,  2 May 2017 11:49:35 +0200 (CEST)
Date: Tue, 02 May 2017 11:50:31 +0200
From: Steffen Nurpmeso <steffen@sdaoden.eu>
To: Doug McIlroy <doug@cs.dartmouth.edu>
Cc: g.branden.robinson@gmail.com, groff@gnu.org, schwarze@usta.de
Message-ID: <20170502095031.9WWos%steffen@sdaoden.eu>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
In-Reply-To: <201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
Mail-Followup-To: schwarze@usta.de, groff@gnu.org,
	g.branden.robinson@gmail.com, Doug McIlroy <doug@cs.dartmouth.edu>
User-Agent: s-nail v14.9.0-pre4-37-gf921ae51
OpenPGP: id=232C220BCB5690A37BD22FFDEB66022795F382CE;
	url=https://www.sdaoden.eu/downloads/steffen.asc
BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in
	the world can make no bugs.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 217.144.132.164
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 09:49:41 -0000

Doug McIlroy <doug@cs.dartmouth.edu> wrote:
 |Originally \(pl and \(mi came from a fixed font (S) while + and \-
 |came from the current font. As I understand your comment, groff
 |has reversed this troff convention. Additionally groff interprets - as
 |a compromise HYPHEN-MINUS.
 |
 |man groff_char, however, tells the original state of affairs.  What is
 |one to believe?

I now think it is better to revert all those per-macro adjustments
altogether and be pure; if people use \- to get "nicer" (smoother
and finer that is) output then pasting from manual is simply
impossible.  Distributions like Debian can then still easily apply
remappings at well-known places and document it in their
guidelines.  And/or the remappings could be covered by
a conditional and a global per-site configuration file can set the
corresponding switch, which macro packages then honour.
I think this will be my distant target.

--steffen
|Soylent Green is people!


From MAILER-DAEMON Tue May 02 06:33:27 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5V7W-0001vV-Tr
	for mharc-groff@gnu.org; Tue, 02 May 2017 06:33:26 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43386)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5V7T-0001uU-Me
	for groff@gnu.org; Tue, 02 May 2017 06:33:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5V7O-000051-R2
	for groff@gnu.org; Tue, 02 May 2017 06:33:23 -0400
Received: from sdaoden.eu ([217.144.132.164]:39262)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5V7O-0008UQ-Ka
	for groff@gnu.org; Tue, 02 May 2017 06:33:18 -0400
Received: by sdaoden.eu (Postfix, from userid 1000)
	id 4E99216051; Tue,  2 May 2017 12:33:17 +0200 (CEST)
Date: Tue, 02 May 2017 12:34:12 +0200
From: Steffen Nurpmeso <steffen@sdaoden.eu>
To: groff@gnu.org
Message-ID: <20170502103412.rKxyL%steffen@sdaoden.eu>
References: <20170501171854.h23xh4duksmodrn3@crack.deadbeast.net>
	<20170501173002.NbXvk%steffen@sdaoden.eu>
	<20170501173621.73xbr65avp76avxs@crack.deadbeast.net>
In-Reply-To: <20170501173621.73xbr65avp76avxs@crack.deadbeast.net>
Mail-Followup-To: groff@gnu.org
User-Agent: s-nail v14.9.0-pre4-37-gf921ae51
OpenPGP: id=232C220BCB5690A37BD22FFDEB66022795F382CE;
	url=https://www.sdaoden.eu/downloads/steffen.asc
BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in
	the world can make no bugs.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 217.144.132.164
Subject: Re: [Groff] [PATCH] correct some \c-related markup
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 10:33:24 -0000

"G. Branden Robinson" <g.branden.robinson@gmail.com> wrote:
 |At 2017-05-01T19:30:02+0200, Steffen Nurpmeso wrote:
 |> "G. Branden Robinson" <g.branden.robinson@gmail.com> wrote:
 |>|Please find a patch attached.
  ...
 |> I for one always found those one/two/one/two/.. macros very
 |> suspicious, but now i see actual use cases.
 |
 |One of the advantages of some of them is that, if people think to use
 |them, they relieve the writer of having to remember to supply italic
 |corrections:

I came from TeX, and luckily groff then had strings with arguments
already!

  .STRING I \\,\\fI\\$*\\fP\\/

is \*[I almost] as easy (especially with US keyboard) as

  \def\it{\edef\@font@currIsBold{\FALSE}\@font@setFont{it}}%
  \def\tit#1{{\it#1\/}}

the \tit{version} of \TeX.  Almost as clean.

--steffen
|Soylent Green is people!


From MAILER-DAEMON Tue May 02 09:45:09 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5Y73-00009Z-P1
	for mharc-groff@gnu.org; Tue, 02 May 2017 09:45:09 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33031)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5Y71-000067-FW
	for groff@gnu.org; Tue, 02 May 2017 09:45:08 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5Y70-0003bX-JZ
	for groff@gnu.org; Tue, 02 May 2017 09:45:07 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:52171)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5Y70-0003aO-DO
	for groff@gnu.org; Tue, 02 May 2017 09:45:06 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>) id 1d5Y6w-0006WX-AZ
	for groff@gnu.org; Tue, 02 May 2017 15:45:04 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>) id 1d5Y6v-0005Zg-LK
	for groff@gnu.org; Tue, 02 May 2017 15:45:01 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>) id 1d5Y6v-0005If-Cd
	for groff@gnu.org; Tue, 02 May 2017 15:45:01 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id d8aaadb0
	for <groff@gnu.org>; Tue, 2 May 2017 15:45:01 +0200 (CEST)
Date: Tue, 2 May 2017 15:45:01 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20170502134501.GA19813@athene.usta.de>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
	<20170502095031.9WWos%steffen@sdaoden.eu>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170502095031.9WWos%steffen@sdaoden.eu>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 13:45:08 -0000

Hi,

Steffen Nurpmeso wrote on Tue, May 02, 2017 at 11:50:31AM +0200:

> I now think it is better to revert all those per-macro adjustments
> altogether and be pure; if people use \- to get "nicer" (smoother
> and finer that is) output then pasting from manual is simply
> impossible.

That is clearly the worst suggestion so far.  It is not just a
matter of "if (some) people".  Take, for example, mdoc(7).  It has
been enforcing \- for .Fl since its inception in 4.3BSD-Reno in
1990, and that wasn't a new choice even though man(7) does not
enforce rendering of command line options in any particular way,
but leaves the choice to the author; but standard practice, in
man(7) as well, has been to use \- for command line options since
the first release of man(7) in Version 7 AT&T UNIX in 1979.  And
that made sense at the time because the minus sign was ASCII 0x2d
in nroff(1), you couldn't cut and paste from a manual printed on
paper, and the distinction between Unicode U+002D HYPHEN-MINUS and
U+2212 MINUS SIGN did not yet exist.

So you propose that we break copy and paste from more or less all
manual pages now (including in -Tutf8 output which is the default
on terminals in many systems at this point), even though it has
been working just fine for almost 40 years?  You must be jesting.

No, making the decision at this point in time that \- has to
consistently render as U+2212 MINUS SIGN is not an option at all.
That's one half of the reason why i suggested to make it render
consistently as U+002D HYPHEN-MINUS.

> Distributions like Debian can then still easily apply
> remappings at well-known places and document it in their
> guidelines.

So groff should do something that is unusable and ask downstream
distributions to fix it up to make it useable?  That guarantees
utter confusion and doesn't make any sense whatsoever.  What are
other formatters (like mandoc) supposed to do?  Mandoc doesn't even
have the distinction of "upstream" and "distribution" to implement
such a split in behavior.  Both FreeBSD and OpenBSD use the mandoc
code directly from the HEAD of the VCS.

By the way, in the meantime, i also received support from NetBSD/pkgsrc
for my proposal (\- always U+002D, \(mi always U+2212).  That's
Ralph, Branden, NetBSD/pkgsrc, and one relevant FreeBSD developer
then, and no protest so far from OpenBSD.  I think i'll start
preparing patches and submit them to the groff bugtracker when they
are ready.

Yours,
  Ingo


From MAILER-DAEMON Tue May 02 11:49:05 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5a2z-00081R-AR
	for mharc-groff@gnu.org; Tue, 02 May 2017 11:49:05 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42922)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5a2x-00080K-SZ
	for groff@gnu.org; Tue, 02 May 2017 11:49:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5a2u-00048d-Qk
	for groff@gnu.org; Tue, 02 May 2017 11:49:03 -0400
Received: from mail-qk0-x22b.google.com ([2607:f8b0:400d:c09::22b]:35594)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5a2u-00047u-Ld
	for groff@gnu.org; Tue, 02 May 2017 11:49:00 -0400
Received: by mail-qk0-x22b.google.com with SMTP id q1so46325498qkd.2
	for <groff@gnu.org>; Tue, 02 May 2017 08:49:00 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=yznFVEjzPX848gObMhYvc+ccCikhqaOUjN0Xd8x7+j8=;
	b=iD5OpEJBQX+fK5jm8tR36NM7yH2CZ6JFWlo9z1BlnC9wvuFXrabkpO0FQeYF0HMAPg
	xizi7kEfuio7arWFFXSJ2KIf1vr5BuHlqCgeYqFUFS1xi7tKEmgvGNpNKUGdaavAOX40
	xHrtThLSCiMqwML4ubseBYoccx6N3aXkI5IfL1cO+mRyrjnUbgTQfRDpoACEe4mX+tpi
	swUWBGV+sdNVnpXpkmFW4ieoGVsvHiV/f0sne57M6wKtx3/co86swoL6qKK6Z8rmaBwJ
	4aTEQk49ANFdZ/DW/bVmdubQCU/pwty2CIZ7tp5MWLjpZlbaIPPHG7lqsCbSVFxvVvtZ
	jCgw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=yznFVEjzPX848gObMhYvc+ccCikhqaOUjN0Xd8x7+j8=;
	b=Rce9j8SLbFuS4tKBMXs5njytEEcDz5f6hovpK2fTT6qKjwktiSiHmKkWj9Q+86King
	0XC/v96qtp2/MdNDZHeab/e10MJqWSdAYhv7Bu/BwISK4lFeoqU3EkzXAK3ZmjPQRAoA
	glbAAlQhjpHXjNSmUbf9L/1sYFTlVV9tfOdPeXXZpIo1BhdfBbhtgH9g/ouOk2G+hlgJ
	knAModeI+GM1S+0pGsnGLEMoR993RbIjpenrbGDveuls9WFKnDYcZH4+wkca0nc1MyuC
	aVmntDA3iAlb70eVhdulCbS3i1JuaFqSaGisBKiv1VQvd8QDgRB6wBvdK86/kphTC54A
	J73w==
X-Gm-Message-State: AN3rC/4eqTpSpy3hzIBw3mpJFqisLsEXHNBz9jJKtCNauQSMVQojnFcV
	k9mtqMibz51/ctYYcsI=
X-Received: by 10.55.92.131 with SMTP id q125mr28765452qkb.138.1493740139444; 
	Tue, 02 May 2017 08:48:59 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	u49sm13760112qte.44.2017.05.02.08.48.58 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 02 May 2017 08:48:58 -0700 (PDT)
Date: Tue, 2 May 2017 11:48:56 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170502154853.hwdhmc67ydwt6mgs@crack.deadbeast.net>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="vijecthdr5745v6x"
Content-Disposition: inline
In-Reply-To: <20170501235754.GI28290@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::22b
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 15:49:04 -0000


--vijecthdr5745v6x
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-02T01:57:54+0200, Ingo Schwarze wrote:
> Purely FYI:
>=20
> Given that the man(7) .TP .itc hack got committed to groff,

Some men just want to watch the world burn.  ;-)

> A few days ago, a patch from <G dot Branden dot Robinson at gmail dot com>
> got committed to groff which changed .TP from using .it to using .itc,
> such that groff now supports more than one man(7) macro line in the .TP
> head if all but the last line in the head end with \c.

Note that the commits also affected the .SH, .SS, .B, .I, .SM, and .SB
macros as well.  Basically it affected anything that set an input trap.

> Of course, relying on that behaviour is utterly non-portable, but if
> authors are reckless enough to use that idiom, let's do what they want.

I, for one, welcome our new \f-less overlords.  :-P

> A few days ago, a patch from <G dot Branden dot Robinson at gmail dot com>
> got committed to groff which changed .TP from using .it to using .itc,
> such that groff now supports more than one man(7) macro line in the .TP
> head if all but the last line in the head end with \c.

Technically, Bjarni Ingi Gislason proposed these changes in GNU
Savannah back in 2014.

But my hollering seems to be correlated with the commit date, so if
there's blame to be shouldered, I'll accept my share.

Regards,
Branden

--vijecthdr5745v6x
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkIqlwACgkQ0Z6cfXEm
bc5NtRAAiNQafDLm4GxRHYk82PUbLh8DtA/Raq1I9ya5LBpUgPg66Hs0y5Pa3Io8
hTfTSUbk8LirGW/TAQKnQL0D1A3Isfn8g/k0w/Ky8WNAEDGC/aMRwWebolGDeLie
FF7dXJyYQQNug2ae38pc+C6gzuiwXQ9vG35KLVrwZQxcSpLsi8FDg1vI2VnKpgCA
egm0b2RPXt4+OCbPuO0pqqCsKzJLkUdGTK6WtRr6Y26eBAt/xIcuC9JHfGY9kiRP
nN5IaaGCF0zaHRWya2guG1iabLxIEFIV8+bcUcsPXV49PSV+sPVYg0IE/RU6XZ3X
pFq2kTqnXIeFQL91n63TxYJwL6TdBGGR3ZCjkVW9/CN8wbOA9njT2w7hcDA5EJ2p
Lr7OMckJwCpBH8JMEJdoXzAEIJdHjqxw3LjhZRSgQtIUR0kwYnmNsSF4SGcB63QR
lXMYT5u/Bd4f9ZySzIIG5Umr4AmGUh/NvBUEtryi+qitYj4lKENew0KopzUeExkw
KWWuqRpstIojQiNSTCBb9RY6S870NvNb2jjk7qQzWEPkg0xdD4a5BjtG19egae7o
IIlQ5cw8IOJBEn9Fj9xzSbww/wek07CyUZQjSntpTJD9zP8lGZT9ohvN+UDNWOvD
1GZwwrvR0cYsTTeCBTLp/QlyyhwvsUeNnBND2s+eFYiUh8njFRo=
=0sgg
-----END PGP SIGNATURE-----

--vijecthdr5745v6x--


From MAILER-DAEMON Tue May 02 12:27:50 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5aeU-00073C-9G
	for mharc-groff@gnu.org; Tue, 02 May 2017 12:27:50 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57457)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5aeR-00071P-RM
	for groff@gnu.org; Tue, 02 May 2017 12:27:48 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5aeO-0008U5-Ma
	for groff@gnu.org; Tue, 02 May 2017 12:27:47 -0400
Received: from mail-yb0-x233.google.com ([2607:f8b0:4002:c09::233]:33963)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5aeO-0008TU-IL
	for groff@gnu.org; Tue, 02 May 2017 12:27:44 -0400
Received: by mail-yb0-x233.google.com with SMTP id 8so36216243ybw.1
	for <groff@gnu.org>; Tue, 02 May 2017 09:27:44 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=2v/CgnJpc6grYp/l2HTYmcrjwbRA/TQnSNh8VMZaZGs=;
	b=KkvgU8f/Ru4Ar3JyCD15UacIemWGVIhV5VEZbChnatzW5QTtf/ofYiAI9aoobYU0mU
	jY8r7RCkYzUqJNRS/qiSYjckd4b/74vmvZsFzbRfCu1qDIBdsgZKbbzb/YpON5ginYY2
	/j0/TEcJI0itE04trs8MQBVrrSlrU4qSIiDTbqY/nfa+ckguit0svZOEUpmv252Y4gHZ
	Bq+SmhgjSLng1sOD0SF7O1gRNweHYlUViot31bEF7PEF1qmI1L2zDpMlo7/sfzEVS5Uc
	R9Q4ee75hc3BXKDhKiI0eUP+bdLkEqGuoAfDccv79EjfoKCbKsO7oHvxRiWgsFKx1YpP
	Xf/Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=2v/CgnJpc6grYp/l2HTYmcrjwbRA/TQnSNh8VMZaZGs=;
	b=blG7GrGlVvzWG0REqgEOcdXmAdlOvru/f/O4M7aomZ7jyAa5tLAOQFP6NlG1h7AN4X
	+Byp4DRHxGnsSGFxz8F3oj5YdqRbgPNHNeDpaPO4C9eb6pZ2cW+CXXvQbIyheifjkwKZ
	1KfyA+ezRMU9Ik6foBNtx72UnziL7bUCp7fxPpCbQqItFep3gVPJcOtuEHMmzQ/oX9Hi
	1GiCMYS0pUaVCYY2CLkreKrVEV01P01DHWWatPu3Ko0XgFDT5GKwDKvHgroktNo+Pzy0
	pj3yQMCEDd9ytxutwnvdflpPepqvN1qt0yfnjelfNAmYaROP06KAZzV+woimqL7pCPUI
	Z+LA==
X-Gm-Message-State: AN3rC/76EBKQFmONKob3wUfM+Uv1M7r/DCUKqt3L9dVAcFT7G+JcvG4z
	OJrsVoJcBhN5ffuUfz0=
X-Received: by 10.37.192.79 with SMTP id c76mr25877726ybf.69.1493742463593;
	Tue, 02 May 2017 09:27:43 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	v207sm8046557ywa.45.2017.05.02.09.27.42 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 02 May 2017 09:27:42 -0700 (PDT)
Date: Tue, 2 May 2017 12:27:40 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170502162738.i7cbwcksnqlctbmq@crack.deadbeast.net>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="qdtxpicpuuz33w2w"
Content-Disposition: inline
In-Reply-To: <201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::233
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 16:27:49 -0000


--qdtxpicpuuz33w2w
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hi Doug,

You didn't quote to whom you're responding so I may be a little
confused.

At 2017-05-01T22:06:38-0400, Doug McIlroy wrote:
> Originally \(pl and \(mi came from a fixed font (S) while + and \-
> came from the current font.

Yes, I believe you're correct, going by CSTR #54.  (And, of course, you
were there, and I was in diapers.)

> As I understand your comment, groff has reversed this troff
> convention. Additionally groff interprets - as a compromise
> HYPHEN-MINUS.

I don't understand Ingo to be proposing to make either of these
statements true.

Ingo's proposal would not mandate that + and \- come from the special
font.

It also would not mandate that \(pl and \(mi come from the current font.

Am I misunderstanding something?

Regards,
Branden

--qdtxpicpuuz33w2w
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkIs2wACgkQ0Z6cfXEm
bc535Q/+M8waFfurRQYlA9y6mQHOzIcQzSmpAW11ba8i2ROHbFwFHplUaHW3yXPk
JSBF3svWaWudgmLeoHYOqXvJHDTHfmGQ8n/g1DqbnPx7f9eXF1h7dUtanROExBQN
m9p7kYhYMM+8AGUCZ2S6cRR2HmV6HA/PHfd9GJjsAhD+/4HLLwW5FuBq/n0Q4gaG
tC2fUgmK3npZ9cg560vF2pdbGo2Bf+T87RH/fwKgKqYzOSysC/OZ0Zr9VlKBBKJC
bwom12lHsWedDu7cxU1tquJXAsRmrnEI0r4jL9csqiaZfSH32uym33LEgYnULy9p
4QDKwgiIYYiX/SNDgw1rK8r9d44fdPbpQFgbW0G/cFYSNMxmJQ+R4vX0OUCmCCgP
cz/c2rVWQXog/dlw7AsiIzlSnonZqL2ok/d3dWF1SkaIydmGIeylusz9bI8v+g8/
7TBn55mniphBJLUadh4ef6EgDK32ZFqOqAsZtpoLXlBrk9tT7ZvultOzEGkGXb0h
n/hewVra2oyos1ikTbOl6cHz9Z42/+Qd9ZC1lsPYEj3wt5/PfhKGNfXNmCSdcGlQ
imo55GrG9yxiNQ9HJ1mM5w1E6cGXIjTKmEoEG+LBEuyMIfQeGvwViBxrZX1WgEBj
MIqC0W0fKtTeceO/AxKaEQGCWQHjRF5ZQHE5PTYJIP9iw/VLDq8=
=v58L
-----END PGP SIGNATURE-----

--qdtxpicpuuz33w2w--


From MAILER-DAEMON Tue May 02 12:34:59 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5alP-0002dt-Ae
	for mharc-groff@gnu.org; Tue, 02 May 2017 12:34:59 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59572)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5alM-0002cq-Qp
	for groff@gnu.org; Tue, 02 May 2017 12:34:57 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5alL-0006LB-Tx
	for groff@gnu.org; Tue, 02 May 2017 12:34:56 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:40836)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5alL-0006IZ-OU
	for groff@gnu.org; Tue, 02 May 2017 12:34:55 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d5alH-0007vS-IY; Tue, 02 May 2017 18:34:52 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d5alG-0002yR-OS; Tue, 02 May 2017 18:34:50 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d5alG-0000Do-KJ; Tue, 02 May 2017 18:34:50 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id b5596c37;
	Tue, 2 May 2017 18:34:50 +0200 (CEST)
Date: Tue, 2 May 2017 18:34:50 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170502163450.GC19813@athene.usta.de>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
	<20170502154853.hwdhmc67ydwt6mgs@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170502154853.hwdhmc67ydwt6mgs@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 16:34:57 -0000

Hi,

G. Branden Robinson wrote on Tue, May 02, 2017 at 11:48:56AM -0400:

> Note that the commits also affected the .SH, .SS, .B, .I, .SM, and .SB
> macros as well.  Basically it affected anything that set an input trap.

True.  What i committed to mandoc(1) so far only adjusts the block
macros (that is, .SH, .SS, .TP).  For those, the formatting damage
is most severe when \c is used in the way in question: The second
macro line that is intended for the head ends up in the body of the
block, see the Solaris example that i posted.

But you are right that i should probably adjust the in-line macros
(that is, .B, .I, .SM, .SB) as well, even though for them, the
damage is minor, wrong font at the worst - and even that is unlikely
to happen in practice, because why would anybody do something like

.B
three \c
bold \c
words
and then back to the default font.

rather than simply

.B three bold words
and then back to the default font.

?

I really hope that in manual pages, nobody does stunts like

.TH TEST 1 2017-05-02
.SH NAME
test \- descr
.SH DESCRIPTION
.B
three \c
.gcolor red
bold \c
.gcolor
words
and then back to the default font.

> Technically, Bjarni Ingi Gislason proposed these changes in GNU
> Savannah back in 2014.

True, sorry for forgetting that information in the commit message.

> But my hollering seems to be correlated with the commit date,
> so if there's blame to be shouldered, I'll accept my share.

Right, credit where credit is due, or blame where blame is due,
that is the question...  ;-)

Yours,
  Ingo


From MAILER-DAEMON Tue May 02 12:47:58 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5axy-0005Qa-AD
	for mharc-groff@gnu.org; Tue, 02 May 2017 12:47:58 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35917)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5axr-0005LG-Cr
	for groff@gnu.org; Tue, 02 May 2017 12:47:57 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5axo-0004sw-9C
	for groff@gnu.org; Tue, 02 May 2017 12:47:51 -0400
Received: from mail-yw0-x233.google.com ([2607:f8b0:4002:c05::233]:34797)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5axo-0004sS-5J
	for groff@gnu.org; Tue, 02 May 2017 12:47:48 -0400
Received: by mail-yw0-x233.google.com with SMTP id k11so72570733ywb.1
	for <groff@gnu.org>; Tue, 02 May 2017 09:47:48 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=eLC4nd2NOEB4UxNXnXxCzD9FyUgoSqsw0AlMEB92aU0=;
	b=I3cr1pENmkh/OBRvrEj2wZcNNTxeXW/3IWUpphOJTCYKP3LBDJUSla2kYsrcm70Its
	FFvlN9HuMkL90DsqQpi1zbvok3N+egGsaVZQXHFPXHoQ0o8Ky9MJJngrd2NxMZeVIosI
	rtXU7YwqukHqvSYkyqZMtT0rQHpobrUQaxPrhppJ/Rcpa2Xui9zai8Lv2XhN+n1wVKwz
	gFO0298lWlQ5B3+mT6GXJ9ancDKoODz4K6DCbSz94xI1+dheie83cHM7J8tNFlNiLvQR
	kVVxJ5N2gFLXIzT1I3muDt6v0TfUHHrdfk2WdU7YfmcFyIs+zv6Rlrv4GNZt9yyt4snU
	jVlA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=eLC4nd2NOEB4UxNXnXxCzD9FyUgoSqsw0AlMEB92aU0=;
	b=OTCpkBMiSh/elCmj5f9xYlsBxNxZUFJCmU+A5b/H6CzuyC1uUqPOlMjW/BPsSp27G5
	d/D7qSxqo0JgbXI40q9jBwY4Tpys759yOHnNRBuK/xCa14b8wOaWDMVuLDAqWw7xWVeI
	YaZOmM9n+zKZdVZlbLUOf/OAoeYVOUBVzNoQtEYS3+MCWaMIr5XVravQO332igw2xyMM
	Hh26ygbeuIREHN5GXdoaKMfjrIAMJ+pcdHyN8LYZAAPLoIeVjpxtSqtggxaf41MXo2m/
	BvLx/qOIRDpLaLbG2ltd1tyqKBB8UJnsA8uHKRVqdg0uyf5CtKgng7EyXhqOC9Avqvy9
	hWgg==
X-Gm-Message-State: AN3rC/4NmgSuZodgoUN8yogGBtMIWnAnlj7VrKhYi0NDbtH7Ox1QUDt+
	eSliTjQtE3QZDvpQBuc=
X-Received: by 10.13.248.193 with SMTP id i184mr25120958ywf.88.1493743667039; 
	Tue, 02 May 2017 09:47:47 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	a10sm4100398ywa.24.2017.05.02.09.47.45 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 02 May 2017 09:47:45 -0700 (PDT)
Date: Tue, 2 May 2017 12:47:43 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170502164741.b3iqub6jmj3zjknq@crack.deadbeast.net>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
	<20170502154853.hwdhmc67ydwt6mgs@crack.deadbeast.net>
	<20170502163450.GC19813@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="ha6e4i5cfrbbjqrv"
Content-Disposition: inline
In-Reply-To: <20170502163450.GC19813@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::233
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 16:47:57 -0000


--ha6e4i5cfrbbjqrv
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-02T18:34:50+0200, Ingo Schwarze wrote:
> But you are right that i should probably adjust the in-line macros
> (that is, .B, .I, .SM, .SB) as well, even though for them, the
> damage is minor, wrong font at the worst - and even that is unlikely
> to happen in practice, because why would anybody do something like
>=20
> .B
> three \c
> bold \c
> words
> and then back to the default font.
>=20
> rather than simply
>=20
> .B three bold words
> and then back to the default font.
>=20
> ?

Or even

=2EB
three bold words

> I really hope that in manual pages, nobody does stunts like
>=20
> .TH TEST 1 2017-05-02
> .SH NAME
> test \- descr
> .SH DESCRIPTION
> .B
> three \c
> .gcolor red
> bold \c
> .gcolor
> words
> and then back to the default font.

On my (Debian stretch) system, no one uses .gcolor requests in _any_ man
page--thank God.

find /usr/share/man/man* -type f -and -not -type l | xargs zgrep
'^\.\s*gcolor'

$ find /usr/share/man/man* -type f -and -not -type l \
	| xargs zgrep '^\.\s*gcolor' || echo none
none

Regards,
Branden

--ha6e4i5cfrbbjqrv
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkIuCQACgkQ0Z6cfXEm
bc4czA//VIe1gaLfvKy57bRRUZJ5bxb8j31b2EOhqP+x7qDIp/+6ytouVNgCV6F7
RquJfObqH3SA6YlhkDVpuIB3UDR704ohgcZvELsMGFj+BcORcH22f89cFa+VH//D
Wtj8ShOQRKPepQDixb5P1ofFdctRCRtAS10nMQZja6qCujhYLcXHzJQKehJmzrRY
fJJAOrdIVBHJaLP8VjA+kAAzu1b0LzIp+tobgp+p1N7qcZNy3d2NSD4js/b+EnBI
Yc7o0dQMeLp6mfMXUyCh7VmIaaOhD2ZUXCBKDpySqLHXw5fajT6C1/WZR2MqLvjg
tXLM6VOKMTWLnblbYoia6rve+h3uH/BftzfeBtAdreq474r7Rjr5hfLASkYUA+jN
Dt3eIrKsr39ucsdp7J59OaGt3nXZlA23wwFPwHgHDV/tpOLc/L/Izgpg/VGULy0w
outlD1afPRvqAqe/691NjQVKqQzBiePHk3d6SOQS7lD68Fjb3GGdHVc4+3CKggRY
j/NvM+64GfgFUsIL0Bfi7tV59ScLqsOkZcaa740x/R+Yu7W4jhYolUFOErNDTY1v
GfbrD7dZcbWzQke7rsPWqd2cgb8FW/N/qL3sYlMZBHlDoYOE34Qd3VSJbe9X9OIS
DzIpIkjftb08sIFmKh10OOSNvCmoYk6YnxDJbRCgi6Blcw43mKg=
=nZiF
-----END PGP SIGNATURE-----

--ha6e4i5cfrbbjqrv--


From MAILER-DAEMON Tue May 02 13:22:15 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5bV9-0007ka-0C
	for mharc-groff@gnu.org; Tue, 02 May 2017 13:22:15 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:46607)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5bV6-0007jQ-MM
	for groff@gnu.org; Tue, 02 May 2017 13:22:14 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d5bV5-0007LL-6b
	for groff@gnu.org; Tue, 02 May 2017 13:22:12 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:55949)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d5bV4-0007IT-Jv
	for groff@gnu.org; Tue, 02 May 2017 13:22:11 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>) id 1d5bV1-0006CB-4A
	for groff@gnu.org; Tue, 02 May 2017 19:22:08 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>) id 1d5bV0-0004jd-SJ
	for groff@gnu.org; Tue, 02 May 2017 19:22:06 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>) id 1d5bV0-000184-Ma
	for groff@gnu.org; Tue, 02 May 2017 19:22:06 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id cb3ac3a8
	for <groff@gnu.org>; Tue, 2 May 2017 19:22:06 +0200 (CEST)
Date: Tue, 2 May 2017 19:22:06 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20170502172206.GD19813@athene.usta.de>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
	<20170502095031.9WWos%steffen@sdaoden.eu>
	<20170502134501.GA19813@athene.usta.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170502134501.GA19813@athene.usta.de>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 17:22:14 -0000

Hi,

Ingo Schwarze wrote on Tue, May 02, 2017 at 03:45:01PM +0200:

> By the way, in the meantime, i also received support from NetBSD/pkgsrc
> for my proposal (\- always U+002D, \(mi always U+2212).  That's
> Ralph, Branden, NetBSD/pkgsrc, and one relevant FreeBSD developer
> then, and no protest so far from OpenBSD.  I think i'll start
> preparing patches and submit them to the groff bugtracker when they
> are ready.

Let's do that in slow, careful steps.

I just submitted the first, less intrusive patch:

  https://savannah.gnu.org/bugs/index.php?50917
  Make \- consistently render as U+002D across all macro sets and devices

For easy access, i'm also appending the patch below.

See the bug notes for remarks regarding non-UTF-8 output devices.

Comments are welcome, and if consensus emerges, so is a commit.

After that, i would then move on to the next step and submit a patch
to always render unescaped "-" as U+2010 HYPHEN.  Of course, it would
be OK to accept this first patch but reject or delay that second one.

Yours,
  Ingo



diff --git a/font/devutf8/NOTES b/font/devutf8/NOTES
index 8e724703..cd997ac2 100644
--- a/font/devutf8/NOTES
+++ b/font/devutf8/NOTES
@@ -6,9 +6,10 @@ Kernighan) is unmapped:
 
   bs    shaded solid ball (Bell System logo, AT&T logo)
 
-Character 0x002D has not been given a name because its Unicode name
-HYPHEN-MINUS is so ambiguous that it is unusable for serious typographic
-use.
+Even though its Unicode name HYPHEN-MINUS is so ambiguous that it
+is unusable for serious typographic use, the character 0x002D is
+needed to describe the syntax of many programming languages and to
+represent code samples.  It can be obtained with `\-'.
 
 \[wp] has been mapped to 0x2118, because according to Unicode 4.1's
 NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass `p',
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index e38c70b9..a77ca08c 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -279,6 +279,9 @@ hyphen (Unicode u2010).
 The same output glyph can be requested explicitly
 with \[oq]\f(CW\e(hy\fP\[cq].
 A minus sign can be obtained with \[oq]\f(CW\e(mi\fP\[cq] (Unicode u2212).
+To describe programming language syntax or present code samples,
+the original character can be obtained
+with \[oq]\f(CW\e-\fP\[cq] (Unicode u002D).
 .
 .
 .TP
@@ -315,6 +318,7 @@ _
 \[char43]	\[char43]	43	plus	u002B	plus
 \[char44]	\[char44]	44	comma	u002C	comma
 \[char45]	\[char45]	45	hyphen	u2010	hyphen
+\-	\e-		minus	u002D	hyphen-minus
 \[char46]	\[char46]	46	period	u002E	period, dot
 \[char47]	\[char47]	47	slash	u002F	slash
 \[char58]	\[char58]	58	colon	u003A	colon
@@ -753,6 +757,7 @@ _
 \[r?]	\e[r?]	questiondown	u00BF	inverted question mark
 \[em]	\e[em]	emdash	u2014	em-dash symbol +
 \[en]	\e[en]	endash	u2013	en-dash symbol
+\-	\e-	minus	u002D	ASCII hyphen-minus +
 \[hy]	\e[hy]	hyphen	u2010	hyphen symbol +
 .TE
 .ad
diff --git a/src/libs/libgroff/glyphuni.cpp b/src/libs/libgroff/glyphuni.cpp
index 62c81654..c94a37f8 100644
--- a/src/libs/libgroff/glyphuni.cpp
+++ b/src/libs/libgroff/glyphuni.cpp
@@ -55,6 +55,7 @@ struct S {
   { "+", "002B" },
   { "pl", "002B" },
   { ",", "002C" },
+  { "\\-", "002D" },
   { ".", "002E" },
   { "/", "002F" },
   { "sl", "002F" },
@@ -397,11 +398,6 @@ struct S {
   { "product", "220F" },
   { "coproduct", "2210" },
   { "sum", "2211" },
-  // `mi' and `\-' represent a MINUS sign.  But it is used in many man pages
-  // to denote the U+002D character that introduces a command-line option. 
-  // For devices that support copy&paste, such as devhtml and devutf8, the
-  // user can apply the workaround described in the PROBLEMS file.
-  { "\\-", "2212" },
   { "mi", "2212" },
   { "-+", "2213" },
   { "**", "2217" },
diff --git a/src/libs/libgroff/uniglyph.cpp b/src/libs/libgroff/uniglyph.cpp
index 3fafb225..2c773b8b 100644
--- a/src/libs/libgroff/uniglyph.cpp
+++ b/src/libs/libgroff/uniglyph.cpp
@@ -52,6 +52,7 @@ struct S {
 //{ "002B", "+" },
   { "002B", "pl" },
   { "002C", "," },
+  { "002D", "\\-" },
   { "002E", "." },
 //{ "002F", "/" },
   { "002F", "sl" },
@@ -390,7 +391,6 @@ struct S {
   { "2210", "coproduct" },
   { "2211", "sum" },
   { "2212", "mi" },
-//{ "2212", "\\-" },
   { "2213", "-+" },
   { "2217", "**" },
   { "221A", "sr" },
diff --git a/tmac/an-old.tmac b/tmac/an-old.tmac
index 1091e3d2..199baccd 100644
--- a/tmac/an-old.tmac
+++ b/tmac/an-old.tmac
@@ -676,9 +676,8 @@
 .\" of easy cut and paste.
 .
 .if '\*[.T]'utf8' \{\
-.  rchar \- - ' `
+.  rchar - ' `
 .
-.  char \- \N'45'
 .  char  - \N'45'
 .  char  ' \N'39'
 .  char  ` \N'96'
diff --git a/tmac/doc.tmac-u b/tmac/doc.tmac-u
index 8b7ad4cb..01eff136 100644
--- a/tmac/doc.tmac-u
+++ b/tmac/doc.tmac-u
@@ -6550,9 +6550,8 @@
 .\" of easy cut and paste.
 .
 .if '\*[.T]'utf8' \{\
-.  rchar \- - ' `
+.  rchar - ' `
 .
-.  char \- \N'45'
 .  char  - \N'45'
 .  char  ' \N'39'
 .  char  ` \N'96'
diff --git a/PROBLEMS b/PROBLEMS
index e0f1239a..c97f96f5 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -107,7 +107,6 @@ those characters back to the ASCII characters, insert the following
 code snippet into the `troffrc' configuration file:
 
 .if '\*[.T]'utf8' \{\
-.  char \- \N'45'
 .  char  - \N'45'
 .  char  ' \N'39'
 .\}


From MAILER-DAEMON Tue May 02 13:48:06 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5buA-0005Tp-Pg
	for mharc-groff@gnu.org; Tue, 02 May 2017 13:48:06 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:53471)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bjarniig@hi.is>) id 1d5bu8-0005Tb-D5
	for groff@gnu.org; Tue, 02 May 2017 13:48:05 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bjarniig@hi.is>) id 1d5bu7-0007SL-Bs
	for groff@gnu.org; Tue, 02 May 2017 13:48:04 -0400
Received: from mx1.hi.is ([2a00:c88:4000:1650::165:103]:46674)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <bjarniig@hi.is>) id 1d5bu6-0007Ny-Vo
	for groff@gnu.org; Tue, 02 May 2017 13:48:03 -0400
Received: from hekla.rhi.hi.is (hekla.rhi.hi.is
	[IPv6:2a00:c88:4000:1650::165:2])
	by mx1.hi.is (8.14.7/8.14.7) with ESMTP id v42Hlpvj025754
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256
	verify=NO); Tue, 2 May 2017 17:47:53 GMT
Received: from hekla.rhi.hi.is (localhost [127.0.0.1])
	by hekla.rhi.hi.is (8.14.4/8.14.4) with ESMTP id v42Hlpkf018749;
	Tue, 2 May 2017 17:47:51 GMT
Received: (from bjarniig@localhost)
	by hekla.rhi.hi.is (8.14.4/8.14.4/Submit) id v42HloBt018702;
	Tue, 2 May 2017 17:47:50 GMT
Date: Tue, 2 May 2017 17:47:50 +0000
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170502174750.GA8003@rhi.hi.is>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
User-Agent: Mutt/1.5.20 (2009-12-10)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:c88:4000:1650::165:103
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 17:48:05 -0000

On Sat, Apr 29, 2017 at 06:25:29AM -0400, G. Branden Robinson wrote:
> Any advice on how I can improve this?  (I'll take "no, don't even try to
> do this" as read, from those who hate man(7). ;-) )
> 

  You did not check the macro for errors (correctness, portability)!

> This is a private macro, not something I'm proposing as an extension to
> any macro package.
> 
> .\" The bold italic font is not accessible via the man macro package.
> .de BOLD-ITALIC
> .  ie d an-trap \       \" Groff and Heirloom troff have this diversion.
> .    ie F BI \{\        \" Is the font available?
> .    itc 1 an-trap      \" Set input trap for the next logical line.
> .    ft BI              \" Use the font.
> .    if \\n[.$] \&\\$*  \" Emit any arguments.
> .    \}
> .    el \&\\$*          \" Otherwise, simply emit arguments.
> .  el \&\\$*            \" Dupe because "&" cannot be used in if clauses.
> ..
> 
[...]

-- 
Bjarni I. Gislason


From MAILER-DAEMON Tue May 02 13:53:53 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5bzl-0006S4-Cy
	for mharc-groff@gnu.org; Tue, 02 May 2017 13:53:53 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54580)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5bzi-0006Rw-Vf
	for groff@gnu.org; Tue, 02 May 2017 13:53:52 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5bzf-0003ue-SY
	for groff@gnu.org; Tue, 02 May 2017 13:53:51 -0400
Received: from sdaoden.eu ([217.144.132.164]:39274)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5bzf-0003r7-Hz
	for groff@gnu.org; Tue, 02 May 2017 13:53:47 -0400
Received: by sdaoden.eu (Postfix, from userid 1000)
	id 68C7716056; Tue,  2 May 2017 19:53:42 +0200 (CEST)
Date: Tue, 02 May 2017 19:54:38 +0200
From: Steffen Nurpmeso <steffen@sdaoden.eu>
To: Ingo Schwarze <schwarze@usta.de>
Cc: groff@gnu.org
Message-ID: <20170502175438.Jw78d%steffen@sdaoden.eu>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
	<20170502095031.9WWos%steffen@sdaoden.eu>
	<20170502134501.GA19813@athene.usta.de>
In-Reply-To: <20170502134501.GA19813@athene.usta.de>
Mail-Followup-To: Ingo Schwarze <schwarze@usta.de>, groff@gnu.org
User-Agent: s-nail v14.9.0-pre4-37-gf921ae51
OpenPGP: id=232C220BCB5690A37BD22FFDEB66022795F382CE;
	url=https://www.sdaoden.eu/downloads/steffen.asc
BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in
	the world can make no bugs.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 217.144.132.164
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 17:53:52 -0000

Ingo Schwarze <schwarze@usta.de> wrote:
 |Steffen Nurpmeso wrote on Tue, May 02, 2017 at 11:50:31AM +0200:
 |> I now think it is better to revert all those per-macro adjustments
 |> altogether and be pure; if people use \- to get "nicer" (smoother
 |> and finer that is) output then pasting from manual is simply
 |> impossible.
 |
 |That is clearly the worst suggestion so far.  It is not just a

No, it is not.  Noone at all complained when thousands of lines of
rather or completely messed up stuff came into this software after
~2005, and i want to point out that several dozen pages of text
have been emitted to this list on the question whether \- should
be pastable or not.  My, that is me who has nothing countable in
the groff source, which is a pity, my first two sentences of this
thread were, and that is all about it

  I use U+002D hyphen-minus.  The minus sign is a mathematical
  symbol, i would say.

 |matter of "if (some) people".  Take, for example, mdoc(7).  It has
 |been enforcing \- for .Fl since its inception in 4.3BSD-Reno in
 |1990, and that wasn't a new choice even though man(7) does not

Noone at all seems to have been interested to give her some
feedback, look over the rim of his tea cup and enter a discussion,
otherwise we possibly would also have nice -idx options to several
commands.  Then you can't paste it, period.  Add or use the local
macro package to warp that to hyphen-minus upon request, that is
my opinion.

 |enforce rendering of command line options in any particular way,
 |but leaves the choice to the author; but standard practice, in
 |man(7) as well, has been to use \- for command line options since
 |the first release of man(7) in Version 7 AT&T UNIX in 1979.  And
 |that made sense at the time because the minus sign was ASCII 0x2d
 |in nroff(1), you couldn't cut and paste from a manual printed on
 |paper, and the distinction between Unicode U+002D HYPHEN-MINUS and
 |U+2212 MINUS SIGN did not yet exist.

But i think there were already font slots for graphical symbols
that could be addressed, right?  No, they surely have had lust,
coming back from playing Spacewar or SpaceInvaders or so, and have
some nicer graphical symbol.  That is not en par but just like the
one who drives a up to 60l/100km Ferrari because he gives a s..t.
The guys who are really used to the stuff and penetrated it do
things like

  .SH NAME
  deroff, delatex \- remove formatting requests
  .SH SYNOPSIS

I think he does this either because he and everybody else is used
to that for a long time.  I would prefer U+2014 EM DASH, my
PDF-to-text of the POSIX standard ends up with that one.

  The options are
  .TP
  .B -w

  .B Fhdr.next
  fields) of all currently open headers
  (see
  .I symopen
  in
  .IR mach-symbol (3)).

That is absolutely pastable, whether UTF-8 or not.
(I don't count myself among them, as i have sacrificed the good
for the bad, e.g., style for content, much too often myself.  But
now i am here, and i think that is better.)

 |So you propose that we break copy and paste from more or less all
 |manual pages now (including in -Tutf8 output which is the default
 |on terminals in many systems at this point), even though it has
 |been working just fine for almost 40 years?  You must be jesting.
 |
 |No, making the decision at this point in time that \- has to
 |consistently render as U+2212 MINUS SIGN is not an option at all.
 |That's one half of the reason why i suggested to make it render
 |consistently as U+002D HYPHEN-MINUS.
 |
 |> Distributions like Debian can then still easily apply
 |> remappings at well-known places and document it in their
 |> guidelines.
 |
 |So groff should do something that is unusable and ask downstream
 |distributions to fix it up to make it useable?  That guarantees
 |utter confusion and doesn't make any sense whatsoever.  What are
 |other formatters (like mandoc) supposed to do?  Mandoc doesn't even
 |have the distinction of "upstream" and "distribution" to implement
 |such a split in behavior.  Both FreeBSD and OpenBSD use the mandoc
 |code directly from the HEAD of the VCS.

I think a growing number of Linux distributions will follow.
Mandoc is faster and can even markdown now.  I cannot talk for
groff.

 |By the way, in the meantime, i also received support from NetBSD/pkgsrc
 |for my proposal (\- always U+002D, \(mi always U+2212).  That's
 |Ralph, Branden, NetBSD/pkgsrc, and one relevant FreeBSD developer
 |then, and no protest so far from OpenBSD.  I think i'll start
 |preparing patches and submit them to the groff bugtracker when they
 |are ready.

You are free to do whatever you want, of course.  I don't know
actually what i will do when i finally have time for my own roff
clone, i for myself have found what i think is a Solaris stdio bug
as well as a OpenBSD 6.1 grep(1) bug as well what i think is
a OpenBSD 6.0 make bug, but that i won't figure out no more, since
yesterday, and have seen fly by changesets which at least
partially revert Bern commits, a work i have done when
i synchronized my roff clone some years ago, hopefully ok, without
having the possibility to step any further yet with that piece of
metal in my side that my MUA was and in parts still is, -- where
is he, by the way, i hope he is well! --, so _that_is a real mess!

But roff documents \- as the minus sign and if the charset
/ font makes available the minus sign as a graphical symbol and
the writer has chosen to use a graphical symbol then i think she
or he should get a graphical symbol, whether it can be pasted onto
a command line or not.

--steffen
|Soylent Green is people!


From MAILER-DAEMON Tue May 02 19:02:53 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5gon-00037m-Cw
	for mharc-groff@gnu.org; Tue, 02 May 2017 19:02:53 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59290)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5gol-00037f-Ra
	for groff@gnu.org; Tue, 02 May 2017 19:02:52 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5gog-0006D8-U5
	for groff@gnu.org; Tue, 02 May 2017 19:02:51 -0400
Received: from mail-yb0-x22d.google.com ([2607:f8b0:4002:c09::22d]:33435)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5gog-0006Cx-P2
	for groff@gnu.org; Tue, 02 May 2017 19:02:46 -0400
Received: by mail-yb0-x22d.google.com with SMTP id j17so12141218ybj.0
	for <groff@gnu.org>; Tue, 02 May 2017 16:02:46 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=ZY3upmZ+JwpSq5jMe+WaA2ysOuZWj2xnkqJkImZ9hdY=;
	b=sIer7s5Wrw2IGzONw5d3xT2iA7/bcj6tbyGjxiNabyT2GSeFOTOYw9NO7hl1nqwNIH
	o+PD6jLE7Tvgv5ktu84E2HDl/uVNOZxpKwJeRSmWP4cTP2iENlvkunIrO1C5pr7+E2kn
	2fesDE9eNniT+xlnuw8msdBVAbj62w2BQ9Dg54gVOIOf5dbLfq9ExGQi4TZs8wJbyFY6
	Iek9Biz/avvS60NKSfSAwNAIbsOPkShKB7mo97QFsfKL1z9PXGCIAF+wCGiuaPzdu6o1
	bWV/GzOFDbRnMdrFIw89Jeu7/QASXUhSYZBphpwQcSAn8jUF5w8X8TRV7T/ng8JTsOLY
	L30A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=ZY3upmZ+JwpSq5jMe+WaA2ysOuZWj2xnkqJkImZ9hdY=;
	b=cXnpGRa9w0pDRN0G+cP3TGRcYHZ5t8Om/GUQg5FwM0sQL71Wj4MWnEPttySgFswXZ7
	ooRho4TDQZk1gpx/8DRTffzSAf2unEh9ZERjMVkrKkB/Ne0PG6epA/6sqCa4afzGyLhc
	lLmiBSY0DEkr1UpgwLI6fuAVnFGKDkbnXxMB5ZyP8Nk4bDTVtw7kCfyeNXnYUaGYTNnw
	D5kEncjdlIa2EKwy0p3zmzCL28vOx1psTKkEs/Fz8RLA3qvJIXqOdTwnFHfz1pER6vqZ
	GqaD0YbnyKDuAvQAfYexV4mVcBpxhFlkVppZxAKFw2FSig1BwyI5c0qmcmifKy1GBJZN
	SbOA==
X-Gm-Message-State: AN3rC/5GpF8l0tJ0ZVNMP+um/JrYeucpr7WBD7nsMN08oXkTzYhnERUF
	wgHP2jdn8b81CoFqJmM=
X-Received: by 10.37.173.80 with SMTP id l16mr27740845ybe.155.1493766165781;
	Tue, 02 May 2017 16:02:45 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100])
	by smtp.gmail.com with ESMTPSA id z7sm8566302ywz.46.2017.05.02.16.02.44
	for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 02 May 2017 16:02:44 -0700 (PDT)
Date: Tue, 2 May 2017 19:02:42 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="bae2mjgwlgmi3kmt"
Content-Disposition: inline
In-Reply-To: <20170502174750.GA8003@rhi.hi.is>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::22d
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2017 23:02:53 -0000


--bae2mjgwlgmi3kmt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-02T17:47:50+0000, Bjarni Ingi Gislason wrote:
> On Sat, Apr 29, 2017 at 06:25:29AM -0400, G. Branden Robinson wrote:
> > Any advice on how I can improve this?  (I'll take "no, don't even try to
> > do this" as read, from those who hate man(7). ;-) )
> >=20
>=20
>   You did not check the macro for errors (correctness, portability)!

Okay.  I neither require nor parse arguments, so I don't need to
validate them, I don't think.

The .itc request is a groff extension so an additional layer of

=2Eie \(.g

could be added.

Anything else?

Regards,
Branden

--bae2mjgwlgmi3kmt
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkJEAgACgkQ0Z6cfXEm
bc7XVQ//dqt+vxwbrLyki03Bt3YMw4TiHUDT1Q2Q2HQWBdpshuaOYyMVdeF2ouZQ
JjdrO4r4B2emQQC+bBXvPb13cPRaeDy6R+/K5NVLStR3Of7cmZ5a32God83p/tkm
nbxSNIg86G7bl7K0ysqSlBqtDaiqcUKkuftz719FBKNBwxS5LrHj6iIshdgpdJw0
2oXm7mZwdIb1k7dZKuTxgpSbuHLNcfqPOCEUBcsbBjNt2RNMe39X9tD8brUlDjVM
g0jMVeHuwUtdg+daKS8SM0TDFRUoW+6RXWTjMNfn7Ydm7M8p6X1WQWSlnDNZEbTj
PzSf6dkOYiI9rBbuz9xJvqvG5e53GCm42HwS7prsxDqscr4RORvrOIq2+z2TYvv3
qEUlMnew+cj+RBDymQejmnNCkwUhb7s3U57rpNv+eRuJn2KXLZ4D/qZ/OF7dknLa
ChS8hZzUVuTjJJHaDfVR86iY+eKdoyk1ujxFHdLg7UPcXNsOlT36dOSVcabfHKs7
UUmoaqA6mBm9EPve/bCQ0JD0kZg/QAnSzjkPyL+vU1Y0RDYfILbgSq5cnwl+U8Qw
Kef6IZnWPHM374N1smiCwI6ODc4JtU9knkKMaY+ZPTOb7vICcx8i+i3oS+gBvda8
p82dnKGjBTr6sPgsqhiREfOD4PbAq3oPU3SAme4hfU2AjvQpvEA=
=DJ37
-----END PGP SIGNATURE-----

--bae2mjgwlgmi3kmt--


From MAILER-DAEMON Tue May 02 21:29:49 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5j6z-0000lB-N4
	for mharc-groff@gnu.org; Tue, 02 May 2017 21:29:49 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35445)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5j6w-0000ku-N4
	for groff@gnu.org; Tue, 02 May 2017 21:29:47 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d5j6r-0001zp-OA
	for groff@gnu.org; Tue, 02 May 2017 21:29:46 -0400
Received: from mail.cs.dartmouth.edu ([129.170.212.100]:57742)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <doug@cs.dartmouth.edu>)
	id 1d5j6r-0001zl-Kv
	for groff@gnu.org; Tue, 02 May 2017 21:29:41 -0400
Received: from coolidge.cs.Dartmouth.EDU (coolidge.cs.dartmouth.edu
	[129.170.213.217])
	by mail.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTPS id v431TeIk019706
	(version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO)
	for <groff@gnu.org>; Tue, 2 May 2017 21:29:40 -0400
Received: from coolidge.cs.Dartmouth.EDU (localhost.localdomain [127.0.0.1])
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTP id
	v431TeB6004633 for <groff@gnu.org>; Tue, 2 May 2017 21:29:40 -0400
Received: (from doug@localhost)
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2/Submit) id v431TdUT004632
	for groff@gnu.org; Tue, 2 May 2017 21:29:39 -0400
From: Doug McIlroy <doug@cs.dartmouth.edu>
Message-Id: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
Date: Tue, 02 May 2017 21:29:39 -0400
To: groff@gnu.org
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 129.170.212.100
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 01:29:47 -0000


Branden wrote

Ingo's proposal would not mandate that + and \- come from the special
font.

It also would not mandate that \(pl and \(mi come from the current font.


------

I was previously told that \(mi is the true minus sign. But the
true minus sign, at least in my mind, must come from the current
font, so that it comes out right wherever it occurs, even in a
bold headline like "Fairbanks shivers at -50".


I'll buy Branden's  first assertion, but if + and \- come from the
current font as they originally did, and \(pl and \(mi come
from the the current font per the previous paragraph, they
become redundant.

So I remain confused.

Doug


From MAILER-DAEMON Wed May 03 06:27:27 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5rVH-00059E-FY
	for mharc-groff@gnu.org; Wed, 03 May 2017 06:27:27 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54042)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5rVD-000589-Tt
	for groff@gnu.org; Wed, 03 May 2017 06:27:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5rVA-0002f6-QZ
	for groff@gnu.org; Wed, 03 May 2017 06:27:23 -0400
Received: from relay01.pair.com ([209.68.5.15]:38830)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d5rVA-0002df-Li
	for groff@gnu.org; Wed, 03 May 2017 06:27:20 -0400
Received: from orac.inputplus.co.uk (241.198.189.80.dyn.plus.net
	[80.189.198.241])
	by relay01.pair.com (Postfix) with ESMTP id BEA26D00B2D;
	Wed,  3 May 2017 06:27:15 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id DBA3E2156F;
	Wed,  3 May 2017 11:27:14 +0100 (BST)
To: Doug McIlroy <doug@cs.dartmouth.edu>
cc: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
References: <201705012255.v41MtJ6k022190@tahoe.cs.Dartmouth.EDU>
	<20170501231616.GH28290@athene.usta.de>
	<201705020206.v4226cps025884@coolidge.cs.Dartmouth.EDU>
Date: Wed, 03 May 2017 11:27:14 +0100
Message-Id: <20170503102714.DBA3E2156F@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] : ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 10:27:26 -0000

Hi Doug,

> Originally \(pl and \(mi came from a fixed font (S) while + and \-
> came from the current font.

That matches CSTR 54 which has

    \-    Minus sign in the current font

in the table near the beginning and \(pl and \(mi as `Special Character
Names' on the last page.

> As I understand your comment, groff has reversed this troff
> convention. Additionally groff interprets - as a compromise
> HYPHEN-MINUS.

It's not that simple.  :-)  Here's groff 1.22.3-7 with a UTF-8 terminal.

    $ nroff <<<'- \- \(mi + \(pl' | tr -d ' \n' | recode ..dump
    UCS2   Mne   Description

    2010   -1    hyphen
    2212   -2    minus sign
    2212   -2    minus sign
    002B   +     plus sign
    002B   +     plus sign
    $=20

    $ troff -Tutf8 <<<'- \- \(mi + \(pl' | egrep 'font|^[Ct]'
    x font 1 R
    Chy
    C\-
    Cmi
    t+
    Cpl
    $

nroff never gave U+002D, an ASCII minus.  This is a problem for a man
page wanting text with an ASCII minus that can be cut and pasted to sh.
Because Unicode has reached the TTY, and PDF can be viewed as pixels,
we've migrated away from the many-usage ASCII minus to the other
specific, more typographic, runes.

The PostScript from groff is

    /F0 10 /Times-Roman@0 SF
    2.5<2dad>72 12 S            PostScript names: 2d=3Dhyphen  ad=3Dsofth=
yphen
    /F1 10 /Symbol SF
    (-) A
    F0
    (+) 2.5 E
    F1
    (+) 2.5 E
    0 Cg EP

So troff's characters map onto these PostScript fonts and characters.

    -     Times-Roman  hyphen
    \-    Times-Roman  softhyphen
    \(mi  Symbol       hyphen
    +     Times-Roman  plus
    \(pl  Symbol       plus

All five look distinct here in gv(1) and match your description;  \(mi
and \(pl are the Symbol font, \- and + are the current font.

As a solution, Ingo made the suggestion to switch \- to always be ASCII
minus because we thought \(mi was another name for \- and so still
available for the original use of a mathematical minus sign.  It's spelt
out half-way through
https://lists.gnu.org/archive/html/groff/2017-04/msg00052.html starting
"That leads to a natural suggestion solving *both* of these problems".

But you've thrown a spanner by pointing out \- and \(mi are not
equivalent.  :-)

Ingo, I think this means we need to pause on the switching of \- to
always be ASCII minus.

> man groff_char, however, tells the original state of affairs.  What is
> one to believe?

groff_char(7) is correct.

    Output  Input  PostScript  Unicode  Notes
    +       \[pl]  plus        u002B    plus in special font
    =E2=88=92       \[mi]  minus       u2212    minus in special font

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Wed May 03 06:37:18 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5reo-0007x4-Ss
	for mharc-groff@gnu.org; Wed, 03 May 2017 06:37:18 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56741)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5rem-0007ul-SC
	for groff@gnu.org; Wed, 03 May 2017 06:37:17 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5reh-0007JB-Uw
	for groff@gnu.org; Wed, 03 May 2017 06:37:16 -0400
Received: from relay01.pair.com ([209.68.5.15]:39592)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d5reh-0007Iz-Pj
	for groff@gnu.org; Wed, 03 May 2017 06:37:11 -0400
Received: from orac.inputplus.co.uk (241.198.189.80.dyn.plus.net
	[80.189.198.241])
	by relay01.pair.com (Postfix) with ESMTP id 22EE1D00B80
	for <groff@gnu.org>; Wed,  3 May 2017 06:37:09 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 7698D2156F
	for <groff@gnu.org>; Wed,  3 May 2017 11:37:08 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170501235754.GI28290@athene.usta.de>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
Date: Wed, 03 May 2017 11:37:08 +0100
Message-Id: <20170503103708.7698D2156F@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 10:37:17 -0000

Hi,

Ingo wrote:
> Given that the man(7) .TP .itc hack got committed to groff
...
> Of course, i still don't recommend actually using it, because that
> would make your manual page misrender on groff <=3D 1.22.3, on mandoc <=
=3D
> 1.14.1, and on any version of anything else.

This is sad news.  It's an insufficient improvement due to one man's
dislike of inline \f.  It shouldn't be used.  Hopefully groff's
documentation points out in all cases that it's incompatible?

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Wed May 03 09:04:37 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5txN-0005oW-B2
	for mharc-groff@gnu.org; Wed, 03 May 2017 09:04:37 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41741)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5txL-0005mo-JQ
	for groff@gnu.org; Wed, 03 May 2017 09:04:36 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5txG-0004HO-LQ
	for groff@gnu.org; Wed, 03 May 2017 09:04:35 -0400
Received: from mail-yw0-x22f.google.com ([2607:f8b0:4002:c05::22f]:33550)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5txG-0004HA-Hb
	for groff@gnu.org; Wed, 03 May 2017 09:04:30 -0400
Received: by mail-yw0-x22f.google.com with SMTP id 203so84181298ywe.0
	for <groff@gnu.org>; Wed, 03 May 2017 06:04:30 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=hx5/om0sur7HwHUWqUHlofXgnJOuIXqaFtF1z9vWN4w=;
	b=a4T374KpLB+k09jXYJvm3BpUu364VFFLIKWMhwC9n3K7Y02X0iQH2xU1/A4WIxkM7g
	kf6tXrNNA+hmdOm9ryVMnv9Z99bxxfVNWWlOwYrJfyXyFr93lh+z9ctRWC00oOjb66yr
	Ae1fi8dV+KWUj7n0Km0p/2u/5CKDM3jjT+S2FFEeyHx9zS93+qiD0UelwpVdy46uwMjb
	/BGuNoSv4znMIx6gAlqg9hTw3iamaugRrQ5uJhbiy2YNBbSJ+xmQO5EK+Dw0aIKHGznk
	ZV7Y3EaQMiGZ7Bq9LqNFGIy9zuvddYLOLTNOP6c1orvRyB7R99PR5CKLCIcga2tGlCGS
	I9hQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=hx5/om0sur7HwHUWqUHlofXgnJOuIXqaFtF1z9vWN4w=;
	b=GJLZXeezYNvYWtD4I9G7m+N2DqSoo+5NDCBqyhOPmKcz564xLYZFNRfBDRrU01oLtB
	jOAB0wdesDR554PL/F8K3KeIHt8lW6Vd79TyI3Xw58DodZYw7lbGpd4OzeM9RPhzztd1
	un1bdThr1Fz8L1yR8+G6cxu+U9N00eIEfX+CS3JsZlam3P6mNgNsi4XXbjuDSACfmq/8
	n2Vbtm+WnDDZChshJd6Sn4q4igysO5ykkY1Sh86y5mDG4BB5smbyqIKXmWmfCVYlzUd/
	F+GjSlwfkK/x/0cRCTBOr8z35WzlJtNEEKE/pfgsl/341GeUDUUVZfIp9EO0mLlani3f
	0PmQ==
X-Gm-Message-State: AN3rC/7NImILPy5x/vIWFwNnZl5X3N1iRPMCY54/eZ0vuvNc2E8V7PZa
	zkzDRl6B7FPgw0FLDpY=
X-Received: by 10.129.84.131 with SMTP id i125mr28626818ywb.335.1493816669525; 
	Wed, 03 May 2017 06:04:29 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	c62sm8452357ywa.43.2017.05.03.06.04.27 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Wed, 03 May 2017 06:04:28 -0700 (PDT)
Date: Wed, 3 May 2017 09:04:25 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170503130423.uv56xmyvtptjtbl3@crack.deadbeast.net>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="nsukhqfl75cao5l7"
Content-Disposition: inline
In-Reply-To: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::22f
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 13:04:36 -0000


--nsukhqfl75cao5l7
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-02T21:29:39-0400, Doug McIlroy wrote:
> I was previously told that \(mi is the true minus sign. But the
> true minus sign, at least in my mind, must come from the current
> font, so that it comes out right wherever it occurs, even in a
> bold headline like "Fairbanks shivers at -50".

I agree.

> I'll buy Branden's  first assertion, but if + and \- come from the
> current font as they originally did, and \(pl and \(mi come
> from the the current font per the previous paragraph, they
> become redundant.

It wouldn't be the first redundancy in the character escapes:

=46rom groff(7):


       \=B4     The acute accent =B4; same as \(aa.  Unescaped: apostrophe,
              right quotation mark, single quote (ASCII 0x27).
       \`     The grave accent `; same as \(ga.  Unescaped: left quote,
              backquote (ASCII 0x60).
[...]
       \_     The same as \(ul, the underline character.

I want to remove some of that overload encouragement in the descriptions
of the unescaped results above, because we have (long had) \[cq] and
\[oq] for single quotation marks, but that's another discussion.

> So I remain confused.

I think it's a confusing issue.  We didn't have Unicode back in the days
of CSTR #54, so the idea that you could get a pile of
mathematically-oriented glyphs out of the same font that you had loaded
to print your running prose was unheard of.

A quick experiment with -Z shows me that groff does still today load the
S [special] font when the \(pl and \(mi character escapes are used.

On my UTF-8 device, of course, this is a no-op.

It's not a no-op on a PostScript device, but I note no _visual_
difference.

/F0 10/Times-Roman@0 SF 196.51(foo\(1\) quux foo\(1\))72 48 R(plus +)108
84 Q(mathplus)108 100.8 Q/F1 10/Symbol SF(+)2.5 E F0(minus \255)108    =20
117.6 Q(mathminus)108 134.4 Q F1(-)2.5 E F0 211.235(baz bar)72 768 R(1)=20
222.615 E 0 Cg EP

On what devices do we expect a visual difference?

Regards,
Branden

--nsukhqfl75cao5l7
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkJ1UcACgkQ0Z6cfXEm
bc5xig//ZqAfrc8srWO7UyrMMP+acSfj5DGMX24yCJgZi4MWdZsUyhp62dEzjG2/
RxXsqa0e77vO9aehxNdzDUmg9VL/HPgMuE+1ggX6MqGeDnlbUCffFot5TA6Lx+oQ
X5XDE09QycSE9tzWUOAyurbvbCBXrwHFNGgsOwdBWZAHY7oudfz3PFJDbWPzgBRi
jVZKEqBpNQHtkrqDSzNlSd5+qyVKWyAqyKst+EAFBoqaOc1mrlHtbIZHeMKMUyn+
aH3W6x46OGZ7UBxHmc8tkFBey/OMAsgJx7vEtfSQEo6aJUsOf5RPrl5/phaVH6Wf
LXt1iCn5KnLt2dZM9Rng0BuN/NFSZNCbWCvc/MMTXfqdXg9a3NOkoDzANRP5+rIM
5e4tMz/fV4ipqF/sQ7YJ2R+qJipcsFKWWIzUUmB3X5v85HeHAfl8EQvaOPT7F1cx
zzc587Qylt4mbk+0yn/ulYLx/FQ1JOcf+qtu8WEi1f5860DETTXYZQXWniTt+519
s/tIgLTWTtgCg7H8vru5hWQTenWTwu/KuKxiJX37ifVe4OOsI/jkJzeosjgaCCDq
uF+6ge7GmYQjmIwzqn+9A+gIIQArpOM+ncYkIntVIY/S9+842FM8UM88R25HoR+/
Va2ymML1v+O3UZB+QfxH46+x7iPlNRHjshwGxnRuccrCOZahJi8=
=ewig
-----END PGP SIGNATURE-----

--nsukhqfl75cao5l7--


From MAILER-DAEMON Wed May 03 09:50:18 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5ufa-0000Cd-Ps
	for mharc-groff@gnu.org; Wed, 03 May 2017 09:50:18 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57835)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5ufY-0000CI-Ii
	for groff@gnu.org; Wed, 03 May 2017 09:50:17 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5ufT-0006lG-1N
	for groff@gnu.org; Wed, 03 May 2017 09:50:16 -0400
Received: from relay01.pair.com ([209.68.5.15]:56245)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d5ufS-0006kb-TM
	for groff@gnu.org; Wed, 03 May 2017 09:50:10 -0400
Received: from orac.inputplus.co.uk (241.198.189.80.dyn.plus.net
	[80.189.198.241])
	by relay01.pair.com (Postfix) with ESMTP id 61217D00B6C
	for <groff@gnu.org>; Wed,  3 May 2017 09:50:05 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 864AB215A3
	for <groff@gnu.org>; Wed,  3 May 2017 14:50:04 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170503130423.uv56xmyvtptjtbl3@crack.deadbeast.net>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503130423.uv56xmyvtptjtbl3@crack.deadbeast.net>
Date: Wed, 03 May 2017 14:50:04 +0100
Message-Id: <20170503135004.864AB215A3@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 13:50:18 -0000

Hi Branden,

> A quick experiment with -Z shows me that groff does still today load
> the S [special] font when the \(pl and \(mi character escapes are
> used.

Yes, my list email from earlier today lists the PostScript glyphs:
https://lists.gnu.org/archive/html/groff/2017-05/msg00028.html

> It's not a no-op on a PostScript device, but I note no _visual_
> difference.

That's odd.  It's a noticeable difference here, even sticking with the
default Roman.  Also, + and \(pl vary similarly.

    $ cat minus.tr
    .ds b \(rs
    .ds m \N'45'
    \*m -. \*bN'45' \N'45'. \*b\*m \-. \*b(mi \(mi. + +. \*b(pl \(pl.
    $ groff minus.tr >minus.ps
    $ gs -q -r600 -sDEVICE=3Dpnmraw -sOutputFile=3D- \
    >     -dTextAlphaBits=3D4 - <minus.ps |
    > pnmcrop -quiet |
    > pnmmargin -white 10 |
    > pnmtopng -quiet -compression 9 >minus.png
    $

Visible at https://s29.postimg.org/ddwg1okz9/minus.png

The PostScript is using Symbol for \(mi and \(pl.

    /F0 10/Times-Roman@0 SF
        2.5 (--)72 12 S
        2.5(.\\)-2.5 G
        (N'45' -.  \\- \255.  \\\(mi)-2.5 E
    /F1 10/Symbol SF
        (-)2.5 E
    F0
        2.5(.++)C
        2.5(.\\)-2.5 G
        (\(pl)-2.5 E
    F1
        (+)2.5 E
    F0
        (.)A 0

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Wed May 03 10:16:05 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5v4X-00016y-7m
	for mharc-groff@gnu.org; Wed, 03 May 2017 10:16:05 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35931)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d5v4U-00015b-NP
	for groff@gnu.org; Wed, 03 May 2017 10:16:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d5v4R-0008SC-EU
	for groff@gnu.org; Wed, 03 May 2017 10:16:02 -0400
Received: from relay01.pair.com ([209.68.5.15]:58933)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mbianchi@foveal.com>) id 1d5v4R-0008PO-8W
	for groff@gnu.org; Wed, 03 May 2017 10:15:59 -0400
Received: from foveal8 (pool-173-70-89-159.nwrknj.fios.verizon.net
	[173.70.89.159])
	by relay01.pair.com (Postfix) with ESMTP id D846AD00B15;
	Wed,  3 May 2017 10:15:54 -0400 (EDT)
Received: by foveal8 (Postfix, from userid 617)
	id 9999511E0042; Wed,  3 May 2017 10:15:54 -0400 (EDT)
Date: Wed, 3 May 2017 10:15:54 -0400
From: Mike Bianchi <MBianchi@Foveal.com>
To: Doug McIlroy <doug@cs.dartmouth.edu>
Cc: groff@gnu.org
Message-ID: <20170503141554.GB3530@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
User-Agent: Mutt/1.5.23 (2014-03-12)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 14:16:04 -0000

Folk,

I've been sort of watching from the sidelines here, but am going to toss in my
2 cents.

First, I once heard  troff/groff  described as the assembly language of type
setting.  So to my mind it should be "simple" (as in not too complicated) and
stable.  The first goal is forever lost.

Stable, to me, implies not changing much over time, and most changes
should be backward compatible.  troff/groff has by and large met that test.
Having mastered troff at one time the stability has saved me.  But my mastery
has degraded as I have not kept up with all the improvements and never was a
grand master.

Backward compatible means that all code written to the existing definitions
should turn out the same results as in the past when submitted to new
assemblers.
(I have nroff documents and C code from the 1970s that still work.)

Thus when we have pieces of documented definitions that contradict each other
the problem becomes which definition to change.  The definitions for

	-   \-   \(mi   \(hy   \(em   \(en   (others?)

should be clear and the implementations should implement them as defined.
To my mind  -  in groff should always default to the ASCII, 7-bit,
undistinguished character.

When we have assemblers that contradict because of the documentation being
inconsistent, what do we do about that?  For me, I want the assembler I use,
groff, to match the corrected documentation.

If different assemblers knowingly disagree with each other it would be a
courtesy to the community to document that fact.  (Witness the documentation
for many of the Linux/Unix/BSD implementations of "the shell".)

So if the current definitions for  -  \-  \(hy  disagree with historical
documents and implementations, they should be documented.
If I am writing at the assembly level, I can always
		.char - \-


Given those opinions, I feel it is for the macro packages, the "compilers",
to implement the necessary features such as associating true minus-signs
with numbers and true hyphens with word separators.  And if  -x  is meant to be
keyboard (7-bit ASCII) characters, the compiler should make that so.

The unfortunate history is that the man pages and other ancient documents come
from a time when the users of macros where expected to dive into the assembly
language _frequently_ to get-around the things that the macros just did not
address.  And that history is still with us in WYSIWYG (What You See Is What
You Get) word processors.  Want that  -  to be a minus in WYSIWYG?  Dive into
the font table and pick out the character there, if you can find it.

My impression is that some macros, such as Schaffter's Mom, go a long way
towards eliminating the assembly get-arounds.  Still macros take a programmers
view of documentation, namely to compile our document source code rather than
format the WYSIWYG input.  Their advantage is that simple "commands" crank out
a lot of assembler code.  Calling something a TITLE implies a lot of specifics.

All that said, the concept of having the complier decide whether a character
should be a minus, hyphen, minus-hyphen, UTF8-something-or-other, etc. should
be in the realm of a higher level component than troff/groff.

And the fix for old documents, such as the man pages that depend on groff
for their appearance, is to edit their source code so their specifics match
the (corrected?) groff definitions.
								Mike


On Tue, May 02, 2017 at 09:29:39PM -0400, Doug McIlroy wrote:
> 
> Branden wrote
> 
> Ingo's proposal would not mandate that + and \- come from the special
> font.
> 
> It also would not mandate that \(pl and \(mi come from the current font.
> 
> 
> ------
> 
> I was previously told that \(mi is the true minus sign. But the
> true minus sign, at least in my mind, must come from the current
> font, so that it comes out right wherever it occurs, even in a
> bold headline like "Fairbanks shivers at -50".
> 
> 
> I'll buy Branden's  first assertion, but if + and \- come from the
> current font as they originally did, and \(pl and \(mi come
> from the the current font per the previous paragraph, they
> become redundant.
> 
> So I remain confused.
> 
> Doug
 

-- 
 Mike Bianchi
 Foveal Systems

 973 822-2085

 MBianchi@Foveal.com
 http://www.AutoAuditorium.com
 http://www.FovealMounts.com


From MAILER-DAEMON Wed May 03 10:51:34 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5vcs-0004bm-DN
	for mharc-groff@gnu.org; Wed, 03 May 2017 10:51:34 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:45095)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5vcq-0004au-Pa
	for groff@gnu.org; Wed, 03 May 2017 10:51:33 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d5vcl-00032B-Su
	for groff@gnu.org; Wed, 03 May 2017 10:51:32 -0400
Received: from relay01.pair.com ([209.68.5.15]:60976)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d5vcl-000316-OK
	for groff@gnu.org; Wed, 03 May 2017 10:51:27 -0400
Received: from orac.inputplus.co.uk (241.198.189.80.dyn.plus.net
	[80.189.198.241])
	by relay01.pair.com (Postfix) with ESMTP id E5AA1D010BC;
	Wed,  3 May 2017 10:51:24 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 2F08C215A3;
	Wed,  3 May 2017 15:51:24 +0100 (BST)
To: Mike Bianchi <MBianchi@Foveal.com>
cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170503141554.GB3530@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
Date: Wed, 03 May 2017 15:51:24 +0100
Message-Id: <20170503145124.2F08C215A3@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 14:51:34 -0000

Hi Mike,

> Stable, to me, implies not changing much over time, and most changes
> should be backward compatible.
...
> Backward compatible means that all code written to the existing
> definitions should turn out the same results as in the past when
> submitted to new assemblers.  (I have nroff documents and C code from
> the 1970s that still work.)

Agreed.

> Thus when we have pieces of documented definitions that contradict
> each other the problem becomes which definition to change.  The
> definitions for
>
> 	-   \-   \(mi   \(hy   \(em   \(en   (others?)

\N'45' ?

    -       A hyphen for text, e.g. beer-flavoured ice-cream.
    \-      A minus sign in the current font.
    \(mi    A minus sign in the special font.
    \(hy    Another name for plain `-', so a hyphen for text.
    \N'45'  Glyph 45 in the current font.

> To my mind  -  in groff should always default to the ASCII, 7-bit,
> undistinguished character.

But it's always meant hyphen in pre-groff troff because it's a lot more
common to want a hyphen in writing than a minus sign.  Then Unicode
decided ASCII minus had too many meanings and couldn't be used for any
of them so created U+2010 for hyphen, and U+2212 for minus sign, and
groff switched to producing those for the hyphen and minus sign, leaving
ASCII minus unreproducible apart from \N'45'.

man pages that were and are considered correctly written have used \-
for a command-line minus sign, e.g. `wc \-l'.  (Incorrect man pages that
wrote `wc -l' can be ignored for the discussion;  there seems to be the
will to fix them.)  For that to paste from a man page, viewed as UTF-8
TTY, PostScript, PDF, browser, ..., it needs to be character 45.
Writing =C2=ABwc \N'45'l=C2=BB isn't going to gain support.  :-)  How to =
produce
it is the issue.

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Wed May 03 11:16:13 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5w0j-0006Wf-2X
	for mharc-groff@gnu.org; Wed, 03 May 2017 11:16:13 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51832)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5w0g-0006V8-H9
	for groff@gnu.org; Wed, 03 May 2017 11:16:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5w0d-0004tx-B7
	for groff@gnu.org; Wed, 03 May 2017 11:16:10 -0400
Received: from sdaoden.eu ([217.144.132.164]:39340)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <steffen@sdaoden.eu>) id 1d5w0d-0004sQ-4Y
	for groff@gnu.org; Wed, 03 May 2017 11:16:07 -0400
Received: by sdaoden.eu (Postfix, from userid 1000)
	id AC65316056; Wed,  3 May 2017 17:16:05 +0200 (CEST)
Date: Wed, 03 May 2017 17:17:07 +0200
From: Steffen Nurpmeso <steffen@sdaoden.eu>
To: Mike Bianchi <MBianchi@Foveal.com>
Cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
Message-ID: <20170503151707.pTfzw%steffen@sdaoden.eu>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
In-Reply-To: <20170503141554.GB3530@foveal5.foveal.com>
Mail-Followup-To: Mike Bianchi <MBianchi@Foveal.com>, groff@gnu.org,
	Doug McIlroy <doug@cs.dartmouth.edu>
User-Agent: s-nail v14.9.0-pre4-37-gf921ae51
OpenPGP: id=232C220BCB5690A37BD22FFDEB66022795F382CE;
	url=https://www.sdaoden.eu/downloads/steffen.asc
BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in
	the world can make no bugs.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 217.144.132.164
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 15:16:11 -0000

Mike Bianchi <MBianchi@Foveal.com> wrote:

I absolutely and completely support this opinion of yours.

Maybe except that it would be nice if some future user could
easily find some documentation and now what to do to get "nice"r
looking output, maybe with some command line argument (variable),
or a configuration file, because all those misuses came in for
a reason, and that cannot simply be neglected, after all.

--steffen
|Ralph says i must not use signatures which spread the light!


From MAILER-DAEMON Wed May 03 11:25:04 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5w9I-0001MQ-J6
	for mharc-groff@gnu.org; Wed, 03 May 2017 11:25:04 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54426)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d5w9G-0001MK-Pg
	for groff@gnu.org; Wed, 03 May 2017 11:25:03 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d5w9D-0002bm-Kt
	for groff@gnu.org; Wed, 03 May 2017 11:25:02 -0400
Received: from vsmx011.vodafonemail.xion.oxcs.net ([153.92.174.89]:37311)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d5w9D-0002RD-EE
	for groff@gnu.org; Wed, 03 May 2017 11:24:59 -0400
Received: from vsmx003.vodafonemail.xion.oxcs.net (unknown [192.168.75.197])
	by mta-5-out.mta.xion.oxcs.net (Postfix) with ESMTP id 80A2C3E039F
	for <groff@gnu.org>; Wed,  3 May 2017 15:24:45 +0000 (UTC)
Received: from app-36.app.xion.oxcs.net (app-36.app.xion.oxcs.net [10.10.1.36])
	by mta-7-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 700FF3003A8
	for <groff@gnu.org>; Wed,  3 May 2017 15:24:42 +0000 (UTC)
Date: Wed, 3 May 2017 17:24:41 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: groff@gnu.org
Message-ID: <508133548.253388.1493825081893@mail.vodafone.de>
In-Reply-To: <20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.89
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 15:25:03 -0000

> "G. Branden Robinson" <g.branden.robinson@gmail.com> hat am 3. Mai 2017 um 01:02 geschrieben:
> 
> The .itc request is a groff extension so an additional layer of
> 
> .ie \(.g
> 
> could be added.

Where do you want to add this--in the macro package?  This would not be necessary, since it is already groff's own package.  We don't need to care for those who steal it ;)

I saw testing for \(.g in manpages--this is a bad idea.  Manpages itself need to be written portable, without testing for this or that formatter.

Carsten


From MAILER-DAEMON Wed May 03 11:30:13 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5wEH-0003qn-J0
	for mharc-groff@gnu.org; Wed, 03 May 2017 11:30:13 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:55464)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5wEF-0003p9-Nk
	for groff@gnu.org; Wed, 03 May 2017 11:30:12 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d5wEA-000785-Nv
	for groff@gnu.org; Wed, 03 May 2017 11:30:11 -0400
Received: from mail-yb0-x241.google.com ([2607:f8b0:4002:c09::241]:35170)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d5wEA-00077x-J1
	for groff@gnu.org; Wed, 03 May 2017 11:30:06 -0400
Received: by mail-yb0-x241.google.com with SMTP id 19so7499968ybl.2
	for <groff@gnu.org>; Wed, 03 May 2017 08:30:06 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=jkOHnC/MVfm3jWlhzH4EP/WkdXrU57JCtB3YtEUiv3U=;
	b=IdBAREJE8p6xfjG5SH+Lr+tR0J4gCvVVloB+KZT1T5M7sY9/M3YtDQK+4nJe/fisGk
	Kn+JTeL4nnaz+C4I6POaZfFDM8uPhWKpnGS/TO3KIO1zhGG6FOH1r8YqSTXPRo/3uJeu
	m/9oT8hIYHYidP08yBU16MX9UINETgxSuN40lSLy/AGAjyAVlVYm/PT6Lsl9b7Hvj/Ar
	iOJVsKAaE3ihVSCN4y2m1FMJNaFMUcycmVw4uZchvusxUQgI033cmCiJ/GGW6h2onzjM
	OsANWoQhdgh17qzfsVw5Jy4HFD+Ar2be5CL35siiXJaqcd/vctYO6+rcVAicT7vxz4Ok
	afDA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=jkOHnC/MVfm3jWlhzH4EP/WkdXrU57JCtB3YtEUiv3U=;
	b=JLWIG6Ygf78rOX4YM9gi2rKl0mqaGXTBTpCAz5YVC0aFr19sv4UXR3EEpdN0n5d2+Q
	jkQDAR8Zl3Bv1oiwLvNlLPV1cv/n+7hQ8tL/f2pB+Ule8FhrQpZP9SE8V9imLyDCZkpr
	z2pSI8bnEuc2RRwT5wl++VTZiRM/znDTAyTD1UqsIaI6WmHuCUn0L/i9QhX6NRDrJLrJ
	3Y2IyqQzCO72jjZ/4MNGpHvG2iiHNbPdsu/k9wBKDjGpUB8mixkKguswZH/TrcWwlzIV
	r5O4hyNLRz4lszWdDzGfhyEU5ZWCFOgK6CGBshoH7o0KSR4OlzkZhzzyuaycLhQtCkZX
	zOUw==
X-Gm-Message-State: AN3rC/7bbnzlfeaGhuSqFR7oc7owYequsJdGDyb4t6+7CRMYy3A9kQW0
	WKq1BimDLRWUUm5VTG8=
X-Received: by 10.37.173.146 with SMTP id z18mr29247826ybi.96.1493825405452;
	Wed, 03 May 2017 08:30:05 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	y21sm4610758ywg.78.2017.05.03.08.30.03 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Wed, 03 May 2017 08:30:04 -0700 (PDT)
Date: Wed, 3 May 2017 11:30:02 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="vbsube3eql6i2d2g"
Content-Disposition: inline
In-Reply-To: <508133548.253388.1493825081893@mail.vodafone.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::241
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 15:30:12 -0000


--vbsube3eql6i2d2g
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-03T17:24:41+0200, Carsten Kunze wrote:
> > "G. Branden Robinson" <g.branden.robinson@gmail.com> hat am 3. Mai 2017=
 um 01:02 geschrieben:
> >=20
> > The .itc request is a groff extension so an additional layer of
> >=20
> > .ie \(.g
> >=20
> > could be added.
>=20
> Where do you want to add this--in the macro package?

Nope.  By "private macro" I mean one defined and used only within one
document.

> I saw testing for \(.g in manpages--this is a bad idea.  Manpages
> itself need to be written portable, without testing for this or that
> formatter.

Most \n(.g tests I've seen in man pages are to try to _achieve_
portability, not break it.

E.g., ncurses uses these conditionals in many of its pages:

=2Eie \n(.g .ds `` \(lq
=2Eel       .ds `` ``
=2Eie \n(.g .ds '' \(rq
=2Eel       .ds '' ''

Regards,
Branden

--vbsube3eql6i2d2g
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkJ928ACgkQ0Z6cfXEm
bc5SkQ//bGBI4wdZySspq5fvu7W9C09b1EQZ+UX1sQRJ6D6tU2MXXHCZLvo8m5AC
5/+R4rife+hizYl8/nehNTDNo4Yf/TbtXWjWWxh7Rc9dygnoUSTRAsYA/Iv+RkGl
24sL9pdpMCE9J4+WssnUYOdncmolgbJfunB1QNEPoG0ERo3Vqp5PsFEvDhWawVm7
bXovg0NuvaHxQROsPZsomggQz9pBWtIH0Pw9/i7XvAyfSKWp2RmCQgGmvgp9CQ6v
hwnDJHmTbLPvkXdiHTP9NLblQ8AIiKspf6/H24462E4rPHxAZd2WvlFJg2+JmznZ
5EpJQK+0vS5DtVKIIXgrcUv38Rs6h0coW/ssAcYGzvksck9OJ5CtjEPPCJsyXAma
rS7QTl16Jcte6D88cWDnRI875kB8D8NZ4hcwl5E8cAMqEoJtjJZhPcLFGS+avaMd
LL2KE4TtiNq3IBXqcVRbBm724awkzA+g9pLmyak0b/Zu8fIPE6IbRnmqyWN42M/D
hrO8rGS9klvMXO4sR+EJfg1XLzq7qQBrTEmcfkGM05qVszM3LgYa43Hyt6r1r10J
kgcKfPgQj3zuEooa7JG2vtf0vv0lZ2plXaZDI8L1cbDONT1A0+d47xO12RRReRgi
oWFJ377jWMEn7mo5EDHC4UhNrnYGn5JWV/PCXm+gZu4+YSSE2tY=
=NzCx
-----END PGP SIGNATURE-----

--vbsube3eql6i2d2g--


From MAILER-DAEMON Wed May 03 12:11:29 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5wsD-0000am-P1
	for mharc-groff@gnu.org; Wed, 03 May 2017 12:11:29 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42197)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d5wsA-0000YT-U6
	for groff@gnu.org; Wed, 03 May 2017 12:11:28 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d5ws0-0007OE-6q
	for groff@gnu.org; Wed, 03 May 2017 12:11:22 -0400
Received: from mail-yw0-x234.google.com ([2607:f8b0:4002:c05::234]:35996)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d5ws0-0007Lq-1v
	for groff@gnu.org; Wed, 03 May 2017 12:11:16 -0400
Received: by mail-yw0-x234.google.com with SMTP id l18so87602823ywh.3
	for <groff@gnu.org>; Wed, 03 May 2017 09:11:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc; bh=YBV83hkJUgThz5wTZaUpdguC/4IxVR6s+L0GbjKsgdc=;
	b=k+X+4DvkT7YX5yRr94AkCQheX1rR8t1askHiSLfd1Z2vyT3ayjq21EfS7qt7BZCY54
	AIafrubdxlpvfdYw8nb4uLww1/0CHjBVvQmIp9fcFwoq8oqq6XBnONs9Cn8Gn8SY4c0M
	Q/NZBLlwPn85UQHjR2CNTlBXvAXdM1ZG/Exl45RYzgRKjw83W32R06cDOFmXL+3aagZ5
	xTNNotfCuhhUeNcReD+m0KvImAW8GdU9Qo6yFVLw3yolC/4/iU81bjACOFKJ8y3vocyl
	ZaCzge2M2fdeB74p6LRoorQZBHOurJ60+cJ5u2sJK3gITfJ7O79RnLgVx3o/NqDW23Wl
	eD2g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to:cc;
	bh=YBV83hkJUgThz5wTZaUpdguC/4IxVR6s+L0GbjKsgdc=;
	b=lHkO79ZjGhfipvDPANP7AoTz/v/ts5sB33U48TvmFHrf0tWrRODNF0FZbHFwnf8tS/
	0q+84V/1gRJznbNFTn9CGRUddoSu+/3oNGnGigFvmi2d8Uo+xxn1EvSbFreE+1uZDS6t
	3gwyzSBR2mSwm5XbMmKSuY2MOPFzRdJyJOPaM9GAZ8pAGk3GibqPOtn2tpvkPEQ8TtAq
	P8nR6azXuKAKTwe3Ebmzu3dVuaAxF//U+YBNaLW+pUj0vqDStwoZ5evhbKfqoXnnzufl
	z/4jSU7lbvVzZHHKF6NUKwd4aiecBaI7iWxPT6qO1j1BxSIGSSxdfW8lfjVd6rPhETCH
	jigw==
X-Gm-Message-State: AN3rC/6rHPdoQsEURdA8mOHaGnNAVt+Kb68eFtaQlqdX5iYRD+GON7Xf
	TEWaaIsflLWdRFoowVRwYrnAK+z+PA==
X-Received: by 10.129.73.72 with SMTP id w69mr29542721ywa.190.1493827873336;
	Wed, 03 May 2017 09:11:13 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Wed, 3 May 2017 09:10:57 -0700 (PDT)
In-Reply-To: <20170503145124.2F08C215A3@orac.inputplus.co.uk>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
From: John Gardner <gardnerjohng@gmail.com>
Date: Thu, 4 May 2017 02:10:57 +1000
Message-ID: <CAGcdajeL7s8K1abNeVQDixxLJa1e0hyx=_fEYh_7zbyGLc246g@mail.gmail.com>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: Mike Bianchi <MBianchi@foveal.com>, Doug McIlroy <doug@cs.dartmouth.edu>,
	groff <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::234
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 16:11:28 -0000

>
> For that to paste from a man page, viewed as UTF-8 TTY,


Erm, I may be missing something, here... but if monospaced hyphens and
minus signs are optically indistinguishable, what's the worth in
differentiating between either?

IMHO, if any change is to be made, it should be with grotty's handling of \=
-.
A new escape sequence (or command-line switch) could always be added  for
authors/users who wish for a \- to *always* be rendered as U+2212, even for
Unicode-enabled terminals. Possible example might be character listings
(e.g., groff_char(7), or for Unicode-related documentation).

Of course, that still wouldn't do anything for code-blocks in PDFs. Then
again, I wouldn't be copying code from a PDF without expecting to clean it
up after pasting, anyway...

(I'm sure this suggestion is sounding silly to somebody...)



On 4 May 2017 at 00:51, Ralph Corderoy <ralph@inputplus.co.uk> wrote:

> Hi Mike,
>
> > Stable, to me, implies not changing much over time, and most changes
> > should be backward compatible.
> ...
> > Backward compatible means that all code written to the existing
> > definitions should turn out the same results as in the past when
> > submitted to new assemblers.  (I have nroff documents and C code from
> > the 1970s that still work.)
>
> Agreed.
>
> > Thus when we have pieces of documented definitions that contradict
> > each other the problem becomes which definition to change.  The
> > definitions for
> >
> >       -   \-   \(mi   \(hy   \(em   \(en   (others?)
>
> \N'45' ?
>
>     -       A hyphen for text, e.g. beer-flavoured ice-cream.
>     \-      A minus sign in the current font.
>     \(mi    A minus sign in the special font.
>     \(hy    Another name for plain `-', so a hyphen for text.
>     \N'45'  Glyph 45 in the current font.
>
> > To my mind  -  in groff should always default to the ASCII, 7-bit,
> > undistinguished character.
>
> But it's always meant hyphen in pre-groff troff because it's a lot more
> common to want a hyphen in writing than a minus sign.  Then Unicode
> decided ASCII minus had too many meanings and couldn't be used for any
> of them so created U+2010 for hyphen, and U+2212 for minus sign, and
> groff switched to producing those for the hyphen and minus sign, leaving
> ASCII minus unreproducible apart from \N'45'.
>
> man pages that were and are considered correctly written have used \-
> for a command-line minus sign, e.g. `wc \-l'.  (Incorrect man pages that
> wrote `wc -l' can be ignored for the discussion;  there seems to be the
> will to fix them.)  For that to paste from a man page, viewed as UTF-8
> TTY, PostScript, PDF, browser, ..., it needs to be character 45.
> Writing =C2=ABwc \N'45'l=C2=BB isn't going to gain support.  :-)  How to =
produce
> it is the issue.
>
> --
> Cheers, Ralph.
> https://plus.google.com/+RalphCorderoy
>
>

From MAILER-DAEMON Wed May 03 13:43:05 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d5yIr-0004bs-Ik
	for mharc-groff@gnu.org; Wed, 03 May 2017 13:43:05 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34030)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d5yIn-0004bh-U3
	for groff@gnu.org; Wed, 03 May 2017 13:43:03 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d5yIk-00043S-Jg
	for groff@gnu.org; Wed, 03 May 2017 13:43:02 -0400
Received: from relay01.pair.com ([209.68.5.15]:42188)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mbianchi@foveal.com>) id 1d5yIk-00042D-FH
	for groff@gnu.org; Wed, 03 May 2017 13:42:58 -0400
Received: from foveal8 (pool-173-70-89-159.nwrknj.fios.verizon.net
	[173.70.89.159])
	by relay01.pair.com (Postfix) with ESMTP id E3398D00B54;
	Wed,  3 May 2017 13:42:55 -0400 (EDT)
Received: by foveal8 (Postfix, from userid 617)
	id AB4DE11E0042; Wed,  3 May 2017 13:42:55 -0400 (EDT)
Date: Wed, 3 May 2017 13:42:55 -0400
From: Mike Bianchi <MBianchi@Foveal.com>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
Message-ID: <20170503174255.GA17280@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
In-Reply-To: <20170503145124.2F08C215A3@orac.inputplus.co.uk>
User-Agent: Mutt/1.5.23 (2014-03-12)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 17:43:03 -0000

On Wed, May 03, 2017 at 03:51:24PM +0100, Ralph Corderoy wrote:
>	:=20
>	:=20
>     -       A hyphen for text, e.g. beer-flavoured ice-cream.
>	:=20
> > To my mind  -  in groff should always default to the ASCII, 7-bit,
> > undistinguished character.
>=20
> But it's always meant hyphen in pre-groff troff because it's a lot more
> common to want a hyphen in writing than a minus sign.

_I_ would claim this interpretation was a mistake.  ((My opinion only her=
e.))
The  -  character exists on all keyboards.  It is not labeled minus or hy=
phen
or endash.  It generates the decimal 45 (hex 0x2D, octal 055) character.
That any *roff processor would give it a different meaning is most unfort=
unate.
Especially because hyphenation is a built in feature of *roff and once th=
ere
was the concept of  \(hy , hyphenated words should have used it.
Note please that I am not saying that  -  should be interpreted as  \(mi
either.


>	:=20
>     \-      A minus sign in the current font.
>     \(mi    A minus sign in the special font.

I would claim that  \-  makes sense, but  \(mi  coming from the special f=
ont
is a hold-over from the _first_ troff at Bell Labs that was tailored to t=
he
first support photo typesetter that supported 4 102-character fonts.  The=
y
were Roman, Bold, Italic, and Special (R B I S).  Special was the Greek
alphabet and other needed characters.
Us old-timers fondly remember the Bell System bell.
See
	https://en.wikipedia.org/wiki/Troff     "CAT phototypesetter"
	https://en.wikipedia.org/wiki/CAT_%28phototypesetter%29

((And interestingly, the current S (Symbol) font also contains the number=
s,
presumably so the they and the arithmetic and logic operators could all l=
ook
alike in mathematical writing.
I'm guessing that *roff does not take the digits from the Symbol font by
default.  I think that as an effective argument for not making \(mi draw =
from
the S font by default.))


>     \-      A minus sign in the current font.
>     \(mi    A minus sign in the special font.
>     \(hy    Another name for plain `-', so a hyphen for text.
>     \N'45'  Glyph 45 in the current font.

Once fonts distinguished between minus and hyphen with distinctive glyphs
then  \(mi  and  \(hy  have should come from the current font, especially=
 if
neither is  \N'45' .

BUT that is MY opinion.  What I am pushing for is that all the groff
documentation speak truth on this matter.


> ... paste from a man page, viewed as UTF-8
> TTY, PostScript, PDF, browser, ..., it needs to be character 45.
> Writing =ABwc \N'45'l=BB isn't going to gain support.  :-)
> How to produce it is the issue.

Absolutely.  I propose
	wc -l

if  -  was  \N'45'  It would make sense for future generations.  As a fir=
st
generation UNIX citizen it is interesting to contemplate how much longer =
the
man pages groff documents will be relevant.


--=20
 Mike Bianchi
 Foveal Systems

 973 822-2085

 MBianchi@Foveal.com
 http://www.AutoAuditorium.com
 http://www.FovealMounts.com


From MAILER-DAEMON Wed May 03 15:37:33 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d605d-0008B4-IB
	for mharc-groff@gnu.org; Wed, 03 May 2017 15:37:33 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39216)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d605b-0008Ax-M1
	for groff@gnu.org; Wed, 03 May 2017 15:37:32 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d605X-0007xS-Pu
	for groff@gnu.org; Wed, 03 May 2017 15:37:31 -0400
Received: from vsmx012.vodafonemail.xion.oxcs.net ([153.92.174.90]:32919)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d605X-0007vZ-Hy
	for groff@gnu.org; Wed, 03 May 2017 15:37:27 -0400
Received: from vsmx004.vodafonemail.xion.oxcs.net (unknown [192.168.75.198])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTP id AF45F4002F2
	for <groff@gnu.org>; Wed,  3 May 2017 19:37:24 +0000 (UTC)
Received: from app-39.app.xion.oxcs.net (app-39.app.xion.oxcs.net [10.10.1.39])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 51B03380073
	for <groff@gnu.org>; Wed,  3 May 2017 19:37:22 +0000 (UTC)
Date: Wed, 3 May 2017 21:37:21 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: Groff <groff@gnu.org>
Message-ID: <1512443572.281651.1493840242048@mail.vodafone.de>
In-Reply-To: <20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.90
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 19:37:32 -0000

> "G. Branden Robinson" <g.branden.robinson@gmail.com> hat am 3. Mai 2017 um 17:30 geschrieben:
> 
> Nope.  By "private macro" I mean one defined and used only within one
> document.

A manpage is "one document". Or what do you refer to?

> Most \n(.g tests I've seen in man pages are to try to _achieve_
> portability, not break it.
> 
> E.g., ncurses uses these conditionals in many of its pages:
> 
> .ie \n(.g .ds `` \(lq
> .el       .ds `` ``
> .ie \n(.g .ds '' \(rq
> .el       .ds '' ''

So all formatters except groff are only allowed to have second class output?  Exactly because of this poor code Heirloom sets .g to 1.  I assume also mandoc(1) reads \(.g as 1.  Had this been the intention behind register .g in groff?  So when all relevant tools set .g to 1, what is the point of this register? ;)

Three tools know of these special characters.  Either change other tools to support groff_char(7), groff_man(7) and groff_mdoc(7) or replace them with with one of the three tools.


From MAILER-DAEMON Wed May 03 15:46:57 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d60Ej-0002nZ-L4
	for mharc-groff@gnu.org; Wed, 03 May 2017 15:46:57 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42076)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d60Eh-0002mE-QV
	for groff@gnu.org; Wed, 03 May 2017 15:46:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d60Ee-0000sj-NY
	for groff@gnu.org; Wed, 03 May 2017 15:46:55 -0400
Received: from vsmx010.vodafonemail.xion.oxcs.net ([153.92.174.88]:54905)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d60Ee-0000qk-Gp
	for groff@gnu.org; Wed, 03 May 2017 15:46:52 -0400
Received: from vsmx002.vodafonemail.xion.oxcs.net (unknown [192.168.75.192])
	by mta-6-out.mta.xion.oxcs.net (Postfix) with ESMTP id 6977B80186
	for <groff@gnu.org>; Wed,  3 May 2017 19:46:50 +0000 (UTC)
Received: from app-39.app.xion.oxcs.net (app-39.app.xion.oxcs.net [10.10.1.39])
	by mta-6-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 116983C07BC
	for <groff@gnu.org>; Wed,  3 May 2017 19:46:47 +0000 (UTC)
Date: Wed, 3 May 2017 21:46:47 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: Groff <groff@gnu.org>
Message-ID: <1658250590.281765.1493840807873@mail.vodafone.de>
In-Reply-To: <1512443572.281651.1493840242048@mail.vodafone.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.88
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 19:46:56 -0000

> Carsten Kunze <carsten.kunze@arcor.de> hat am 3. Mai 2017 um 21:37 geschrieben:
> 
> > E.g., ncurses uses these conditionals in many of its pages:
> > 
> > .ie \n(.g .ds `` \(lq
> > .el       .ds `` ``
> > .ie \n(.g .ds '' \(rq
> > .el       .ds '' ''

I overlooked the word ncurses...

Ok, there had been days when this distinction did made sense.  But it should not be used in new code anymore...

Carsten


From MAILER-DAEMON Wed May 03 15:55:25 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d60Mv-0005LV-CA
	for mharc-groff@gnu.org; Wed, 03 May 2017 15:55:25 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44711)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d60Mt-0005LN-93
	for groff@gnu.org; Wed, 03 May 2017 15:55:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d60Ms-0001hr-IV
	for groff@gnu.org; Wed, 03 May 2017 15:55:23 -0400
Received: from mail-yw0-x232.google.com ([2607:f8b0:4002:c05::232]:35635)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d60Ms-0001gN-Es
	for groff@gnu.org; Wed, 03 May 2017 15:55:22 -0400
Received: by mail-yw0-x232.google.com with SMTP id u70so90916439ywe.2
	for <groff@gnu.org>; Wed, 03 May 2017 12:55:22 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc; bh=pWoURCwBOnQTDWME1BPwS8DDjreUgXf1YMt6qhFCkkE=;
	b=IQtHvNv3yGaKvbv4wbHYP99uXtd3XbE7PjZSxr1HxDXiRhLiuD6vq74sIcG2kqYPY/
	wAfnmYpIILUFKl+RUaWIwFC0DNm4CGlEbOJfQT6lPPlaY09EGELJPE9UPt2sn0ZSdrGf
	LHgJcy7T+KUGBvMwb62dGcD5IOsmG7npLcrskQR3j4fILRec/Rr9DchmpkNnPqd5mXPY
	VbVSFmehZuG7RJ0KayV9PbKFjEIzqmGjO4IvfenYomMTWDrkeW7eUdHMAYCiK4W1rxw7
	cY2wuLP6rcABHffcJkfy81Am1Os2ls4rQw1/jEVbknsW2A05ZNp8BhwAVxOLsslsQGfe
	IcHA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to:cc;
	bh=pWoURCwBOnQTDWME1BPwS8DDjreUgXf1YMt6qhFCkkE=;
	b=geHJ1VdtoDQX3tFR5ct91Nz84fpGEOrun5flqvsXd8hAJl2XADCYCokvPlbNRr4UtT
	6G6S1RpCUmy3nxDi2zr99Ls4Gx3BLdaNdVOUNNuc7w9TOS12z/07Ie3yHQ/VmPFk6ekY
	lUFqf1me0MQZTwUxRxOYdDWCWV8R8WFPK9JktSrPl11p7lVU663hNURkRxjKpHWZbBsp
	C/M9tzxDSSDJUskxnYGAc2GQdtfHsV9OfrWzqdJ4dtVp8wr5c29Nz83mYbD4cG7sNEIc
	KqnS+roWkRtA2OGS7aP51g6hmSjHwiQT1oLLfJ6IasKtrO+QzEUKiygL//rJ+BulcOub
	+Vsw==
X-Gm-Message-State: AN3rC/42X6yEB7PfdGARgJY/bqB++HFJ4v+xFm5NdeHMyjHIja8wom+z
	WMrsQgtJrSW3GEJg0+MMQSeiPaXFpQ==
X-Received: by 10.129.97.132 with SMTP id v126mr8406445ywb.171.1493841321285; 
	Wed, 03 May 2017 12:55:21 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Wed, 3 May 2017 12:55:05 -0700 (PDT)
In-Reply-To: <1658250590.281765.1493840807873@mail.vodafone.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
From: John Gardner <gardnerjohng@gmail.com>
Date: Thu, 4 May 2017 05:55:05 +1000
Message-ID: <CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
To: Carsten Kunze <carsten.kunze@arcor.de>
Cc: Groff <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::232
Content-Type: text/plain; charset=UTF-8
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 19:55:24 -0000

Is there literally no way to identify when a modern (non-GNU) troff is
being used?

On 4 May 2017 at 05:46, Carsten Kunze <carsten.kunze@arcor.de> wrote:

> > Carsten Kunze <carsten.kunze@arcor.de> hat am 3. Mai 2017 um 21:37
> geschrieben:
> >
> > > E.g., ncurses uses these conditionals in many of its pages:
> > >
> > > .ie \n(.g .ds `` \(lq
> > > .el       .ds `` ``
> > > .ie \n(.g .ds '' \(rq
> > > .el       .ds '' ''
>
> I overlooked the word ncurses...
>
> Ok, there had been days when this distinction did made sense.  But it
> should not be used in new code anymore...
>
> Carsten
>
>

From MAILER-DAEMON Wed May 03 16:06:20 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d60XU-0002Sy-JB
	for mharc-groff@gnu.org; Wed, 03 May 2017 16:06:20 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47238)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d60XT-0002Sr-4c
	for groff@gnu.org; Wed, 03 May 2017 16:06:19 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d60XP-0005TK-Vo
	for groff@gnu.org; Wed, 03 May 2017 16:06:19 -0400
Received: from vsmx010.vodafonemail.xion.oxcs.net ([153.92.174.88]:35421)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d60XP-0005Ql-PC
	for groff@gnu.org; Wed, 03 May 2017 16:06:15 -0400
Received: from vsmx002.vodafonemail.xion.oxcs.net (unknown [192.168.75.192])
	by mta-6-out.mta.xion.oxcs.net (Postfix) with ESMTP id 91DCD803DA
	for <groff@gnu.org>; Wed,  3 May 2017 20:06:13 +0000 (UTC)
Received: from app-39.app.xion.oxcs.net (app-39.app.xion.oxcs.net [10.10.1.39])
	by mta-6-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 3400F3C0275
	for <groff@gnu.org>; Wed,  3 May 2017 20:06:10 +0000 (UTC)
Date: Wed, 3 May 2017 22:06:10 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: Groff <groff@gnu.org>
Message-ID: <2067319.281997.1493841970242@mail.vodafone.de>
In-Reply-To: <CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
	<CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.88
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 20:06:20 -0000

> John Gardner <gardnerjohng@gmail.com> hat am 3. Mai 2017 um 21:55 geschrieben:
> 
> 
> Is there literally no way to identify when a modern (non-GNU) troff is
> being used?

General typesetting is something else.  Heirloom has this kludge only for manpages, neatroff (AFAIK not used for manpages) likely does not set .g.

There are ways to detect the formatter but a manpage must not do this.  IMHO a manpage should suppose that groff is used.  If groff has bugs (e.g. compared to mandoc(1)) they should be fixed.

Carsten


From MAILER-DAEMON Wed May 03 16:48:20 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d61C8-0004i5-My
	for mharc-groff@gnu.org; Wed, 03 May 2017 16:48:20 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57830)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d61Bh-0004Mx-8Q
	for groff@gnu.org; Wed, 03 May 2017 16:48:17 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d61BJ-0004fW-Ah
	for groff@gnu.org; Wed, 03 May 2017 16:47:53 -0400
Received: from mail-yw0-x242.google.com ([2607:f8b0:4002:c05::242]:33460)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d61BI-0004c1-I8
	for groff@gnu.org; Wed, 03 May 2017 16:47:29 -0400
Received: by mail-yw0-x242.google.com with SMTP id 203so125129ywe.0
	for <groff@gnu.org>; Wed, 03 May 2017 13:47:26 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=EEikwOsVgnTZc/36cStyKY/O8VpD6qgWhnILI66Kukg=;
	b=E29tUaKecd7tXXmNCzkOsMwLk2ZnMF7JuE8Y24Gk56LNOjo5p5dvtA+cYqAcPfdU+W
	jynBA+zTBcLxVW2qzhfyWTKBLienTp0KQWBtCTG/4P9O7sQ6ca+o/4Dqt1LXRXXZUWXk
	vxHt15wyM9XM6aUQBdNxMfI+3FcKMs0EhLJCoUHnI/TZtaQxdCMgeKVVS2pjEjr+aNgZ
	1N5KRpEMuxxkgvU3WZHunzzPZGBQO1Osq5bnN+dw4u+ONYnbxtO3NlHAn1vgOi2lE5Nz
	LA9wwBmDc/GCIMUGhf1r87QoDCJ3egAJm8Y6S0xjek5I2aPuuPdPrOUdwVwwn6xH8Op1
	1nGA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=EEikwOsVgnTZc/36cStyKY/O8VpD6qgWhnILI66Kukg=;
	b=s66TviCOY2hp0W8EmuP7gfQQWPBrvVa1nxmf3HmRVbwDyh2JLpJLsQ3+vToIL7QJpr
	MGyvQqvmH0thktZeo+mmvTsIXL5uPHQt5LGeour+N0tC6Wu0GCJBRDRtT6w+l8X5daw5
	Rblo3ys0CGp6FEbVHDEynLsKeLdJaHd4WrPmBLvSklK/w6kjYJh95JEYsLsBf44z8m4s
	W+01btaly9lancW4z3Khp1KWOvzYs9Pj11m2BAEdOcvXXNpU2zx1fCUv69Ui7eq7fhKa
	nsdYhzc6vqiJ3GPNEYhHybbpAPFISdNGoe8BdI4Y+AbN6oalD70Gy7o+bX3pw30tZOWo
	ldtA==
X-Gm-Message-State: AN3rC/5V9Z8EO1nrJe6I7+I94LXOJiOZcZoVrBbuY1KMSCqwezVnjDhg
	69KNhao+inY4/4hJXZ4=
X-Received: by 10.129.162.74 with SMTP id z71mr30186497ywg.231.1493844445992; 
	Wed, 03 May 2017 13:47:25 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100])
	by smtp.gmail.com with ESMTPSA id z17sm47542ywd.67.2017.05.03.13.47.23
	for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Wed, 03 May 2017 13:47:24 -0700 (PDT)
Date: Wed, 3 May 2017 16:47:21 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: Groff <groff@gnu.org>
Message-ID: <20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="azsropqrweb55gcm"
Content-Disposition: inline
In-Reply-To: <1512443572.281651.1493840242048@mail.vodafone.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::242
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 20:48:17 -0000


--azsropqrweb55gcm
Content-Type: multipart/mixed; boundary="wyedxhrgqehxlxqt"
Content-Disposition: inline


--wyedxhrgqehxlxqt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-03T21:37:21+0200, Carsten Kunze wrote:
> > "G. Branden Robinson" <g.branden.robinson@gmail.com> hat am 3. Mai 2017=
 um 17:30 geschrieben:
> >=20
> > Nope.  By "private macro" I mean one defined and used only within one
> > document.
>=20
> A manpage is "one document". Or what do you refer to?

It's a man page for xtrs, a TRS-80 emulator, for which I've been the
Debian package maintainer for (off and on) almost 20 years.

My uptsream doesn't has a long and sophisticated man page (in terms of
content) but is not very idiomatic man(7) markup.

See the attachment.  You may want to brew a pot of coffee.

> > Most \n(.g tests I've seen in man pages are to try to _achieve_
> > portability, not break it.
> >=20
> > E.g., ncurses uses these conditionals in many of its pages:
> >=20
> > .ie \n(.g .ds `` \(lq
> > .el       .ds `` ``
> > .ie \n(.g .ds '' \(rq
> > .el       .ds '' ''
>=20
> So all formatters except groff are only allowed to have second class
> output?

I think the idea here is to degrade in a predictable way.

> Exactly because of this poor code Heirloom sets .g to 1.  I
> assume also mandoc(1) reads \(.g as 1.  Had this been the intention
> behind register .g in groff?  So when all relevant tools set .g to 1,
> what is the point of this register? ;)

I think the idea, as with so many GNU tools, was to be able to
feature-gate GNU extensions.  Heirloom Troff--_after_ Gunnar Ritter took
it over--decided to implement so many GNU Troff extensions that he
decided to get behind the same feature gate.

That's not a wrong or bad decision.  It's an independent implementation
that has decided to follow GNU's (de facto) standard.

But not every Troff implementation chooses to follow GNU.

We've seen the same story play out over many software systems in the
past few decades.  Some people ignore GNU innovations, some people copy
them, and some try wipe GNU off the face of earth.

I think either of the first two options are defensible.  :)

> Three tools know of these special characters.  Either change other
> tools to support groff_char(7), groff_man(7) and groff_mdoc(7) or
> replace them with with one of the three tools.

Well, how about this?

There's a "c glyph" predicate that can be fed to .if and .ie requests:

https://www.gnu.org/software/groff/manual/html_node/Operators-in-Conditiona=
ls.html

So ncurses should be gating on the definition of the glyph rather than
on whether groff is the typesetter, right?

=2Eie c \(lq .ds `` \(lq
=2Eel        .ds `` ``
=2Eie c \(rq .ds '' \(rq
=2Eel        .ds '' ''

What do you think?

Regards,
Branden

--wyedxhrgqehxlxqt
Content-Type: text/x-diff; charset=iso-8859-1
Content-Disposition: attachment; filename="xtrs-idiomatize-manpage.patch"
Content-Transfer-Encoding: quoted-printable

Reformat and tweak style of manual page to attempt to more closely
follow the conventions set down in man-pages(7), groff_man(7), and
groff(7).

Make many minor clarifications, comment-out dead Web links, and so
forth.  It's less than a rewrite, more than a minor editing pass.

* Offer the reader a 1,000-foot view of what xtrs actually is.
* Update language in places to reflect that not every host for xtrs
  is a "PC".  This affects mainly discussions of PC-style keyboards
  with their numeric keypads, and floppy disk controllers on (real or
  southbridge-emulated) ISA buses.
* Update X keyboard-related material.  xmodmap is pretty strongly
  deprecated these days, at least for mucking about with key mappings.
  Also, despite XKB's lack of coherent, centralized, and accessible
  documentation, most *nix distributors seem to get NumLock straight
  these days.
* Update discussion of emulator tick timing since the Linux kernel has
  undergone a lot of change in this area.
* Note which tools on utility.dsk are affected by the -emtsafe option.
* Update real-time clock discussion.  LDOS's year-2012 bug has arrived
  en force.
* Inform bold readers where to find information on X resource syntax.
* Add "Exit status", "Environment", and "Files" sections.
* Incorporate "Additional resources" section into new "See also"
  section.

* Clarify that various files can be found in the source distribution for
  those not reading the man page from there.
* Style: When using numeric or letter literal plurals in prose, apply
  quotation marks instead of a pseudo-possessive, or recast the
  sentence, to avoid the "greengrocer's apostrophe" look.
* Style: "tty" -> "terminal" [man-pages(7)]
* Style: Render "Z-80" as "Z80" since that seems to be Zilog's
  preferred convention.
* Style: Use hyphens in phrasal adjectives (cf. "command-line option"
  and ("do this at the command line").
* Style: Use "k", not "K", as the metric prefix for "kilo".
* Style: Use IEC "metric binary" prefixes--grudgingly--in contemporary
  contexts; but do _not_ thus update references to how historical floppy
  drives and diskettes were marketed and labeled.
* Style: "current directory" -> "current working directory", as that's
  the Unix parlance.
* Style: "{lower,upper} case" -> "{lowercase,uppercase}"
* Introduce abbreviations like "OSS" in prose.

* Introduce macros to render floppy diskette size fractions (5=BC and 3=BD).
  Since glyphs for these common fractions are supported on every *roff
  output device except "ascii", use them.  However, they degrade badly
  in the ASCII case (51/4 and 31/2, which are confusing and numerically
  wrong), so render them as decimals in that case.
* Introduce macros to render the umlaut and ess-tsett ("sharp s")
  symbols as such on every output device except "ascii".  Fall back
  gracefully for ASCII.

* Mark up URL with groff's extended man macros UR and UE.  These macros
  produce actual clickable URLs in grohtml, and maybe someday in gropdf.
* Mark up the Synopsis (n=E9 Syntax) section with groff's extended man
  macros OP, SY, and YS, replacing the less-specific "[flags]".
* However, xtrs has so _many_ options that this seemed unhelpful for the
  full smorgasbord of 'em; so leave the synopsis with just the
  (near-?)essentials of model number and disk image directory.
* Mark up examples with groff's extended man macros EX and EE.
* Mark up tagged paragraph continuations with groff's extended man macro
  TQ.
* If groff is not the typesetter, copy and define the extended man
  macros we use.  They are even more permissively licensed than xtrs
  itself.
* That leaves the man page proper without an explicit copyright and
  license.  Declare the former based on changelog history and use Tim
  Mann's xtrs license for the latter.
  + *** NOTE *** I reviewed the xtrs 1.0 version of the man page and
                 feel that Tim so comprehensively rewrote and expanded
                 it that it's not worth the trouble trying to extract a
                 few phrases here and there to mark them with the
                 Clarendon Hill Software copyright statement and
                 license.
* Push several top-level sections to subsections of the Description
  section.
* Add "extra" information to the TH arguments.  Base the date on
  upstream's SVN keyword, and mark the tool as part of the xtrs suite or
  package.
* Retitle "Syntax" section to "Synopsis", which is much, much more
  widespread.
* Use EX/EE macros to bracket the copy of reed.h.  This makes it look
  nice in all output formats.
* Use .ne ("need") requests to keep the ReedHardHeader struct fields
  from getting broken across pages.
* Reflow (the copy of) reed.h so its lines will fit on an 80-column
  terminal.
* Reference (and, if outputting HTML, link to) the "dskspec" document by
  its title, not just its filename.
* Mark up literal input in bold, variables in italics, and synopsis
  syntax itself (such as brackets for optional arguments and ellipses)
  in roman.
* Mark up literal filespec references in italics.
* Mark up host machine keycaps in bold.
* Use *roff character escapes for directional quotes when used as prose
  quotation marks (contra programming-language quotation marks).
* Use *roff character escapes for literal backslashes, and "spacing"
  carets ("circumflex accents") and tildes ("tilde accents", sometimes
  called "swung dashes" when spacing).
* Use multiplication and division signs rather than C operators.
* Use *roff character escapes for em-dashes and en-dashes.
* Eliminate completely blank source lines.
* Break source lines at sentence endings.
* Mark up names of software products in italics (cf. the topic of the
  current man page or a man page cross-reference, see next item).  It
  was hard to find an authoritative source for NEWDOS/80, though.
* Render man page cross-references in bold and roman, not italic and
  roman, for the page name and parenthesized section respectively.
* Move the SVN keyword expansion into a *roff source comment.
* Add a *roff comment with a Vim modeline to ease editing.

What I didn't do:

* The man-pages people deprecate "Author"(s) sections, but I'm not
  willing to make such a change to upstream.

--Branden Robinson, 2017-04-30T19:06:12-0400
--- a/xtrs.man
+++ b/xtrs.man
@@ -1,1071 +1,2505 @@
-.TH xtrs 1
+.\" This man page attempts to follow the conventions and recommendations f=
ound
+.\" in Michael Kerrisk's man-pages(7) and GNU's groff_man(7), and groff(7).
+.\"
+.\" The following macro definitions come from groff's an-ext.tmac.
+.\"
+.\" Copyright (C) 2007-2014  Free Software Foundation, Inc.
+.\"
+.\" Written by Eric S. Raymond <esr@thyrsus.com>
+.\"            Werner Lemberg <wl@gnu.org>
+.\"
+.\" You may freely use, modify and/or distribute this file.
+.\"
+.\" If _not_ GNU roff, define macros to handle synopsis and URLs.
+.if !\n[.g] \{\
+.\" Declare start of command synopsis.  Sets up hanging indentation.
+.de SY
+.  ie !\\n(mS \{\
+.    nh
+.    nr mS 1
+.    nr mA \\n(.j
+.    ad l
+.    nr mI \\n(.i
+.  \}
+.  el \{\
+.    br
+.    ns
+.  \}
+.
+.  nr mT \w'\fB\\$1\fP\ '
+.  HP \\n(mTu
+.  B "\\$1"
+..
+.
+.
+.\" End of command synopsis.  Restores adjustment.
+.de YS
+.  in \\n(mIu
+.  ad \\n(mA
+.  hy \\n(HY
+.  nr mS 0
+..
+.
+.
+.\" Declare optional option.
+.de OP
+.  ie \\n(.$-1 \
+.    RI "[\fB\\$1\fP" "\ \\$2" "]"
+.  el \
+.    RB "[" "\\$1" "]"
+..
+.
+.
+.\" Start URL.
+.de UR
+.  ds m1 \\$1\"
+.  nh
+.  if \\n(mH \{\
+.    \" Start diversion in a new environment.
+.    do ev URL-div
+.    do di URL-div
+.  \}
+..
+.
+.
+.\" End URL.
+.de UE
+.  ie \\n(mH \{\
+.    br
+.    di
+.    ev
+.
+.    \" Has there been one or more input lines for the link text?
+.    ie \\n(dn \{\
+.      do HTML-NS "<a href=3D""\\*(m1"">"
+.      \" Yes, strip off final newline of diversion and emit it.
+.      do chop URL-div
+.      do URL-div
+\c
+.      do HTML-NS </a>
+.    \}
+.    el \
+.      do HTML-NS "<a href=3D""\\*(m1"">\\*(m1</a>"
+\&\\$*\"
+.  \}
+.  el \
+\\*(la\\*(m1\\*(ra\\$*\"
+.
+.  hy \\n(HY
+..
+.
+.
+.\" Start example.
+.de EX
+.  do ds mF \\n[.fam]
+.  nr mE \\n(.f
+.  nf
+.  nh
+.  do fam C
+.  ft CW
+..
+.
+.
+.\" End example.
+.de EE
+.  do fam \\*(mF
+.  ft \\n(mE
+.  fi
+.  hy \\n(HY
+..
+.
+.
+.\" Continuation line for .TP header.
+.de TQ
+.  br
+.  ns
+.  TP \\$1\" no doublequotes around argument!
+..
+.\} \" not GNU roff
+.\" Copyright 1997 Timothy Mann
+.\"
+.\" This software may be copied, modified, and used for any purpose
+.\" without fee, provided that (1) the above copyright notice is
+.\" retained, and (2) modified versions are clearly marked as having
+.\" been modified, with the modifier's name and the date included.
+.\"
+.\" Define macros for frequent references to floppy drive sizes requiring
+.\" fractional units, because the standard character escapes for common
+.\" ("vulgar") fractions degrade to ASCII poorly in context (e.g., 5\(14 r=
enders
+.\" as "51/4" in xtrs.txt).
+.\"
+.\" Usage note: These macros do _not_ have an ending word break; this is s=
o that
+.\" the "-inch" suffix can be appended where desired.  If you require a wo=
rd
+.\" break, the correct *roff way to get one is to put a single word space =
on a
+.\" line by itself after the macro call.
+.\"
+.\" BEGIN EXAMPLE
+.\" The drive can be eight inches or
+.\" .5-1/4
+.\"  \" ordinary space character (paddable by *roff)
+.\" inches.
+.\" END EXAMPLE
+.de 3-1/2
+3\c
+.  ie '\*(.T'ascii' \&.5\c
+.  el \(12\c
+..
+.de 5-1/4
+5\c
+.  ie '\*(.T'ascii' \&.25\c
+.  el \(14\c
+..
+.\" Define macros to handle the GENIE's non-ASCII keycaps.
+.de ess-tsett
+.  ie '\*(.T'ascii' ess-tsett
+.  el \(ss
+..
+.de umlaut
+.  ie '\*(.T'ascii' umlaut
+.  el \(ad
+..
+.\" The bold italic font is not accessible via the man macro package.
+.de BOLD-ITALIC
+.  ie d an-trap \
+.    ie F BI \{\
+.      itc 1 an-trap
+.      ft BI
+.      if \\n[.$] \&\\$*
+.    \}
+.    el \&\\$*
+.  el \&\\$*
+..
+.TH xtrs 1 2017-04-16 xtrs
+.\" Redefine TP macro to let us use \c and font-changing macros so we can =
have
+.\" more than two fonts in a tagged paragraph's tag without using ugly font
+.\" escapes.  (This was committed to groff upstream on 2017-04-28. --brand=
en)
+.\" This definition MUST follow TH because of the way groff's andoc.tmac w=
orks.
+.if \n[.g] \{\
+.de1 TP
+.  sp \\n[PD]u
+.  if \\n[.$] .nr an-prevailing-indent (n;\\$1)
+.  itc 1 an-trap
+.  in 0
+.  if !\\n[an-div?] \{\
+.    ll -\\n[an-margin]u
+.    di an-div
+.  \}
+.  nr an-div? 1
+.. \}
 .SH Name
-xtrs \- TRS-80 Model I/III/4/4P emulator for the X Window System
-.SH Syntax
-.B xtrs [-model m] [-diskdir d] [-debug]
-.I [other options]
+.B xtrs
+\- TRS-80 Model I/III/4/4P emulator for the X Window System
+.SH Synopsis
+.SY xtrs
+.OP \-model m
+.OP \-diskdir d
+.OP \-debug
+.RI [ other-options ]
+.YS
 .SH Description
-\fBxtrs\fP is built on top of a Z-80 emulator, with added routines to supp=
ort
-keyboard and video I/O through an X interface.
-The hardware emulation can operate as a TRS-80 Model I, Model III,
-Model 4, or Model 4P.
-
-\fBxtrs\fP supports 48K of RAM in Model I or Model III mode, 128K in
-Model 4 or Model 4P mode.  Floppy disks and hard disks are emulated
-using files to store the data; or under Linux only, real floppy drives
-can be used.  A printer is emulated by sending its output to standard
-output.  A serial port is emulated using a Unix tty device.
-Cassette I/O is emulated using files to store the cassette
-data; real cassettes can also be read or written (with luck), either
-directly through your sound card (on Linux and other systems with
-OSS-compatible sound drivers), or via .wav files.  Game sound and
-music output are also supported if you have an OSS-compatible sound
-driver; sound output though the cassette port, through the Model 4
-sound option, and through the optional Orchestra-85/90 music synthesizer
-card are all emulated.  In Model I mode, the HRG1B graphics card
-is emulated.  In Model III and 4/4P mode, you can select whether
-the Radio Shack graphics card or Micro Labs Grafyx Solution is emulated.
-There is also a mouse driver for Model 4/4P mode.  Several common
-time-of-day clock cards are emulated on all models.  The Alpha Products
-joystick is emulated using the PC's numeric keypad.
-
-Because \fBxtrs\fP emulates the hardware, all known TRS-80 Model
-I/III/4/4P operating systems should run on it, including all flavors
-of TRSDOS, LDOS/LS-DOS, NEWDOS, DOSPLUS, MultiDOS, and TRS-80 CP/M.
-However, the emulator also includes some extensions to the standard
-hardware, and the special drivers, utilities, and instructions needed
-for these are not provided for all operating systems.
-
-The Z-80 emulator has a debugger called zbx.  You can enter the
-debugger either by starting \fBxtrs\fP with the -debug flag or by
-pressing F9 while \fBxtrs\fP is running.  The debugger runs in the X
-terminal window that you started \fBxtrs\fP from.  Once you are in the
-debugger, type "help" for more information.
-
-Special support in the emulator allows the program to block when
-waiting for information from the keyboard.  This will work only for
-programs that wait for keyboard input using the standard Model I/III
-ROM call; the emulator decides whether to block the Z-80 program when
-it tries to read from the keyboard memory by pattern-matching its
-stack.
-.SH Keys
-The following keys have special meanings to \fBxtrs\fP:
-
-F11 toggles onscreen help on the keyboard mappings.
-
-LeftArrow, Backspace, or Delete is the TRS-80 left arrow key.
-RightArrow or Tab is the right arrow key.  UpArrow is the up arrow
-key.  DownArrow or Linefeed is the down arrow key.  Esc or Break is
-the Break key.  Home, Clear, or LeftAlt is the Clear key.  Control is
-the Model 4 Ctrl key (address bit 7, data bit 2).  RightAlt is
-equivalent to the shifted down arrow key (used as a control key with
-some TRS-80 software).
-
-F1, F2, and F3 are the Model 4/4P function keys (address bit 7, data bits
-4, 5, and 6).  F1 is also the Model I Electric Pencil control key that
-some users added to their machines.  F4 is the Model 4 Caps Lock key
-(address bit 7, data bit 3).  F5, Compose, or ScrollLock is equivalent
-to the @ key (so that @ can be used as a modifier key).  F6 is
-equivalent to the 0 key (so that a shifted 0 can be obtained).  F7
-signals a disk change in the emulated floppy drives (see below).  F8
-exits the program.  F9 enters the debugger (zbx).  F10 is the reset button.
-
-In Model III, 4, and 4P modes, the left and right shift keys are
-distinct; in Model I mode, they are the same.  The PageUp and PageDown
-keys always activate the positions that correspond to the Model
-III/4/4P left and right shift keys (address bit 7, data bits 0 and 1
-respectively), even in Model I mode.  The End key activates an unused
-position in the keyboard matrix (address bit 7, data bit 7).
-
-The keys [, \\, ], ^, _, {, |, }, and ~ also activate unused positions
-in the keyboard matrix (address bit 3, data bits 3-7).  With many
-TRS-80 keyboard drivers, these keys map to the corresponding ASCII
-characters; with others, they do nothing.  In some cases you may find
-the shift state is reversed from what it should be; if you press [ but
-{ is displayed instead (etc.), see the -shiftbracket and
--noshiftbracket options below to correct the problem.  The Insert key
-maps to the same position as underscore (address bit 3, data bit 7),=20
-so that this key can be used both with and without shift pressed;
-with many TRS-80 keyboard drivers one of these maps to ASCII code 0x7f.
-
-On a German keyboard, the umlaut and "ess-tsett" keys should activate
-the corresponding characters used in the GENIE, a German Model I clone.
-This feature is most useful together with the "-charset genie" command
-line argument.
-
-Pressing a key on a PC numeric keypad with NumLock disengaged emulates
-the Alpha Products joystick.  Keys 2, 4, 6, 8 (KP_Down, KP_Left,
-KP_Right, KP_Up) are the main directions; keys 1, 3, 7, and 9 (KP_End,
-KP_Page_Down, KP_Home, KP_Page_Up) work as diagonal directions by
-activating two main directions at once; and key 0 (KP_Insert) or 5
-(KP_Begin) is the fire button.  Note that your X server may default to
-sending digits for the keys on the numeric pad even if NumLock is not
-pressed.  If you have this problem, you can use the xmodmap program to rem=
ap
-your numeric pad, and use the xev program to debug it.
-.SH Emulated cassette
-To control the emulated cassette, a file called ".cassette.ctl" in the
-current directory keeps track of what file is currently loaded as
-the cassette tape and the current position within that file.  The
-\fBcassette\fP(1) shell script provides a way to manipulate this file.
+.B xtrs
+is an emulator for a series of 8-bit microcomputers manufactured by Tandy/=
Radio
+Shack in the 1970s and 1980s.
+The program is built on top of a Zilog Z80 emulator, with added routines to
+support keyboard and video I/O through an X interface.
+The hardware emulation can operate as a TRS-80 Model I, Model III, Model 4=
, or
+Model 4P.
+.PP
+.B xtrs
+supports 48kiB of RAM in Model I or Model III mode, and 128kiB in Model 4 =
or
+Model 4P mode.
+Floppy disks and hard disks are emulated using files to store the data; or=
 under
+Linux only, real floppy drives can be used.
+A printer is emulated by sending its output to the standard output.
+A serial port is emulated using a Unix terminal device.
+Cassette I/O is emulated using files to store the cassette data; real cass=
ettes
+can also be read or written (with luck), either directly through your soun=
d card
+(on Linux and other systems with OSS-compatible sound drivers), or via
+.I .wav
+files.
+Game sound and music output are also supported if you have an OSS-compatib=
le
+sound driver; sound output though the cassette port, through the Model 4 s=
ound
+option, and through the optional Orchestra-85/90 music synthesizer card ar=
e all
+emulated.
+In Model I mode, the HRG1B graphics card is emulated.
+In Model III and 4/4P mode, you can select whether the Radio Shack graphic=
s card
+or Micro Labs Grafyx Solution is emulated.
+There is also a mouse driver for Model 4/4P mode.
+Several common time-of-day clock cards are emulated on all models.
+The Alpha Products joystick is emulated using the keyboard's numeric keypa=
d.
+.PP
+Because
+.B xtrs
+emulates the hardware, all known TRS-80 Model I/III/4/4P operating systems
+should run on it, including all flavors of
+.IR TRSDOS ,
+.IR LDOS/LS-DOS ,
+.IR NEWDOS ,
+.IR DOSPLUS ,
+.IR MultiDOS ,
+and
+TRS-80
+.IR CP/M .
+However, the emulator also includes some extensions to the standard hardwa=
re,
+and the special drivers, utilities, and instructions needed for these are =
not
+provided for all operating systems.
+.PP
+The Z80 emulator has a debugger called
+.IR zbx .
+You can enter the debugger either by starting
+.B xtrs
+with the
+.B \-debug
+flag or by pressing
+.B F9
+while
+.B xtrs
+is running.
+The debugger runs in the X terminal window that you started
+.B xtrs
+from.
+Once you are in the debugger, type
+.if "\*(.T"ascii" "\c
+.B help\c
+.ie "\*(.T"ascii" "
+ \" ordinary paddable space
+for more information.
+.PP
+Special support in the emulator allows the program to block when waiting f=
or
+information from the keyboard.
+This will work only for programs that wait for keyboard input using the st=
andard
+Model I/III ROM call; the emulator decides whether to block the Z80 program
+when it tries to read from the keyboard memory by pattern-matching its sta=
ck.
+.SS Keys
+The following keys on the host keyboard have special meanings to
+.BR xtrs .
+.PP
+.B F11
+toggles onscreen help on the keyboard mappings.
+.PP
+.BR LeftArrow ,
+.BR Backspace ,
+or
+.B Delete
+is the TRS-80 left arrow key.
+.B RightArrow
+or
+.B Tab
+is the right arrow key.
+.B UpArrow
+is the up arrow key.
+.B DownArrow
+or
+.B Linefeed
+is the down arrow key.
+.B Esc
+or
+.B Break
+is the Break key.
+.BR Home ,
+.BR Clear ,
+or
+.B LeftAlt
+is the Clear key.
+.B Control
+is the Model 4 Ctrl key (address bit 7, data bit 2).
+.B RightAlt
+is equivalent to the shifted down arrow key (used as a control key with so=
me
+TRS-80 software).
+.PP
+.BR F1 ,
+.BR F2 ,
+and
+.B F3
+are the Model 4/4P function keys (address bit 7, data bits 4, 5, and 6).
+.B F1
+is also the Model I Electric Pencil control key that some users added to t=
heir
+machines.
+.B F4
+is the Model 4 Caps Lock key (address bit 7, data bit 3).
+.BR F5 ,
+.BR Compose ,
+or
+.B ScrollLock
+is equivalent to the @ key (so that @ can be used as a modifier key).
+.B F6
+is equivalent to the 0 key (so that a shifted 0 can be obtained).
+.B F7
+signals a floppy disk change (see
+.BR "Emulated floppy disks" ,
+below).
+.B F8
+exits the program.
+.B F9
+enters the
+.I zbx
+debugger.
+.B F10
+is the reset button.
+.PP
+In Model III, 4, and 4P modes, the left and right
+.B Shift
+keys are distinct; in Model I mode, they are the same.
+The
+.B PageUp
+and
+.B PageDown
+keys always activate the positions that correspond to the Model III/4/4P l=
eft
+and right shift keys (address bit 7, data bits 0 and 1 respectively), even=
 in
+Model I mode.
+The
+.B End
+key activates an unused position in the keyboard matrix (address bit 7, da=
ta bit
+7).
+.PP
+The keys
+.BR [ ,
+.BR \(rs ,
+.BR ] ,
+.BR \(ha ,
+and
+.B _
+also activate unused positions
+in the keyboard matrix (address bit 3, data bits 3\(en7), as do the
+ASCII-shifted counterparts of the first four
+.RB ( { ,
+.BR | ,
+.BR } ,
+and
+.BR \(ti );
+see above regarding
+.BR Delete .
+With many TRS-80 keyboard drivers, these keys map to the corresponding ASC=
II
+characters; with others, they do nothing.
+In some cases you may find the shift state reversed from what you expect; =
if,
+for instance, you press
+.B [
+but \(lq{\(rq is displayed instead, see
+.B \-shiftbracket
+and
+.B \-noshiftbracket
+in
+.BR Options ,
+below, to correct the problem.
+The
+.B Insert
+key maps to the same position as underscore (address bit 3, data bit 7), s=
o that
+this key can be used both with and without shift pressed; with many TRS-80
+keyboard drivers one of these maps to ASCII code 0x7f (DEL).
+.PP
+On a German keyboard, the
+.B
+.umlaut
+and
+.B
+.ess-tsett
+keys should activate the corresponding characters used in the GENIE, a Ger=
man
+Model I clone.
+This feature is most useful together with the
+.B \-charset genie
+command-line option.
+.PP
+Pressing a key on a PC-style keyboard's numeric keypad with
+.B NumLock
+disengaged emulates the Alpha Products joystick.
+Keys 2, 4, 6, and 8
+.RB ( KP_Down ,
+.BR KP_Left ,
+.BR KP_Right ,
+and
+.BR KP_Up )
+are the main directions;
+keys 1, 3, 7, and 9
+.RB ( KP_End ,
+.BR KP_Page_Down ,
+.BR KP_Home ,
+.BR KP_Page_Up )
+work as diagonal directions by activating two main directions at once; and=
 key 0
+.RB ( KP_Insert )
+or 5
+.RB ( KP_Begin )
+is the fire button.
+Note that your X server may default to sending digits for the keys on the
+numeric pad even if
+.B NumLock
+is not active.
+If you have this problem, you can use
+.BR xev (1)
+to determine the names of the X keysyms generated by your keystroke events.
+You may need to check or update your XKB configuration.
+Alternatively, you can use
+.BR xmodmap (1)
+to remap your numeric pad.
+.SS Emulated cassette
+To control the emulated cassette, a file called
+.I .cassette.ctl
+in the current working directory keeps track of what file is currently loa=
ded as
+the cassette tape and the current position within that file.
+The
+.BR cassette (1)
+shell script provides a way to manipulate this file.
 You may use this script to load and
-position cassette tape files.  The operation works very much like an
-actual tape recorder.  See the \fBcassette\fP man page for more information
-about the cassette shell script and the cassette file formats that are sup=
ported.
-.SH Printer
-For printer support, any text sent to the TRS-80's printer (using LPRINT
-or LLIST, for example) is sent to the standard output.
-.SH Emulated floppy disks
-In Model I mode, \fBxtrs\fP emulates a Radio Shack Expansion Interface
-with the Percom Doubler or Radio Shack Doubler installed.  The Doubler
-provides double-density disk access by allowing either the stock
+position cassette tape files.
+The operation works very much like an
+actual tape recorder.
+The
+.B cassette
+man page has more information about the shell script and the cassette file
+formats that are supported.
+.SS Printer
+For printer support, any text sent to the TRS-80's printer (using LPRINT or
+LLIST, for example) is sent to the standard output.
+.SS Emulated floppy disks
+In Model I mode,
+.B xtrs
+emulates a Radio Shack Expansion Interface with the Percom Doubler or Radio
+Shack Doubler installed.
+The Doubler provides double-density disk access by allowing either the sto=
ck
 WD1771 FDC chip or a WD1791 chip to be selected under program control.
-At powerup the 1771 is selected, so operating systems with no Doubler
-driver see a stock system.  By default, the emulator pretends to be
-both a Percom and Radio Shack Doubler at the same time -- it responds
-to the special commands of both -- so a driver for either should work.
-Under LDOS, use the command "FDUBL" (newer versions of LDOS), or
-"PDUBL" or "RDUBL" (older versions) to install the driver. Software that
-tries to detect which doubler you have (such as Super Utility) may be
-confused by the emulation of both at once, so you can choose to emulate
-only one with a command line option; see below.
-
-In Model III, 4, or 4P mode, \fBxtrs\fP emulates the stock floppy
-controller, which uses a WD1793 chip (software-compatible with the
-WD1791) to provide both single and double density.
-
-Four 5.25-inch floppy drives are emulated, with storage in files named
-diskM-U, where M is the TRS-80 model (1, 3, 4, or 4p) and U is the
-drive unit number (0, 1, 2, or 3).  If a file of the required name is
-not found, a drive with no disk in it is emulated (but see below).  If
-the user does not have write permission for a floppy file, and/or the
-file has an internal write protect flag set, a write-protect tab is
-emulated.  Use the \fBmkdisk\fP(1) program to turn the write protect
-flag on or off.  To change floppies in an emulated drive, rename the
-existing file for the drive (if any), rename the new floppy file to
-the proper name, and hit function key F7 in the emulator.
-
+At powerup the 1771 is selected, so operating systems with no Doubler driv=
er see
+a stock system.
+By default, the emulator pretends to be both a Percom and Radio Shack Doub=
ler at
+the same time\(emit responds to the special commands of both\(emso a drive=
r for
+either should work.
+Under
+.IR LDOS
+use the command
+.I FDUBL
+(on newer versions of
+.IR LDOS ),
+or
+.I PDUBL
+or
+.I RDUBL
+(on older versions) to install the driver.
+Software that tries to detect which doubler you have (such as
+.IR "Super Utility" )
+may be confused by the emulation of both at once, so you can choose to emu=
late
+only one with a command-line option; see
+.B Options
+below.
+.PP
+In Model III, 4, or 4P mode,
+.B xtrs
+emulates the stock floppy controller, which uses a WD1793 chip
+(software-compatible with the WD1791) to provide both single and double de=
nsity.
+.PP
+Four
+.5-1/4
+-inch floppy drives are emulated, with storage in files named
+.IR disk M \- U,
+where
+.I M
+is the TRS-80 model
+.RB ( 1 ,
+.BR 3 ,
+.BR 4 ,
+or
+.BR 4p )
+and
+.I U
+is the
+drive unit number
+.RB ( 0 ,
+.BR 1 ,
+.BR 2 ,
+or
+.BR 3 ).
+If a file of the required name is not found, a drive with no disk in it is
+emulated (but see below).
+If the user does not have write permission for a floppy file, and/or the f=
ile
+has an internal write protect flag set, a write-protect tab is emulated.
+Use the
+.BR mkdisk (1)
+program to turn the write protect flag on or off.
+To change floppies in an emulated drive, rename the existing file for the =
drive
+(if any), rename the new floppy file to the proper name, and press
+.B F7
+(see
+.BR Keys,
+above).
+.PP
 If you try to boot an emulated Model I, III, or 4 with no file named
-diskM-0 (that is, no disk in drive 0), \fBxtrs\fP emulates having no
-floppy disk controller.  The behavior of a real machine with a disk
-controller in this case didn't seem useful to emulate faithfully: A
-real Model I hangs with a screen full of garbage; a real Model III or
-4 goes into a retry loop printing "Diskette?" on the screen and
-rechecking whether you've inserted one.  A real Model 4P always has a
-floppy controller, however, so \fBxtrs\fP always emulates one.
-
+.IR disk M \-0
+(that is, no disk in drive 0),
+.B xtrs
+emulates having no floppy disk controller.
+The behavior of a real machine with a disk controller in this case didn't =
seem
+useful to emulate faithfully: a real Model I hangs with a screen full of
+garbage; a real Model III or 4 goes into a retry loop printing "Diskette?"=
 on
+the screen and rechecking whether you've inserted one.
+A real Model 4P always has a floppy controller, however, so
+.B xtrs
+always emulates one.
+.PP
 Due to a limitation of the original Model I hardware, drive :3 cannot
-be double-sided in Model I mode.  In the original Model I, you could
-not have a drive :3 at all if any drive in the system was
-double-sided, but the emulator is able to be more forgiving.
-
-Emulated floppy image files can be of any of three types: JV1,
-compatible with Jeff Vavasour's popular freeware Model I emulator for
-MS-DOS; JV3, a compatible extension of a format first used in
-Vavasour's commercial Model III/4 emulator; or DMK, compatible with
-David Keil's Model 4 emulator.  All three types work in \fBxtrs\fP
-regardless of what model it is emulating.  A heuristic is used to
-decide which type of image is in a drive, as none of the types has a
-magic number or signature.
-
-JV1 supports only single density, single sided, with directory on
-track 17.  Sectors must be 256 bytes long.  Use FORMAT (DIR=3D17) if you
-want to format JV1 disks with more (or less) than 35 tracks under
-LDOS.
-
-JV3 is much more flexible, though it still does not support everything
-the real controllers could do.  It is probably best to use JV3 for all
-the disk images you create, since it is the most widely implemented by
-other emulators, unless you have a special reason to use one of the
-others.  A JV3 disk can be formatted with 128, 256, 512, or 1024-byte
-sectors, 1 or 2 sides, single or double density, with either FB
-(normal) or F8 (deleted) data address mark on any sector.  In single
-density the nonstandard data address marks FA and F9 are also
-available.  You cannot format a sector with an incorrect track number
-or head number.  You can format a sector with an intentional CRC error
-in the data field.  \fBxtrs\fP supports at most 5802 total sectors on
-a JV3 image.
-
-The original Vavasour JV3 format supported only 256-byte sectors, and
-had a limit of 2901 total sectors.  If you use sector sizes other
-than 256 bytes or format more than 2901 sectors on a disk image,
-emulators other than \fBxtrs\fP may be unable to read it.  Note that
-an 80 track, double-sided, double-density (18 sector) 5.25-inch floppy
-will fit within the original 2901 sector limit; the extension to 5802
-is primarily for emulation of 8-inch drives (discussed below).
-
-The DMK format is the most flexible.  It supports essentially
-everything that the original hardware could do, including all
-"protected" disk formats.  However, a few protected disks still may
-not work with xtrs due to limitations in xtrs's floppy disk controller
-emulation rather than limitations of the DMK format; see the
-LIMITATIONS section below.
-
-The program \fBmkdisk\fP(1) makes a blank emulated floppy or "bulk
-erases" an existing one.  By default, mkdisk makes a JV3 floppy, but
-with the -1 flag it makes a JV1 floppy, or with the -k flag a DMK
-floppy.  See the \fBmkdisk\fP man page for more information.
-
-Early Model I operating systems used an FA data address mark for the
-directory on single density disks, while later ones wrote F8 but would
-accept either upon reading.  The change was needed because FA is a
-nonstandard DAM that is fully supported only by the WD1771 floppy disk
-controller used in the Model I; the controllers in the Model III and 4
-cannot distinguish between FA and FB (which is used for non-directory
-sectors) upon reading, and cannot write FA.  To deal nicely with this
-problem, \fBxtrs\fP implements the following kludge.  On writing in
-single density, an F8 data address mark is recorded as FA.  On reading
-with an emulated WD1771 (available in Model I mode only), FA is
-returned as FA; on reading with a WD179x, FA is returned as F8.  This
-trick makes the different operating systems perfectly compatible with
-each other, which is better than on a real Model I!  You can use the
--truedam flag to turn off this kludge if you need to; in that case the
-original hardware is emulated exactly.
-
-TRS-80 programs that attempt to measure the rotational
-speed of their floppy disk drives using timing loops will get the
-answers they expect, even when \fBxtrs\fP does not
-emulate instructions at the same speed as the original
-machines. This works because \fBxtrs\fP keeps a virtual clock
-(technically, a T-state counter),
-which measures how much time it should have taken to execute the
-instruction stream on a real machine, and it ties the emulation of
-floppy disk index holes to this clock, not to real time.
-.SH Emulated 8-inch floppy disks
-In addition to the four standard 5.25-inch drives, \fBxtrs\fP also
-emulates four 8-inch floppy drives.  There is no widely-accepted
-standard hardware interface for 8-inch floppies on the TRS-80, so \fBxtrs\=
fP
-emulates a pseudo-hardware interface of its own and provides an LDOS/LS-DOS
+be double-sided in Model I mode.
+In the original Model I, you could not have a drive :3 at all if any drive=
 in
+the system was double-sided, but the emulator is able to be more forgiving.
+.PP
+Emulated floppy image files can be of any of three types: JV1, compatible =
with
+Jeff Vavasour's popular freeware Model I emulator for
+.IR MS-DOS ;
+JV3, a compatible extension of a format first used in Vavasour's commercial
+Model III/4 emulator; or DMK, compatible with David Keil's Model 4 emulato=
r.
+All three types work in
+.B xtrs
+regardless of what model it is emulating.
+A heuristic is used to decide which type of image is in a drive, as none o=
f the
+types has a magic number or signature.
+.PP
+JV1 supports only single-sided, single-density diskettes, with directory on
+track 17.
+Sectors must be 256 bytes long.
+Use
+.B FORMAT (DIR=3D17)
+if you want to format JV1 disks with more (or less) than 35 tracks under
+.IR LDOS .
+.PP
+JV3 is much more flexible, though it still does not support everything the=
 real
+controllers could do.
+It is probably best to use JV3 for all the disk images you create, since i=
t is
+the most widely implemented by other emulators, unless you have a special =
reason
+to use one of the others.
+A JV3 disk can be formatted with 128, 256, 512, or 1024-byte sectors, 1 or=
 2
+sides, single or double density, with either an 0xFB (normal) or 0xF8 (del=
eted)
+data address mark on any sector.
+On single-density JV3 disks, the nonstandard data address marks 0xFA and 0=
xF9
+are also available.
+You cannot format a sector with an incorrect track number or head number.
+You
+.I can
+format a sector with an intentional CRC error in the data field.
+.B xtrs
+supports at most 5802 total sectors on a JV3 image.
+.PP
+The original Vavasour JV3 format supported only 256-byte sectors, and had a
+limit of 2901 total sectors.
+If you use sector sizes other than 256 bytes or format more than 2901 sect=
ors on
+a disk image, emulators other than
+.B xtrs
+may be unable to read it.
+Note that an 80 track, double-sided, double-density (18 sector)
+.5-1/4
+-inch floppy
+will fit within the original 2901 sector limit; the extension to 5802 is
+primarily for emulation of 8-inch drives (discussed below).
+.PP
+The DMK format is the most flexible.
+It supports essentially everything that the original hardware could do,
+including all \(lqprotected\(rq disk formats.
+However, a few protected disks still may
+not work with
+.B xtrs
+due to limitations in
+.BR xtrs 's
+floppy disk controller emulation rather than limitations of the DMK format=
; see
+.BR "Bugs and limitations" ,
+below.
+.PP
+The program
+.BR mkdisk (1)
+makes a blank emulated floppy or \(lqbulk erases\(rq an existing one.
+By default,
+.B mkdisk
+makes a JV3 floppy, but with the
+.B \-1
+flag it makes a JV1 floppy, or with the
+.B \-k
+flag a DMK
+floppy.
+See the
+.B mkdisk
+man page for more information.
+.PP
+Early Model I operating systems used an 0xFA data address mark (DAM) for t=
he
+directory on single-density disks, while later ones wrote 0xF8 but would a=
ccept
+either upon reading.
+The change was needed because 0xFA is a nonstandard DAM that is fully supp=
orted
+only by the WD1771 floppy disk controller used in the Model I; the control=
lers
+in the Model III and 4 cannot distinguish between 0xFA and 0xFB (which is =
used
+for non-directory sectors) upon reading, and cannot write 0xFA.
+To deal nicely with this problem,
+.B xtrs
+implements the following kludge.
+On writing in single density, an 0xF8 data address mark is recorded as 0xF=
A.
+On reading with an emulated WD1771 (available in Model I mode only), 0xFA =
is
+returned as 0xFA; on reading with a
+.RI WD179 x ,
+0xFA is returned as 0xF8.
+This trick makes the different operating systems perfectly compatible with=
 each
+other, which is better than on a real Model I!
+You can use the
+.B \-truedam
+flag to turn off this kludge if you need to; in that case the original har=
dware
+is emulated exactly.
+.PP
+TRS-80 programs that attempt to measure the rotational speed of their flop=
py
+disk drives using timing loops will get the answers they expect, even when
+.B xtrs
+does not emulate instructions at the same speed as the original machines.
+This works because
+.B xtrs
+keeps a virtual clock (technically, a T-state counter), which measures how=
 much
+time it should have taken to execute the instruction stream on a real mach=
ine,
+and it ties the emulation of floppy disk index holes to this clock, not to=
 real
+time.
+.SS Emulated 8-inch floppy disks
+In addition to the four standard
+.5-1/4
+-inch drives,
+.B xtrs
+also emulates four 8-inch floppy drives.
+There is no widely-accepted standard hardware interface for 8-inch floppie=
s on
+the TRS-80, so
+.B xtrs
+emulates a pseudo-hardware interface of its own and provides an
+.IR LDOS / LS-DOS
 driver for it.
-
-Storage for the emulated 8-inch disks is in files named diskM-U, where
-M is the TRS-80 model number (1, 3, 4, or 4p) and U is a unit number
-(4, 5, 6, or 7).  The only difference between 5.25-inch and 8-inch
-emulated drives is that the emulator allows you to format more bytes
-per track in the latter.  A new JV3 floppy can be formatted as either
-5.25-inch or 8-inch depending on whether you initially put it into a
-5.25-inch or 8-inch emulated drive.  A new DMK floppy, however, must
-be created with the -8 flag to mkdisk in order to be large enough for
-use in an 8-inch emulated drive.  JV1 floppies cannot be used in
-8-inch drives.  Be careful not to put an emulated floppy into a
-5.25-inch emulated drive after it has been formatted in an 8-inch
-emulated drive or vice versa; the results are likely to be confusing.
-Consider using different file extensions for the two types; say, \.dsk
-for 5.25-inch and \.8in for 8-inch.
-
-To use the emulated 8-inch drives, you'll need a driver.  Under LDOS
-or LS-DOS, use the program XTRS8/DCT supplied on the emulated floppy
-\fIutility.dsk\fP.  This driver is a very simple wrapper around the
-native LDOS/LS-DOS floppy driver.  Here are detailed instructions.
-
-First, make sure an appropriate version of LDOS is in emulated floppy
-drive 0, and the supplied file \fIutility.dsk\fP is in another
-emulated floppy drive.  Boot LDOS.  If you are using Model I LDOS, be
-sure FDUBL is running.
-
-Second, type the following commands.  Here \fId\fP is the LDOS drive
-number you want to use for the 8-inch drive and \fIu\fP is the
-unit number you chose when naming the file.  Most likely you will
-choose \fId\fP and \fIu\fP to be equal to reduce confusion.
-
-.nf
-    SYSTEM (DRIVE=3D\fId\fP,DRIVER=3D"XTRS8",ENABLE)
-    Enter unit number ([4]-7): \fIu\fP
-.fi
-
-You can repeat these steps with different values of \fId\fP and
-\fIu\fP to have more than one 8-inch drive.  You might want to repeat
-four times using 4, 5, 6, and 7, or you might want to save some drive
-numbers for hard drives (see below).
-
-Finally, it's a good idea to give the SYSTEM (SYSGEN) command (Model
-I/III) or SYSGEN command (Model 4/4P).  This command saves the SYSTEM
-settings, so the 8-inch drives will be available again the next time
-you reboot or restart the emulator.  If you need to access an 8-inch
-drive after booting from a disk that hasn't been SYSGENed, simply use
-the same SYSTEM command again.
-
-In case you want to write your own driver for another TRS-80 operating
-system, here are details on the emulated pseudo-hardware.  The 8-inch
-drives are accessed through the normal floppy disk controller, exactly
-like 5.25-inch drives.  The four 5.25-inch drives have hardware select cod=
es
-1, 2, 4, and 8, corresponding respectively to files diskM-0, -1, -2, and
--3.  The four 8-inch drives have hardware select codes 3, 5, 6, and 7,
-corresponding respectively to files diskM-4, -5, -6, and -7.
-(See also the \-sizemap option below, however.)
-.SH Real floppy disks
-Under Linux only, any diskM-U file can be a symbolic link to a real
-floppy disk drive, typically /dev/fd0 or /dev/fd1.  Most PCs should be
-able to read and write TRS-80 compatible floppies in this way.  Many
-PC floppy controllers cannot handle single density, however, and some
-may have problems even with double density disks written on a real
-TRS-80, especially disks formatted by older TRS-80 operating systems.
-Use the -doublestep flag if you need to read 35-track or 40-track
-media in an 80-track drive.  If you need to write 35-track or 40-track
-media in an 80-track drive, bulk-erase the media first and format it
-in the 80-track drive.  Don't write to a disk in an 80-track drive if it
-has ever been written to in a 40-track drive.  The narrower head used
-in an 80-track drive cannot erase the full track width written by the
-head in a 40-track drive.
-
-If you link one of the 5.25-inch floppy files (diskM-0 through
-diskM-3) to a real floppy drive, TRS-80 programs will see it as a
-5.25-inch drive, but the actual drive can be either 3.5-inch or
-5.25-inch.  The drive will be operated in double density (or single
-density), not high density, so be sure to use the appropriate media.
-
-If you link one of the 8-inch floppy files (diskM-4 through diskM-7)
-to a real floppy drive, TRS-80 programs will see it as an 8-inch
-drive.  Again, you need to use the XTRS8/DCT driver described above to
-enable LDOS/LS-DOS to access an 8-inch drive.  The real drive can be
-either 3.5-inch, 5.25-inch, or 8-inch.  A 3.5-inch or 5.25-inch drive
-will be operated in high-density mode, using MFM recording if the
-TRS-80 is trying to do double density, FM recording if the TRS-80 is
-trying to do single density.  In this mode, these drives can hold as
-much data as a standard 8-inch drive.  In fact, a 5.25-inch HD drive
-holds exactly the same number of bits per track as an 8-inch drive; a
-3.5-inch HD drive can hold 20% more, but we waste that space when
-using one to emulate an 8-inch drive.  In both cases we also waste the
-top three tracks, since an 8-inch drive has only 77 tracks, not 80.
-
-The nonstandard FA and F9 data address marks available in single
-density on a real Model I with the WD1771 controller also need special
-handling.  A PC-style floppy disk controller can neither read nor
-write sectors with such DAMs at all.  This raises three issues: (1) It
-will be impossible for you to read some Model I disks on your PC even
-if your PC otherwise supports single density.  In particular, Model I
-TRSDOS 2.3 directory tracks will be unreadable.  (2) On writing in
-single density, \fBxtrs\fP silently records a F9 or FA DAM as F8.  (3)
-On reading in single density with an emulated WD1771 (Model I mode
-only), F8 is returned as FA.  If you need more accurate behavior, the
--truedam flag will turn on error messages on attempts to write F9 or
-FA DAMs and will turn off translation of F8 to FA on reading.
-
-Hint: Be sure to set the drive type correctly in your PC's BIOS.
-Linux and xtrs rely on this information to know how fast your drives
-are spinning and hence what data rate to use when reading and writing.
-All 3.5-inch drives spin at 300 RPM.  Newer 5.25-inch high-density
-capable drives ("1.2MB" drives) normally always spin at 360 RPM.  (Some
-can be jumpered to slow down to 300 RPM when in double-density mode,
-but you should not do that when plugging one into a PC.)  Older
-5.25-inch drives that cannot do high density ("180KB", "360KB" or
-"720KB" 5.25-inch drives) always spin at 300 RPM.  All 8-inch drives
-spin at 360 RPM.  If you plug an 8-inch drive into a PC (this requires
-a 50-pin to 34-pin adaptor cable), tell your BIOS that it is a
-5.25-inch 1.2MB drive.
-.SH Emulated hard disks
-\fBxtrs\fP can emulate a hard disk in a file in one of two ways: it
-can use a special, xtrs-specific LDOS driver called XTRSHARD/DCT,
-or it can emulate the Radio Shack hard drive controller (based on
-the Western Digital WD1010) and use the native drivers for the
-original hardware.
-
-.B Using XTRSHARD/DCT
-
-The XTRSHARD/DCT driver has been tested and
-works under both LDOS 5.3.1 for Model I or III and TRSDOS/LS-DOS 6.3.1
-for Model 4/4P.  It may or may not work under earlier LDOS versions.  It
-definitely will not work under other TRS-80 operating systems or with
-emulators other than \fBxtrs\fP.  The hard disk format was designed by
-Matthew Reed for his Model I/III and Model 4 emulators; \fBxtrs\fP
-duplicates the format so that users can exchange hard drive images
-across the emulators.
-
-To use XTRSHARD/DCT, first run the \fBmkdisk\fP program
-under Unix to create a blank hard drive (.hdv) file.  Typical usage
-would be: \fImkdisk -h mydisk.hdv\fP.  See the \fBmkdisk\fP(1) man
-page for other options.
-
-Second, link the file to an appropriate name.  XTRSHARD/DCT supports up
-to eight hard drives, with names of the form hardM-U, where M is the
-TRS-80 model (1, 3, or 4; in this case Model 4P also uses M=3D4) and U
-is a unit number from 0 to 7.  It looks for these files in the same
-directory as the floppy disk files diskM-U.
-
-Third, make sure an appropriate version of LDOS is in emulated floppy
-drive 0, and the supplied file \fIutility.dsk\fP is in another
-emulated floppy drive.  Boot LDOS.  If you are using Model I LDOS
-5.3.1, patch a bug in the FORMAT command by typing=20
-\fIPATCH FORMAT/CMD.UTILITY M1FORMAT/FIX\fP.
-You need to apply this patch only
-once.  It must not be applied to Model III or Model 4/4P LDOS.
-
-Fourth, type the following commands.  Here \fId\fP is the LDOS drive number
-you want to use for the hard drive (a typical choice would be 4) and \fIu\=
fP
-is the unit number you chose when naming the file (most likely 0).
-
-.nf
-    SYSTEM (DRIVE=3D\fId\fP,DRIVER=3D"XTRSHARD",ENABLE)
-    Enter unit number ([0]-7): \fIu\fP
-    FORMAT \fId\fP (DIR=3D1)
-.fi
-
-Answer the questions asked by FORMAT as you prefer.  The
-\fIDIR=3D1\fP parameter to FORMAT is optional; it causes the hard
-drive's directory to be on track 1, making the initial size of
-the image smaller.  You can repeat these steps with different values of
-\fId\fP and \fIu\fP to have more than one hard drive.
-
-Finally, it's a good idea to give the SYSTEM (SYSGEN) command (Model
-I/III) or SYSGEN command (Model 4/4P).  This command saves the SYSTEM
-settings, so the drive will be available again the next time you
-reboot or restart the emulator.  If you need to access the hard disk
-file after booting from a floppy that hasn't been SYSGENed, simply use
-the same SYSTEM command(s) again, but don't FORMAT.  You can freely
-use a different drive number or (if you renamed the hard disk file) a
-different unit number.
-
-The F7 key currently doesn't allow XTRSHARD/DCT disk changes to be
-recognized, but you can change to a different hard disk file for the
-same unit by renaming files as needed and rebooting LDOS.
-
-Technical note: XTRSHARD/DCT is a small Z-80 program that implements
-all the required functions of an LDOS disk driver.  Instead of talking
-to a real (or emulated) hard disk controller, however, it uses special
-support in \fBxtrs\fP that allows Z-80 programs to open, close, read,
-and write Unix files directly.  This support is described further in
-the "Data import and export" section below.
-
+.PP
+Storage for the emulated 8-inch disks is in files named
+.IR disk M \- U,
+where
+.I M
+is the TRS-80 model
+.RB ( 1 ,
+.BR 3 ,
+.BR 4 ,
+or
+.BR 4p )
+and
+.I U
+is the
+drive unit number
+.RB ( 4 ,
+.BR 5 ,
+.BR 6 ,
+or
+.BR 7 ).
+The only difference between
+.5-1/4
+-inch and 8-inch emulated drives is that the emulator allows you to format=
 more
+bytes per track in the latter.
+A new JV3 floppy can be formatted as either
+.5-1/4
+-inch or 8-inch depending on whether you initially put it into a
+.5-1/4
+-inch or 8-inch emulated drive.
+A new DMK floppy, however, must be created with the
+.B \-8
+flag to
+.B mkdisk
+in order to be large enough for use in an 8-inch emulated drive.
+JV1 floppies cannot be used in 8-inch drives.
+Be careful not to put an emulated floppy into a
+.5-1/4
+-inch emulated drive after it has been formatted in an 8-inch emulated dri=
ve or
+vice versa; the results are likely to be confusing.
+Consider using different file extensions for the two types; say,
+.I .dsk
+for
+.5-1/4
+-inch and
+.I .8in
+for 8-inch.
+.PP
+To use the emulated 8-inch drives, you'll need a driver.
+Under
+.I LDOS
+or
+.IR LS-DOS ,
+use the program
+.I XTRS8/DCT
+supplied on the emulated floppy
+.IR utility.dsk .
+This driver is a very simple wrapper around the native
+.IR LDOS / LS-DOS
+floppy driver.
+Here are detailed instructions.
+.PP
+First, make sure an appropriate version of
+.I LDOS
+is in emulated floppy drive 0, and the supplied file
+.I utility.dsk
+is in another emulated floppy drive.
+Boot
+.IR LDOS .
+If you are using Model I
+.IR LDOS ,
+be sure
+.I FDUBL
+is running.
+.PP
+Second, type the following commands.
+Here
+.I d
+is the
+.I LDOS
+drive
+number you want to use for the 8-inch drive and
+.I u
+is the unit number you chose when naming the file.
+Most likely you will choose
+.I d
+and
+.I u
+to be equal to reduce confusion.
+.RS
+.EX
+.B SYSTEM (DRIVE=3D\c
+.BOLD-ITALIC d\c
+.B ,DRIVER=3D"XTRS8",ENABLE)
+Enter unit number ([4]-7): \c
+.BOLD-ITALIC u
+.EE
+.RE
+You can repeat these steps with different values of
+.I d
+and
+.I u
+to have more than one 8-inch drive.
+You might want to repeat four times using
+.BR 4 ,
+.BR 5 ,
+.BR 6 ,
+and
+.BR 7 ,
+or you might want to save some drive numbers for hard drives (see below).
+.PP
+Finally, it's a good idea to give the
+.I SYSTEM (SYSGEN)
+command (Model I/III) or
+.I SYSGEN
+command (Model 4/4P).
+This command saves the
+.I SYSTEM
+settings, so the 8-inch drives will be available again the next time you r=
eboot
+or restart the emulator.
+If you need to access an 8-inch drive after booting from a disk that hasn'=
t been
+.IR SYSGEN ed,
+simply use the same
+.I SYSTEM
+command again.
+.PP
+In case you want to write your own driver for another TRS-80 operating sys=
tem,
+here are details on the emulated pseudo-hardware.
+The 8-inch drives are accessed through the normal floppy disk controller,
+exactly like
+.5-1/4
+-inch drives.
+The four
+.5-1/4
+-inch drives have hardware select codes
+1, 2, 4, and 8, corresponding respectively to files
+.IR disk M \-0,
+.IR \-1 ,
+.IR \-2 ,
+and
+.IR \-3 .
+The four 8-inch drives have hardware select codes 3, 5, 6, and 7, correspo=
nding
+respectively to files
+.IR disk M \-4,
+.IR \-5 ,
+.IR \-6 ,
+and
+.IR \-7 .
+(See also the
+.B \-sizemap
+option below, however.)
+.SS Real floppy disks
+Under Linux only, any
+.IR disk M \- U
+file can be a symbolic link to a real floppy disk drive, typically
+.I /dev/fd0
+or
+.IR /dev/fd1 .
+.\" XXX: Modern PC-compatibles with support fort legacy peripherals are ge=
tting
+.\" scarce.  Has anyone tried these tricks with a USB floppy drive?
+Most machines with \(lqlegacy\(rq (ISA bus) floppy drive support should be=
 able
+to read and write TRS-80-compatible floppies in this way.
+Many floppy controllers cannot handle single density, however, and some ma=
y have
+problems even with double-density disks written on a real TRS-80, especial=
ly
+disks formatted by older TRS-80 operating systems.
+Use the
+.B \-doublestep
+flag if you need to read 35-track or 40-track media in an 80-track drive.
+If you need to write 35-track or 40-track media in an 80-track drive, bulk=
-erase
+the media first and format it in the 80-track drive.
+Don't write to a disk in an 80-track drive if it has ever been written to =
in a
+40-track drive.
+The narrower head used in an 80-track drive cannot erase the full track wi=
dth
+written by the head in a 40-track drive.
+.PP
+If you link one of the
+.5-1/4
+-inch floppy files
+.RI ( disk M \-0
+through
+.IR disk M \-3 )
+to a real floppy drive, TRS-80 programs will see it as a
+.5-1/4
+-inch drive, but the actual drive can be either
+.3-1/2
+-inch or
+.5-1/4
+-inch.
+The drive will be operated in double density (or single density), not high
+density, so be sure to use the appropriate media.
+.PP
+If you link one of the 8-inch floppy files
+.RI ( disk M \-4
+through
+.IR disk M \-7 )
+to a real floppy drive, TRS-80 programs will see it as an 8-inch drive.
+Again, you need to use the
+.I XTRS8/DCT
+driver described above to enable
+.IR LDOS / LS-DOS
+to access an 8-inch drive.
+The real drive can be either
+.3-1/2
+-inch,
+.5-1/4
+-inch,
+or 8-inch.
+A
+.3-1/2
+-inch or
+.5-1/4
+-inch drive will be operated in high-density mode, using MFM recording if =
the
+TRS-80 is trying to do double density, or FM recording if the TRS-80 is tr=
ying
+to do single density.
+In this mode, these drives can hold as much data as a standard 8-inch driv=
e.
+In fact, a
+.5-1/4
+-inch HD drive holds exactly the same number of bits per track as an 8-inch
+drive; a
+.3-1/2
+-inch HD drive can hold 20% more, but we waste that space when using one to
+emulate an 8-inch drive.
+In both cases we also waste the top three tracks, since an 8-inch drive ha=
s only
+77 tracks, not 80.
+.PP
+The nonstandard 0xFA and 0xF9 data address marks available in single densi=
ty on
+a real Model I with the WD1771 controller also need special handling.
+A ISA-bus floppy disk controller can neither read nor write sectors with s=
uch
+DAMs at all.
+This raises three issues.
+.IP 1.
+It will be impossible for you to read some Model I disks on your machine e=
ven if
+it otherwise supports single density.
+In particular, Model I
+.I TRSDOS
+2.3 directory tracks will be unreadable.
+.IP 2.
+On writing in
+single density,
+.B xtrs
+silently records a 0xF9 or 0xFA DAM as 0xF8.
+.IP 3.
+On reading in single density with an emulated WD1771 (Model I mode only), =
0xF8
+is returned as 0xFA.
+If you need more accurate behavior, the
+.B \-truedam
+flag will turn on error messages on attempts to write 0xF9 or 0xFA DAMs an=
d will
+turn off translation of 0xF8 to 0xFA on reading.
+.PP
+.I Hint:
+Be sure to set the drive type correctly in your machine's firmware.
+Linux and
+.B
+xtrs
+rely on this information to know how fast your drives are spinning and hen=
ce
+what data rate to use when reading and writing.
+All
+.3-1/2
+-inch drives spin at 300 rpm.
+Newer
+.5-1/4
+-inch high-density capable drives (\(lq1.2MB\(rq drives) normally always s=
pin at
+360 rpm.
+(Some can be jumpered to slow down to 300 rpm when in double-density mode,=
 but
+you should not do that when connecting one to a floppy disk controller des=
igned
+for ISA-bus machines.
+Older
+.5-1/4
+-inch drives that cannot do high density (\(lq180kB\(rq, \(lq360kB\(rq, or
+\(lq720kB\(rq
+.5-1/4
+-inch drives) always spin at 300 rpm.
+All 8-inch drives spin at 360 rpm.
+If you plug an 8-inch drive into an ISA-bus floppy disk controller\(emthis
+requires a 50-pin to 34-pin adaptor cable\(emtell your firmware that it is=
 a
+.5-1/4
+-inch 1.2MiB drive.
+.SS Emulated hard disks
+.B xtrs
+can emulate a hard disk in a file in one of two ways: it
+can use a special,
+.BR xtrs -specific
+.I LDOS
+driver called
+.IR XTRSHARD/DCT ,
+or it can emulate the Radio Shack hard drive controller (based on the West=
ern
+Digital WD1010) and use the native drivers for the original hardware.
+.TP
+.B Using \c
+.BOLD-ITALIC XTRSHARD/DCT
+The
+.I XTRSHARD/DCT
+driver has been tested and works under both
+.I LDOS
+5.3.1 for Model I or III and
+.IR TRSDOS / LS-DOS
+6.3.1 for Model 4/4P.
+It may or may not work under earlier
+.I LDOS
+versions.
+It definitely will not work under other TRS-80 operating systems or with
+emulators other than
+.BR xtrs .
+The hard disk format was designed by Matthew Reed for his Model I/III and =
Model
+4 emulators;
+.B xtrs
+duplicates the format so that users can exchange hard drive images across =
the
+emulators.
+.IP ""
+To use
+.IR XTRSHARD/DCT ,
+first run the
+.BR mkdisk (1)
+program to create a blank hard drive
+.RI ( .hdv )
+file.
+A typical usage
+would be
+.BR "mkdisk -h myhd.hdv" .
+See the
+.B mkdisk
+man page for other options.
+.IP ""
+Second, link the file to an appropriate name.
+.I XTRSHARD/DCT
+supports up
+to eight hard drives, with names of the form
+.IR hard M \- U,
+where
+.I M
+is the TRS-80 model
+.RB ( 1 ,
+.BR 3 ,
+or
+.BR 4 ;
+in this case the Model 4P also uses
+.IR M =3D4)
+and
+.I U
+is a unit number in the range 0\(en7.
+It looks for these files in the same directory as the floppy disk files
+.IR disk M \- U.
+.IP ""
+Third, make sure an appropriate version of
+.I LDOS
+is in emulated floppy drive 0, and the supplied file
+.I utility.dsk
+is in another emulated floppy drive.
+Boot
+.IR LDOS .
+If you are using Model I
+.I LDOS
+5.3.1, patch a bug in the
+.I FORMAT
+command by typing
+.BR "PATCH FORMAT/CMD.UTILITY M1FORMAT/FIX" .
+You need to apply this patch only once.
+It must not be applied to Model III or Model 4/4P
+.IR LDOS .
+.IP ""
+Fourth, type the following commands.
+Here
+.I d
+is the
+.I LDOS
+drive number you want to use for the hard drive (a typical choice would be
+.BR 4 )
+and
+.I u
+is the unit number you chose when naming the file (most likely
+.BR 0 ).
+.\" XXX: .RS/.RE don't indent further within this .SS->.IP environment.  B=
ug?
+.br
+.in +1i/2u
+.EX
+.B SYSTEM (DRIVE=3D\c
+.BOLD-ITALIC d\c
+.B ,DRIVER=3D"XTRSHARD",ENABLE)
+Enter unit number ([0]-7): \c
+.BOLD-ITALIC u
+.B FORMAT \c
+.BOLD-ITALIC d \c
+.B (DIR=3D1)
+.EE
+.in -1i/2u
+.br
+Answer the questions asked by
+.I FORMAT
+as you prefer.
+The
+.B DIR=3D1
+parameter to
+.I FORMAT
+is optional; it causes the hard drive's directory to be on track 1, making=
 the
+initial size of the image smaller.
+You can repeat these steps with different values of
+.I d
+and
+.I u
+to have more than one hard drive.
+.IP ""
+Finally, it's a good idea to give the
+.I SYSTEM (SYSGEN)
+command (Model I/III) or
+.I SYSGEN
+command (Model 4/4P).
+This command saves the
+.I SYSTEM
+settings, so the drive will be available again the next time you reboot or
+restart the emulator.
+.IP ""
+If you need to access the hard disk file after booting from a floppy that =
hasn't
+been
+.IR SYSGEN ed,
+simply use the same
+.I SYSTEM
+command(s) again, but don't
+.IR FORMAT .
+You can freely use a different drive number or (if you renamed the hard di=
sk
+file) a different unit number.
+.IP ""
+The
+.B F7
+key currently doesn't allow
+.I XTRSHARD/DCT
+disk changes to be recognized, but you can change to a different hard disk=
 file
+for the same unit by renaming files as needed and rebooting
+.IR LDOS .
+.IP ""
+.I Technical note:
+.I XTRSHARD/DCT
+is a small Z80 program that implements all the required functions of an
+.I LDOS
+disk driver.
+Instead of talking to a real (or emulated) hard disk controller, however, =
it
+uses special support in
+.B xtrs
+that allows Z80 programs to open, close, read, and write Unix files direct=
ly.
+This support is described further in
+.BR "Data import and export" ,
+below.
+.TP
 .B Using native hard disk drivers
-
-Beginning in version 4.1, \fBxtrs\fP also emulates the Radio Shack
-hard disk controller (based on the Western Digital WD1010) and will
-work with the native drivers for this hardware.  This emulation uses
-the same hard drive (.hdv) file format that XTRSHARD/DCT does.  With
-LDOS/LS-DOS, the RSHARDx/DCT and TRSHD/DCT drivers are known to work.
-With Montezuma CP/M 2.2, the optional Montezuma hard disk drivers are
-known to work.  The hard disk drivers for NEWDOS/80 and for Radio
-Shack CP/M 3.0 should work, but they have not yet been tested at this
-writing.  Any bugs should be reported.
-
-To get started, run the \fBmkdisk\fP program under Unix to create a
-blank hard drive (.hdv) file.  Typical usage would be:=20
-\fImkdisk -h mydisk.hdv\fP.
-See the \fBmkdisk\fP(1) man page for other options.
-
-Second, link the file to an appropriate name.  The WD1010 emulation
-supports up to four hard drives, with names of the form hardM-U, where
-M is the TRS-80 model (1, 3, 4, or 4p) and U is a unit number from 0
-to 3.  It looks for these files in the same directory as the floppy
-disk files diskM-U.  If no such files are present, \fBxtrs\fP disables
-the WD1010 emulation.
-
+Beginning in version 4.1,
+.B xtrs
+also emulates the Radio Shack hard disk controller (based on the Western D=
igital
+WD1010) and will work with the native drivers for this hardware.
+This emulation uses the same hard drive
+.RI ( .hdv )
+file format that
+.I XTRSHARD/DCT
+does.
+With
+.IR LDOS / LS-DOS ,
+the
+.IR RSHARD x /DCT
+and
+.I TRSHD/DCT
+drivers are known to work.
+With Montezuma
+.I CP/M
+2.2, the optional Montezuma hard disk drivers are known to work.
+The hard disk drivers for
+.I NEWDOS/80
+and for Radio Shack
+.I CP/M
+3.0 should work, but they have not yet been tested at this writing.
+Any bugs should be reported.
+.IP ""
+To get started, run the
+.BR mkdisk (1)
+program to create a blank hard drive
+.RI ( .hdv )
+file.
+A typical usage
+would be
+.BR "mkdisk -h myhd.hdv" .
+See the
+.B mkdisk
+man page for other options.
+.IP ""
+Second, link the file to an appropriate name.
+The WD1010 emulation supports up to four hard drives, with names of the fo=
rm
+.IR hard M \- U,
+where
+.I M
+is the TRS-80 model
+.RB ( 1 ,
+.BR 3 ,
+.BR 4 ,
+or
+.BR 4p )
+and
+.I U
+is a unit number in the range 0\(en3.
+It looks for these files in the same directory as the floppy disk files
+.IR disk M \- U.
+If no such files are present,
+.B xtrs
+disables the WD1010 emulation.
+.IP ""
 Note that if hard drive unit 0 is present on a Model 4P (file
-hard4p-0), the Radio Shack boot ROM will always try to boot from it,
-even if the operating system does not support booting from a hard
-drive.  If you have this problem, either hold down F2 while booting to
-force the ROM to boot from floppy, or simply avoid using unit number
-0.  Stock TRSDOS/LS-DOS 6 systems do not support booting from a hard
-drive; M.A.D. Software's HBUILD6 add-on to LS-DOS for hard drive
-booting should work, but is untested.  Montezuma CP/M 2.2 does boot
-from the emulated hard drive.
-
-Finally, obtain the correct driver for the operating system you will be
-using, read its documentation, configure the driver, and format the drive.
+.IR hard4p-0 ),
+the Radio Shack boot ROM will always try to boot from it, even if the oper=
ating
+system does not support booting from a hard drive.
+If you have this problem, either hold down
+.B F2
+while booting to force the ROM to boot from floppy, or simply avoid using =
unit
+number 0.
+Stock
+.IR TRSDOS / LS-DOS
+6 systems do not support booting from a hard drive; M.A.D. Software's
+.I HBUILD6
+add-on to
+.I LS-DOS
+for hard drive booting should work, but is untested.
+Montezuma
+.I CP/M
+2.2 does boot from the emulated hard drive.
+.IP ""
+Finally, obtain the correct driver for the operating system you will be us=
ing,
+read its documentation, configure the driver, and format the drive.
 Detailed instructions are beyond the scope of this manual page.
-.SH Data import and export
-Several Z-80 programs for data import and export from various TRS-80
-operating systems are included with \fBxtrs\fP on two emulated floppy
-images.  These programs use special support in the emulator to read
-and write external Unix files, discussed further at the end of this sectio=
n.
-
-The emulated floppy \fIutility.dsk\fP contains some programs for
-transferring data between the emulator and ordinary Unix files.
-IMPORT/CMD, EXPORT/CMD, and SETTIME/CMD run on
-the emulator under Model I/III TRSDOS, Model I/III LDOS, Model I/III
-Newdos/80, and Model 4/4P TRSDOS/LS-DOS 6; they may also work under
-other TRS-80 operating systems.  Model III TRSDOS users will have to
-use TRSDOS's CONVERT command to read utility.dsk.
-
-IMPORT/CMD imports a Unix file and writes it to an emulated disk.
-Usage: \fIIMPORT [-lne] unixfile [trsfile]\fP.  The -n flag converts
-Unix newlines (\\n) to TRS-80 newlines (\\r).  The -l flag converts
-the Unix filename to lower case, to compensate for TRS-80 operating
-systems such as Newdos/80 that convert all command line arguments to
-upper case.  When using the -l flag, you can put a [ or up-arrow in
-front of a character to keep it in upper case.  Give the -e flag if
-your TRS-80 operating system uses the Newdos/80 convention for
-representing the ending record number in an open file control block.
-This should be detected automatically for Newdos/80 itself and for
-TRSDOS 1.3, but you'll need to give the flag for DOSPLUS and possibly
-other non-LDOS operating systems.  If you need the flag but don't give
-it (or vice versa), imported files will come out the wrong length.  If
-the destination file is omitted, IMPORT uses the last component of the
-Unix pathname, but with any "." changed to "/" to match TRS-80 DOS
-file extension syntax.
-
-EXPORT/CMD reads a file from an emulated disk and exports it to a Unix
-file. Usage: \fIEXPORT [-lne] trsfile [unixfile]\fP.  The -n flag
-converts TRS-80 newlines (\\r) to Unix newlines (\\n).  The -l flag
-converts the Unix filename to lower case.  When using the -l flag, you
-can put a [ or up-arrow in front of a character to keep it in upper
-case.  Give the -e flag if your TRS-80 operating system uses the
-Newdos/80 convention for representing the ending record number in an
-open file control block.  This should be detected automatically for
-Newdos/80 itself and for TRSDOS 1.3, but you'll need to give the flag
-for DOSPLUS and possibly other non-LDOS operating systems.  If you
-need the flag but don't give it (or vice versa), exported files will
-come out the wrong length.  If the destination file is omitted, EXPORT
-uses the TRS-80 filename, but with any "/" changed to "." to match
+.SS Data import and export
+Several Z80 programs for data import and export from various TRS-80 operat=
ing
+systems are included with
+.B xtrs
+on two emulated floppy images.
+These programs use special support in the emulator to read and write exter=
nal
+Unix files, discussed further at the end of this section.
+.PP
+The emulated floppy
+.I utility.dsk
+contains some programs for transferring data between the emulator and ordi=
nary
+Unix files.
+.IR IMPORT/CMD ,
+.IR EXPORT/CMD ,
+and
+.I SETTIME/CMD
+run on
+the emulator under Model I/III
+.IR TRSDOS ,
+Model I/III
+.IR LDOS ,
+Model I/III
+.IR NEWDOS/80 ,
+and Model 4/4P
+.IR TRSDOS / LS-DOS
+6; they may also work under other TRS-80 operating systems.
+Model III
+.I TRSDOS
+users will have to
+use
+.IR TRSDOS 's
+.I CONVERT
+command to read
+.IR utility.dsk .
+.TP
+.I IMPORT/CMD
+imports a Unix file and writes it to an emulated disk.
+.IP ""
+Usage:
+.B IMPORT
+.RB [ \-lne ]
+.I unixfile
+.RI [ trsfile ]
+.IP ""
+The
+.B \-n
+flag converts
+Unix newlines (\(rsn) to TRS-80 newlines (\(rsr).
+The
+.B \-l
+flag converts the Unix filename to lowercase, to compensate for TRS-80
+operating systems such as
+.I NEWDOS/80
+that convert all command-line arguments to uppercase.
+When using the
+.B \-l
+flag, you can put a
+.B [
+or up-arrow in front of a character to keep it in uppercase.
+Give the
+.B \-e
+flag if your TRS-80 operating system uses the
+.I NEWDOS/80
+convention for representing the ending record number in an open file contr=
ol
+block.
+This should be detected automatically for
+.I NEWDOS/80
+itself and for
+.I TRSDOS
+1.3, but you'll need to give the flag for
+.I DOSPLUS
+and possibly
+other
+.RI non- LDOS
+operating systems.
+If you need the flag but don't give it (or vice versa), imported files wil=
l come
+out the wrong length.
+If the destination file is omitted,
+.I IMPORT
+uses the last component of the Unix pathname, but with any \(lq.\(rq chang=
ed to
+\(lq/\(rq to match TRS-80 DOS file extension syntax.
+.TP
+.I EXPORT/CMD
+reads a file from an emulated disk and exports it to a Unix file.
+.IP ""
+Usage:
+.B EXPORT
+.RB [ \-lne ]
+.I trsfile
+.RI [ unixfile ]
+.IP ""
+The
+.B \-n
+flag converts TRS-80 newlines (\(rsr) to Unix newlines (\(rsn).
+The
+.B \-l
+flag converts the Unix filename to lowercase.
+When using the
+.B \-l
+flag, you can put a
+.B [
+or up-arrow in front of a character to keep it in uppercase.
+Give the
+.B \-e
+flag if your TRS-80 operating system uses the
+.I NEWDOS/80
+convention for representing the ending record number in an open file contr=
ol
+block.
+This should be detected automatically for
+.I NEWDOS/80
+itself and for
+.I TRSDOS
+1.3, but you'll need to give the flag for
+.I DOSPLUS
+and possibly
+other
+.RI non- LDOS
+operating systems.
+If you need the flag but don't give it (or vice versa), imported files wil=
l come
+out the wrong length.
+If the destination file is omitted,
+.I EXPORT
+uses the TRS-80 filename, but with any \(lq/\(rq changed to \(lq.\(rq to m=
atch
 Unix file extension syntax.
-
-SETTIME/CMD reads the date and time from Unix and sets the TRS-80
-DOS's date and time accordingly.
-
-The next several programs were written in Misosys C and exist in two
-versions on utility.dsk.  The one whose name ends in "6" runs
-on Model 4 TRSDOS/LS-DOS 6.x; the other runs on LDOS 5.x and most
-other Model I/III operating systems.
-
-CD/CMD (or CD6/CMD) changes xtrs's Unix working directory.
-Usage: \fICD [-l] unixdir\fP.  The -l flag converts the Unix directory
-name to lower case.  When using the -l flag, you can put a [ or
-up-arrow in front of a character to keep it in upper case.  Running
-CD/CMD will change the interpretation of any relative pathnames given
-to IMPORT or EXPORT.  It will also change the interpretation of disk
-names at the next disk change, unless you specified an absolute
-pathname for xtrs's -diskdir parameter.
-
-PWD/CMD (or PWD6/CMD) prints xtrs's Unix working directory.
-
-UNIX/CMD (or UNIX6/CMD) runs a Unix shell command.
-Usage: \fIUNIX [-l] unix command line\fP.
-The -l flag converts the Unix command line
-to lower case.  When using the -l flag, you can put a [ or
-up-arrow in front of a character to keep it in upper case.
+.IP ""
+.I Note:
+The export of files from
+.B xtrs
+may be prohibited by the
+.B \-emtsafe
+flag; see
+.BR Options ,
+below.
+.TP
+SETTIME/CMD
+reads the date and time from Unix and sets the TRS-80 DOS's date and time
+accordingly.
+.PP
+The next several programs were written in Misosys C and exist in two versi=
ons on
+.IR utility.dsk .
+The one whose name ends in \(lq6\(rq runs on Model 4
+.IR TRSDOS / LS-DOS
+6.x; the other runs on
+.I LDOS
+5.x and most other Model I/III operating systems.
+.TP
+.I CD/CMD
+(or
+.IR CD6/CMD )
+changes
+.BR xtrs 's
+current working directory under Unix.
+.IP ""
+Usage:
+.B CD
+.RB [ \-l ]
+.I unixdir
+.IP ""
+The
+.B \-l
+flag converts the Unix directory name to lowercase.
+When using the
+.B \-l
+flag, you can put a
+.B [
+or up-arrow in front of a character to keep it in uppercase.
+Running
+.I CD/CMD
+will change the interpretation of any relative pathnames given to
+.I IMPORT
+or
+.IR EXPORT .
+It will also change the interpretation of disk names at the next disk chan=
ge,
+unless you specified an absolute pathname for
+.BR xtrs 's
+.B \-diskdir
+parameter.
+.IP ""
+.I Note:
+The change of
+.BR xtrs 's
+current working directory may be prohibited by the
+.B \-emtsafe
+flag; see
+.BR Options ,
+below.
+.TP
+.I PWD/CMD
+(or
+.IR PWD6/CMD )
+prints
+.BR xtrs 's
+current working directory under Unix.
+.TP
+.I UNIX/CMD
+(or
+.IR UNIX6/CMD )
+runs a Unix shell command.
+.IP ""
+Usage:
+.B UNIX
+.RB [ \-l ]
+.I unix-command-line
+.IP ""
+The
+.B \-l
+flag converts the Unix command line to lowercase.
+When using the
+.B \-l
+flag, you can put a
+.B [
+or up-arrow in front of a character to keep it in uppercase.
 Standard I/O for
-the command uses the xtrs program's standard I/O descriptors; it does
-not go to the TRS-80 screen or come from the TRS-80 keyboard.
-
-MOUNT/CMD (or MOUNT6/CMD) is a convenience program that switches
-emulated floppy disks in the drives.  Usage: \fIMOUNT [-l] filename U\fP.
-The -l flag converts the Unix filename
-to lower case.  When using the -l flag, you can put a [ or
-up-arrow in front of a character to keep it in upper case.
-The filename is any Unix filename; U is a single digit, 0 through 7.
-The command deletes the file diskM-U (where M is the TRS-80 model)
-from the disk directory (see -diskdir option), replaces it with a
-symbolic link to the given filename, and signals a disk change (as if
-F7 had been pressed).
-
-UMOUNT/CMD (or UMOUNT6/CMD) is a convenience program that removes an
-emulated floppy disk from a drive.  Usage: \fIUMOUNT U\fP.  U is a
-single digit, 0 through 7.  The command deletes the file diskM-U
-(where M is the TRS-80 model) from the disk directory (see -diskdir
-option) and signals a disk change (as if F7 had been pressed).
-
-The emulated floppy \fIcpmutil.dsk\fP contains import and export
-programs for Montezuma CP/M, written by Roland Gerlach.  It was
-formatted as a "Montezuma Micro Standard DATA disk (40T, SS, DD,
-200K)," with 512-byte sectors.  Be careful to configure your CP/M to
-the proper disk format and drive parameters (40 track, not 80), or you
-will have confusing problems reading this disk.  Documentation is
-included in the file cpmutil.html and source code in the file
-cpmutil.tgz (a gzipped tar archive). =20
-See http://members.optusnet.com.au/~rgerlach/trs-80/cpmutil.html
-where you will sometimes find a newer version of the utilities
-than is included with xtrs.
-
-The emulator implements a set of pseudo-instructions (emulator traps)
-that give TRS-80 programs access to Unix files.  The programs listed
-above use them.  If you would like to write your own such programs,
-the traps are documented in the file trs_imp_exp.h.  Assembler
-source code for the existing programs is supplied in xtrshard.z,
-import.z, export.z, and settime.z.  You can also write programs that
-use the traps in Misosys C, using the files xtrsemt.h and xtrsemt.ccc
-as an interface; a simple example is in settime.ccc.=20
-.SH Interrupts
-The emulator supports only interrupt mode 1.  It will complain if your
-program enables interrupts after powerup without executing an IM 1
-instruction first.  All Model I/III/4/4P software does this, as the
-built-in peripherals in these machines support only IM 1.
-
-The Model I has a 40 Hz heartbeat clock interrupt, while the Model
-III uses 30 Hz, and the Model 4/4P can run at either 30 Hz or 60 Hz.
-The emulator approximates this rather well even on a system where
-clock ticks come at some frequency that isn't divisible by the
-emulated frequency (e.g., 100 Hz on Intel Linux), as long as the true
-frequency is not slower than the emulated frequency.  The emulator has
-a notion of the absolute time at which each tick is supposed to occur,
-and it asks the host system to wake it up at each of those times.  The
-net result is that some ticks may be late, but there are always the
-proper number of ticks per second.  For example, running in Model I
-mode on Intel Linux you'd see this pattern: (tick, 30ms, tick,
-20ms,...) instead of seeing ticks every 25ms.
-.SH Processor speed selection
-A standard Model 4 has a software-controlled switch to select
-operation at either 4.05504 MHz (with heartbeat clock at 60 Hz)
-or 2.02752 MHz (with heartbeat clock at 30 Hz).  xtrs emulates this
-feature.
-
-Model I's were often modified to operate at higher speeds than the
-standard 1.77408 MHz.  With one common modification, writing a 1
-to port 0xFE would double the speed to 3.54816 MHz, while writing a 0
-would set the speed back to normal.  The heartbeat clock runs at 40 Hz
-in either case.  xtrs emulates this feature as well.
-.SH Sound
-Sound support uses
-the Open Sound System /dev/dsp device, standard on Linux and available
-on many other Unix versions as well.  This support is compiled in
-automatically on Linux; if you have OSS on another version of Unix,
-you'll need to define the symbol HAVE_OSS in your Makefile or in
-trs_cassette.c.  Any time TRS-80 software tries to write non-zero
-values to the cassette port (or the Model 4/4P optional sound port)
-with the cassette motor off, it is assumed to be trying to make sounds
-and xtrs opens /dev/dsp.  It automatically closes the device again
-after a few seconds of silence.
-
+the command uses the
+.B xtrs
+program's standard I/O descriptors; it does not go to the TRS-80 screen or=
 come
+from the TRS-80 keyboard.
+.IP ""
+.I Note:
+The execution of Unix shell commands may be prohibited by the
+.B \-emtsafe
+flag; see
+.BR Options ,
+below.
+.TP
+.I MOUNT/CMD
+(or
+.IR MOUNT6/CMD )
+is a convenience program that switches emulated floppy disks in the drives.
+.IP ""
+Usage:
+.B MOUNT
+.RB [ \-l ]
+.I unixfile unit-number
+.IP ""
+The
+.B \-l
+flag converts
+.I unixfile
+to lowercase.
+When using the
+.B \-l
+flag, you can put a
+.B [
+or up-arrow in front of a character to keep it in uppercase.
+.I unixfile
+is any Unix filename;
+.I unit-number
+is a single digit, 0 through 7.
+The command deletes the file
+.IR disk M \- U
+(where
+.I M
+is the TRS-80 model and
+.I U
+is the given
+.IR unit-number )
+from the disk directory (see the
+.B \-diskdir
+option below), replaces it with a symbolic link to the given filename, and
+signals a disk change (as if
+.B F7
+had been pressed).
+.IP ""
+.I Note:
+The mounting of a Unix file as a disk image may be prohibited by the
+.B \-emtsafe
+flag; see
+.BR Options ,
+below.
+.TP
+.I UMOUNT/CMD
+(or
+.IR UMOUNT6/CMD )
+is a convenience program that removes an emulated floppy disk from a drive.
+.IP ""
+Usage:
+.B UMOUNT
+.I unit-number
+.IP ""
+.I unit-number
+is a
+single digit, 0 through 7.
+The command deletes the file
+.IR disk M \- U
+(where
+.I M
+is the TRS-80 model and
+.I U
+is the given
+.IR unit-number )
+from the disk directory (see the
+.B \-diskdir
+option below), and signals a disk change (as if
+.B F7
+had been pressed).
+.IP ""
+.I Note:
+The unmounting of a Unix file as a disk image by deleting it on the host m=
ay be
+prohibited by the
+.B \-emtsafe
+flag; see
+.BR Options ,
+below.
+.PP
+The emulated floppy
+.I cpmutil.dsk
+contains import and export programs for Montezuma
+.IR CP/M ,
+written by Roland Gerlach.
+It was formatted as a \(lqMontezuma Micro Standard DATA disk (40T, SS, DD,
+200K)\(rq, with 512-byte sectors.
+Be careful to configure your
+.I CP/M
+to the proper disk format and drive parameters (40 tracks, not 80), or you=
 will
+have confusing problems reading this disk.
+Documentation is included in the file
+.\" If outputting HTML, make the filename a clickable link.
+.if '\*(.T'html' .UR file:///usr/share/doc/xtrs/cpmutil.html
+.I cpmutil.html
+.if '\*(.T'html' .UE
+and source code in the file
+.I cpmutil.tgz
+(a gzipped tar archive) in the
+.B xtrs
+source distribution.
+.\" Per the Internet Archive, Roland's site disappeared sometime between
+.\" 2007-12-22 and 2015-05-20.
+.\" See http://members.optusnet.com.au/~rgerlach/trs-80/cpmutil.html
+.\" where you will sometimes find a newer version of the utilities
+.\" than is included with xtrs.
+.PP
+The emulator implements a set of pseudo-instructions (emulator traps) that=
 give
+TRS-80 programs access to Unix files.
+The programs listed above use them.
+If you would like to write your own such programs, the traps are documente=
d in
+the file
+.IR trs_imp_exp.h .
+Assembler source code for the existing programs is supplied in
+.IR xtrshard.z ,
+.IR import.z ,
+.IR export.z ,
+and
+.IR settime.z .
+You can also write programs that use the traps in Misosys C, using the fil=
es
+.I xtrsemt.h
+and
+.I xtrsemt.ccc
+as an interface; a simple example is in
+.IR settime.ccc .
+All of these files are available in the
+.B xtrs
+source distribution.
+.SS Interrupts
+The emulator supports only interrupt mode 1 of the Z80.
+It will complain if your program enables interrupts after powerup without
+executing an IM 1 instruction first.
+All Model I/III/4/4P software does this, as the built-in peripherals in th=
ese
+machines support only IM 1.
+The Model I has a 40 Hz heartbeat clock interrupt, while the Model III use=
s 30
+Hz, and the Model 4/4P can run at either 30 Hz or 60 Hz.
+.\" This discussion used to assume that HZ=3D100 on Intel Linux.  Much has=
 changed
+.\" since then.  In Linux 2.6.13, HZ changed to 250.  After that, the Linux
+.\" kernel developed high-resolution timers and "tickless" behavior.
+.\"
+.\" Old language:
+.\" The emulator approximates this rather well even on a system where clock
+.\" ticks come at some frequency that isn't divisible by the emulated freq=
uency
+.\" (e.g., 100 Hz on Intel Linux), as long as the true frequency is not sl=
ower
+.\" than the emulated frequency.
+The emulator has a notion of the absolute time at which each tick is suppo=
sed to
+occur, and it asks the host system to wake it up at each of those times.
+The net result is that some ticks may be late, but there are always the pr=
oper
+number of ticks per second.
+For example, running in Model I mode on a Linux kernel configured with HZ=
=3D100,
+you'd see this pattern: (tick, 30ms, tick, 20ms, ...) instead of a tick ev=
ery
+25ms.
+.SS Processor speed selection
+A standard Model 4 has a software-controlled switch to select operation at
+either 4.05504 MHz (with heartbeat clock at 60 Hz) or 2.02752 MHz (with
+heartbeat clock at 30 Hz).
+.B xtrs
+emulates this feature.
+.PP
+Model I machines were often modified to operate at higher speeds than the
+standard 1.77408 MHz.
+With one common modification, writing a 1 to port 0xFE would double the sp=
eed to
+3.54816 MHz, while writing a 0 would set the speed back to normal.
+The heartbeat clock runs at 40 Hz in either case.
+.B xtrs
+emulates this feature as well.
+.SS Sound
+Sound support uses the Open Sound System (OSS)
+.I /dev/dsp
+device, standard on Linux and available on many other Unix versions as wel=
l.
+This support is compiled in automatically on Linux; if you have OSS on ano=
ther
+version of Unix, you'll need to define the symbol
+.B HAVE_OSS
+in the source distribution's
+.I Makefile
+or in
+.IR trs_cassette.c .
+Any time TRS-80 software tries to write non-zero values to the cassette po=
rt (or
+the Model 4/4P optional sound port) with the cassette motor off, it is ass=
umed
+to be trying to make sounds and
+.B xtrs
+opens
+.IR /dev/dsp .
+It automatically closes the device again after a few seconds of silence.
+.PP
 If you are playing a game with sound, you'll want to use the
--autodelay flag to slow down instruction emulation to approximately
-the speed of a real TRS-80.  If you don't do this, sound will still
-play correctly, but the gameplay may be way too fast and get ahead of
-the sound.
-
-On the other hand, if your machine is a bit too slow,
-you'll hear gaps and pops in the sound when the TRS-80 program lags
-behind the demand of the sound card for more samples.  The -autodelay
-feature includes a small speed boost whenever a sound starts to play
-to try to prevent this, but if the boost is too much or too little,
-you might either find that the game runs too fast when a lot of sound
-is playing, or that the sound has gaps in it anyway.  If your sound
-has gaps, you can try reducing the sample rate with the -samplerate flag.
-
-The Orchestra-85 music synthesis software will run under xtrs's Model
-I emulation, and the Orchestra-90 software will run with Model III
-operating systems under xtrs's Model III, 4, or 4P emulation.  For
-best results, use Orchestra-90 and the Model 4 emulation, as this lets
-the software run at the highest emulated clock rate (4 MHz) and thus
-generate the best sound.  If you want to run Orchestra-85 instead, you
-can tell it that you have a 3.5 MHz clock speedup with enable sequence
-3E01D3FE and disable sequence 3E00D3FE; this will let the software run
-twice as fast as on an unmodified Model I and generate better sound.
-There is no need to use xtrs's -autodelay flag when running
-Orchestra-85/90, but you might want to specify a small fixed delay to
-keep from getting excessive key repeat.
-.SH Mouse
+.B \-autodelay
+flag to slow down instruction emulation to approximately the speed of a re=
al
+TRS-80.
+If you don't do this, sound will still play correctly, but the gameplay ma=
y be
+way too fast and get ahead of the sound.
+.PP
+On the other hand, if your machine is a bit too slow, you'll hear gaps and=
 pops
+in the sound when the TRS-80 program lags behind the demand of the sound c=
ard
+for more samples.
+The
+.B \-autodelay
+feature includes a small speed boost whenever a sound starts to play to tr=
y to
+prevent this, but if the boost is too much or too little, you might either=
 find
+that the game runs too fast when a lot of sound is playing, or that the so=
und
+has gaps in it anyway.
+If your sound has gaps, you can try reducing the sample rate with the
+.B \-samplerate
+flag.
+.PP
+The Orchestra-85 music synthesis software will run under
+.BR xtrs 's
+Model I emulation, and the Orchestra-90 software will run with Model III
+operating systems under
+.BR xtrs 's
+Model III, 4, or 4P emulation.
+For best results, use Orchestra-90 and the Model 4 emulation, as this lets=
 the
+software run at the highest emulated clock rate (4 MHz) and thus generate =
the
+best sound.
+If you want to run Orchestra-85 instead, you can tell it that you have a 3=
=2E5 MHz
+clock speedup with enable sequence 3E01D3FE and disable sequence 3E00D3FE;=
 this
+will let the software run twice as fast as on an unmodified Model I and ge=
nerate
+better sound.
+There is no need to use
+.BR xtrs 's
+.B \-autodelay
+flag when running Orchestra-85/90, but you might want to specify a small f=
ixed
+delay to keep from getting excessive key repeat.
+.SS Mouse
 A few Model 4 programs could use a mouse, such as the shareware hi-res
-drawing program MDRAW-II. The program XTRSMOUS/CMD on the utility disk
-(utility.dsk) is a mouse driver for Model 4/4P mode that should work
-with most such programs.  \fBxtrs\fP does not emulate the actual mouse
-hardware (a serial mouse plugged into the Model 4 RS-232 port), so the
-original mouse drivers will not work under \fBxtrs\fP.  Instead,
-XTRSMOUS accesses the X mouse pointer using an emulator trap.
-XTRSMOUS implements the same TRSDOS/LS-DOS 6 SVC interface as the
-David Goben and Matthew Reed mouse drivers. (It does not implement the
-interface of the older Scott McBurney mouse driver, which may be
-required by some programs.)
-
-By default XTRSMOUS installs itself in high memory. This is done
-because MDRAW-II tests for the presence of a mouse by
-looking to see whether the mouse SVC is vectored to high memory. If the
-driver is installed in low memory, MDRAW thinks it is not there at
-all. If you use mouse-aware programs that don't have this bug, or if
-you edit the first line of MDRAW to remove the test, you can install
-XTRSMOUS in low memory using the syntax "XTRSMOUS (LOW)".
-.SH Time of day clock
-Several battery-backed time of day clocks were sold for the various
-TRS-80 models,
-including the TimeDate80, TChron1, TRSWatch, and T-Timer.  They are
-essentially all the same hardware, but reside at a few different port
-ranges.  \fBxtrs\fP currently emulates them at port ranges 0x70-0x7C and
-0xB0-0xBC.  The T-Timer port range at 0xC0-0xCC conflicts with the Radio S=
hack
-hard drive controller and is not emulated.
-
-These clocks return only a 2-digit year, and it is unknown what their
-driver software will do in the year 2000 and beyond.  If you have
-software that works with one of them, please send email to report
-what happens when it is used with \fBxtrs\fP.
-
-Also see SETTIME/CMD in the "Data import and export" section above for
-another way to get the correct time into a Z-80 operating system
-running under \fBxtrs\fP.
-
-Finally, you might notice that LDOS/LS-DOS always magically knows the
-correct date when you boot it (but not the time).  When you first
-power up the emulated TRS-80, \fBxtrs\fP dumps the date into the
-places in memory where LDOS and LS-DOS normally save it across
-reboots, so it looks to the operating system as if you rebooted after
-setting the date.
-.SH Joystick
-Pressing a key on a PC numeric keypad with NumLock disengaged emulates
-the Alpha Products joystick.  See the Keys section above for details.
-The emulated joystick is mapped only at port 0, to avoid conflicts
-with other devices.  The joystick emulation could be made to work with
-real joysticks using the X input extension, but this is not
-implemented yet.
-.SH Running games
-Some games run rather well under \fBxtrs\fP now,
-provided that your
-machine is fast enough to run the emulation in real time and that you
-choose the right command line options.
-"Galaxy Invaders Plus" by Big 5 Software is particularly good.
-You will usually want to turn on autodelay,
-and if your machine is slow you may need to reduce the sound sample rate.
-Running your X server in 8-bit/pixel mode
-also seems to help in some cases. Example command lines:
-
-.nf
-    startx -- -bpp 8
-    xtrs -autodelay
-.fi
-
-If you have a slow machine and the sound breaks up, it is possible
-that your machine is not fast enough to generate samples at the default
-rate of 44,100 Hz.  If you think this may be happening,
-try "-samplerate 11025" or even "-samplerate 8000".
+drawing program
+.IR MDRAW-II .
+The program
+.I XTRSMOUS/CMD
+on the utility disk
+.RI ( utility.dsk )
+is a mouse driver for Model 4/4P mode that should work with most such prog=
rams.
+.B xtrs
+does not emulate the actual mouse hardware (a serial mouse plugged into the
+Model 4 RS-232 port), so the original mouse drivers will not work under
+.BR xtrs .
+Instead,
+.I XTRSMOUS
+accesses the X mouse pointer using an emulator trap.
+.I XTRSMOUS
+implements the same
+.IR TRSDOS / LS-DOS
+6 SVC interface as the David Goben and Matthew Reed mouse drivers.
+(It does not implement the interface of the older Scott McBurney mouse dri=
ver,
+which may be required by some programs.)
+.PP
+By default
+.I XTRSMOUS
+installs itself in high memory.
+This is done because
+.I MDRAW-II
+tests for the presence of a mouse by looking to see whether the mouse SVC =
is
+vectored to high memory.
+If the driver is installed in low memory,
+.I MDRAW
+thinks it is not there at all.
+If you use mouse-aware programs that don't have this bug, or if you edit t=
he
+first line of
+.I MDRAW
+to remove the test, you can install
+.I XTRSMOUS
+in low memory under
+.IR TRSDOS / LS-DOS
+6 using the syntax
+.BR "XTRSMOUS (LOW)" .
+.SS Time-of-day clock
+Several battery-backed time of day clocks were sold for the various TRS-80
+models, including the TimeDate80, TChron1, TRSWatch, and T-Timer.
+They are essentially all the same hardware, but reside at a few different =
port
+ranges.
+.B xtrs
+currently emulates them at port ranges 0x70\(en0x7C and 0xB0\(en0xBC.
+The T-Timer port range at 0xC0\(en0xCC conflicts with the Radio Shack hard=
 drive
+controller and is not emulated.
+.PP
+These clocks return only a 2-digit year, and it is not well-documented what
+their driver software does since the year 2000.
+If you have software that works with one of them, please contact the
+.ie \n[.g] .UR http://\:www.tim-mann.org/
+.el .UR http://www.tim-mann.org/
+author
+.UE
+to report what happens when it is used with
+.BR xtrs .
+.PP
+Also see
+.I SETTIME/CMD
+in
+.BR "Data import and export" ,
+above, for another way to get the correct time into a Z80 operating system
+running under
+.BR xtrs .
+.PP
+Note that Model I
+.I TRSDOS
+and
+.I VTOS
+4.0 have a \(lqyear 1988\(rq problem, and
+.IR LDOS / LS-DOS
+has a \(lqyear 2012\(rq problem; see
+.\" If GNU roff, use hyphenless breakpoints.
+.ie \n[.g] .UR http://\:www.trs-80.org/\
+\:ldos-and-ls-dos-2012-and-beyond-technical-information/
+.el .UR http://www.trs-80.org/\
+ldos-and-ls-dos-2012-and-beyond-technical-information/
+.I LDOS and LS-DOS: 2012 and Beyond \(em Technical information
+.UE
+by Matthew Reed.
+.\" Finally, you might notice that LDOS/LS-DOS always magically knows the
+.\" correct date when you boot it (but not the time).  When you first
+.\" power up the emulated TRS-80, \fBxtrs\fP dumps the date into the
+.\" places in memory where LDOS and LS-DOS normally save it across
+.\" reboots, so it looks to the operating system as if you rebooted after
+.\" setting the date.
+.SS Joystick
+Pressing a key on a PC-keyboard-style numeric keypad with
+.B NumLock
+disengaged emulates the Alpha Products joystick.
+See
+.BR Keys ,
+above, for details.
+The emulated joystick is mapped only at port 0, to avoid conflicts with ot=
her
+devices.
+.SS Running games
+Some games run rather well under
+.B xtrs
+provided that your machine is fast enough to run the emulation in real tim=
e and
+that you choose the right command-line options.
+.I Galaxy Invaders Plus
+by Big 5 Software is particularly good.
+You will usually want to turn on autodelay, and if your machine is slow yo=
u may
+need to reduce the sound sample rate.
+Running your X server in 8-bit/pixel mode also seems to help in some cases.
+Example command lines:
+.RS
+.EX
+.RB "$ " "startx \-\- \-bpp 8"
+.RB "$ " "xtrs \-autodelay"
+.EE
+.RE
+.PP
+If you have a slow machine and the sound breaks up, it is possible that yo=
ur
+machine is not fast enough to generate samples at the default rate of 44,1=
00 Hz.
+If you think this may be happening, try
+.B \-samplerate 11025
+or even
+.BR "\-samplerate 8000" .
 .SH Options
 Defaults for all options can be specified using the standard X resource
-mechanism, and the class name for \fBxtrs\fP is "Xtrs".
-.TP
-.B \-display \fIdisplay\fP
-Set your X display to \fIdisplay\fP. The default is to
-use the DISPLAY environment variable.
+mechanism; see the
+.\" If GNU roff, use hyphenless breakpoints.
+.ie \n[.g] .UR ftp://\:www.x.org/\:pub/\:current/\:doc/\:libX11/\:libX11/\
+\:libX11.html#\:Resource_Manager_Functions
+.el .UR ftp://www.x.org/pub/current/doc/libX11/libX11/libX11.html\
+#Resource_Manager_Functions
+Resource Manager Functions chapter of
+.IR "Xlib \(em C Language X Interface"
+.UE
+by Jim Gettys, Robert W. Scheifler, et al.
+The class name for
+.B xtrs
+is
+.BR Xtrs .
+.TP
+.B \-display \c
+.I x-display
+Set your X display to
+.IR x-display.
+The default is to use the DISPLAY environment variable.
 .TP
 .B \-iconic
-Start with the \fBxtrs\fP window iconified.
-.TP
-.B \-background \fIcolor\fP
-.PD 0
-.TP
-.B \-bg \fIcolor\fP
-.PD
-Specifies the background color of the \fBxtrs\fP window.
-.TP
-.B \-foreground \fIcolor\fP
-.PD 0
-.TP
-.B \-fg \fIcolor\fP
-.PD
-Specifies the foreground color of the \fBxtrs\fP window.
-.TP
-.B \-title \fItitletext\fP
-Use \fItitletext\fP in the window title bar instead of the
-program name.
-.TP
-.B \-borderwidth \fIwidth\fP
-Put a border of \fIwidth\fP pixels
-around the TRS-80 display.  The default is 2.
-.TP
-.B \-scale \fIxfac[,yfac]\fP
-Multiply the horizontal and vertical window size by \fIxfac\fP and
-\fIyfac\fP, respectively.  Possible values are integers in the range
-[1,4] for \fIxfac\fP and [1,8] for \fIyfac\fP.  Defaults are
-\fIxfac\fP=3D1 and \fIyfac\fP=3D2*\fIxfac\fP.
+Start with the
+.B xtrs
+window iconified.
+.TP
+.B \-background \c
+.I color
+.TQ
+.B \-bg \c
+.I color
+Set the background color of the
+.B xtrs
+window to
+.IR color .
+.TP
+.B \-foreground \c
+.I color
+.TQ
+.B \-fg \c
+.I color
+Set the foreground color of the
+.B xtrs
+window to
+.IR color .
+.TP
+.B \-title \c
+.I title-text
+Use
+.I title-text
+in the window title bar instead of the program name.
+.TP
+.B \-borderwidth \c
+.I width
+Put a border of
+.I width
+pixels
+around the TRS-80 display.
+The default is 2.
+.TP
+.B \-scale \c
+.IR xfac [\c
+.BI , yfac\c
+]
+Multiply the horizontal and vertical window size by
+.I xfac
+and
+.IR yfac ,
+respectively.
+Possible values are integers in the range
+[1,4] for
+.I xfac
+and [1,8] for
+.IR yfac .
+Defaults are
+.IR xfac =3D1
+and
+.IR yfac =3D2\(mu xfac .
+Ignored if
+.B \-usefont
+is given.
 .TP
 .B \-resize
-In Model III or 4/4P mode, resize the X window whenever the emulated
-display mode changes between 64x16 text (or 512x192 graphics) and 80x24
-text (or 640x240 graphics).
-This is the default in Model III mode, since 80x24 text is not available
-and the 640x240 graphics add-on card is seldom used.
+In Model III or 4/4P mode, resize the X window whenever the emulated displ=
ay
+mode changes between 64\(mu16 text (or 512\(mu192 graphics) and 80\(mu24 t=
ext
+(or 640\(mu240 graphics).
+This is the default in Model III mode, since 80\(mu24 text is not availabl=
e and
+the 640\(mu240 graphics add-on card is seldom used.
 .TP
 .B \-noresize
-In Model III or 4/4P mode, always keep the X window large enough for
-80x24 text or 640x240 graphics, putting a blank margin around the
-outside when the emulated display mode is 64x16 text or 512x192
-graphics.  This is the default in Model 4/4P mode, since otherwise there
-is an annoying size switch during every reboot.
+In Model III or 4/4P mode, always keep the X window large enough for 80\(m=
u24
+text or 640\(mu240 graphics, putting a blank margin around the outside whe=
n the
+emulated display mode is 64\(mu16 text or 512\(mu192 graphics.
+This is the default in Model 4/4P mode, since otherwise there is an annoyi=
ng
+size switch during every reboot.
 .TP
-.B \-charset \fIname\fP
+.B \-charset \c
+.I charset-name
 Select among several sets of built-in character bitmaps.
-
-In Model I mode, five sets are available. The default, \fIwider\fP, is
-a modified Model III set with characters 8 pixels wide; it looks
-better on a modern computer screen with square pixels than the real
-Model I fonts, which were 6 pixels wide. \fIlcmod\fP is the character
-set in the replacement character generator that was supplied with the
-Radio Shack lower case modification.  (It was reconstructed partly
-from memory and may have some minor bit errors.)  \fIstock\fP is the
-character set in the stock character generator supplied with most
-upper case only machines. Since \fIxtrs\fP currently always emulates
-the extra bit of display memory needed to support lower case, this
-character set gives you the authentic, unpleasant effect that real
-Model I users saw when they tried to do homebrew lower case
-modifications without replacing the character generator: lower case
-letters appear at an inconsistent height, and if you are using the
-Level II BASIC ROM display driver, upper case letters are replaced by
-meaningless symbols.  \fIearly\fP is the same as stock, but with the
-standard ASCII characters [, \\, ], and ^ in the positions where most
-Model I's had directional arrows.  This was the default programming in
-the Motorola character generator ROM that Radio Shack used, and a few
-early machines were actually shipped with this ROM.  Finally,
-\fIgerman\fP or \fIgenie\fP gives an approximate emulation of the
-GENIE, a German Model I clone.  Characters are 8 pixels wide, and
-double width is supported even though later GENIE models did not
-include it.
-
+Valid values of
+.I charset-name
+depend on the TRS-80 model being emulated.
+.IP ""
+In Model I mode, five sets are available.
+The default,
+.BR wider ,
+is a modified Model III set with characters 8 pixels wide; it looks better=
 on a
+modern computer screen with square pixels than the real Model I fonts, whi=
ch
+were 6 pixels wide.
+.B lcmod
+is the character set in the replacement character generator that was suppl=
ied
+with the Radio Shack lowercase modification.
+(It was reconstructed partly from memory and may have some minor bit error=
s.)
+.B stock
+is the character set in the stock character generator supplied with most
+uppercase-only machines.
+Since
+.B xtrs
+currently always emulates the extra bit of display memory needed to support
+lowercase, this character set gives you the authentic, unpleasant effect t=
hat
+real Model I users saw when they tried to do homebrew lowercase modificati=
ons
+without replacing the character generator: lowercase letters appear at an
+inconsistent height, and if you are using the Level II BASIC ROM display d=
river,
+uppercase letters are replaced by meaningless symbols.
+.B early
+is the same as stock, but with the standard ASCII characters [, \(rs, ], a=
nd
+\(ha in the positions where most Model I machines had directional arrows.
+This was the default programming in the Motorola character generator ROM t=
hat
+Radio Shack used, and a few early machines were actually shipped with this=
 ROM.
+Finally,
+.B german
+or
+.B genie
+gives an approximate emulation of the GENIE, a German Model I clone.
+Characters are 8 pixels wide, and double width is supported even though la=
ter
+GENIE models did not include it.
+.IP ""
 In Model III, 4, and 4P modes, three sets are available:
-\fIkatakana\fP (the default for Model III) is the original Model III set w=
ith
-Japanese Katakana characters in the alternate character
-positions. This set was also used in early Model 4's.
-\fIinternational\fP (the default for Model 4 and 4P) is a
-later Model 4 set with accented Roman letters in the alternate positions.
-\fIbold\fP is a bold set from a character generator ROM found in one
-Model III, origin uncertain.
+.B katakana
+(the default for Model III) is the original Model III set with Japanese Ka=
takana
+characters in the alternate character positions.
+This set was also used in early Model 4 machines.
+.B international
+(the default for Model 4 and 4P) is a later Model 4 set with accented Roman
+letters in the alternate positions.
+.B bold
+is a boldface set from a character generator ROM found in one Model
+III\(emorigin uncertain.
 .TP
 .B \-usefont
 Use X fonts instead of the built-in character bitmaps.
 .TP
 .B \-nofont
-Use the built-in character bitmaps, not a X font.  This is the default.
+Use the built-in character bitmaps, not an X font.
+This is the default.
 .TP
-.B \-font \fIfontname\fP
-If -usefont is also given,
-use the specified X font for normal width characters.
+.B \-font \c
+.I font-name
+If
+.B \-usefont
+is also given, use the X font
+.I font-name
+for normal-width characters.
 The default uses a common X fixed-width font:
 "-misc-fixed-medium-r-normal--20-200-75-75-*-100-iso8859-1".
 .TP
-.B \-widefont \fIfontname\fP
-If -usefont is also given,
-use the specified X font for double width characters.
+.B \-widefont \c
+.I font-name
+If
+.B \-usefont
+is also given, use the X font
+.I font-name
+for double-width characters.
 The default uses a common X fixed-width font, scaled to double width:
 "-misc-fixed-medium-r-normal--20-200-75-75-*-200-iso8859-1".
 .TP
 .B \-nomicrolabs
-In Model I mode, emulate the HRG1B 384x192 hi-res graphics card.
+In Model I mode, emulate the HRG1B 384\(mu192 hi-res graphics card.
 In Model III mode or Model 4/4P mode, emulate the Radio Shack hi-res card.
-This is now the default.
+This is the default.
 .TP
 .B \-microlabs
 In Model III or 4/4P mode, emulate the Micro Labs Grafyx Solution hi-res
-graphics card.  Note that the Model III and Model 4/4P cards from Micro
-Labs are very different from one another.
+graphics card.
+Note that the Model III and Model 4/4P cards from Micro Labs are very diff=
erent
+from one another.
 .TP
 .B \-debug
-Enter zbx, the z80 debugger.
-.TP
-.B \-romfile \fIfilename\fP
-.PD 0
-.TP
-.B \-romfile3 \fIfilename3\fP
-.TP
-.B \-romfile4p \fIfilename4p\fP
-.PD
-Use the romfile specified by \fIfilename\fP in Model I mode, the
-romfile specified by \fIfilename3\fP in Model III and Model 4 mode,
-or the romfile specified by \fIfilename4p\fP in Model 4P mode,
-A romfile can be either a raw binary dump, Intel hex format, or
-TRS-80 cmd format (for example, a MODELA/III file).
+Enter
+.IR zbx ,
+the Z80 debugger.
+.TP
+.B \-romfile \c
+.I filename
+.TQ
+.B \-romfile3 \c
+.I filename3
+.TQ
+.B \-romfile4p \c
+.I filename4p
+Use the ROM image file specified by
+.I filename
+in Model I mode,
+by
+.I filename3
+in Model III and Model 4 mode,
+or by
+.I filename4p
+in Model 4P mode.
+A ROM image file can be either a raw binary dump in Intel hex format, or
+TRS-80 CMD format (for example, a
+.I MODELA/III
+file).
 If you do not set this option or the corresponding X resource, a default
-established at compile time is used (if any); see Makefile.local for
-instructions on compiling in default romfiles or default romfile names.
-.TP
-.B \-model \fIm\fP
-Specifies which TRS-80 model to emulate.  Values accepted are 1 or I (Model
-I), 3 or III (Model III), 4 or IV (Model 4), and 4P or IVP (Model 4P).
+established at compile time is used (if any); see
+.I Makefile.local
+in the
+.B xtrs
+source distribution
+for instructions on compiling in default ROM image files or default ROM im=
age
+filenames.
+.TP
+.B \-model \c
+.I m
+Emulate a TRS-80 Model
+.IR m .
+Values accepted are
+.B 1
+or
+.B I
+(Model I),
+.B 3
+or
+.B III
+(Model III),
+.B 4
+or
+.B IV
+(Model 4), and
+.B 4P
+or
+.B IVP
+(Model 4P).
 Model I is the default.
 .TP
-.B \-delay \fId\fP
-A crude speed control.  After each Z-80 instruction, xtrs busy-waits
-for \fId\fP iterations around an empty loop.  A really smart C optimizer
-might delete this loop entirely, so it's possible that this option
-won't work if you compile xtrs with too high an optimization level.
+.B \-delay \c
+.I d
+Tune the emulator's (crude) speed control.
+After each Z80 instruction,
+.B xtrs
+busy-waits for
+.I d
+iterations around an empty loop.
+A really smart C optimizer might delete this loop entirely, so it's possib=
le
+that this option won't work if
+.B xtrs
+is compiled with too high an optimization level.
 The default delay is 0.
 .TP
 .B \-autodelay
-Dynamically adjusts the value of -delay to run instructions at roughly
-the same rate as a real machine.  The tracking is only approximate,
-but it can be useful for running games.
+Dynamically adjust the value of the speed control described in
+.B \-delay
+above to run instructions at roughly the same rate as a real machine.
+The tracking is only approximate, but it can be useful for running games.
 .TP
 .B \-noautodelay
-Turn off -autodelay. This is the default.
+Turn off
+.BR \-autodelay .
+This is the default.
 .TP
-.B \-keystretch \fIcycles\fP
-Fine-tune the keyboard behavior.  To prevent keystrokes from being
-lost, xtrs "stretches" the intervals between key transitions, so that
-the Z-80 program has time to see each transition before the next one
-occurs.  Whenever the Z-80 program reads the keyboard matrix and
-sees an emulated key go up or down, xtrs waits \fIcycles\fP
-Z-80 clock cycles (T-states) before it allows the program to see
-another key transition.  Key transitions that are received during
-the waiting period or when the Z-80 program is not reading the keyboard
-are held in a queue.  The default stretch value is 4000 cycles; it
-should seldom if ever be necessary to change it.
+.B \-keystretch \c
+.I cycles
+Fine-tune the keyboard behavior.
+To prevent keystrokes from being lost,
+.B xtrs
+\(lqstretches\(rq the intervals between key transitions, so that the Z80 p=
rogram
+has time to see each transition before the next one occurs.
+Whenever the Z80 program reads the keyboard matrix and sees an emulated ke=
y go
+up or down,
+.B xtrs
+waits
+.I cycles
+Z80 clock cycles (T-states) before it allows the program to see another key
+transition.
+Key transitions that are received during the waiting period or when the Z80
+program is not reading the keyboard are held in a queue.
+The default stretch value is 4000 cycles; it should seldom if ever be nece=
ssary
+to change it.
 .TP
 .B \-shiftbracket
-Emulate [, \\, ], ^, and _ as shifted keys, and {, |, }, and ~ as
-unshifted.  This is the default in Model 4 and 4P modes, and it
-works well with the keyboard driver in Model 4 TRSDOS/LS-DOS 6.
+Emulate [, \(rs, ], \(ha and _ as shifted keys, and {, |, }, and \(ti as
+unshifted.
+This is the default in Model 4 and 4P modes, and it works well with the ke=
yboard
+driver in Model 4
+.IR TRSDOS / LS-DOS
+6.
 .TP
 .B \-noshiftbracket
-Emulate [, \\, ], ^, and _ as unshifted keys, and {, |, }, and ~ as
-shifted.  This is the default in Model I and III modes, and it
-works well with many TRS-80 keyboard drivers.  With some
-keyboard drivers these keys do not work at all, however.
-.TP
-.B \-diskdir \fIdir\fP
-Specify the directory containing floppy and hard disk images.
-If the value starts with "~/" (or is just "~"), it is relative to your
-home directory.  The default value is ".".
-.TP
-.B \-doubler \fItype\fP
-Specify what type of double density adaptor to emulate (Model I mode only).
-The \fItype\fP may be \fIpercom\fP, \fIradioshack\fP (or \fItandy\fP),
-\fIboth\fP, or \fInone\fP. The type may be abbreviated to one character.
-The default is \fIboth\fP, which causes the double density adaptor emulati=
on
-to respond to the special commands of both the Percom and Radio Shack card=
s.
+Emulate [, \(rs, ], \(ha and _ as unshifted keys, and {, |, }, and \(ti as
+shifted.
+This is the default in Model I and III modes, and it works well with many =
TRS-80
+keyboard drivers.
+With some keyboard drivers these keys do not work at all, however.
+.TP
+.B \-diskdir \c
+.I dir
+Set the search directory for floppy and hard disk images to
+.IR dir .
+If the value starts with \(lq\(ti/\(rq (or is just \(lq\(ti\(rq), it is re=
lative
+to your home directory (as determined by the
+.B HOME
+environment variable).
+The default value is \(lq.\(rq.
+.TP
+.B \-doubler \c
+.I doubler-type
+(Model I mode only)
+Set the double-density adaptor to emulate to
+.IR doubler-type .
+The parameter may be
+.BR percom ,
+.B radioshack
+(or
+.BR tandy ),
+.BR both ,
+or
+.BR none .
+.I doubler-type
+may be abbreviated to one character.
+The default is
+.BR both ,
+which causes the double density adaptor emulation to respond to the special
+commands of both the Percom and Radio Shack cards.
 .TP
 .B \-doublestep
-Make all real floppy drives double-step, allowing access to 35-track or
-40-track media in an 80-track drive.  Linux only.  See the Floppy Disks
-section for limitations.
+(Linux only)
+Make all real floppy drives double-step, allowing access to 35-track or 40=
-track
+media in an 80-track drive.
+See
+.BR "Bugs and limitations" ,
+below.
 .TP
 .B \-nodoublestep
-Turn off double-step mode for all real floppy drives.  Linux only.
+(Linux only)
+Turn off double-step mode for all real floppy drives.
 This is the default.
 .TP
-.B \-stepmap s0,s1,s2,s3,s4,s5,s6,s7
+.B \-stepmap \c
+.IR s0 [\c
+.BI , s1\c
+[\c
+.BI , s2\c
+[\c
+.BI , s3\c
+[\c
+.BI , s4\c
+[\c
+.BI , s5\c
+[\c
+.BI , s6\c
+[\c
+.BI , s7\c
+]]]]]]]
+(Linux only)
 Selectively set double-step mode for individual real floppy drives.
-If \fIsU\fP is 2 and \fIdiskM-U\fP is a real drive, the drive will
-be double-stepped; if \fIsU\fP is 1, it will be single-stepped.
+Each comma-delimited parameter corresponds to a drive unit number; see
+.BR "Real floppy disks" ,
+above.
+If
+.IR s U
+is
+.B 1
+and
+.IR disk M \- U
+is a (symbolic link to) a real drive,
+where
+.I M
+is the TRS-80 model
+.RB ( 1 ,
+.BR 3 ,
+.BR 4 ,
+or
+.BR 4p )
+and
+.I U
+is the drive unit number (a digit in the range 0\(en7), the drive will be
+single-stepped; if
+.IR s U
+is
+.BR 2 ,
+it will be double-stepped.
 You can omit values from the end of the list; those drives will get the
-default value set by -doublestep or -nodoublestep.
-.TP
-.B \-sizemap z0,z1,z2,z3,z4,z5,z6,z7
-Selectively set whether drives are emulated as 5-inch or 8-inch; see
-the section "Emulated 8-inch floppy disks" above.  If \fIzU\fP is 5,
-the drive will appear to Z-80 software as 5-inch; if 8, as 8-inch.
+default value set by
+.B \-doublestep
+or
+.BR \-nodoublestep .
+.IP ""
+Example:
+.B \-model 1 \-stepmap 2,1,2
+double-steps
+.I disk1-0
+and
+.IR disk1-2 ,
+and single-steps
+.IR disk1-1 .
+.TP
+.B \-sizemap \c
+.IR z0 [\c
+.BI , z1\c
+[\c
+.BI , z2\c
+[\c
+.BI , z3\c
+[\c
+.BI , z4\c
+[\c
+.BI , z5\c
+[\c
+.BI , z6\c
+[\c
+.BI , z7\c
+]]]]]]]
+Selectively set whether drives are emulated as
+.5-1/4
+-inch or 8-inch; see
+.BR "Emulated 8-inch floppy disks" ,
+above.
+If
+.I zU
+is
+.BR 5 ,
+the drive will appear to Z80 software as
+.5-1/4
+-inch; if
+.BR 8 ,
+as 8-inch.
 The default setting (as reflected in the documentation above) is
-5,5,5,5,8,8,8,8.  You can omit values from the end of the list; those
-drives will get the default values.  Setting one or more of the first
-four drives to 8-inch may be useful for CP/M software that supports
-8-inch drives.  You can also use XTRS8/DCT with 8-inch drives in the
-first four positions; even though the prompt suggests the unit number
-must be 4-7, numbers 0-3 are accepted. XTRS8 does not check whether
-the unit you've selected is really being emulated as an 8-inch drive,
-however; you'll simply get errors during FORMAT if you get this wrong.
+.BR 5,5,5,5,8,8,8,8 .
+You can omit values from the end of the list; those drives will get the de=
fault
+values.
+Setting one or more of the first four drives to 8-inch may be useful for
+.I CP/M
+software that supports 8-inch drives.
+You can also use
+.I XTRS8/DCT
+with 8-inch drives in the first four positions; even though the prompt sug=
gests
+the unit number must be 4\(en7, numbers 0\(en3 are accepted.
+.I XTRS8
+does not check whether the unit you've selected is really being emulated a=
s an
+8-inch drive, however; you'll simply get errors during
+.I FORMAT
+if you get this wrong.
 .TP
 .B \-truedam
 Turn off the single density data address mark remapping kludges
-described in the "Emulated floppy disks" and "Real floppy disks"
-sections above.  With this
-option given, the distinction between F8 and FA data address marks
-is strictly observed on both writing and reading.  This option is
-probably not useful unless you need to deal with Model I disks that use
-the distinction as part of a copy-protection scheme.  See also
-"Common File Formats for Emulated TRS-80 Floppy Disks", available
-at http://www.tim-mann.org/trs80/dskspec.html.
+described in
+.B Emulated floppy disks
+and
+.BR "Real floppy disks" ,
+above.
+With this option given, the distinction between 0xF8 and 0xFA data address=
 marks
+is strictly observed on both writing and reading.
+This option is probably not useful unless you need to deal with Model I di=
sks
+that use the distinction as part of a copy-protection scheme.
+See also
+.\" If GNU roff, use hyphenless breakpoints.
+.ie \n[.g] .UR http://\:www.tim-mann.org/\:trs80/\:dskspec.html
+.el .UR http://www.tim-mann.org/trs80/dskspec.html
+.I Common File Formats for Emulated TRS-80 Floppy Disks
+.UE .
 .TP
 .B \-notruedam
-The opposite of -truedam.  This setting is the default.
-.TP
-.B \-samplerate \fIrate\fP
-Set the sample rate for new cassette wav files, direct
-cassette I/O to the sound card, and game sound output to the sound
-card.  Existing wav files will be read or modified using their
-original sample rate regardless of this flag.  The default is 44,100
-Hz.  See also the cassette(1) man page.
-.TP
-.B \-serial \fIttyname\fP
-Set the tty device to be used for I/O to the TRS-80's serial port.
-The default is /dev/ttyS0 on Linux, /dev/tty00 on other versions
-of Unix.  Setting the name to be empty (\-serial "") emulates having
-no serial port.
-.TP
-.B \-switches \fIvalue\fP
-Set the sense switches on the Model I serial port card.  This option
-is meaningful only in Model I mode, and only when the -serial option
-is not set to "".  The default value is 0x6f, which Radio Shack software
-conventionally interprets as 9600 bps, 8 bits/word, no parity, 1 stop
-bit.
+The opposite of
+.BR \-truedam .
+This setting is the default.
+.TP
+.B \-samplerate \c
+.I rate
+Set the sample rate for new cassette WAVE files, direct cassette I/O to the
+sound card, and game sound output to the sound card.
+Existing WAVE files will be read or modified using their original sample r=
ate
+regardless of this flag.
+The default is 44,100 Hz.
+See also
+.BR cassette (1).
+.TP
+.B \-serial \c
+.I terminal-name
+Set the terminal device to be used for I/O to the TRS-80's serial port to
+.IR terminal-name.
+The default is
+.I /dev/ttyS0
+on Linux, and
+.I /dev/tty00
+on other versions of Unix.
+Setting the name to be empty
+.RB ( "\-serial \(dq\(dq" )
+emulates having no serial port.
+.TP
+.B \-switches \c
+.I value
+Set the sense switches on the Model I serial port card.
+This option is meaningful only in Model I mode, and only when the
+.B -serial
+option is not set to \(dq\(dq.
+The default value is 0x6F, which Radio Shack software conventionally inter=
prets
+as 9600 bps, 8 bits/word, no parity, 1 stop bit.
 .TP
 .B \-emtsafe
-Disable emulator traps (see "Data import and export") that could write
-to host files other than disk images in the original diskdir.
+Disable emulator traps (see
+.BR "Data import and export" ,
+above) that could write to host files other than disk images in the origin=
al
+emulated disk directory, or otherwise affect the host system (e.g., Unix s=
hell
+commands).
 .TP
 .B \-noemtsafe
-The opposite of -emtsafe.  This setting is the default.
-.SH Additional resources
-There are many other TRS-80 resources available on the Web, including
-shareware and freeware emulators that run under MSDOS and other
-operating systems, software for converting TRS-80 physical media to
-the emulator's disk file format, ROM images, and TRS-80 software that
-has already been converted.  For pointers, see
-http://www.tim-mann.org/trs80.html.
+The opposite of
+.BR \-emtsafe .
+This setting is the default.
+.SH Exit status
+.B
+xtrs
+primarily uses diagnostic messages to indicate trouble.
+.TP
+0
+Successful operation; normal or expected exit.
+.TP
+1
+Fatal error; includes usage errors such as unrecognized command-line argum=
ents.
+.TP
+\-1, 255
+Unable to open X display.
+.SH Environment
+.B
+xtrs
+reads a couple of environment variables.
+.TP
+.B DISPLAY
+is read indirectly via
+.BR XOpenDisplay (3),
+and specifies the X server to which
+.B xtrs
+(an X client)
+should connect.
+.TP
+.B HOME
+is used at startup to (1) locate
+.B .Xdefaults
+and
+.B Xtrs
+files specifying defaults for command-line options and (2) resolve the arg=
ument
+to the
+.B \-diskdir
+option;
+and sometimes when the emulator trap to change
+.BR xtrs 's
+current working directory is activated; see
+.BR "Data import and export" ,
+above.
+.SH Files
+.B xtrs
+may access files as described under
+.B HOME
+in
+.BR Environment ,
+above, as well as floppy drive, digital signal processor (sound), and term=
inal
+device files; see
+.B Real floppy disks
+and
+.BR Sound ,
+above, and
+.B \-serial
+under
+.BR Options ,
+above.
+.PP
+If the
+.B \-emtsafe
+flag is not in effect, then through the use of emulator traps
+(see
+.BR "Data import and export" ,
+above)
+.I arbitrary
+files on the system may be read, written, or deleted from within the emula=
tor
+with the privileges of the user invoking
+.BR xtrs .
 .SH Bugs and limitations
-The emulated serial port's modem status and control signals are not
-tied to the signals on the real serial port, because the real signals
-are not available to software through the Unix tty device interface.
-The ability to check for parity, framing, and overrun errors and
-receive an interrupt when one occurs is not emulated.  Unix does not
-support 2000, 3600, or 7200 baud, so these TRS-80 data rates are
+The emulated serial port's modem status and control signals are not tied t=
o the
+signals on the real serial port, because the real signals are not availabl=
e to
+software through the Unix terminal device interface.
+The ability to check for parity, framing, and overrun errors and receive an
+interrupt when one occurs is not emulated.
+Unix does not support 2000, 3600, or 7200 baud, so these TRS-80 data rates=
 are
 remapped to 38400, 57600, and 115200 baud respectively.
-
-A better signal processing algorithm might help read real cassettes
-more reliably, especially at 1500bps.
-
-Some features of the floppy disk controller are not currently
-emulated: Force Interrupt with condition bits 0x01, 0x02, or 0x04 is not
-implemented. Read Track is implemented only for DMK emulated
-floppies. The multiple-sector flags in Read and Write are not
-implemented.  The timing of returned sectors is emulated only for the
-Read Address command, and not very accurately for JV1 or JV3.
+.PP
+A better signal processing algorithm might help read real cassettes more
+reliably, especially at 1500bps.
+.PP
+Some features of the floppy disk controller are not currently emulated.
+.IP \(bu
+Force Interrupt with condition bits 0x01, 0x02, or 0x04 is not implemented.
+.IP \(bu
+Read Track is implemented only for DMK emulated floppies.
+.IP \(bu
+The multiple-sector flags in Read and Write are not implemented.
+.IP \(bu
+The timing of returned sectors is emulated only for the Read Address comma=
nd,
+and not very accurately for JV1 or JV3.
+.IP \(bu
 If a disk has more than one sector with the same number on a track,
-\fBxtrs\fP will always see the first (counting from the index hole)
-when reading or writing; a real machine would see the next one to come
-under the head depending on the current rotational position of the disk.
-Partially reformatting a track (which TRS-80 programs like HyperZap
-and Model I Super Utility do to achieve mixed density) is supported
-for DMK but not JV3; however, switching densities while formatting
-(which Model III and 4 Super Utility do) works on both DMK and JV3.
-
-Real physical floppy disks are supported only under Linux, because
-Unix does not define a portable interface to the low-level floppy
-controller functionality that \fBxtrs\fP needs.  There are some
-limitations even under Linux: Index holes are faked, not detected on
-the real disk, and the timing of returned sectors is not emulated at
-all.  Due to the limitations of PC-style floppy disk controllers, when
-formatting a physical floppy under \fBxtrs\fP, you cannot mix sectors
-of different sizes on the same track, switch densities in the middle
-of a track, or reformat only part of a track.  However, \fBxtrs\fP can
-read and write to physical floppies that have already been formatted
-in these ways (perhaps by a real TRS-80).
-
-The extended JV3 limit of 5802 sectors is somewhat arbitrary.  It
-could be raised by generalizing the code to permit more than two
-blocks of 2901, but this does not seem too useful.  5802 sectors is
-already enough for a 3.5-inch HD (1.44MB) floppy, which the TRS-80
-didn't support anyway.  If you need more space, use emulated hard
-drives instead of emulated floppies with huge numbers of tracks.
-
-XTRSHARD/DCT ignores the internal write-protected flag in hard drive
-images, but a hard drive image can still be effectively write
-protected by turning off its Unix write permission bits.
-
-The emulator uses a heuristic to decide what format a ROM file is in.
+.B xtrs
+will always see the first (counting from the index hole) when reading or
+writing; a real machine would see the next one to come under the head depe=
nding
+on the current rotational position of the disk.
+Partially reformatting a track (which TRS-80 programs like
+.I HyperZap
+and Model I
+.I Super Utility
+do to achieve mixed density) is supported for DMK but not JV3; however,
+switching densities while formatting (which Model III and 4
+.I Super Utility
+do) works on both DMK and JV3.
+.PP
+Real physical floppy disks are supported only under Linux, because Unix do=
es not
+define a portable interface to the low-level floppy controller functionali=
ty
+that
+.B xtrs
+needs.
+There are some limitations even under Linux: index holes are faked, not de=
tected
+on the real disk, and the timing of returned sectors is not emulated at al=
l.
+Due to the limitations of ISA-bus floppy disk controllers, when formatting=
 a
+physical floppy under
+.BR xtrs ,
+you cannot mix sectors of different sizes on the same track, switch densit=
ies in
+the middle of a track, or reformat only part of a track.
+However,
+.B xtrs
+can read and write to physical floppies that have already been formatted in
+these ways (perhaps by a real TRS-80).
+.PP
+The extended JV3 limit of 5802 sectors is somewhat arbitrary.
+It could be raised by generalizing the code to permit more than two blocks=
 of
+2901, but this does not seem too useful.
+5802 sectors is already enough for a
+.3-1/2
+-inch HD (1.44MB) floppy, which the TRS-80 didn't support anyway.
+If you need more space, use emulated hard drives instead of emulated flopp=
ies
+with huge numbers of tracks.
+.PP
+.I XTRSHARD/DCT
+ignores the internal write-protected flag in hard drive images, but a hard=
 drive
+image can still be effectively write protected by turning off its Unix wri=
te
+permission bits.
+.PP
+The emulator uses a heuristic to decide what format a ROM image file is in.
 If a raw binary ROM image starts with 0x01, 0x05, or 0x22, it can be
-misidentified as being in a different format.  This is rather unlikely
-to occur, as ROMs typically begin with 0xF3, the DI instruction.
-
-The joystick emulation could be made to work with real joysticks using
-the X input extension, but this is not implemented yet.
-
-If you discover other bugs, write fixes for any of these, or make any
-other enhancements, please let us know so that we can incorporate
-the changes into future releases.
+misidentified as being in a different format.
+This is rather unlikely to occur, as ROMs typically begin with 0xF3, the DI
+instruction.
+.PP
+The joystick emulation could be made to work with real joysticks using the=
 X
+Input extension, but this is not implemented yet.
+.PP
+If you discover other bugs, write fixes for any of these, or make any other
+enhancements, please let us know so that we can incorporate the changes in=
to
+future releases.
 .SH Authors and acknowledgements
-\fBxtrs\fP 1.0 was written by David Gingold and Alec Wolman.
+.B xtrs
+1.0 was written by David Gingold and Alec Wolman.
 The current version was revised and much extended by Timothy Mann
-(see http://tim-mann.org/).  See README and
-README.tpm for additional notes from the authors.
-
-We also thank the following people for their help.  The JV1 and JV3
-floppy disk file formats were designed by Jeff Vavasour, originally
-for his MSDOS-based TRS-80 emulators.  The DMK format was designed by
-David Keil for his MSDOS-based TRS-80 emulator.  The hard disk file
-format was designed by Matthew Reed for his MSDOS-based TRS-80
-emulators.  Al Petrofsky and Todd P. Cromwell III supplied font data.
-Roland Gerlach contributed the CP/M import and export programs as well
-as several bug reports and fixes for the emulator itself.  Ulrich
-Mueller added the -borderwidth option, improved the -scale option and
-the bitmap font scaling, ported the import, export, and settime
-utilities to Newdos/80, and contributed the HRG1B emulation.  Branden
-Robinson supplied the first version of the cassette man page, fixed
-Makefile bugs, translated cassette to the Bourne shell, and
-implemented watchpoints in zbx.  Mark McDougall provided documentation
-for the Micro Labs Grafyx Solution card.  Jenz Guenther added the
--title option and contributed code to emulate the GENIE (German Model
-I clone).  Joe Peterson contributed code to emulate the TimeDate80 and
-the -emtsafe feature.  Denis Leconte contributed part of the -scale
+(see
+.\" If GNU roff, use hyphenless breakpoints.
+.ie \n[.g] .UR http://\:www.tim-mann.org/
+.el .UR http://www.tim-mann.org/
+.UE ).
+See
+.I README
+in the
+.B xtrs
+source distribution for additional notes from the authors; a (compressed) =
copy
+may be locally available with your
+.B xtrs
+installation at
+.\" If outputting HTML, make the filename a clickable link.
+.ie '\*(.T'html' \{\
+.UR file:///usr/share/doc/xtrs/README.gz
+.UE . \}
+.el \{\
+.IR /usr/share/doc/xtrs/README.gz . \}
+.PP
+We also thank the following people for their help.
+The JV1 and JV3 floppy disk file formats were designed by Jeff Vavasour,
+originally for his
+.IR MS-DOS -based
+TRS-80 emulators.
+The DMK format was designed by David Keil for his
+.IR MS-DOS -based
+TRS-80 emulator.
+The hard disk file format was designed by Matthew Reed for his
+.IR MS-DOS -based
+TRS-80 emulators.
+Al Petrofsky and Todd P. Cromwell III supplied font data.
+Roland Gerlach contributed the
+.I CP/M
+import and export programs as well as several bug reports and fixes for the
+emulator itself.
+Ulrich Mueller added the
+.B \-borderwidth
+option, improved the
+.B \-scale
+option and the bitmap font scaling, ported the
+.IR IMPORT ,
+.IR EXPORT ,
+and
+.I SETTIME
+utilities to
+.IR NEWDOS/80 ,
+and contributed the HRG1B emulation.
+Branden Robinson supplied the first version of the cassette man page, fixed
+Makefile bugs, translated cassette to the Bourne shell, and implemented
+watchpoints in
+.IR zbx .
+Mark McDougall provided documentation for the Micro Labs Grafyx Solution c=
ard.
+Jenz Guenther added the
+.B \-title
+option and contributed code to emulate the GENIE (German Model I clone).
+Joe Peterson contributed code to emulate the TimeDate80 and the
+.B \-emtsafe
+feature.
+Denis Leconte contributed part of the
+.B \-scale
 implementation.
-
-$Id: xtrs.man,v 1.69 2009/06/15 23:44:43 mann Exp $
+.SH See also
+.BR cmddump (1),
+.BR hex2cmd (1),
+.BR cassette (1),
+.BR mkdisk (1)
+.PP
+There are many other TRS-80 resources available on the Web, including shar=
eware
+and freeware emulators that run under
+.I MS-DOS
+and other operating systems,
+software for converting TRS-80 physical media to the emulator's disk file
+format, ROM images, and TRS-80 software that has already been converted.
+For pointers, see
+.\" If GNU roff, use hyphenless breakpoints.
+.ie \n[.g] .UR http://\:www.tim-mann.org/\:trs80.html
+.el .UR http://www.tim-mann.org/trs80.html
+.UE .
+.\" $Id: xtrs.man,v 1.69 2009/06/15 23:44:43 mann Exp $
+.\" vim:set et ft=3Dnroff tw=3D80:
--- a/xtrs.txt
+++ b/xtrs.txt
@@ -1,34 +1,36 @@
-xtrs(1)                                                                xtr=
s(1)
+xtrs(1)                     General Commands Manual                    xtr=
s(1)
=20
 Name
        xtrs - TRS-80 Model I/III/4/4P emulator for the X Window System
=20
-Syntax
-       xtrs [-model m] [-diskdir d] [-debug] [other options]
+Synopsis
+       xtrs [-model m] [-diskdir d] [-debug] [other-options]
=20
 Description
-       xtrs is built on top of a Z-80 emulator, with added routines to sup=
port
-       keyboard and video I/O through an X interface.  The hardware  emula=
tion
-       can operate as a TRS-80 Model I, Model III, Model 4, or Model 4P.
-
-       xtrs  supports 48K of RAM in Model I or Model III mode, 128K in Mod=
el 4
-       or Model 4P mode.  Floppy disks and hard disks are emulated using f=
iles
-       to store the data; or under Linux only, real floppy drives can be u=
sed.
-       A printer is emulated by sending its  output  to  standard  output.=
   A
-       serial  port is emulated using a Unix tty device.  Cassette I/O is =
emu-
-       lated using files to store the cassette data; real cassettes  can  =
also
-       be read or written (with luck), either directly through your sound =
card
-       (on Linux and other systems with OSS-compatible sound drivers), or =
 via
-       .wav files.  Game sound and music output are also supported if you =
have
-       an OSS-compatible sound driver; sound output though the cassette  p=
ort,
-       through  the  Model  4  sound  option, and through the optional Orc=
hes-
-       tra-85/90 music synthesizer card are all emulated.  In  Model  I  m=
ode,
-       the  HRG1B  graphics card is emulated.  In Model III and 4/4P mode,=
 you
-       can select whether the Radio Shack graphics card or Micro  Labs  Gr=
afyx
-       Solution  is  emulated.   There  is  also a mouse driver for Model =
4/4P
-       mode.  Several common time-of-day clock cards are emulated on all  =
mod-
-       els.   The  Alpha  Products joystick is emulated using the PC's num=
eric
-       keypad.
+       xtrs  is  an emulator for a series of 8-bit microcomputers manufact=
ured
+       by Tandy/Radio Shack in the 1970s and 1980s.  The program is  built=
  on
+       top  of  a  Zilog Z80 emulator, with added routines to support keyb=
oard
+       and video I/O through an X interface.  The hardware emulation can o=
per-
+       ate as a TRS-80 Model I, Model III, Model 4, or Model 4P.
+
+       xtrs  supports 48kiB of RAM in Model I or Model III mode, and 128ki=
B in
+       Model 4 or Model 4P mode.  Floppy disks and  hard  disks  are  emul=
ated
+       using  files to store the data; or under Linux only, real floppy dr=
ives
+       can be used.  A printer is emulated by sending its output to the  s=
tan-
+       dard  output.   A serial port is emulated using a Unix terminal dev=
ice.
+       Cassette I/O is emulated using files to store the cassette  data;  =
real
+       cassettes  can  also  be  read  or written (with luck), either dire=
ctly
+       through your sound card (on Linux and other systems with OSS-compat=
ible
+       sound  drivers),  or  via  .wav files.  Game sound and music output=
 are
+       also supported if you have an OSS-compatible sound driver; sound ou=
tput
+       though the cassette port, through the Model 4 sound option, and thr=
ough
+       the optional Orchestra-85/90 music synthesizer card are  all  emula=
ted.
+       In Model I mode, the HRG1B graphics card is emulated.  In Model III=
 and
+       4/4P mode, you can select whether the  Radio  Shack  graphics  card=
  or
+       Micro  Labs  Grafyx Solution is emulated.  There is also a mouse dr=
iver
+       for Model 4/4P mode.  Several common time-of-day clock cards  are  =
emu-
+       lated on all models.  The Alpha Products joystick is emulated using=
 the
+       keyboard's numeric keypad.
=20
        Because xtrs emulates the hardware, all known TRS-80  Model  I/III/=
4/4P
        operating  systems  should  run on it, including all flavors of TRS=
DOS,
@@ -37,523 +39,585 @@
        the special drivers, utilities, and instructions needed for  these =
 are
        not provided for all operating systems.
=20
-       The  Z-80 emulator has a debugger called zbx.  You can enter the de=
bug-
-       ger either by starting xtrs with the -debug  flag  or  by  pressing=
  F9
-       while xtrs is running.  The debugger runs in the X terminal window =
that
-       you started xtrs from.  Once you are in the debugger, type  "help" =
 for
-       more information.
-
-       Special  support in the emulator allows the program to block when w=
ait-
-       ing for information from the keyboard.  This will work  only  for  =
pro-
-       grams  that  wait for keyboard input using the standard Model I/III=
 ROM
-       call; the emulator decides whether to block the Z-80  program  when=
  it
+       The Z80 emulator has a debugger called zbx.  You can enter the debu=
gger
+       either by starting xtrs with the -debug flag or by  pressing  F9  w=
hile
+       xtrs  is  running.  The debugger runs in the X terminal window that=
 you
+       started xtrs from.  Once you are in the debugger, type "help"
+
+       for more information.
+
+       Special support in the emulator allows the program to block when  w=
ait-
+       ing  for  information  from the keyboard.  This will work only for =
pro-
+       grams that wait for keyboard input using the standard Model  I/III =
 ROM
+       call;  the  emulator  decides  whether to block the Z80 program whe=
n it
        tries to read from the keyboard memory by pattern-matching its stac=
k.
=20
-Keys
-       The following keys have special meanings to xtrs:
+   Keys
+       The following keys on the host keyboard have special meanings to xt=
rs.
=20
        F11 toggles onscreen help on the keyboard mappings.
=20
        LeftArrow, Backspace, or Delete is the TRS-80 left arrow key.  Righ=
tAr-
-       row or Tab is the right arrow key.  UpArrow is the up arrow key.   =
Dow-
-       nArrow  or  Linefeed  is the down arrow key.  Esc or Break is the B=
reak
+       row  or Tab is the right arrow key.  UpArrow is the up arrow key.  =
Dow-
+       nArrow or Linefeed is the down arrow key.  Esc or Break  is  the  B=
reak
        key.  Home, Clear, or LeftAlt is the Clear key.  Control is the Mod=
el 4
-       Ctrl  key  (address  bit 7, data bit 2).  RightAlt is equivalent to=
 the
-       shifted down arrow key (used as a control key with  some  TRS-80  s=
oft-
+       Ctrl key (address bit 7, data bit 2).  RightAlt is  equivalent  to =
 the
+       shifted  down  arrow  key (used as a control key with some TRS-80 s=
oft-
        ware).
=20
-       F1,  F2,  and  F3 are the Model 4/4P function keys (address bit 7, =
data
-       bits 4, 5, and 6).  F1 is also the Model I Electric Pencil control =
 key
-       that  some  users added to their machines.  F4 is the Model 4 Caps =
Lock
+       F1, F2, and F3 are the Model 4/4P function keys (address  bit  7,  =
data
+       bits  4, 5, and 6).  F1 is also the Model I Electric Pencil control=
 key
+       that some users added to their machines.  F4 is the Model 4  Caps  =
Lock
        key (address bit 7, data bit 3).  F5, Compose, or ScrollLock is equ=
iva-
-       lent  to  the  @  key (so that @ can be used as a modifier key).  F=
6 is
+       lent to the @ key (so that @ can be used as a  modifier  key).   F6=
  is
        equivalent to the 0 key (so that a shifted 0 can be obtained).  F7 =
sig-
-       nals a disk change in the emulated floppy drives (see below).  F8 e=
xits
-       the program.  F9 enters the debugger (zbx).  F10 is the reset butto=
n.
+       nals a floppy disk change (see Emulated floppy disks, below).  F8 e=
xits
+       the program.  F9 enters the zbx debugger.  F10 is the reset button.
=20
-       In Model III, 4, and 4P modes, the left and right shift keys  are  =
dis-
-       tinct;  in  Model  I  mode, they are the same.  The PageUp and Page=
Down
-       keys always  activate  the  positions  that  correspond  to  the  M=
odel
-       III/4/4P  left  and  right shift keys (address bit 7, data bits 0 a=
nd 1
-       respectively), even in Model I mode.  The End key activates  an  un=
used
+       In  Model  III, 4, and 4P modes, the left and right Shift keys are =
dis-
+       tinct; in Model I mode, they are the same.   The  PageUp  and  Page=
Down
+       keys  always  activate  the  positions  that  correspond  to  the M=
odel
+       III/4/4P left and right shift keys (address bit 7, data bits  0  an=
d  1
+       respectively),  even  in Model I mode.  The End key activates an un=
used
        position in the keyboard matrix (address bit 7, data bit 7).
=20
-       The  keys  [, \, ], ^,  , {, |, }, and ~ also activate unused posit=
ions
-       in the keyboard matrix (address bit  3,  data  bits  3-7).   With  =
many
-       TRS-80  keyboard  drivers,  these  keys  map to the corresponding A=
SCII
-       characters; with others, they do nothing.  In some cases you  may  =
find
-       the  shift state is reversed from what it should be; if you press [=
 but
-       { is displayed instead (etc.),  see  the  -shiftbracket  and  -nosh=
ift-
-       bracket  options  below to correct the problem.  The Insert key map=
s to
-       the same position as underscore (address bit 3, data bit  7),  so  =
that
-       this  key  can  be  used both with and without shift pressed; with =
many
-       TRS-80 keyboard drivers one of these maps to ASCII code 0x7f.
-
-       On a German keyboard, the umlaut and "ess-tsett" keys  should  acti=
vate
-       the corresponding characters used in the GENIE, a German Model I cl=
one.
-       This feature is most useful together with the "-charset genie"  com=
mand
-       line argument.
-
-       Pressing  a key on a PC numeric keypad with NumLock disengaged emul=
ates
-       the Alpha Products joystick.   Keys  2,  4,  6,  8  (KP Down,  KP L=
eft,
-       KP Right,  KP Up) are the main directions; keys 1, 3, 7, and 9 (KP =
End,
-       KP Page Down, KP Home, KP Page Up) work as diagonal directions by a=
cti-
-       vating  two  main  directions  at  once;  and  key  0  (KP Insert) =
or 5
-       (KP Begin) is the fire button.  Note that your X server may default=
  to
-       sending  digits  for the keys on the numeric pad even if NumLock is=
 not
-       pressed.  If you have this problem, you can use the xmodmap program=
  to
-       remap your numeric pad, and use the xev program to debug it.
-
-Emulated cassette
-       To  control the emulated cassette, a file called ".cassette.ctl" in=
 the
-       current directory keeps track of what file is currently loaded  as =
 the
-       cassette  tape  and  the  current  position within that file.  The =
cas-
-       sette(1) shell script provides a way to manipulate this file.  You =
 may
-       use  this  script to load and position cassette tape files.  The op=
era-
-       tion works very much like an actual tape recorder.   See  the  cass=
ette
-       man  page  for more information about the cassette shell script and=
 the
-       cassette file formats that are supported.
+       The keys [, \, ], ^, and   also activate unused positions in  the  =
key-
+       board  matrix  (address  bit 3, data bits 3-7), as do the ASCII-shi=
fted
+       counterparts of the first four ({, |, }, and ~);  see  above  regar=
ding
+       Delete.   With many TRS-80 keyboard drivers, these keys map to the =
cor-
+       responding ASCII characters; with others, they  do  nothing.   In  =
some
+       cases  you  may find the shift state reversed from what you expect;=
 if,
+       for instance, you press [ but "{" is  displayed  instead,  see  -sh=
ift-
+       bracket  and -noshiftbracket in Options, below, to correct the prob=
lem.
+       The Insert key maps to the same position as underscore (address bit=
  3,
+       data  bit  7), so that this key can be used both with and without s=
hift
+       pressed; with many TRS-80 keyboard drivers one of these maps  to  A=
SCII
+       code 0x7f (DEL).
+
+       On a German keyboard, the umlaut and ess-tsett keys should activate=
 the
+       corresponding characters used in the GENIE, a  German  Model  I  cl=
one.
+       This  feature  is most useful together with the -charset genie comm=
and-
+       line option.
+
+       Pressing a key on a PC-style keyboard's  numeric  keypad  with  Num=
Lock
+       disengaged  emulates  the Alpha Products joystick.  Keys 2, 4, 6, a=
nd 8
+       (KP Down, KP Left, KP Right, and KP Up) are the main  directions;  =
keys
+       1,  3,  7,  and  9  (KP End, KP Page Down, KP Home, KP Page Up) wor=
k as
+       diagonal directions by activating two main directions at once; and =
 key
+       0  (KP Insert)  or  5  (KP Begin) is the fire button.  Note that yo=
ur X
+       server may default to sending digits for the keys on  the  numeric =
 pad
+       even  if  NumLock is not active.  If you have this problem, you can=
 use
+       xev(1) to determine the names of the X keysyms generated by  your  =
key-
+       stroke events.  You may need to check or update your XKB configurat=
ion.
+       Alternatively, you can use xmodmap(1) to remap your numeric pad.
+
+   Emulated cassette
+       To control the emulated cassette, a file called  .cassette.ctl  in =
 the
+       current  working directory keeps track of what file is currently lo=
aded
+       as the cassette tape and the current position within  that  file.  =
 The
+       cassette(1)  shell  script provides a way to manipulate this file. =
 You
+       may use this script to load and  position  cassette  tape  files.  =
 The
+       operation  works  very much like an actual tape recorder.  The cass=
ette
+       man page has more information about the shell script and  the  cass=
ette
+       file formats that are supported.
=20
-Printer
-       For printer support, any text  sent  to  the  TRS-80's  printer  (u=
sing
+   Printer
+       For  printer  support,  any  text  sent  to the TRS-80's printer (u=
sing
        LPRINT or LLIST, for example) is sent to the standard output.
=20
-Emulated floppy disks
-       In  Model  I mode, xtrs emulates a Radio Shack Expansion Interface =
with
-       the Percom Doubler or Radio Shack Doubler installed.  The Doubler  =
pro-
-       vides  double-density  disk  access by allowing either the stock WD=
1771
-       FDC chip or a WD1791 chip to be selected  under  program  control. =
  At
-       powerup  the  1771  is  selected,  so operating systems with no Dou=
bler
-       driver see a stock system.  By default, the  emulator  pretends  to=
  be
-       both  a  Percom and Radio Shack Doubler at the same time -- it resp=
onds
-       to the special commands of both -- so a driver for either should  w=
ork.
-       Under  LDOS,  use  the  command  "FDUBL"  (newer  versions of LDOS)=
, or
-       "PDUBL" or "RDUBL" (older versions) to  install  the  driver.  Soft=
ware
-       that tries to detect which doubler you have (such as Super Utility)=
 may
-       be confused by the emulation of both at once, so you can choose to =
emu-
-       late only one with a command line option; see below.
+   Emulated floppy disks
+       In Model I mode, xtrs emulates a Radio Shack Expansion  Interface  =
with
+       the  Percom Doubler or Radio Shack Doubler installed.  The Doubler =
pro-
+       vides double-density disk access by allowing either  the  stock  WD=
1771
+       FDC  chip  or  a  WD1791 chip to be selected under program control.=
  At
+       powerup the 1771 is selected, so  operating  systems  with  no  Dou=
bler
+       driver  see  a  stock  system.  By default, the emulator pretends t=
o be
+       both a Percom and Radio Shack Doubler at the same time--it responds=
  to
+       the  special  commands  of  both--so  a  driver for either should w=
ork.
+       Under LDOS use the command FDUBL (on newer versions of LDOS), or  P=
DUBL
+       or  RDUBL  (on  older  versions)  to install the driver.  Software =
that
+       tries to detect which doubler you have (such as Super Utility)  may=
  be
+       confused by the emulation of both at once, so you can choose to emu=
late
+       only one with a command-line option; see Options below.
=20
        In Model III, 4, or 4P mode, xtrs emulates the stock floppy control=
ler,
-       which uses a WD1793 chip (software-compatible with the WD1791) to  =
pro-
+       which  uses a WD1793 chip (software-compatible with the WD1791) to =
pro-
        vide both single and double density.
=20
-       Four  5.25-inch floppy drives are emulated, with storage in files n=
amed
-       diskM-U, where M is the TRS-80 model (1, 3, 4, or  4p)  and  U  is =
 the
-       drive  unit  number (0, 1, 2, or 3).  If a file of the required nam=
e is
-       not found, a drive with no disk in it is emulated (but see below). =
  If
-       the  user  does not have write permission for a floppy file, and/or=
 the
-       file has an internal write protect flag set,  a  write-protect  tab=
  is
-       emulated.   Use the mkdisk(1) program to turn the write protect fla=
g on
-       or off.  To change floppies in an emulated drive, rename  the  exis=
ting
-       file  for  the drive (if any), rename the new floppy file to the pr=
oper
-       name, and hit function key F7 in the emulator.
+       Four 5.25-inch floppy drives are emulated, with storage in files  n=
amed
+       diskM-U,  where  M  is  the  TRS-80 model (1, 3, 4, or 4p) and U is=
 the
+       drive unit number (0, 1, 2, or 3).  If a file of the required  name=
  is
+       not  found, a drive with no disk in it is emulated (but see below).=
  If
+       the user does not have write permission for a floppy file,  and/or =
 the
+       file  has  an  internal  write protect flag set, a write-protect ta=
b is
+       emulated.  Use the mkdisk(1) program to turn the write protect flag=
  on
+       or  off.   To change floppies in an emulated drive, rename the exis=
ting
+       file for the drive (if any), rename the new floppy file to  the  pr=
oper
+       name, and press F7 (see Keys, above).
=20
-       If you try to boot an emulated Model I, III, or 4 with  no  file  n=
amed
-       diskM-0  (that  is, no disk in drive 0), xtrs emulates having no fl=
oppy
+       If  you  try  to boot an emulated Model I, III, or 4 with no file n=
amed
+       diskM-0 (that is, no disk in drive 0), xtrs emulates having  no  fl=
oppy
        disk controller.  The behavior of a real machine with a disk contro=
ller
-       in  this  case didn't seem useful to emulate faithfully: A real Mod=
el I
-       hangs with a screen full of garbage; a real Model III or 4 goes int=
o  a
-       retry  loop  printing  "Diskette?" on the screen and rechecking whe=
ther
-       you've inserted one.  A real Model 4P always has a  floppy  control=
ler,
+       in this case didn't seem useful to emulate faithfully: a real  Mode=
l  I
+       hangs  with a screen full of garbage; a real Model III or 4 goes in=
to a
+       retry loop printing "Diskette?" on the screen  and  rechecking  whe=
ther
+       you've  inserted  one.  A real Model 4P always has a floppy control=
ler,
        however, so xtrs always emulates one.
=20
-       Due  to  a limitation of the original Model I hardware, drive :3 ca=
nnot
-       be double-sided in Model I mode.  In the original Model  I,  you  c=
ould
+       Due to a limitation of the original Model I hardware, drive  :3  ca=
nnot
+       be  double-sided  in  Model I mode.  In the original Model I, you c=
ould
        not have a drive :3 at all if any drive in the system was double-si=
ded,
        but the emulator is able to be more forgiving.
=20
        Emulated floppy image files can be of any of three types: JV1, comp=
ati-
-       ble  with Jeff Vavasour's popular freeware Model I emulator for MS-=
DOS;
-       JV3, a compatible extension of a format first used in  Vavasour's  =
com-
-       mercial  Model  III/4  emulator;  or  DMK, compatible with David Ke=
il's
-       Model 4 emulator.  All three types work  in  xtrs  regardless  of  =
what
-       model  it  is  emulating.   A heuristic is used to decide which typ=
e of
-       image is in a drive, as none of the types has a magic number or  si=
gna-
+       ble with Jeff Vavasour's popular freeware Model I emulator for  MS-=
DOS;
+       JV3,  a  compatible extension of a format first used in Vavasour's =
com-
+       mercial Model III/4 emulator; or  DMK,  compatible  with  David  Ke=
il's
+       Model  4  emulator.   All  three  types work in xtrs regardless of =
what
+       model it is emulating.  A heuristic is used to  decide  which  type=
  of
+       image  is in a drive, as none of the types has a magic number or si=
gna-
        ture.
=20
-       JV1 supports only single density, single sided, with directory on t=
rack
-       17.  Sectors must be 256 bytes long.  Use FORMAT (DIR=3D17) if  you=
  want
-       to format JV1 disks with more (or less) than 35 tracks under LDOS.
+       JV1 supports only single-sided, single-density diskettes,  with  di=
rec-
+       tory on track 17.  Sectors must be 256 bytes long.  Use FORMAT (DIR=
=3D17)
+       if you want to format JV1 disks with more  (or  less)  than  35  tr=
acks
+       under LDOS.
=20
        JV3  is much more flexible, though it still does not support everyt=
hing
        the real controllers could do.  It is probably best to use JV3 for =
 all
        the  disk images you create, since it is the most widely implemente=
d by
        other emulators, unless you have a special reason to  use  one  of =
 the
        others.   A  JV3 disk can be formatted with 128, 256, 512, or 1024-=
byte
-       sectors, 1 or 2 sides, single or double density, with either  FB  (=
nor-
-       mal)  or  F8 (deleted) data address mark on any sector.  In single =
den-
-       sity the nonstandard data address marks FA and F9 are  also  availa=
ble.
-       You  cannot format a sector with an incorrect track number or head =
num-
-       ber.  You can format a sector with an intentional CRC error in the =
data
-       field.  xtrs supports at most 5802 total sectors on a JV3 image.
-
-       The  original  Vavasour JV3 format supported only 256-byte sectors,=
 and
-       had a limit of 2901 total sectors.  If you use sector sizes other  =
than
-       256  bytes  or format more than 2901 sectors on a disk image, emula=
tors
-       other than xtrs may be unable to read it.  Note that an 80 track,  =
dou-
-       ble-sided,  double-density (18 sector) 5.25-inch floppy will fit wi=
thin
-       the original 2901 sector limit; the extension to 5802 is primarily =
 for
+       sectors, 1 or 2 sides, single or double density, with  either  an  =
0xFB
+       (normal) or 0xF8 (deleted) data address mark on any sector.  On sin=
gle-
+       density JV3 disks, the nonstandard data address marks 0xFA and 0xF9=
 are
+       also  available.   You  cannot  format a sector with an incorrect t=
rack
+       number or head number.  You can format a sector with an intentional=
 CRC
+       error in the data field.  xtrs supports at most 5802 total sectors =
on a
+       JV3 image.
+
+       The original Vavasour JV3 format supported only 256-byte  sectors, =
 and
+       had  a limit of 2901 total sectors.  If you use sector sizes other =
than
+       256 bytes or format more than 2901 sectors on a disk  image,  emula=
tors
+       other  than xtrs may be unable to read it.  Note that an 80 track, =
dou-
+       ble-sided, double-density (18 sector) 5.25-inch floppy will fit  wi=
thin
+       the  original 2901 sector limit; the extension to 5802 is primarily=
 for
        emulation of 8-inch drives (discussed below).
=20
-       The  DMK  format  is the most flexible.  It supports essentially ev=
ery-
-       thing that the original hardware could do,  including  all  "protec=
ted"
-       disk  formats.   However, a few protected disks still may not work =
with
-       xtrs due to limitations in  xtrs's  floppy  disk  controller  emula=
tion
-       rather  than limitations of the DMK format; see the LIMITATIONS sec=
tion
+       The DMK format is the most flexible.  It  supports  essentially  ev=
ery-
+       thing  that  the  original hardware could do, including all "protec=
ted"
+       disk formats.  However, a few protected disks still may not  work  =
with
+       xtrs  due  to  limitations  in  xtrs's floppy disk controller emula=
tion
+       rather than limitations of the DMK format; see  Bugs  and  limitati=
ons,
        below.
=20
        The program mkdisk(1) makes a blank emulated floppy or "bulk erases=
" an
-       existing  one.   By default, mkdisk makes a JV3 floppy, but with th=
e -1
-       flag it makes a JV1 floppy, or with the -k flag a DMK floppy.  See =
 the
+       existing one.  By default, mkdisk makes a JV3 floppy, but with  the=
  -1
+       flag  it makes a JV1 floppy, or with the -k flag a DMK floppy.  See=
 the
        mkdisk man page for more information.
=20
-       Early  Model  I  operating systems used an FA data address mark for=
 the
-       directory on single density disks, while later ones wrote F8 but  w=
ould
-       accept either upon reading.  The change was needed because FA is a =
non-
-       standard DAM that is fully supported only by  the  WD1771  floppy  =
disk
-       controller  used in the Model I; the controllers in the Model III a=
nd 4
-       cannot distinguish between FA and FB (which is used  for  non-direc=
tory
-       sectors)  upon  reading, and cannot write FA.  To deal nicely with =
this
-       problem, xtrs implements the following kludge.  On  writing  in  si=
ngle
-       density, an F8 data address mark is recorded as FA.  On reading wit=
h an
-       emulated WD1771 (available in Model I mode only), FA is returned as=
 FA;
-       on  reading  with a WD179x, FA is returned as F8.  This trick makes=
 the
-       different operating systems perfectly compatible with each other, w=
hich
-       is  better  than  on  a real Model I!  You can use the -truedam fla=
g to
-       turn off this kludge if you need to; in that case the original hard=
ware
-       is emulated exactly.
+       Early Model I operating systems used an 0xFA data  address  mark  (=
DAM)
+       for  the directory on single-density disks, while later ones wrote =
0xF8
+       but would accept either upon reading.  The change  was  needed  bec=
ause
+       0xFA  is  a  nonstandard DAM that is fully supported only by the WD=
1771
+       floppy disk controller used in the Model  I;  the  controllers  in =
 the
+       Model III and 4 cannot distinguish between 0xFA and 0xFB (which is =
used
+       for non-directory sectors) upon reading, and  cannot  write  0xFA. =
  To
+       deal  nicely  with  this problem, xtrs implements the following klu=
dge.
+       On writing in single density, an 0xF8 data address mark is recorded=
  as
+       0xFA.   On  reading  with an emulated WD1771 (available in Model I =
mode
+       only), 0xFA is returned as 0xFA; on reading  with  a  WD179x,  0xFA=
  is
+       returned  as  0xF8.   This  trick makes the different operating sys=
tems
+       perfectly compatible with each other, which is better than  on  a  =
real
+       Model  I!  You can use the -truedam flag to turn off this kludge if=
 you
+       need to; in that case the original hardware is emulated exactly.
=20
-       TRS-80  programs  that attempt to measure the rotational speed of t=
heir
+       TRS-80 programs that attempt to measure the rotational speed  of  t=
heir
        floppy disk drives using timing loops will get the answers they exp=
ect,
-       even  when  xtrs does not emulate instructions at the same speed as=
 the
-       original machines. This works because xtrs keeps a virtual clock (t=
ech-
-       nically,  a  T-state  counter),  which measures how much time it sh=
ould
-       have taken to execute the instruction stream on a real machine, and=
  it
-       ties  the  emulation  of  floppy disk index holes to this clock, no=
t to
-       real time.
-
-Emulated 8-inch floppy disks
-       In addition to the four standard 5.25-inch drives, xtrs  also  emul=
ates
-       four  8-inch floppy drives.  There is no widely-accepted standard h=
ard-
-       ware interface for 8-inch floppies on the TRS-80, so  xtrs  emulate=
s  a
+       even when xtrs does not emulate instructions at the same speed  as =
 the
+       original  machines.   This  works  because  xtrs  keeps a virtual c=
lock
+       (technically, a T-state counter),  which  measures  how  much  time=
  it
+       should  have taken to execute the instruction stream on a real mach=
ine,
+       and it ties the emulation of floppy disk index holes to this clock,=
 not
+       to real time.
+
+   Emulated 8-inch floppy disks
+       In  addition  to the four standard 5.25-inch drives, xtrs also emul=
ates
+       four 8-inch floppy drives.  There is no widely-accepted standard  h=
ard-
+       ware  interface  for  8-inch floppies on the TRS-80, so xtrs emulat=
es a
        pseudo-hardware interface of its own and provides an LDOS/LS-DOS dr=
iver
        for it.
=20
-       Storage for the emulated 8-inch disks is in files named diskM-U,  w=
here
-       M  is  the  TRS-80 model number (1, 3, 4, or 4p) and U is a unit nu=
mber
+       Storage  for the emulated 8-inch disks is in files named diskM-U, w=
here
+       M is the TRS-80 model (1, 3, 4, or 4p) and U is the drive  unit  nu=
mber
        (4, 5, 6, or 7).  The only difference between 5.25-inch and 8-inch =
emu-
-       lated  drives  is that the emulator allows you to format more bytes=
 per
-       track in the latter.  A new JV3  floppy  can  be  formatted  as  ei=
ther
-       5.25-inch  or  8-inch  depending on whether you initially put it in=
to a
+       lated drives is that the emulator allows you to format more  bytes =
 per
+       track  in  the  latter.   A  new  JV3 floppy can be formatted as ei=
ther
+       5.25-inch or 8-inch depending on whether you initially put  it  int=
o  a
        5.25-inch or 8-inch emulated drive.  A new DMK floppy, however, mus=
t be
-       created  with the -8 flag to mkdisk in order to be large enough for=
 use
-       in an 8-inch emulated drive.  JV1 floppies cannot  be  used  in  8-=
inch
+       created with the -8 flag to mkdisk in order to be large enough for =
 use
+       in  an  8-inch  emulated  drive.  JV1 floppies cannot be used in 8-=
inch
        drives.  Be careful not to put an emulated floppy into a 5.25-inch =
emu-
-       lated drive after it has been formatted in an 8-inch emulated drive=
  or
-       vice  versa;  the  results  are likely to be confusing.  Consider u=
sing
-       different file extensions for the two types; say,  .dsk  for  5.25-=
inch
+       lated  drive after it has been formatted in an 8-inch emulated driv=
e or
+       vice versa; the results are likely to  be  confusing.   Consider  u=
sing
+       different  file  extensions  for the two types; say, .dsk for 5.25-=
inch
        and .8in for 8-inch.
=20
        To use the emulated 8-inch drives, you'll need a driver.  Under LDO=
S or
        LS-DOS, use the program XTRS8/DCT supplied on the emulated floppy u=
til-
-       ity.dsk.   This  driver  is  a  very  simple  wrapper around the na=
tive
+       ity.dsk.  This driver is  a  very  simple  wrapper  around  the  na=
tive
        LDOS/LS-DOS floppy driver.  Here are detailed instructions.
=20
-       First, make sure an appropriate version of LDOS is in  emulated  fl=
oppy
-       drive  0,  and  the  supplied  file  utility.dsk is in another emul=
ated
+       First,  make  sure an appropriate version of LDOS is in emulated fl=
oppy
+       drive 0, and the supplied  file  utility.dsk  is  in  another  emul=
ated
        floppy drive.  Boot LDOS.  If you are using Model I LDOS, be sure F=
DUBL
        is running.
=20
-       Second,  type  the following commands.  Here d is the LDOS drive nu=
mber
+       Second, type the following commands.  Here d is the LDOS  drive  nu=
mber
        you want to use for the 8-inch drive and u is the unit number you c=
hose
-       when  naming the file.  Most likely you will choose d and u to be e=
qual
+       when naming the file.  Most likely you will choose d and u to be  e=
qual
        to reduce confusion.
-
-           SYSTEM (DRIVE=3Dd,DRIVER=3D"XTRS8",ENABLE)
-           Enter unit number ([4]-7): u
-
-       You can repeat these steps with different values of d  and  u  to  =
have
-       more  than one 8-inch drive.  You might want to repeat four times u=
sing
-       4, 5, 6, and 7, or you might want to save some drive numbers  for  =
hard
+              SYSTEM (DRIVE=3Dd,DRIVER=3D"XTRS8",ENABLE)
+              Enter unit number ([4]-7): u
+       You  can  repeat  these  steps with different values of d and u to =
have
+       more than one 8-inch drive.  You might want to repeat four times  u=
sing
+       4,  5,  6, and 7, or you might want to save some drive numbers for =
hard
        drives (see below).
=20
-       Finally,  it's  a  good idea to give the SYSTEM (SYSGEN) command (M=
odel
-       I/III) or SYSGEN command (Model 4/4P).  This command saves  the  SY=
STEM
-       settings,  so  the  8-inch drives will be available again the next =
time
-       you reboot or restart the emulator.  If you need to  access  an  8-=
inch
-       drive  after  booting from a disk that hasn't been SYSGENed, simply=
 use
+       Finally, it's a good idea to give the SYSTEM  (SYSGEN)  command  (M=
odel
+       I/III)  or  SYSGEN command (Model 4/4P).  This command saves the SY=
STEM
+       settings, so the 8-inch drives will be available again  the  next  =
time
+       you  reboot  or  restart the emulator.  If you need to access an 8-=
inch
+       drive after booting from a disk that hasn't been SYSGENed,  simply =
 use
        the same SYSTEM command again.
=20
-       In case you want to write your own driver for another TRS-80  opera=
ting
-       system,  here  are details on the emulated pseudo-hardware.  The 8-=
inch
-       drives are accessed through the normal floppy disk controller,  exa=
ctly
-       like  5.25-inch drives.  The four 5.25-inch drives have hardware se=
lect
-       codes 1, 2, 4, and 8, corresponding respectively to files diskM-0, =
 -1,
+       In  case you want to write your own driver for another TRS-80 opera=
ting
+       system, here are details on the emulated pseudo-hardware.   The  8-=
inch
+       drives  are accessed through the normal floppy disk controller, exa=
ctly
+       like 5.25-inch drives.  The four 5.25-inch drives have hardware  se=
lect
+       codes  1, 2, 4, and 8, corresponding respectively to files diskM-0,=
 -1,
        -2, and -3.  The four 8-inch drives have hardware select codes 3, 5=
, 6,
-       and 7, corresponding respectively to files diskM-4,  -5,  -6,  and =
 -7.
+       and  7,  corresponding  respectively  to files diskM-4, -5, -6, and=
 -7.
        (See also the -sizemap option below, however.)
=20
-Real floppy disks
-       Under  Linux  only,  any  diskM-U file can be a symbolic link to a =
real
-       floppy disk drive, typically /dev/fd0 or /dev/fd1.  Most PCs should=
  be
-       able to read and write TRS-80 compatible floppies in this way.  Man=
y PC
-       floppy controllers cannot handle single density, however, and some =
 may
-       have  problems even with double density disks written on a real TRS=
-80,
-       especially disks formatted by older TRS-80 operating systems.  Use =
 the
-       -doublestep  flag  if you need to read 35-track or 40-track media i=
n an
-       80-track drive.  If you need to write 35-track or 40-track media in=
  an
-       80-track  drive,  bulk-erase  the  media  first  and  format  it in=
 the
-       80-track drive.  Don't write to a disk in an 80-track drive if  it =
 has
-       ever been written to in a 40-track drive.  The narrower head used i=
n an
-       80-track drive cannot erase the full track width written by the hea=
d in
-       a 40-track drive.
+   Real floppy disks
+       Under Linux only, any diskM-U file can be a symbolic  link  to  a  =
real
+       floppy  disk drive, typically /dev/fd0 or /dev/fd1.  Most machines =
with
+       "legacy" (ISA bus) floppy drive support should  be  able  to  read =
 and
+       write  TRS-80-compatible floppies in this way.  Many floppy control=
lers
+       cannot handle single density, however, and some may have problems  =
even
+       with  double-density  disks  written on a real TRS-80, especially d=
isks
+       formatted by older TRS-80 operating systems.  Use the -doublestep  =
flag
+       if  you  need  to read 35-track or 40-track media in an 80-track dr=
ive.
+       If you need to write 35-track or 40-track media in an  80-track  dr=
ive,
+       bulk-erase  the media first and format it in the 80-track drive.  D=
on't
+       write to a disk in an 80-track drive if it has ever been written to=
  in
+       a  40-track  drive.  The narrower head used in an 80-track drive ca=
nnot
+       erase the full track width written by the head in a 40-track drive.
=20
        If you link one of the 5.25-inch floppy files (diskM-0 through disk=
M-3)
-       to a real floppy drive, TRS-80 programs will  see  it  as  a  5.25-=
inch
-       drive,  but  the actual drive can be either 3.5-inch or 5.25-inch. =
 The
-       drive will be operated in double density (or single density), not  =
high
+       to  a  real  floppy  drive,  TRS-80 programs will see it as a 5.25-=
inch
+       drive, but the actual drive can be either 3.5-inch or  5.25-inch.  =
 The
+       drive  will be operated in double density (or single density), not =
high
        density, so be sure to use the appropriate media.
=20
        If you link one of the 8-inch floppy files (diskM-4 through diskM-7=
) to
-       a real floppy drive, TRS-80 programs will see it as  an  8-inch  dr=
ive.
-       Again,  you  need to use the XTRS8/DCT driver described above to en=
able
-       LDOS/LS-DOS to access an 8-inch drive.  The real drive  can  be  ei=
ther
-       3.5-inch,  5.25-inch, or 8-inch.  A 3.5-inch or 5.25-inch drive wil=
l be
-       operated in high-density mode, using MFM recording  if  the  TRS-80=
  is
-       trying to do double density, FM recording if the TRS-80 is trying t=
o do
-       single density.  In this mode, these drives can hold as much data a=
s  a
-       standard 8-inch drive.  In fact, a 5.25-inch HD drive holds exactly=
 the
-       same number of bits per track as an 8-inch drive; a 3.5-inch  HD  d=
rive
-       can hold 20% more, but we waste that space when using one to emulat=
e an
-       8-inch drive.  In both cases we also waste the top three tracks,  s=
ince
-       an 8-inch drive has only 77 tracks, not 80.
-
-       The  nonstandard  FA and F9 data address marks available in single =
den-
-       sity on a real Model I with the WD1771  controller  also  need  spe=
cial
-       handling.  A PC-style floppy disk controller can neither read nor w=
rite
-       sectors with such DAMs at all.  This raises three issues: (1)  It  =
will
-       be  impossible  for  you  to read some Model I disks on your PC eve=
n if
-       your PC otherwise supports single density.  In particular, Model I =
TRS-
-       DOS  2.3 directory tracks will be unreadable.  (2) On writing in si=
ngle
-       density, xtrs silently records a F9 or FA DAM as F8.  (3) On readin=
g in
-       single  density  with  an  emulated  WD1771  (Model I mode only), F=
8 is
-       returned as FA.  If you need more accurate behavior, the -truedam  =
flag
-       will turn on error messages on attempts to write F9 or FA DAMs and =
will
-       turn off translation of F8 to FA on reading.
-
-       Hint: Be sure to set the drive type correctly in your PC's BIOS.  L=
inux
-       and  xtrs  rely  on  this  information to know how fast your drives=
 are
-       spinning and hence what data rate to use when reading and writing. =
 All
-       3.5-inch  drives spin at 300 RPM.  Newer 5.25-inch high-density cap=
able
-       drives ("1.2MB" drives) normally always spin at 360 RPM.  (Some can=
  be
-       jumpered  to  slow down to 300 RPM when in double-density mode, but=
 you
-       should not do that when plugging  one  into  a  PC.)   Older  5.25-=
inch
-       drives  that  cannot  do  high  density  ("180KB",  "360KB"  or "72=
0KB"
-       5.25-inch drives) always spin at 300 RPM.  All 8-inch  drives  spin=
  at
-       360 RPM.  If you plug an 8-inch drive into a PC (this requires a 50=
-pin
-       to 34-pin adaptor cable), tell your BIOS that it is a  5.25-inch  1=
=2E2MB
-       drive.
+       a  real  floppy  drive, TRS-80 programs will see it as an 8-inch dr=
ive.
+       Again, you need to use the XTRS8/DCT driver described above  to  en=
able
+       LDOS/LS-DOS  to  access  an 8-inch drive.  The real drive can be ei=
ther
+       3.5-inch, 5.25-inch, or 8-inch.  A 3.5-inch or 5.25-inch drive will=
  be
+       operated  in  high-density  mode,  using MFM recording if the TRS-8=
0 is
+       trying to do double density, or FM recording if the TRS-80 is tryin=
g to
+       do single density.  In this mode, these drives can hold as much dat=
a as
+       a standard 8-inch drive.  In fact, a 5.25-inch HD drive  holds  exa=
ctly
+       the  same  number  of  bits per track as an 8-inch drive; a 3.5-inc=
h HD
+       drive can hold 20% more, but we waste that space when using one to =
emu-
+       late  an  8-inch  drive.   In  both  cases  we also waste the top t=
hree
+       tracks, since an 8-inch drive has only 77 tracks, not 80.
+
+       The nonstandard 0xFA and 0xF9 data address marks  available  in  si=
ngle
+       density  on a real Model I with the WD1771 controller also need spe=
cial
+       handling.  A ISA-bus floppy disk controller can neither read nor  w=
rite
+       sectors with such DAMs at all.  This raises three issues.
+
+       1.     It will be impossible for you to read some Model I disks on =
your
+              machine even if it otherwise supports single density.   In  =
par-
+              ticular, Model I TRSDOS 2.3 directory tracks will be unreada=
ble.
+
+       2.     On  writing  in  single density, xtrs silently records a 0xF=
9 or
+              0xFA DAM as 0xF8.
+
+       3.     On reading in single density with an emulated  WD1771  (Mode=
l  I
+              mode only), 0xF8 is returned as 0xFA.  If you need more accu=
rate
+              behavior, the -truedam flag  will  turn  on  error  messages=
  on
+              attempts  to  write 0xF9 or 0xFA DAMs and will turn off tran=
sla-
+              tion of 0xF8 to 0xFA on reading.
+
+       Hint: Be sure to  set  the  drive  type  correctly  in  your  machi=
ne's
+       firmware.   Linux  and  xtrs  rely on this information to know how =
fast
+       your drives are spinning and hence what data rate to use  when  rea=
ding
+       and  writing.   All  3.5-inch  drives spin at 300 rpm.  Newer 5.25-=
inch
+       high-density capable drives ("1.2MB" drives) normally  always  spin=
  at
+       360 rpm.  (Some can be jumpered to slow down to 300 rpm when in dou=
ble-
+       density mode, but you should not do  that  when  connecting  one  t=
o  a
+       floppy  disk controller designed for ISA-bus machines.  Older 5.25-=
inch
+       drives that cannot  do  high  density  ("180kB",  "360kB",  or  "72=
0kB"
+       5.25-inch  drives)  always  spin at 300 rpm.  All 8-inch drives spi=
n at
+       360 rpm.  If you plug an 8-inch drive into an ISA-bus floppy disk  =
con-
+       troller--this  requires  a  50-pin  to  34-pin adaptor cable--tell =
your
+       firmware that it is a 5.25-inch 1.2MiB drive.
=20
-Emulated hard disks
+   Emulated hard disks
        xtrs can emulate a hard disk in a file in one of two ways: it can u=
se a
-       special, xtrs-specific LDOS driver called XTRSHARD/DCT, or it can  =
emu-
-       late  the Radio Shack hard drive controller (based on the Western D=
igi-
+       special,  xtrs-specific LDOS driver called XTRSHARD/DCT, or it can =
emu-
+       late the Radio Shack hard drive controller (based on the Western  D=
igi-
        tal WD1010) and use the native drivers for the original hardware.
=20
        Using XTRSHARD/DCT
-
-       The XTRSHARD/DCT driver has been tested and works under both LDOS 5=
=2E3.1
-       for  Model  I or III and TRSDOS/LS-DOS 6.3.1 for Model 4/4P.  It ma=
y or
-       may not work under earlier LDOS versions.  It definitely will not  =
work
-       under other TRS-80 operating systems or with emulators other than x=
trs.
-       The hard disk format was designed by Matthew Reed for his  Model  I=
/III
-       and  Model  4  emulators;  xtrs duplicates the format so that users=
 can
-       exchange hard drive images across the emulators.
-
-       To use XTRSHARD/DCT, first run the mkdisk program under Unix to  cr=
eate
-       a  blank  hard  drive  (.hdv)  file.  Typical usage would be: mkdis=
k -h
-       mydisk.hdv.  See the mkdisk(1) man page for other options.
-
-       Second, link the file to an appropriate name.  XTRSHARD/DCT support=
s up
-       to  eight  hard  drives, with names of the form hardM-U, where M is=
 the
-       TRS-80 model (1, 3, or 4; in this case Model 4P also uses M=3D4) an=
d U is
-       a unit number from 0 to 7.  It looks for these files in the same di=
rec-
-       tory as the floppy disk files diskM-U.
-
-       Third, make sure an appropriate version of LDOS is in  emulated  fl=
oppy
-       drive  0,  and  the  supplied  file  utility.dsk is in another emul=
ated
-       floppy drive.  Boot LDOS.  If you are using Model I LDOS 5.3.1, pat=
ch a
-       bug  in  the  FORMAT  command by typing PATCH FORMAT/CMD.UTILITY M1=
FOR-
-       MAT/FIX.  You need to apply this patch  only  once.   It  must  not=
  be
-       applied to Model III or Model 4/4P LDOS.
-
-       Fourth,  type  the following commands.  Here d is the LDOS drive nu=
mber
-       you want to use for the hard drive (a typical choice would be 4) an=
d  u
-       is the unit number you chose when naming the file (most likely 0).
-
-           SYSTEM (DRIVE=3Dd,DRIVER=3D"XTRSHARD",ENABLE)
-           Enter unit number ([0]-7): u
-           FORMAT d (DIR=3D1)
-
-       Answer  the questions asked by FORMAT as you prefer.  The DIR=3D1 p=
arame-
-       ter to FORMAT is optional; it causes the hard drive's directory  to=
  be
-       on  track  1,  making  the  initial size of the image smaller.  You=
 can
-       repeat these steps with different values of d and u to have  more  =
than
-       one hard drive.
-
-       Finally,  it's  a  good idea to give the SYSTEM (SYSGEN) command (M=
odel
-       I/III) or SYSGEN command (Model 4/4P).  This command saves  the  SY=
STEM
-       settings, so the drive will be available again the next time you re=
boot
-       or restart the emulator.  If you need to  access  the  hard  disk  =
file
-       after  booting  from a floppy that hasn't been SYSGENed, simply use=
 the
-       same SYSTEM command(s) again, but don't FORMAT.  You can freely  us=
e  a
-       different drive number or (if you renamed the hard disk file) a dif=
fer-
-       ent unit number.
-
-       The F7 key currently doesn't allow XTRSHARD/DCT disk changes to be =
rec-
-       ognized,  but you can change to a different hard disk file for the =
same
-       unit by renaming files as needed and rebooting LDOS.
-
-       Technical note: XTRSHARD/DCT is a small Z-80  program  that  implem=
ents
-       all  the required functions of an LDOS disk driver.  Instead of tal=
king
-       to a real (or emulated) hard disk controller, however, it uses  spe=
cial
-       support  in  xtrs  that  allows Z-80 programs to open, close, read,=
 and
-       write Unix files directly.  This support is described  further  in =
 the
-       "Data import and export" section below.
+              The  XTRSHARD/DCT  driver  has  been tested and works under =
both
+              LDOS 5.3.1 for Model I or III and TRSDOS/LS-DOS 6.3.1 for  M=
odel
+              4/4P.   It  may or may not work under earlier LDOS versions.=
  It
+              definitely will not work under other TRS-80 operating system=
s or
+              with  emulators  other  than  xtrs.   The  hard  disk format=
 was
+              designed by Matthew Reed for his Model I/III and Model 4  em=
ula-
+              tors; xtrs duplicates the format so that users can exchange =
hard
+              drive images across the emulators.
+
+              To use XTRSHARD/DCT, first run the mkdisk(1) program to crea=
te a
+              blank  hard  drive (.hdv) file.  A typical usage would be mk=
disk
+              -h myhd.hdv.  See the mkdisk man page for other options.
+
+              Second, link the file to an appropriate name.  XTRSHARD/DCT =
sup-
+              ports  up  to eight hard drives, with names of the form hard=
M-U,
+              where M is the TRS-80 model (1, 3, or 4; in this case the  M=
odel
+              4P  also  uses M=3D4) and U is a unit number in the range 0-=
7.  It
+              looks for these files in the same directory as the  floppy  =
disk
+              files diskM-U.
+
+              Third,  make  sure an appropriate version of LDOS is in emul=
ated
+              floppy drive 0, and the supplied file utility.dsk is in  ano=
ther
+              emulated  floppy  drive.   Boot  LDOS.  If you are using Mod=
el I
+              LDOS 5.3.1, patch a bug in the FORMAT command  by  typing  P=
ATCH
+              FORMAT/CMD.UTILITY  M1FORMAT/FIX.   You need to apply this p=
atch
+              only once.  It must not be applied to Model III  or  Model  =
4/4P
+              LDOS.
+
+              Fourth,  type  the following commands.  Here d is the LDOS d=
rive
+              number you want to use for the  hard  drive  (a  typical  ch=
oice
+              would  be  4) and u is the unit number you chose when naming=
 the
+              file (most likely 0).
+                   SYSTEM (DRIVE=3Dd,DRIVER=3D"XTRSHARD",ENABLE)
+                   Enter unit number ([0]-7): u
+                   FORMAT d (DIR=3D1)
+              Answer the questions asked by FORMAT as you prefer.   The  D=
IR=3D1
+              parameter  to  FORMAT  is  optional;  it causes the hard dri=
ve's
+              directory to be on track 1, making the initial size of the i=
mage
+              smaller.   You can repeat these steps with different values =
of d
+              and u to have more than one hard drive.
+
+              Finally, it's a good idea to give the  SYSTEM  (SYSGEN)  com=
mand
+              (Model  I/III)  or  SYSGEN  command  (Model 4/4P).  This com=
mand
+              saves the SYSTEM settings, so the drive will be available  a=
gain
+              the next time you reboot or restart the emulator.
+
+              If  you  need  to access the hard disk file after booting fr=
om a
+              floppy that hasn't been SYSGENed, simply  use  the  same  SY=
STEM
+              command(s)  again,  but don't FORMAT.  You can freely use a =
dif-
+              ferent drive number or (if you renamed the  hard  disk  file=
)  a
+              different unit number.
+
+              The  F7 key currently doesn't allow XTRSHARD/DCT disk change=
s to
+              be recognized, but you can change to a different hard disk  =
file
+              for  the  same  unit  by  renaming files as needed and reboo=
ting
+              LDOS.
+
+              Technical note: XTRSHARD/DCT is a small Z80 program that  im=
ple-
+              ments  all  the  required  functions  of  an  LDOS  disk dri=
ver.
+              Instead of talking to a real (or emulated) hard disk control=
ler,
+              however,  it  uses  special support in xtrs that allows Z80 =
pro-
+              grams to open, close, read, and write Unix files directly.  =
This
+              support is described further in Data import and export, belo=
w.
=20
        Using native hard disk drivers
+              Beginning  in  version  4.1,  xtrs also emulates the Radio S=
hack
+              hard disk controller (based on the Western Digital  WD1010) =
 and
+              will  work with the native drivers for this hardware.  This =
emu-
+              lation uses the same hard drive (.hdv)  file  format  that  =
XTR-
+              SHARD/DCT does.  With LDOS/LS-DOS, the RSHARDx/DCT and TRSHD=
/DCT
+              drivers are  known  to  work.   With  Montezuma  CP/M  2.2, =
 the
+              optional  Montezuma  hard  disk  drivers are known to work. =
 The
+              hard disk drivers for NEWDOS/80 and for  Radio  Shack  CP/M =
 3.0
+              should  work, but they have not yet been tested at this writ=
ing.
+              Any bugs should be reported.
+
+              To get started, run the mkdisk(1) program to create a blank =
hard
+              drive (.hdv) file.  A typical usage would be mkdisk -h myhd.=
hdv.
+              See the mkdisk man page for other options.
+
+              Second, link the file to an appropriate name.  The WD1010 em=
ula-
+              tion  supports  up  to  four hard drives, with names of the =
form
+              hardM-U, where M is the TRS-80 model (1, 3, 4, or 4p) and U =
is a
+              unit  number  in the range 0-3.  It looks for these files in=
 the
+              same directory as the floppy disk files  diskM-U.   If  no  =
such
+              files are present, xtrs disables the WD1010 emulation.
+
+              Note  that  if  hard drive unit 0 is present on a Model 4P (=
file
+              hard4p-0), the Radio Shack boot ROM will always try to boot =
=66rom
+              it, even if the operating system does not support booting fr=
om a
+              hard drive.  If you have this problem, either hold down F2 w=
hile
+              booting  to  force  the ROM to boot from floppy, or simply a=
void
+              using unit number 0.  Stock TRSDOS/LS-DOS 6 systems do not  =
sup-
+              port booting from a hard drive; M.A.D. Software's HBUILD6 ad=
d-on
+              to LS-DOS for hard drive booting should work, but  is  untes=
ted.
+              Montezuma CP/M 2.2 does boot from the emulated hard drive.
+
+              Finally,  obtain the correct driver for the operating system=
 you
+              will be using, read its documentation, configure the driver,=
 and
+              format the drive.  Detailed instructions are beyond the scop=
e of
+              this manual page.
=20
-       Beginning  in version 4.1, xtrs also emulates the Radio Shack hard =
disk
-       controller (based on the Western Digital WD1010) and will work with=
 the
-       native  drivers  for  this hardware.  This emulation uses the same =
hard
-       drive (.hdv) file format that XTRSHARD/DCT does.  With LDOS/LS-DOS,=
 the
-       RSHARDx/DCT  and  TRSHD/DCT  drivers are known to work.  With Monte=
zuma
-       CP/M 2.2, the optional Montezuma hard disk drivers are known  to  w=
ork.
-       The hard disk drivers for NEWDOS/80 and for Radio Shack CP/M 3.0 sh=
ould
-       work, but they have not yet been tested  at  this  writing.   Any  =
bugs
-       should be reported.
-
-       To  get  started,  run  the mkdisk program under Unix to create a b=
lank
-       hard drive (.hdv) file.  Typical usage would be: mkdisk -h  mydisk.=
hdv.
-       See the mkdisk(1) man page for other options.
-
-       Second,  link  the  file  to an appropriate name.  The WD1010 emula=
tion
-       supports up to four hard drives, with names of the form hardM-U,  w=
here
-       M is the TRS-80 model (1, 3, 4, or 4p) and U is a unit number from =
0 to
-       3.  It looks for these files in the same directory as the  floppy  =
disk
-       files  diskM-U.  If no such files are present, xtrs disables the WD=
1010
-       emulation.
-
-       Note that if hard  drive  unit  0  is  present  on  a  Model  4P  (=
file
-       hard4p-0),  the  Radio  Shack boot ROM will always try to boot from=
 it,
-       even if the operating system does  not  support  booting  from  a  =
hard
-       drive.   If you have this problem, either hold down F2 while bootin=
g to
-       force the ROM to boot from floppy, or simply avoid using unit numbe=
r 0.
-       Stock TRSDOS/LS-DOS 6 systems do not support booting from a hard dr=
ive;
-       M.A.D. Software's HBUILD6 add-on  to  LS-DOS  for  hard  drive  boo=
ting
-       should  work,  but  is untested.  Montezuma CP/M 2.2 does boot from=
 the
-       emulated hard drive.
-
-       Finally, obtain the correct driver for the operating system you wil=
l be
-       using,  read  its  documentation,  configure the driver, and format=
 the
-       drive.  Detailed instructions are beyond the scope of this manual p=
age.
-
-Data import and export
-       Several  Z-80  programs  for data import and export from various TR=
S-80
+   Data import and export
+       Several Z80 programs for data import and  export  from  various  TR=
S-80
        operating systems are included with xtrs on two emulated floppy ima=
ges.
-       These  programs  use  special support in the emulator to read and w=
rite
+       These programs use special support in the emulator to  read  and  w=
rite
        external Unix files, discussed further at the end of this section.
=20
        The emulated floppy utility.dsk contains some programs for transfer=
ring
        data  between  the  emulator  and  ordinary  Unix  files.   IMPORT/=
CMD,
-       EXPORT/CMD, and SETTIME/CMD run on the emulator under Model I/III  =
TRS-
-       DOS, Model I/III LDOS, Model I/III Newdos/80, and Model 4/4P TRSDOS=
/LS-
-       DOS 6; they may also work under other TRS-80 operating systems.   M=
odel
-       III  TRSDOS  users  will  have  to use TRSDOS's CONVERT command to =
read
+       EXPORT/CMD,  and SETTIME/CMD run on the emulator under Model I/III =
TRS-
+       DOS, Model I/III LDOS, Model I/III NEWDOS/80, and Model 4/4P TRSDOS=
/LS-
+       DOS  6; they may also work under other TRS-80 operating systems.  M=
odel
+       III TRSDOS users will have to use  TRSDOS's  CONVERT  command  to  =
read
        utility.dsk.
=20
-       IMPORT/CMD imports a Unix file and  writes  it  to  an  emulated  d=
isk.
-       Usage:  IMPORT  [-lne]  unixfile  [trsfile].  The -n flag converts =
Unix
-       newlines (\n) to TRS-80 newlines (\r).  The -l flag converts  the  =
Unix
-       filename to lower case, to compensate for TRS-80 operating systems =
such
-       as Newdos/80 that convert all command line  arguments  to  upper  c=
ase.
-       When using the -l flag, you can put a [ or up-arrow in front of a c=
har-
-       acter to keep it in upper case.  Give the -e flag if your TRS-80  o=
per-
-       ating  system uses the Newdos/80 convention for representing the en=
ding
-       record number in an open file control block.  This should  be  dete=
cted
-       automatically  for Newdos/80 itself and for TRSDOS 1.3, but you'll =
need
-       to give the flag for DOSPLUS and possibly other non-LDOS operating =
sys-
-       tems.  If you need the flag but don't give it (or vice versa), impo=
rted
-       files will come out the wrong length.  If the destination file is o=
mit-
-       ted,  IMPORT uses the last component of the Unix pathname, but with=
 any
-       "." changed to "/" to match TRS-80 DOS file extension syntax.
-
-       EXPORT/CMD reads a file from an emulated disk and exports it to a  =
Unix
-       file.  Usage:  EXPORT  [-lne] trsfile [unixfile].  The -n flag conv=
erts
-       TRS-80 newlines (\r) to Unix newlines (\n).  The -l flag  converts =
 the
-       Unix  filename  to lower case.  When using the -l flag, you can put=
 a [
-       or up-arrow in front of a character to keep it in upper case.  Give=
 the
-       -e  flag  if your TRS-80 operating system uses the Newdos/80 conven=
tion
-       for representing the ending record  number  in  an  open  file  con=
trol
-       block.   This should be detected automatically for Newdos/80 itself=
 and
-       for TRSDOS 1.3, but you'll need to give the flag for DOSPLUS and po=
ssi-
-       bly  other  non-LDOS operating systems.  If you need the flag but d=
on't
-       give it (or vice versa), exported files will come out the wrong len=
gth.
-       If  the  destination  file is omitted, EXPORT uses the TRS-80 filen=
ame,
-       but with any "/" changed to "." to match Unix file extension syntax.
-
-       SETTIME/CMD reads the date and time from Unix and sets the TRS-80 D=
OS's
-       date and time accordingly.
-
-       The  next  several  programs were written in Misosys C and exist in=
 two
-       versions on utility.dsk.  The one whose name ends in "6" runs on  M=
odel
-       4  TRSDOS/LS-DOS  6.x;  the other runs on LDOS 5.x and most other M=
odel
+       IMPORT/CMD
+              imports a Unix file and writes it to an emulated disk.
+
+              Usage: IMPORT [-lne] unixfile [trsfile]
+
+              The -n flag converts Unix newlines (\n) to TRS-80 newlines (=
\r).
+              The -l flag converts the Unix filename to lowercase, to  com=
pen-
+              sate for TRS-80 operating systems such as NEWDOS/80 that con=
vert
+              all command-line arguments to  uppercase.   When  using  the=
  -l
+              flag,  you  can  put  a [ or up-arrow in front of a characte=
r to
+              keep it in uppercase.  Give the -e flag if your TRS-80 opera=
ting
+              system uses the NEWDOS/80 convention for representing the en=
ding
+              record number in an open file control  block.   This  should=
  be
+              detected  automatically for NEWDOS/80 itself and for TRSDOS =
1.3,
+              but you'll need to give the flag for DOSPLUS and possibly  o=
ther
+              non-LDOS operating systems.  If you need the flag but don't =
give
+              it (or vice versa), imported  files  will  come  out  the  w=
rong
+              length.   If  the  destination  file is omitted, IMPORT uses=
 the
+              last component of the Unix pathname, but with any "." change=
d to
+              "/" to match TRS-80 DOS file extension syntax.
+
+       EXPORT/CMD
+              reads  a  file  from  an  emulated disk and exports it to a =
Unix
+              file.
+
+              Usage: EXPORT [-lne] trsfile [unixfile]
+
+              The -n flag converts TRS-80 newlines (\r) to Unix newlines (=
\n).
+              The -l flag converts the Unix filename to lowercase.  When u=
sing
+              the -l flag, you can put a [ or up-arrow in front of a chara=
cter
+              to  keep it in uppercase.  Give the -e flag if your TRS-80 o=
per-
+              ating system uses the NEWDOS/80 convention for representing =
 the
+              ending record number in an open file control block.  This sh=
ould
+              be detected automatically for NEWDOS/80 itself  and  for  TR=
SDOS
+              1.3,  but  you'll need to give the flag for DOSPLUS and poss=
ibly
+              other non-LDOS operating systems.  If  you  need  the  flag =
 but
+              don't  give it (or vice versa), imported files will come out=
 the
+              wrong length.  If the destination file is omitted,  EXPORT  =
uses
+              the  TRS-80  filename,  but with any "/" changed to "." to m=
atch
+              Unix file extension syntax.
+
+              Note: The export of files from xtrs may  be  prohibited  by =
 the
+              -emtsafe flag; see Options, below.
+
+       SETTIME/CMD
+              reads the date and time from Unix and sets the TRS-80 DOS's =
date
+              and time accordingly.
+
+       The next several programs were written in Misosys C and  exist  in =
 two
+       versions  on utility.dsk.  The one whose name ends in "6" runs on M=
odel
+       4 TRSDOS/LS-DOS 6.x; the other runs on LDOS 5.x and  most  other  M=
odel
        I/III operating systems.
=20
-       CD/CMD (or CD6/CMD) changes xtrs's Unix working directory.   Usage:=
  CD
-       [-l]  unixdir.   The  -l flag converts the Unix directory name to l=
ower
-       case.  When using the -l flag, you can put a [ or up-arrow in front=
  of
-       a  character  to keep it in upper case.  Running CD/CMD will change=
 the
-       interpretation of any relative pathnames given to IMPORT or EXPORT.=
  It
-       will  also  change  the  interpretation  of disk names at the next =
disk
-       change, unless you specified an absolute pathname for  xtrs's  -dis=
kdir
-       parameter.
-
-       PWD/CMD (or PWD6/CMD) prints xtrs's Unix working directory.
-
-       UNIX/CMD  (or  UNIX6/CMD)  runs a Unix shell command.  Usage: UNIX =
[-l]
-       unix command line.  The -l flag converts the Unix command line to l=
ower
-       case.   When using the -l flag, you can put a [ or up-arrow in fron=
t of
-       a character to keep it in upper case.  Standard  I/O  for  the  com=
mand
-       uses the xtrs program's standard I/O descriptors; it does not go to=
 the
-       TRS-80 screen or come from the TRS-80 keyboard.
-
-       MOUNT/CMD (or MOUNT6/CMD) is a convenience program that  switches  =
emu-
-       lated  floppy  disks in the drives.  Usage: MOUNT [-l] filename U. =
 The
-       -l flag converts the Unix filename to lower case.  When  using  the=
  -l
-       flag, you can put a [ or up-arrow in front of a character to keep i=
t in
-       upper case.  The filename is any Unix filename; U is a single digit=
,  0
-       through 7.  The command deletes the file diskM-U (where M is the TR=
S-80
-       model) from the disk directory (see -diskdir option), replaces it  =
with
-       a symbolic link to the given filename, and signals a disk change (a=
s if
-       F7 had been pressed).
-
-       UMOUNT/CMD (or UMOUNT6/CMD) is a convenience program  that  removes=
  an
-       emulated  floppy  disk  from  a drive.  Usage: UMOUNT U.  U is a si=
ngle
-       digit, 0 through 7.  The command deletes the file diskM-U (where  M=
  is
-       the  TRS-80  model)  from  the disk directory (see -diskdir option)=
 and
-       signals a disk change (as if F7 had been pressed).
+       CD/CMD (or  CD6/CMD)  changes  xtrs's  current  working directory u=
nder
+              Unix.
+
+              Usage: CD [-l] unixdir
+
+              The -l flag converts the Unix directory name to lowercase.  =
When
+              using  the  -l  flag,  you can put a [ or up-arrow in front =
of a
+              character to keep it in uppercase.  Running CD/CMD  will  ch=
ange
+              the  interpretation of any relative pathnames given to IMPOR=
T or
+              EXPORT.  It will also change the interpretation of disk name=
s at
+              the  next disk change, unless you specified an absolute path=
name
+              for xtrs's -diskdir parameter.
+
+              Note: The change of xtrs's current working directory may be =
pro-
+              hibited by the -emtsafe flag; see Options, below.
+
+       PWD/CMD
+              (or  PWD6/CMD)  prints  xtrs's  current  working directory u=
nder
+              Unix.
+
+       UNIX/CMD
+              (or UNIX6/CMD) runs a Unix shell command.
+
+              Usage: UNIX [-l] unix-command-line
+
+              The -l flag converts the Unix command line to  lowercase.   =
When
+              using  the  -l  flag,  you can put a [ or up-arrow in front =
of a
+              character to keep it in uppercase.  Standard I/O for the com=
mand
+              uses the xtrs program's standard I/O descriptors; it does no=
t go
+              to the TRS-80 screen or come from the TRS-80 keyboard.
+
+              Note: The execution of Unix shell commands may be prohibited=
  by
+              the -emtsafe flag; see Options, below.
+
+       MOUNT/CMD
+              (or  MOUNT6/CMD) is a convenience program that switches emul=
ated
+              floppy disks in the drives.
+
+              Usage: MOUNT [-l] unixfile unit-number
+
+              The -l flag converts unixfile to lowercase.  When using  the=
  -l
+              flag,  you  can  put  a [ or up-arrow in front of a characte=
r to
+              keep it in uppercase.  unixfile is any Unix filename;  unit-=
num-
+              ber  is  a  single  digit, 0 through 7.  The command deletes=
 the
+              file diskM-U (where M is the TRS-80 model and  U  is  the  g=
iven
+              unit-number)  from  the  disk directory (see the -diskdir op=
tion
+              below), replaces it with a symbolic link to the given  filen=
ame,
+              and signals a disk change (as if F7 had been pressed).
+
+              Note: The mounting of a Unix file as a disk image may be pro=
hib-
+              ited by the -emtsafe flag; see Options, below.
+
+       UMOUNT/CMD
+              (or UMOUNT6/CMD) is a convenience program that removes  an  =
emu-
+              lated floppy disk from a drive.
+
+              Usage: UMOUNT unit-number
+
+              unit-number is a single digit, 0 through 7.  The command del=
etes
+              the file diskM-U (where M is the TRS-80 model and U is the g=
iven
+              unit-number)  from  the  disk directory (see the -diskdir op=
tion
+              below), and signals a disk change (as if F7 had been pressed=
).
+
+              Note: The unmounting of a Unix file as a disk image by  dele=
ting
+              it  on  the  host  may  be  prohibited by the -emtsafe flag;=
 see
+              Options, below.
=20
        The emulated floppy cpmutil.dsk contains import and export programs=
 for
        Montezuma CP/M, written by Roland Gerlach.  It was formatted as a "=
Mon-
-       tezuma Micro Standard DATA disk (40T, SS,  DD,  200K),"  with  512-=
byte
+       tezuma Micro Standard DATA disk (40T, SS,  DD,  200K)",  with  512-=
byte
        sectors.   Be  careful to configure your CP/M to the proper disk fo=
rmat
-       and drive parameters (40 track, not 80), or  you  will  have  confu=
sing
+       and drive parameters (40 tracks, not 80), or you  will  have  confu=
sing
        problems  reading  this  disk.   Documentation  is included in the =
file
-       cpmutil.html and source code in the file  cpmutil.tgz  (a  gzipped =
 tar
-       archive).    See  http://members.optusnet.com.au/~rgerlach/trs-80/c=
pmu-
-       til.html where you will sometimes find a newer version of the utili=
ties
-       than is included with xtrs.
+       cpmutil.html and source code in the file cpmutil.tgz (a gzipped tar=
 ar-
+       chive) in the xtrs source distribution.
=20
        The  emulator  implements a set of pseudo-instructions (emulator tr=
aps)
        that give TRS-80 programs access to Unix files.   The  programs  li=
sted
@@ -562,165 +626,161 @@
        for   the  existing  programs  is  supplied  in  xtrshard.z,  impor=
t.z,
        export.z, and settime.z.  You can also  write  programs  that  use =
 the
        traps  in  Misosys  C,  using the files xtrsemt.h and xtrsemt.ccc a=
s an
-       interface; a simple example is in settime.ccc.
-
-Interrupts
-       The emulator supports only interrupt mode 1.  It will complain if  =
your
-       program  enables  interrupts  after  powerup  without executing an =
IM 1
-       instruction first.  All Model I/III/4/4P software  does  this,  as =
 the
-       built-in peripherals in these machines support only IM 1.
+       interface; a simple example is in settime.ccc.  All of these files =
 are
+       available in the xtrs source distribution.
=20
+   Interrupts
+       The  emulator  supports only interrupt mode 1 of the Z80.  It will =
com-
+       plain if your program enables interrupts after powerup without  exe=
cut-
+       ing  an  IM  1  instruction  first.  All Model I/III/4/4P software =
does
+       this, as the built-in peripherals in these machines support only IM=
  1.
        The  Model I has a 40 Hz heartbeat clock interrupt, while the Model=
 III
        uses 30 Hz, and the Model 4/4P can run at either 30 Hz or 60  Hz.  =
 The
-       emulator  approximates  this  rather  well even on a system where c=
lock
-       ticks come at some frequency that isn't divisible by the emulated  =
fre-
-       quency  (e.g., 100 Hz on Intel Linux), as long as the true frequenc=
y is
-       not slower than the emulated frequency.  The emulator has a  notion=
  of
-       the  absolute time at which each tick is supposed to occur, and it =
asks
-       the host system to wake it up at each of those times.  The  net  re=
sult
-       is  that some ticks may be late, but there are always the proper nu=
mber
-       of ticks per second.  For example, running in Model  I  mode  on  I=
ntel
-       Linux  you'd  see this pattern: (tick, 30ms, tick, 20ms,...) instea=
d of
-       seeing ticks every 25ms.
+       emulator  has  a notion of the absolute time at which each tick is =
sup-
+       posed to occur, and it asks the host system to wake it up  at  each=
  of
+       those  times.  The net result is that some ticks may be late, but t=
here
+       are always the proper number of ticks per second.  For example, run=
ning
+       in  Model  I  mode  on a Linux kernel configured with HZ=3D100, you=
'd see
+       this pattern: (tick, 30ms, tick, 20ms, ...) instead  of  a  tick  e=
very
+       25ms.
=20
-Processor speed selection
+   Processor speed selection
        A standard Model 4 has a software-controlled switch to select opera=
tion
-       at  either  4.05504  MHz (with heartbeat clock at 60 Hz) or 2.02752=
 MHz
+       at either 4.05504 MHz (with heartbeat clock at 60 Hz)  or  2.02752 =
 MHz
        (with heartbeat clock at 30 Hz).  xtrs emulates this feature.
=20
-       Model I's were often modified to operate  at  higher  speeds  than =
 the
-       standard  1.77408  MHz.   With  one common modification, writing a =
1 to
-       port 0xFE would double the speed to 3.54816  MHz,  while  writing  =
a  0
-       would  set the speed back to normal.  The heartbeat clock runs at 4=
0 Hz
+       Model  I  machines were often modified to operate at higher speeds =
than
+       the standard 1.77408 MHz.  With one common modification, writing a =
1 to
+       port  0xFE  would  double  the  speed to 3.54816 MHz, while writing=
 a 0
+       would set the speed back to normal.  The heartbeat clock runs at 40=
  Hz
        in either case.  xtrs emulates this feature as well.
=20
-Sound
-       Sound support uses the Open Sound System /dev/dsp device,  standard=
  on
-       Linux  and available on many other Unix versions as well.  This sup=
port
-       is compiled in automatically on Linux; if you have OSS on another  =
ver-
-       sion  of  Unix, you'll need to define the symbol HAVE OSS in your M=
ake-
-       file or in trs cassette.c.  Any time TRS-80  software  tries  to  w=
rite
-       non-zero  values to the cassette port (or the Model 4/4P optional s=
ound
-       port) with the cassette motor off, it is assumed to be trying  to  =
make
-       sounds  and  xtrs  opens  /dev/dsp.  It automatically closes the de=
vice
-       again after a few seconds of silence.
+   Sound
+       Sound  support  uses the Open Sound System (OSS) /dev/dsp device, s=
tan-
+       dard on Linux and available on many other Unix versions as well.   =
This
+       support  is  compiled  in  automatically  on  Linux; if you have OS=
S on
+       another version of Unix, you'll need to define the symbol  HAVE OSS=
  in
+       the  source  distribution's  Makefile  or  in trs cassette.c.  Any =
time
+       TRS-80 software tries to write non-zero values to the cassette port=
 (or
+       the  Model 4/4P optional sound port) with the cassette motor off, i=
t is
+       assumed to be trying to make sounds and xtrs opens /dev/dsp.  It  a=
uto-
+       matically closes the device again after a few seconds of silence.
=20
        If you are playing a game with sound, you'll want to use the -autod=
elay
        flag to slow down instruction emulation to approximately the speed =
of a
-       real TRS-80.  If you don't do this, sound will  still  play  correc=
tly,
+       real  TRS-80.   If  you don't do this, sound will still play correc=
tly,
        but the gameplay may be way too fast and get ahead of the sound.
=20
-       On  the other hand, if your machine is a bit too slow, you'll hear =
gaps
+       On the other hand, if your machine is a bit too slow, you'll hear  =
gaps
        and pops in the sound when the TRS-80 program lags behind the deman=
d of
-       the  sound  card  for  more samples.  The -autodelay feature includ=
es a
-       small speed boost whenever a sound starts to play  to  try  to  pre=
vent
+       the sound card for more samples.  The  -autodelay  feature  include=
s  a
+       small  speed  boost  whenever  a sound starts to play to try to pre=
vent
        this, but if the boost is too much or too little, you might either =
find
        that the game runs too fast when a lot of sound is playing, or that=
 the
-       sound  has  gaps  in  it  anyway.   If your sound has gaps, you can=
 try
+       sound has gaps in it anyway.  If your  sound  has  gaps,  you  can =
 try
        reducing the sample rate with the -samplerate flag.
=20
        The Orchestra-85 music synthesis software will run under xtrs's Mod=
el I
-       emulation,  and the Orchestra-90 software will run with Model III o=
per-
-       ating systems under xtrs's Model III, 4, or  4P  emulation.   For  =
best
-       results,  use  Orchestra-90 and the Model 4 emulation, as this lets=
 the
+       emulation, and the Orchestra-90 software will run with Model III  o=
per-
+       ating  systems  under  xtrs's  Model III, 4, or 4P emulation.  For =
best
+       results, use Orchestra-90 and the Model 4 emulation, as this  lets =
 the
        software run at the highest emulated clock rate (4 MHz) and thus ge=
ner-
-       ate  the  best sound.  If you want to run Orchestra-85 instead, you=
 can
-       tell it that you have a 3.5 MHz  clock  speedup  with  enable  sequ=
ence
-       3E01D3FE  and disable sequence 3E00D3FE; this will let the software=
 run
-       twice as fast as on an unmodified Model I and  generate  better  so=
und.
-       There  is  no  need  to use xtrs's -autodelay flag when running Orc=
hes-
-       tra-85/90, but you might want to specify a small fixed  delay  to  =
keep
+       ate the best sound.  If you want to run Orchestra-85 instead,  you =
 can
+       tell  it  that  you  have  a 3.5 MHz clock speedup with enable sequ=
ence
+       3E01D3FE and disable sequence 3E00D3FE; this will let the software =
 run
+       twice  as  fast  as on an unmodified Model I and generate better so=
und.
+       There is no need to use xtrs's -autodelay  flag  when  running  Orc=
hes-
+       tra-85/90,  but  you  might want to specify a small fixed delay to =
keep
        from getting excessive key repeat.
=20
-Mouse
-       A  few Model 4 programs could use a mouse, such as the shareware hi=
-res
-       drawing program MDRAW-II. The program XTRSMOUS/CMD on the utility  =
disk
-       (utility.dsk)  is  a  mouse driver for Model 4/4P mode that should =
work
-       with most such programs.  xtrs does not emulate the actual mouse  h=
ard-
-       ware  (a  serial  mouse  plugged  into the Model 4 RS-232 port), so=
 the
-       original mouse drivers will not work  under  xtrs.   Instead,  XTRS=
MOUS
-       accesses  the  X mouse pointer using an emulator trap.  XTRSMOUS im=
ple-
-       ments the same TRSDOS/LS-DOS 6 SVC interface as  the  David  Goben =
 and
-       Matthew Reed mouse drivers. (It does not implement the interface of=
 the
-       older Scott McBurney mouse driver, which may be required by  some  =
pro-
-       grams.)
-
-       By  default  XTRSMOUS  installs  itself  in  high  memory. This is =
done
-       because MDRAW-II tests for the presence of a mouse by  looking  to =
 see
-       whether  the  mouse  SVC  is  vectored to high memory. If the drive=
r is
-       installed in low memory, MDRAW thinks it is not there at  all.  If =
 you
-       use  mouse-aware  programs that don't have this bug, or if you edit=
 the
+   Mouse
+       A few Model 4 programs could use a mouse, such as the shareware  hi=
-res
+       drawing program MDRAW-II.  The program XTRSMOUS/CMD on the utility =
disk
+       (utility.dsk) is a mouse driver for Model 4/4P mode  that  should  =
work
+       with  most such programs.  xtrs does not emulate the actual mouse h=
ard-
+       ware (a serial mouse plugged into the Model  4  RS-232  port),  so =
 the
+       original  mouse  drivers  will  not work under xtrs.  Instead, XTRS=
MOUS
+       accesses the X mouse pointer using an emulator trap.   XTRSMOUS  im=
ple-
+       ments  the  same  TRSDOS/LS-DOS  6 SVC interface as the David Goben=
 and
+       Matthew Reed mouse drivers.  (It does not implement  the  interface=
  of
+       the  older  Scott  McBurney mouse driver, which may be required by =
some
+       programs.)
+
+       By default XTRSMOUS installs itself  in  high  memory.   This  is  =
done
+       because  MDRAW-II  tests  for the presence of a mouse by looking to=
 see
+       whether the mouse SVC is vectored to high memory.   If  the  driver=
  is
+       installed  in  low memory, MDRAW thinks it is not there at all.  If=
 you
+       use mouse-aware programs that don't have this bug, or if you  edit =
 the
        first line of MDRAW to remove the test, you can install XTRSMOUS in=
 low
-       memory using the syntax "XTRSMOUS (LOW)".
+       memory under TRSDOS/LS-DOS 6 using the syntax XTRSMOUS (LOW).
=20
-Time of day clock
-       Several  battery-backed  time  of  day clocks were sold for the var=
ious
-       TRS-80 models, including the  TimeDate80,  TChron1,  TRSWatch,  and=
  T-
+   Time-of-day clock
+       Several battery-backed time of day clocks were  sold  for  the  var=
ious
+       TRS-80  models,  including  the  TimeDate80,  TChron1, TRSWatch, an=
d T-
        Timer.  They are essentially all the same hardware, but reside at a=
 few
-       different port ranges.  xtrs currently emulates  them  at  port  ra=
nges
+       different  port  ranges.   xtrs  currently emulates them at port ra=
nges
        0x70-0x7C and 0xB0-0xBC.  The T-Timer port range at 0xC0-0xCC confl=
icts
        with the Radio Shack hard drive controller and is not emulated.
=20
-       These clocks return only a 2-digit year, and it is unknown  what  t=
heir
-       driver software will do in the year 2000 and beyond.  If you have s=
oft-
-       ware that works with one of them, please send email to report what =
hap-
-       pens when it is used with xtrs.
-
-       Also  see SETTIME/CMD in the "Data import and export" section above=
 for
-       another way to get the correct time into a Z-80 operating  system  =
run-
-       ning under xtrs.
-
-       Finally,  you  might notice that LDOS/LS-DOS always magically knows=
 the
-       correct date when you boot it (but not the time).  When you first p=
ower
-       up  the  emulated TRS-80, xtrs dumps the date into the places in me=
mory
-       where LDOS and LS-DOS normally save it across reboots, so it  looks=
  to
-       the operating system as if you rebooted after setting the date.
-
-Joystick
-       Pressing  a key on a PC numeric keypad with NumLock disengaged emul=
ates
-       the Alpha Products joystick.  See the Keys section above  for  deta=
ils.
-       The emulated joystick is mapped only at port 0, to avoid conflicts =
with
-       other devices.  The joystick emulation could be made to work with  =
real
-       joysticks using the X input extension, but this is not implemented =
yet.
-
-Running games
-       Some games run rather well under xtrs now, provided that  your  mac=
hine
-       is  fast  enough  to run the emulation in real time and that you ch=
oose
-       the right command line options.  "Galaxy Invaders Plus" by Big 5  S=
oft-
-       ware is particularly good.  You will usually want to turn on autode=
lay,
-       and if your machine is slow you may need to  reduce  the  sound  sa=
mple
-       rate.   Running your X server in 8-bit/pixel mode also seems to hel=
p in
-       some cases. Example command lines:
-
-           startx -- -bpp 8
-           xtrs -autodelay
+       These  clocks return only a 2-digit year, and it is not well-docume=
nted
+       what their driver software does since the year 2000.  If you have s=
oft-
+       ware  that  works  with one of them, please contact the author <htt=
p://
+       www.tim-mann.org/> to report what happens when it is used with xtrs.
+
+       Also see SETTIME/CMD in Data import and export, above, for another =
 way
+       to get the correct time into a Z80 operating system running under x=
trs.
+
+       Note  that  Model I TRSDOS and VTOS 4.0 have a "year 1988" problem,=
 and
+       LDOS/LS-DOS has a "year 2012" problem; see LDOS and  LS-DOS:  2012 =
 and
+       Beyond  --  Technical  information  <http://www.trs-80.org/ldos-and=
-ls-
+       dos-2012-and-beyond-technical-information/> by Matthew Reed.
+
+   Joystick
+       Pressing a key on a PC-keyboard-style numeric keypad with NumLock  =
dis-
+       engaged  emulates  the  Alpha  Products joystick.  See Keys, above,=
 for
+       details.  The emulated joystick is mapped only at port 0, to avoid =
con-
+       flicts with other devices.
+
+   Running games
+       Some  games  run  rather  well under xtrs provided that your machin=
e is
+       fast enough to run the emulation in real time and that you  choose =
 the
+       right  command-line options.  Galaxy Invaders Plus by Big 5 Softwar=
e is
+       particularly good.  You will usually want to turn on autodelay, and=
  if
+       your  machine  is  slow  you  may need to reduce the sound sample r=
ate.
+       Running your X server in 8-bit/pixel mode also seems to  help  in  =
some
+       cases.  Example command lines:
+              $ startx -- -bpp 8
+              $ xtrs -autodelay
=20
        If you have a slow machine and the sound breaks up, it is possible =
that
        your machine is not fast enough to generate samples at the default =
rate
-       of 44,100 Hz.  If you think this may  be  happening,  try  "-sample=
rate
-       11025" or even "-samplerate 8000".
+       of  44,100  Hz.   If  you  think this may be happening, try -sample=
rate
+       11025 or even -samplerate 8000.
=20
 Options
        Defaults for all options can be specified using the standard X reso=
urce
-       mechanism, and the class name for xtrs is "Xtrs".
-
-       -display display
-              Set your X display to display. The default is to use the DIS=
PLAY
-              environment variable.
+       mechanism;  see  the  Resource  Manager  Functions chapter of Xlib =
-- C
+       Language  X  Interface  <ftp://www.x.org/pub/current/doc/libX11/lib=
X11/
+       libX11.html#Resource Manager Functions> by Jim Gettys, Robert W. Sc=
hei-
+       fler, et al.  The class name for xtrs is Xtrs.
+
+       -display x-display
+              Set your X display to x-display.  The default is to use the =
DIS-
+              PLAY environment variable.
=20
        -iconic
               Start with the xtrs window iconified.
=20
        -background color
        -bg color
-              Specifies the background color of the xtrs window.
+              Set the background color of the xtrs window to color.
=20
        -foreground color
        -fg color
-              Specifies the foreground color of the xtrs window.
+              Set the foreground color of the xtrs window to color.
=20
-       -title titletext
-              Use  titletext  in  the  window title bar instead of the pro=
gram
+       -title title-text
+              Use  title-text  in  the window title bar instead of the pro=
gram
               name.
=20
        -borderwidth width
@@ -731,7 +791,7 @@
               Multiply  the  horizontal  and  vertical window size by xfac=
 and
               yfac, respectively.  Possible values are integers in  the  r=
ange
               [1,4]  for  xfac  and  [1,8]  for yfac.  Defaults are xfac=
=3D1 and
-              yfac=3D2*xfac.
+              yfac=3D2xxfac.  Ignored if -usefont is given.
=20
        -resize
               In Model III or 4/4P mode, resize the X window whenever the =
emu-
@@ -748,58 +808,60 @@
               since otherwise there is an annoying size  switch  during  e=
very
               reboot.
=20
-       -charset name
-              Select among several sets of built-in character bitmaps.
-
-              In Model I mode, five sets are available. The default, wider=
, is
-              a modified Model III set with characters 8 pixels wide; it l=
ooks
-              better  on  a modern computer screen with square pixels than=
 the
-              real Model I fonts, which were 6 pixels wide. lcmod is the c=
har-
-              acter  set  in the replacement character generator that was =
sup-
-              plied with the Radio Shack lower  case  modification.   (It =
 was
+       -charset charset-name
+              Select  among several sets of built-in character bitmaps.  V=
alid
+              values of charset-name depend on the  TRS-80  model  being  =
emu-
+              lated.
+
+              In  Model  I mode, five sets are available.  The default, wi=
der,
+              is a modified Model III set with characters 8  pixels  wide;=
  it
+              looks better on a modern computer screen with square pixels =
than
+              the real Model I fonts, which were 6 pixels wide.  lcmod is =
 the
+              character  set  in  the replacement character generator that=
 was
+              supplied with the Radio Shack lowercase modification.   (It =
 was
               reconstructed  partly  from  memory  and may have some minor=
 bit
               errors.)  stock is the character set in the stock character =
gen-
-              erator  supplied  with most upper case only machines. Since =
xtrs
+              erator  supplied  with most uppercase-only machines.  Since =
xtrs
               currently always emulates the extra bit of display memory ne=
eded
-              to  support lower case, this character set gives you the aut=
hen-
+              to  support  lowercase, this character set gives you the aut=
hen-
               tic, unpleasant effect that real Model I  users  saw  when  =
they
-              tried  to do homebrew lower case modifications without repla=
cing
-              the character generator: lower case letters appear at an  in=
con-
+              tried  to  do homebrew lowercase modifications without repla=
cing
+              the character generator: lowercase letters appear at  an  in=
con-
               sistent height, and if you are using the Level II BASIC ROM =
dis-
-              play driver, upper case letters are replaced by meaningless =
sym-
+              play driver, uppercase letters are replaced by meaningless  =
sym-
               bols.   early  is the same as stock, but with the standard A=
SCII
-              characters [, \, ], and ^ in the positions where most Model =
 I's
-              had directional arrows.  This was the default programming in=
 the
-              Motorola character generator ROM that Radio Shack  used,  an=
d  a
-              few   early  machines  were  actually  shipped  with  this  =
ROM.
-              Finally, german or genie gives an approximate emulation  of =
 the
-              GENIE,  a  German  Model I clone.  Characters are 8 pixels w=
ide,
-              and double width is supported even though later GENIE models=
 did
-              not include it.
+              characters [, \, ], and ^ in the positions where  most  Mode=
l  I
+              machines  had directional arrows.  This was the default prog=
ram-
+              ming in the Motorola character generator ROM  that  Radio  S=
hack
+              used,  and  a few early machines were actually shipped with =
this
+              ROM.  Finally, german or genie gives an approximate emulatio=
n of
+              the  GENIE,  a  German  Model  I clone.  Characters are 8 pi=
xels
+              wide, and double width is supported even though later GENIE =
mod-
+              els did not include it.
=20
               In  Model  III,  4,  and  4P  modes,  three  sets are availa=
ble:
               katakana (the default for Model III) is the original  Model =
 III
               set with Japanese Katakana characters in the alternate chara=
cter
-              positions. This set was also used in early Model 4's.   inte=
rna-
-              tional  (the  default for Model 4 and 4P) is a later Model 4=
 set
-              with accented Roman letters in the alternate positions.  bol=
d is
-              a  bold  set  from  a character generator ROM found in one M=
odel
-              III, origin uncertain.
+              positions.  This set was also used in early  Model  4  machi=
nes.
+              international  (the default for Model 4 and 4P) is a later M=
odel
+              4 set with accented Roman letters in  the  alternate  positi=
ons.
+              bold  is  a boldface set from a character generator ROM foun=
d in
+              one Model III--origin uncertain.
=20
        -usefont
               Use X fonts instead of the built-in character bitmaps.
=20
        -nofont
-              Use the built-in character bitmaps, not a X font.  This  is =
 the
+              Use the built-in character bitmaps, not an X font.  This is =
 the
               default.
=20
-       -font fontname
-              If  -usefont  is also given, use the specified X font for no=
rmal
+       -font font-name
+              If  -usefont is also given, use the X font font-name for nor=
mal-
               width characters.  The default uses a common X fixed-width f=
ont:
               "-misc-fixed-medium-r-normal--20-200-75-75-*-100-iso8859-1".
=20
-       -widefont fontname
-              If  -usefont  is also given, use the specified X font for do=
uble
+       -widefont font-name
+              If  -usefont is also given, use the X font font-name for dou=
ble-
               width characters.  The default uses a common X fixed-width f=
ont,
               scaled     to     double    width:    "-misc-fixed-medium-r-=
nor-
               mal--20-200-75-75-*-200-iso8859-1".
@@ -807,104 +869,115 @@
        -nomicrolabs
               In Model I mode, emulate the HRG1B 384x192 hi-res graphics c=
ard.
               In  Model  III  mode or Model 4/4P mode, emulate the Radio S=
hack
-              hi-res card.  This is now the default.
+              hi-res card.  This is the default.
=20
        -microlabs
               In Model III or 4/4P mode, emulate the Micro Labs  Grafyx  S=
olu-
               tion  hi-res  graphics  card.  Note that the Model III and M=
odel
-              4/4P cards from Micro Labs are very different from one  anot=
her.
+              4/4P cards from Micro Labs are very different from one anoth=
er.
=20
-       -debug Enter zbx, the z80 debugger.
+       -debug Enter zbx, the Z80 debugger.
=20
        -romfile filename
        -romfile3 filename3
        -romfile4p filename4p
-              Use  the romfile specified by filename in Model I mode, the =
rom-
-              file specified by filename3 in Model III and Model  4  mode,=
  or
-              the  romfile specified by filename4p in Model 4P mode, A rom=
file
-              can be either a raw binary dump, Intel hex format, or TRS-80=
 cmd
-              format (for example, a MODELA/III file).  If you do not set =
this
-              option or the corresponding X resource, a default establishe=
d at
-              compile  time  is used (if any); see Makefile.local for inst=
ruc-
-              tions on compiling in default romfiles or default romfile na=
mes.
+              Use the ROM image file specified by filename in Model I mode=
, by
+              filename3  in  Model  III  and Model 4 mode, or by filename4=
p in
+              Model 4P mode.  A ROM image file can be either a raw binary =
dump
+              in  Intel  hex format, or TRS-80 CMD format (for example, a =
MOD-
+              ELA/III file).  If you do not set this option or the corresp=
ond-
+              ing  X  resource,  a default established at compile time is =
used
+              (if any); see Makefile.local in the xtrs source distribution=
 for
+              instructions  on compiling in default ROM image files or def=
ault
+              ROM image filenames.
=20
        -model m
-              Specifies  which TRS-80 model to emulate.  Values accepted a=
re 1
-              or I (Model I), 3 or III (Model III), 4 or IV (Model 4), and=
  4P
-              or IVP (Model 4P).  Model I is the default.
+              Emulate a TRS-80 Model m.  Values accepted are 1 or I (Model=
 I),
+              3  or  III  (Model III), 4 or IV (Model 4), and 4P or IVP (M=
odel
+              4P).  Model I is the default.
=20
        -delay d
-              A  crude speed control.  After each Z-80 instruction, xtrs b=
usy-
-              waits for d iterations around an empty loop.  A really  smar=
t  C
-              optimizer might delete this loop entirely, so it's possible =
that
-              this option won't work if you compile  xtrs  with  too  high=
  an
-              optimization level.  The default delay is 0.
+              Tune the emulator's  (crude)  speed  control.   After  each =
 Z80
+              instruction,  xtrs  busy-waits  for d iterations around an e=
mpty
+              loop.  A  really  smart  C  optimizer  might  delete  this  =
loop
+              entirely,  so  it's possible that this option won't work if =
xtrs
+              is compiled with too high an optimization  level.   The  def=
ault
+              delay is 0.
=20
        -autodelay
-              Dynamically  adjusts  the value of -delay to run instruction=
s at
-              roughly the same rate as a real machine.  The tracking  is  =
only
-              approximate, but it can be useful for running games.
+              Dynamically  adjust  the value of the speed control describe=
d in
+              -delay above to run instructions at roughly the same rate  a=
s  a
+              real  machine.   The tracking is only approximate, but it ca=
n be
+              useful for running games.
=20
        -noautodelay
-              Turn off -autodelay. This is the default.
+              Turn off -autodelay.  This is the default.
=20
        -keystretch cycles
-              Fine-tune  the  keyboard  behavior.   To prevent keystrokes =
=66rom
-              being lost, xtrs "stretches" the intervals between  key  tra=
nsi-
-              tions,  so that the Z-80 program has time to see each transi=
tion
-              before the next one occurs.  Whenever the Z-80 program reads=
 the
-              keyboard  matrix  and  sees  an emulated key go up or down, =
xtrs
-              waits cycles Z-80 clock cycles (T-states) before it  allows =
 the
+              Fine-tune the keyboard behavior.   To  prevent  keystrokes  =
=66rom
+              being  lost,  xtrs "stretches" the intervals between key tra=
nsi-
+              tions, so that the Z80 program has time to see  each  transi=
tion
+              before  the next one occurs.  Whenever the Z80 program reads=
 the
+              keyboard matrix and sees an emulated key go  up  or  down,  =
xtrs
+              waits  cycles  Z80  clock cycles (T-states) before it allows=
 the
               program to see another key transition.  Key transitions that=
 are
-              received during the waiting period or when the Z-80  program=
  is
-              not  reading  the  keyboard  are  held  in a queue.  The def=
ault
+              received  during  the  waiting period or when the Z80 progra=
m is
+              not reading the keyboard are  held  in  a  queue.   The  def=
ault
               stretch value is 4000 cycles; it should seldom if ever be ne=
ces-
               sary to change it.
=20
        -shiftbracket
-              Emulate [, \, ], ^, and   as shifted keys, and {, |, }, and =
~ as
-              unshifted.  This is the default in Model 4 and 4P modes, and=
  it
-              works  well with the keyboard driver in Model 4 TRSDOS/LS-DO=
S 6.
+              Emulate [, \, ], ^ and   as shifted keys, and {, |, }, and ~=
  as
+              unshifted.   This is the default in Model 4 and 4P modes, an=
d it
+              works well with the keyboard driver in Model 4 TRSDOS/LS-DOS=
 6.
=20
        -noshiftbracket
-              Emulate [, \, ], ^, and   as unshifted keys, and {, |, }, an=
d  ~
+              Emulate [, \, ], ^ and   as unshifted keys, and {, |, },  an=
d  ~
               as  shifted.   This is the default in Model I and III modes,=
 and
               it works well with many TRS-80 keyboard drivers.  With some =
key-
               board drivers these keys do not work at all, however.
=20
        -diskdir dir
-              Specify  the  directory  containing floppy and hard disk ima=
ges.
+              Set the search directory for floppy and hard disk images to =
dir.
               If the value starts with "~/" (or is just "~"), it  is  rela=
tive
-              to your home directory.  The default value is ".".
+              to  your  home  directory (as determined by the HOME environ=
ment
+              variable).  The default value is ".".
=20
-       -doubler type
-              Specify  what type of double density adaptor to emulate (Mod=
el I
-              mode only).  The type may  be  percom,  radioshack  (or  tan=
dy),
-              both,  or  none.  The  type may be abbreviated to one charac=
ter.
-              The default is both, which causes  the  double  density  ada=
ptor
-              emulation  to respond to the special commands of both the Pe=
rcom
-              and Radio Shack cards.
+       -doubler doubler-type
+              (Model I mode only) Set the double-density adaptor to emulat=
e to
+              doubler-type.   The  parameter  may  be  percom,  radioshack=
 (or
+              tandy), both, or none.  doubler-type may be abbreviated  to =
 one
+              character.  The default is both, which causes the double den=
sity
+              adaptor emulation to respond to the special commands of both=
 the
+              Percom and Radio Shack cards.
=20
        -doublestep
-              Make all real floppy  drives  double-step,  allowing  access=
  to
-              35-track  or  40-track  media in an 80-track drive.  Linux o=
nly.
-              See the Floppy Disks section for limitations.
+              (Linux  only)  Make all real floppy drives double-step, allo=
wing
+              access to 35-track or 40-track media in an 80-track drive.  =
 See
+              Bugs and limitations, below.
=20
        -nodoublestep
-              Turn off double-step mode for all  real  floppy  drives.   L=
inux
-              only.  This is the default.
+              (Linux  only)  Turn  off  double-step  mode  for all real fl=
oppy
+              drives.  This is the default.
=20
-       -stepmap s0,s1,s2,s3,s4,s5,s6,s7
-              Selectively  set  double-step  mode  for  individual real fl=
oppy
-              drives.  If sU is 2 and diskM-U is a real drive, the drive  =
will
-              be  double-stepped;  if sU is 1, it will be single-stepped. =
 You
-              can omit values from the end of the list; those drives will =
 get
-              the default value set by -doublestep or -nodoublestep.
-
-       -sizemap z0,z1,z2,z3,z4,z5,z6,z7
-              Selectively set whether drives are emulated as 5-inch or 8-i=
nch;
-              see the section "Emulated 8-inch floppy disks" above.  If zU=
  is
-              5,  the  drive  will appear to Z-80 software as 5-inch; if 8=
, as
+       -stepmap s0[,s1[,s2[,s3[,s4[,s5[,s6[,s7]]]]]]]
+              (Linux only) Selectively set  double-step  mode  for  indivi=
dual
+              real  floppy drives.  Each comma-delimited parameter corresp=
onds
+              to a drive unit number; see Real floppy disks, above.  If sU=
  is
+              1  and  diskM-U is a (symbolic link to) a real drive, where =
M is
+              the TRS-80 model (1, 3, 4, or 4p) and U is the drive unit nu=
mber
+              (a digit in the range 0-7), the drive will be single-stepped=
; if
+              sU is 2, it will be double-stepped.  You can  omit  values  =
=66rom
+              the end of the list; those drives will get the default value=
 set
+              by -doublestep or -nodoublestep.
+
+              Example:  -model  1  -stepmap  2,1,2  double-steps  disk1-0 =
 and
+              disk1-2, and single-steps disk1-1.
+
+       -sizemap z0[,z1[,z2[,z3[,z4[,z5[,z6[,z7]]]]]]]
+              Selectively  set  whether  drives  are  emulated as 5.25-inc=
h or
+              8-inch; see Emulated 8-inch floppy disks, above.  If  zU  is=
  5,
+              the  drive  will  appear  to Z80 software as 5.25-inch; if 8=
, as
               8-inch.  The default setting (as reflected in the  documenta=
tion
               above)  is 5,5,5,5,8,8,8,8.  You can omit values from the en=
d of
               the list; those drives will get the default values.  Setting=
 one
@@ -912,65 +985,93 @@
               CP/M software that supports 8-inch drives.   You  can  also =
 use
               XTRS8/DCT  with  8-inch drives in the first four positions; =
even
               though the prompt suggests the unit number must be 4-7,  num=
bers
-              0-3  are  accepted. XTRS8 does not check whether the unit yo=
u've
+              0-3  are accepted.  XTRS8 does not check whether the unit yo=
u've
               selected is really being emulated as an 8-inch  drive,  howe=
ver;
               you'll simply get errors during FORMAT if you get this wrong.
=20
        -truedam
               Turn  off the single density data address mark remapping klu=
dges
-              described in the "Emulated floppy disks" and "Real floppy di=
sks"
-              sections above.  With this option given, the distinction bet=
ween
-              F8 and FA data address marks is strictly observed on both  w=
rit-
-              ing  and reading.  This option is probably not useful unless=
 you
-              need to deal with Model I disks that use the distinction as =
part
-              of  a copy-protection scheme.  See also "Common File Formats=
 for
-              Emulated TRS-80  Floppy  Disks",  available  at  http://www.=
tim-
-              mann.org/trs80/dskspec.html.
+              described in Emulated floppy disks and Real floppy disks, ab=
ove.
+              With  this  option  given, the distinction between 0xF8 and =
0xFA
+              data address marks is strictly  observed  on  both  writing =
 and
+              reading.   This option is probably not useful unless you nee=
d to
+              deal with Model I disks that use the distinction as  part  o=
f  a
+              copy-protection  scheme.   See  also  Common  File  Formats =
 for
+              Emulated  TRS-80  Floppy  Disks  <http://www.tim-mann.org/tr=
s80/
+              dskspec.html>.
=20
        -notruedam
               The opposite of -truedam.  This setting is the default.
=20
        -samplerate rate
-              Set  the sample rate for new cassette wav files, direct cass=
ette
+              Set the sample rate for new cassette WAVE files, direct cass=
ette
               I/O to the sound card, and game sound output to the sound  c=
ard.
-              Existing wav files will be read or modified using their orig=
inal
-              sample rate regardless of this flag.  The default is 44,100 =
 Hz.
-              See also the cassette(1) man page.
-
-       -serial ttyname
-              Set  the  tty  device  to be used for I/O to the TRS-80's se=
rial
-              port.  The default is /dev/ttyS0 on Linux, /dev/tty00  on  o=
ther
-              versions  of  Unix.   Setting  the name to be empty (-serial=
 "")
-              emulates having no serial port.
+              Existing  WAVE files will be read or modified using their or=
igi-
+              nal sample rate regardless of this flag.  The default is  44=
,100
+              Hz.  See also cassette(1).
+
+       -serial terminal-name
+              Set  the  terminal  device  to  be  used for I/O to the TRS-=
80's
+              serial port to terminal-name.   The  default  is  /dev/ttyS0=
  on
+              Linux,  and  /dev/tty00  on other versions of Unix.  Setting=
 the
+              name to be empty (-serial "") emulates having no serial port.
=20
        -switches value
               Set the sense switches on the Model I serial  port  card.   =
This
               option  is  meaningful  only  in Model I mode, and only when=
 the
-              -serial option is not set to "".  The  default  value  is  0=
x6f,
+              -serial option is not set to "".  The  default  value  is  0=
x6F,
               which  Radio  Shack  software  conventionally interprets as =
9600
               bps, 8 bits/word, no parity, 1 stop bit.
=20
        -emtsafe
-              Disable emulator traps (see "Data import and export") that c=
ould
-              write  to  host  files  other  than  disk images in the orig=
inal
-              diskdir.
+              Disable emulator traps (see Data import and export, above)  =
that
+              could write to host files other than disk images in the orig=
inal
+              emulated disk directory, or otherwise  affect  the  host  sy=
stem
+              (e.g., Unix shell commands).
=20
        -noemtsafe
               The opposite of -emtsafe.  This setting is the default.
=20
-Additional resources
-       There are many other TRS-80 resources available on the  Web,  inclu=
ding
-       shareware and freeware emulators that run under MSDOS and other ope=
rat-
-       ing systems, software for converting TRS-80 physical media to the  =
emu-
-       lator's  disk  file  format,  ROM  images, and TRS-80 software that=
 has
-       already   been   converted.    For   pointers,   see    http://www.=
tim-
-       mann.org/trs80.html.
+Exit status
+       xtrs primarily uses diagnostic messages to indicate trouble.
+
+       0      Successful operation; normal or expected exit.
+
+       1      Fatal error; includes usage errors such as unrecognized comm=
and-
+              line arguments.
+
+       -1, 255
+              Unable to open X display.
+
+Environment
+       xtrs reads a couple of environment variables.
+
+       DISPLAY
+              is read indirectly via  XOpenDisplay(3),  and  specifies  th=
e  X
+              server to which xtrs (an X client) should connect.
+
+       HOME   is used at startup to (1) locate .Xdefaults and Xtrs files s=
pec-
+              ifying defaults for command-line options  and  (2)  resolve =
 the
+              argument to the -diskdir option; and sometimes when the emul=
ator
+              trap to change xtrs's current working  directory  is  activa=
ted;
+              see Data import and export, above.
+
+Files
+       xtrs may access files as described under HOME in Environment, above=
, as
+       well as floppy drive, digital signal processor  (sound),  and  term=
inal
+       device files; see Real floppy disks and Sound, above, and -serial u=
nder
+       Options, above.
+
+       If the -emtsafe flag is not in effect, then through the use of emul=
ator
+       traps (see Data import and export, above) arbitrary files on the sy=
stem
+       may be read, written, or deleted from  within  the  emulator  with =
 the
+       privileges of the user invoking xtrs.
=20
 Bugs and limitations
        The  emulated  serial  port's  modem status and control signals are=
 not
        tied to the signals on the real serial port, because the  real  sig=
nals
-       are  not  available  to software through the Unix tty device interf=
ace.
-       The ability to check  for  parity,  framing,  and  overrun  errors =
 and
+       are  not  available to software through the Unix terminal device in=
ter-
+       face.  The ability to check for parity, framing, and overrun errors=
 and
        receive  an  interrupt  when one occurs is not emulated.  Unix does=
 not
        support 2000, 3600, or 7200  baud,  so  these  TRS-80  data  rates =
 are
        remapped to 38400, 57600, and 115200 baud respectively.
@@ -978,51 +1079,59 @@
        A  better  signal  processing  algorithm might help read real casse=
ttes
        more reliably, especially at 1500bps.
=20
-       Some features of the floppy disk controller are not currently emula=
ted:
-       Force  Interrupt  with condition bits 0x01, 0x02, or 0x04 is not im=
ple-
-       mented. Read Track is implemented only for DMK emulated  floppies. =
 The
-       multiple-sector  flags in Read and Write are not implemented.  The =
tim-
-       ing of returned sectors is emulated only for the Read Address  comm=
and,
-       and  not  very  accurately for JV1 or JV3.  If a disk has more than=
 one
-       sector with the same number on a track, xtrs will always see the  f=
irst
-       (counting  from the index hole) when reading or writing; a real mac=
hine
-       would see the next one to come under the head depending on the  cur=
rent
-       rotational position of the disk.  Partially reformatting a track (w=
hich
-       TRS-80 programs like HyperZap and Model I Super Utility do  to  ach=
ieve
-       mixed  density)  is  supported  for DMK but not JV3; however, switc=
hing
-       densities while formatting (which Model III and  4  Super  Utility =
 do)
-       works on both DMK and JV3.
+       Some features of the floppy disk controller are not currently emula=
ted.
+
+       +      Force Interrupt with condition bits 0x01, 0x02, or 0x04  is =
 not
+              implemented.
+
+       +      Read Track is implemented only for DMK emulated floppies.
+
+       +      The multiple-sector flags in Read and Write are not implemen=
ted.
+
+       +      The  timing  of  returned  sectors is emulated only for the =
Read
+              Address command, and not very accurately for JV1 or JV3.
+
+       +      If a disk has more than one sector with the  same  number  o=
n  a
+              track,  xtrs  will always see the first (counting from the i=
ndex
+              hole) when reading or writing; a real machine would see the =
next
+              one  to  come under the head depending on the current rotati=
onal
+              position of the disk.  Partially  reformatting  a  track  (w=
hich
+              TRS-80  programs  like  HyperZap and Model I Super Utility d=
o to
+              achieve mixed density) is supported for DMK but  not  JV3;  =
how-
+              ever,  switching densities while formatting (which Model III=
 and
+              4 Super Utility do) works on both DMK and JV3.
=20
        Real physical floppy disks are supported only under Linux, because =
Unix
        does not define a portable interface to the low-level floppy contro=
ller
-       functionality  that  xtrs needs.  There are some limitations even u=
nder
-       Linux: Index holes are faked, not detected on the real  disk,  and =
 the
-       timing  of returned sectors is not emulated at all.  Due to the lim=
ita-
-       tions of PC-style floppy disk controllers, when formatting  a  phys=
ical
-       floppy  under  xtrs,  you  cannot mix sectors of different sizes on=
 the
+       functionality that xtrs needs.  There are some limitations  even  u=
nder
+       Linux:  index  holes  are faked, not detected on the real disk, and=
 the
+       timing of returned sectors is not emulated at all.  Due to the  lim=
ita-
+       tions  of  ISA-bus  floppy disk controllers, when formatting a phys=
ical
+       floppy under xtrs, you cannot mix sectors of  different  sizes  on =
 the
        same track, switch densities in the middle of a track, or reformat =
only
        part of a track.  However, xtrs can read and write to physical flop=
pies
-       that have already been formatted in  these  ways  (perhaps  by  a  =
real
+       that  have  already  been  formatted  in  these ways (perhaps by a =
real
        TRS-80).
=20
        The extended JV3 limit of 5802 sectors is somewhat arbitrary.  It c=
ould
-       be raised by generalizing the code to permit more than  two  blocks=
  of
-       2901,  but  this  does  not  seem  too useful.  5802 sectors is alr=
eady
-       enough for a 3.5-inch HD (1.44MB) floppy, which the TRS-80 didn't  =
sup-
-       port  anyway.  If you need more space, use emulated hard drives ins=
tead
+       be  raised  by  generalizing the code to permit more than two block=
s of
+       2901, but this does not seem  too  useful.   5802  sectors  is  alr=
eady
+       enough  for a 3.5-inch HD (1.44MB) floppy, which the TRS-80 didn't =
sup-
+       port anyway.  If you need more space, use emulated hard drives  ins=
tead
        of emulated floppies with huge numbers of tracks.
=20
-       XTRSHARD/DCT ignores the internal write-protected flag  in  hard  d=
rive
+       XTRSHARD/DCT  ignores  the  internal write-protected flag in hard d=
rive
        images, but a hard drive image can still be effectively write prote=
cted
        by turning off its Unix write permission bits.
=20
-       The emulator uses a heuristic to decide what format a ROM file  is =
 in.
-       If  a  raw  binary ROM image starts with 0x01, 0x05, or 0x22, it ca=
n be
-       misidentified as being in a different format.  This is rather  unli=
kely
-       to occur, as ROMs typically begin with 0xF3, the DI instruction.
+       The emulator uses a heuristic to decide what format a ROM image fil=
e is
+       in.  If a raw binary ROM image starts with 0x01, 0x05, or 0x22, it =
 can
+       be  misidentified  as  being  in  a  different  format.  This is ra=
ther
+       unlikely to occur, as ROMs typically begin with 0xF3, the  DI  inst=
ruc-
+       tion.
=20
        The  joystick emulation could be made to work with real joysticks u=
sing
-       the X input extension, but this is not implemented yet.
+       the X Input extension, but this is not implemented yet.
=20
        If you discover other bugs, write fixes for any of these, or  make =
 any
        other  enhancements,  please let us know so that we can incorporate=
 the
@@ -1030,29 +1139,38 @@
=20
 Authors and acknowledgements
        xtrs 1.0 was written by David Gingold and  Alec  Wolman.   The  cur=
rent
-       version  was revised and much extended by Timothy Mann (see http://=
tim-
-       mann.org/).  See README and README.tpm for additional  notes  from =
 the
-       authors.
+       version  was  revised  and  much extended by Timothy Mann (see <htt=
p://
+       www.tim-mann.org/>).  See README in the xtrs  source  distribution =
 for
+       additional  notes  from the authors; a (compressed) copy may be loc=
ally
+       available with your xtrs installation at /usr/share/doc/xtrs/README=
=2Egz.
=20
-       We  also  thank  the  following people for their help.  The JV1 and=
 JV3
+       We also thank the following people for their help.   The  JV1  and =
 JV3
        floppy disk file formats were designed by Jeff Vavasour, originally=
 for
-       his MSDOS-based TRS-80 emulators.  The DMK format was designed by D=
avid
-       Keil for his MSDOS-based TRS-80 emulator.  The hard  disk  file  fo=
rmat
-       was  designed by Matthew Reed for his MSDOS-based TRS-80 emulators.=
  Al
-       Petrofsky and Todd P. Cromwell III supplied font data.  Roland  Ger=
lach
-       contributed  the CP/M import and export programs as well as several=
 bug
-       reports and fixes for the emulator itself.  Ulrich  Mueller  added =
 the
-       -borderwidth  option,  improved  the  -scale option and the bitmap =
font
-       scaling, ported the import, export, and settime utilities to Newdos=
/80,
-       and  contributed  the  HRG1B  emulation.  Branden Robinson supplied=
 the
-       first version of the cassette man page, fixed Makefile bugs, transl=
ated
-       cassette to the Bourne shell, and implemented watchpoints in zbx.  =
Mark
-       McDougall provided documentation for the  Micro  Labs  Grafyx  Solu=
tion
-       card.   Jenz  Guenther  added the -title option and contributed cod=
e to
-       emulate the GENIE (German Model I  clone).   Joe  Peterson  contrib=
uted
-       code to emulate the TimeDate80 and the -emtsafe feature.  Denis Lec=
onte
-       contributed part of the -scale implementation.
-
-       $Id: xtrs.man,v 1.69 2009/06/15 23:44:43 mann Exp $
+       his MS-DOS-based TRS-80 emulators.  The  DMK  format  was  designed=
  by
+       David  Keil  for  his MS-DOS-based TRS-80 emulator.  The hard disk =
file
+       format was designed by Matthew Reed for his MS-DOS-based TRS-80  em=
ula-
+       tors.   Al  Petrofsky  and  Todd  P.  Cromwell  III supplied font d=
ata.
+       Roland Gerlach contributed the CP/M import and export programs as  =
well
+       as  several  bug  reports  and  fixes  for the emulator itself.  Ul=
rich
+       Mueller added the -borderwidth option, improved the -scale  option =
 and
+       the  bitmap font scaling, ported the IMPORT, EXPORT, and SETTIME ut=
ili-
+       ties to NEWDOS/80, and contributed the HRG1B emulation.  Branden Ro=
bin-
+       son supplied the first version of the cassette man page, fixed Make=
file
+       bugs, translated cassette to the Bourne shell, and  implemented  wa=
tch-
+       points  in  zbx.   Mark  McDougall provided documentation for the M=
icro
+       Labs Grafyx Solution card.  Jenz Guenther added the -title  option =
 and
+       contributed  code  to  emulate  the  GENIE (German Model I clone). =
 Joe
+       Peterson contributed code to emulate the TimeDate80  and  the  -emt=
safe
+       feature.  Denis Leconte contributed part of the -scale implementati=
on.
+
+See also
+       cmddump(1), hex2cmd(1), cassette(1), mkdisk(1)
+
+       There  are  many other TRS-80 resources available on the Web, inclu=
ding
+       shareware and freeware emulators that run under MS-DOS and other  o=
per-
+       ating  systems,  software  for  converting TRS-80 physical media to=
 the
+       emulator's disk file format, ROM images, and TRS-80 software  that =
 has
+       already  been  converted.   For pointers, see <http://www.tim-mann.=
org/
+       trs80.html>.
=20
-                                                                       xtr=
s(1)
+xtrs                              2017-04-16                           xtr=
s(1)

--wyedxhrgqehxlxqt--

--azsropqrweb55gcm
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkKQcwACgkQ0Z6cfXEm
bc4gvA/9HKYZNcOMuKtluXTINeOcc70H5UjkBXFG1CUJRXTWZ+YK/6vD1JexBgQl
XWMaxoVSZ7h8Em08j4+zsNyhDjRfz5wIjlnMwLlj6KWrmNCbvW++gXlUfbQGMNkd
mga9e80rBsPQpQpM5YCVhWMMQMcAUzdq818mT0vKikQWZAGLzscEVo8lSQGASL3W
RN0T4aujV/lqVryS5lkMj5Y5m4T0rPoxfQXSF0pFv4Hbb6NITt2qQMvWtVvvXspN
o+hPmSN85y+J41Ff9zDQmNrVatuZ1hjKhWtCY2TGscCLkZ8Iz3if7T8z6duXrKj2
4ubjPA2+KL94MJ6I0KN3LapirwQqp7CXe+42rKEsPe4QbwWEOn4yh6LzjAs5OfEE
nDgh+WYNXfuzfvf/Ihr8D6BzxpIWDF3CInQ//4wKVmHeXMsEb67APR+YrBri43XK
y0qdkp02mU/HPaYpbHoVkIhPpz4GuIuCaMF2trqy8jzg+shSbrx5JJIrhyx/T862
qwG5go1O9sWUqxRXwcuvq8egzg3eRHnxkL5VD31Ltf3YMlPl/Vj/FSM+mU59j+Lm
7LFmfSP0pIX3LjHx0vQruBjW0ceSl7JbRHbfODORyZztI33UPCcPIbnTKiOiIagl
yvsJXr2wuk6JgG3y7H6Yg6BBTZhAPEf4GZctUm5y6/2qDgW6Y/k=
=py+2
-----END PGP SIGNATURE-----

--azsropqrweb55gcm--


From MAILER-DAEMON Wed May 03 17:51:16 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d62B2-0008Jm-37
	for mharc-groff@gnu.org; Wed, 03 May 2017 17:51:16 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43531)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d62B0-0008Je-Bt
	for groff@gnu.org; Wed, 03 May 2017 17:51:15 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d62Ax-0006vk-8W
	for groff@gnu.org; Wed, 03 May 2017 17:51:14 -0400
Received: from vsmx012.vodafonemail.xion.oxcs.net ([153.92.174.90]:50289)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d62Ax-0006sW-31
	for groff@gnu.org; Wed, 03 May 2017 17:51:11 -0400
Received: from vsmx004.vodafonemail.xion.oxcs.net (unknown [192.168.75.198])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTP id 9928D4001F2
	for <groff@gnu.org>; Wed,  3 May 2017 21:51:08 +0000 (UTC)
Received: from app-39.app.xion.oxcs.net (app-39.app.xion.oxcs.net [10.10.1.39])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 38FDC38004C
	for <groff@gnu.org>; Wed,  3 May 2017 21:51:05 +0000 (UTC)
Date: Wed, 3 May 2017 23:51:05 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: Groff <groff@gnu.org>
Message-ID: <83632314.282798.1493848265277@mail.vodafone.de>
In-Reply-To: <20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.90
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 21:51:15 -0000

> "G. Branden Robinson" <g.branden.robinson@gmail.com> hat am 3. Mai 2017 um 22:47 geschrieben:
> 
> So ncurses should be gating on the definition of the glyph rather than
> on whether groff is the typesetter, right?
> 
> .ie c \(lq .ds `` \(lq
> .el        .ds `` ``
> .ie c \(rq .ds '' \(rq
> .el        .ds '' ''
> 
> What do you think?

Short answer:  We should differ manpages and other typesetting.  For general typesetting a document is created for one special tool.  If not, if it is e.g. a macro package like -mom, it need to detect the tool to make use of the tools special features.  There are severe differences (not in general but regarding special features) between groff, Heirloom and neatroff.  If you e.g. intent to write a book, it may be better to choose on of these tools and then write a document using all powerful features, which consequently is not portable--but this is ok.

Manpages should use the -man or -mdoc macros itself with as few as possible low level requests or escapes.  -mdoc should not need low level *roff elements at all.  As Ingo said, there are three major tools.  Most system IMHO use groff, more and more are using mandoc(1).  If there is an ancient system with an old *roff tool, this tool should be replaced.

To answer your question:  Simply use \(lq etc. (in manpages) and assume the tool supports it.

Carsten


From MAILER-DAEMON Wed May 03 18:31:00 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d62nT-0007s8-Un
	for mharc-groff@gnu.org; Wed, 03 May 2017 18:30:59 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51747)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d62nR-0007rz-DG
	for groff@gnu.org; Wed, 03 May 2017 18:30:58 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d62nQ-0001Br-FP
	for groff@gnu.org; Wed, 03 May 2017 18:30:57 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:57088)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d62nQ-00016E-8p
	for groff@gnu.org; Wed, 03 May 2017 18:30:56 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d62nM-0001YU-2R; Thu, 04 May 2017 00:30:52 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d62nL-0000Kn-1i; Thu, 04 May 2017 00:30:51 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d62nK-0001v4-S6; Thu, 04 May 2017 00:30:50 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id c661a37e;
	Thu, 4 May 2017 00:30:50 +0200 (CEST)
Date: Thu, 4 May 2017 00:30:50 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: Carsten Kunze <carsten.kunze@arcor.de>
Cc: Groff <groff@gnu.org>
Message-ID: <20170503223050.GA57799@athene.usta.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1512443572.281651.1493840242048@mail.vodafone.de>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 22:30:58 -0000

Hi,

Carsten Kunze Heirloom wrote on Wed, May 03, 2017 at 09:37:21PM +0200:

> I assume also mandoc(1) reads \(.g as 1.

Yes:

 $ echo '\\n(.g' | mandoc | sed -n 5p   
1

 $ less /co/mdocml/roff.c
int
roff_getreg(const struct roff *r, const char *name)
{
	int val;

	if ('.' == name[0] && '\0' != name[1] && '\0' == name[2]) {
		val = roff_getregro(r, name + 1);
		if (-1 != val)
			return val;
	}
	/* ... handle read-write registers ... */
}

/*
 * Handle some predefined read-only number registers.
 * ...
 */
static int
roff_getregro(const struct roff *r, const char *name)
{
        switch (*name) {
	case 'g':  /* Groff compatibility mode is always on. */
		return 1;
	/* ... handle some other read-only registers ... */
	}
}



It's a pervasive pattern:  When writing portable software (or in
this case, portable documentation), and when trying to figure out
whether the platform we are currently trying to run on supports a
given feature we wish to use, *never* test for software or operating
system names or for version numbers.  That plainly doesn't work in
practice: If you test for names, the functionality of those programs
or systems will change over time, and if you test for version
numbers, you will run into implementations you never considered
(and hence don't know any version numbers for) but that still support
the feature, or you run into implementations that do have version
numbers, but where they mean something completely unexpected.

For software, write feature tests instead and configure your software
accordingly for compilation.

For manual pages, do not write any test code at all.  If you put
your feature tests into the manual pages themselves, they are not
only exceedingly ugly, but often a bigger portability problem than
the features you are trying to test for in the first place.  If you
keep the feature tests separate and try to automatically edit the
manual page source code accordingly before installing the manual
pages, that usually turns into a maintenance nightmare.  Manual
pages just don't need the compilation step that program code needs,
and inventing one just for autoconfiguration purposes is seriously
going over the top.

If writing man(7), stick to the lowest common denominator features
that are supported by practically everything.

If writing mdoc(7), write it for the modern standard as documented
in groff_mdoc(7) and mandoc mdoc(7).  Heirloom copes with that as
well, and legacy implementations are virtually inexistent.

Yours,
  Ingo


From MAILER-DAEMON Wed May 03 19:04:57 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d63KL-0000ZU-KI
	for mharc-groff@gnu.org; Wed, 03 May 2017 19:04:57 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:58745)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d63KI-0000Xx-UY
	for groff@gnu.org; Wed, 03 May 2017 19:04:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d63KH-0008LO-UI
	for groff@gnu.org; Wed, 03 May 2017 19:04:54 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:55473)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d63KH-0008JF-Oc
	for groff@gnu.org; Wed, 03 May 2017 19:04:53 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d63KE-0000zs-9N; Thu, 04 May 2017 01:04:51 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d63KD-0003ho-3z; Thu, 04 May 2017 01:04:49 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d63KD-0003M0-0C; Thu, 04 May 2017 01:04:49 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id d68f88b2;
	Thu, 4 May 2017 01:04:48 +0200 (CEST)
Date: Thu, 4 May 2017 01:04:48 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Groff <groff@gnu.org>
Message-ID: <20170503230448.GB57799@athene.usta.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 03 May 2017 23:04:56 -0000

Hi Branden,

> .ie c \(lq .ds `` \(lq
> .el        .ds `` ``
> .ie c \(rq .ds '' \(rq
> .el        .ds '' ''
> 
> What do you think?

If doesn't work:

 $ uname -a
SunOS unstable11s 5.11 11.2 sun4u sparc SUNW,SPARC-Enterprise
 $ cat tmp.roff
.ie c \(lq .ds `` \(lq
.el        .ds `` ``
.ie c \(rq .ds '' \(rq
.el        .ds '' ''
>>>\*(``hello world!\*(''<<<
 $ nroff tmp.roff
>>>hello world!<<<
 $ troff tmp.roff | /usr/lib/lp/postscript/dpost | sed -n '/>>>/,/<<</p'
(>>>)720 120 w
10 R f
(hello world!)1 499 1 888 120 t
10 S1 f
(<<<)1387 120 w

 $ nroff
>>> 
.ie c \(mi defined
.el undefined
<<<
^D
>>> <<<
 $ echo '>>>\(lqhello world!\(rq<<<' | nroff
>>>hello world!<<<

There are real-world systems (sold today) where neither \(lq
nor the 'c' conditional is supported.  And yes, that kind
of nroff may be used for manual page display by default:

 $ strings `which man` | grep roff
/usr/lib/sgml/sgml2roff
troff
lp -c -T troff
nroff -u0 -Tlp

Yours,
  Ingo


From MAILER-DAEMON Wed May 03 20:13:21 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d64OX-0002BT-5v
	for mharc-groff@gnu.org; Wed, 03 May 2017 20:13:21 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47303)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OU-000285-P2
	for groff@gnu.org; Wed, 03 May 2017 20:13:19 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OP-0007o2-NT
	for groff@gnu.org; Wed, 03 May 2017 20:13:18 -0400
Received: from rrcs-50-74-108-158.nyc.biz.rr.com ([50.74.108.158]:64898
	helo=mail.schemamania.org) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OP-0007lW-Hq
	for groff@gnu.org; Wed, 03 May 2017 20:13:13 -0400
Received: from oak.schemamania.org (localhost [IPv6:::1])
	by mail.schemamania.org (Postfix) with ESMTP id 25260256F88D
	for <groff@gnu.org>; Wed,  3 May 2017 20:13:18 -0400 (EDT)
Date: Wed, 3 May 2017 20:13:18 -0400
From: "James K. Lowden" <jklowden@schemamania.org>
To: groff@gnu.org
Message-Id: <20170503201318.7a9d53090467edfe5c7a06e0@schemamania.org>
In-Reply-To: <20170503174255.GA17280@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
	<20170503174255.GA17280@foveal5.foveal.com>
Reply-To: groff@gnu.org
X-Mailer: Sylpheed 3.4.3 (GTK+ 2.24.28; x86_64--netbsd)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 50.74.108.158
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 00:13:19 -0000

On Wed, 3 May 2017 13:42:55 -0400
Mike Bianchi <MBianchi@Foveal.com> wrote:

> The  -  character exists on all keyboards.  It is not labeled minus
> or hyphen or endash.  It generates the decimal 45 (hex 0x2D, octal
> 055) character. That any *roff processor would give it a different
> meaning is most unfortunate.

IMO that is the principal that should be applied: every unadorned
character appearing in troff input should represent itself.  If  you
want something other than that, groff_char(7) describes your options.  

IIUC, this debate about how to render - and \- stems from a conflict in
historical practice.  Is the following correct?  

	When troff was young, terminals were ascii and the - character
was 0x2d.  Manpage guidelines encouraged the use of \- for flags because
they rendered nicely in printed documents with no harm done to nroff
output.  They did that despite the obvious fact that the manpage is
there to describe what to type, and basically no one can type the
denoted character.  

	Then Unicode pronounced that 0x2d was neither fish nor fowl,
and gave us hyphen, minus, and endash characters.  groff dutifully
mapped - onto hyphen \- onto minus.  But when terminals gained Unicode
capability, some of them lost cut-and-paste convenience.  The debate is
over how to recover that convenience.  

Oddly, my system doesn't exibit any cut-and-paste anomaly despite
using xterm with the "-en UTF-8" option.  Searching for - in less also
works.

If it's a UI issue we're confronting, perhaps it's really up to the UI
to deal with.  The man utility can certainly impose on nroff the
requirement that - and \- both render as 0x2d.  Then it shows up
correctly in the pager.  It is visually acceptable to the user, and
DTRT regarding the UI.  (Maybe that's what Ubuntu LTS does for me; I
don't know.) 

It's not obvious to me groff should make any change at all.  At most,
reverting the mapping of - so that it outputs 0x2d again would undo a
nonobvious, subtle change in favor of simplicity.  

Possibly some degree of outreach to the UI community would be service,
too.  

--jkl










From MAILER-DAEMON Wed May 03 20:13:28 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d64Oe-0002EJ-8a
	for mharc-groff@gnu.org; Wed, 03 May 2017 20:13:28 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47361)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OZ-0002Cl-Q0
	for groff@gnu.org; Wed, 03 May 2017 20:13:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OY-00085H-SJ
	for groff@gnu.org; Wed, 03 May 2017 20:13:23 -0400
Received: from rrcs-50-74-108-158.nyc.biz.rr.com ([50.74.108.158]:64897
	helo=mail.schemamania.org) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1d64OY-00084l-Nc
	for groff@gnu.org; Wed, 03 May 2017 20:13:22 -0400
Received: from oak.schemamania.org (localhost [IPv6:::1])
	by mail.schemamania.org (Postfix) with ESMTP id 2D19B256F88D
	for <groff@gnu.org>; Wed,  3 May 2017 20:13:29 -0400 (EDT)
Date: Wed, 3 May 2017 20:13:29 -0400
From: "James K. Lowden" <jklowden@schemamania.org>
To: groff@gnu.org
Message-Id: <20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
In-Reply-To: <2067319.281997.1493841970242@mail.vodafone.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
	<CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
	<2067319.281997.1493841970242@mail.vodafone.de>
Reply-To: groff@gnu.org
X-Mailer: Sylpheed 3.4.3 (GTK+ 2.24.28; x86_64--netbsd)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 50.74.108.158
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 00:13:24 -0000

On Wed, 3 May 2017 22:06:10 +0200 (CEST)
Carsten Kunze <carsten.kunze@arcor.de> wrote:

> There are ways to detect the formatter but a manpage must not do
> this.  

Why not?  ISTM we'd have better manpages if they weren't constrained to
the rendering capability of a VT-100 terminal.   For example, equations
or pictures could augment the text, or replace some of it, when
"printed".  

--jkl


From MAILER-DAEMON Wed May 03 20:52:53 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d650n-0000zD-3R
	for mharc-groff@gnu.org; Wed, 03 May 2017 20:52:53 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56508)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d650k-0000z4-KQ
	for groff@gnu.org; Wed, 03 May 2017 20:52:51 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d650h-0005RP-IO
	for groff@gnu.org; Wed, 03 May 2017 20:52:50 -0400
Received: from mail-yb0-x22d.google.com ([2607:f8b0:4002:c09::22d]:34477)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d650h-0005RC-CK
	for groff@gnu.org; Wed, 03 May 2017 20:52:47 -0400
Received: by mail-yb0-x22d.google.com with SMTP id 8so1449595ybw.1
	for <groff@gnu.org>; Wed, 03 May 2017 17:52:47 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=lIoRbxTxa0ieYCvGKM7sS4gRoGWAwO48Mas0ccxPKb4=;
	b=IIoRmNb91M4Yhr5K8pU9YFOLUv+Cl59V9Sman8GfkK3ySPXOgqWD5fawfRcm3FC6Ye
	yWWw5NvxUy+0/KcwoTOtYCshCEJbsp9+7OTBCdrmkJTSOrtc1PAujd7M6eeClvyp1dZf
	3QVz5vZUppkXuKvuuorvGGhvFJ8qQeQKz0iQqoD8o/RZ8pK3ORWNFoWIqQyPh6ruD69o
	nJZ9RinA0zX5ZSkbP4LPQYYJLOzhIwNKGen3gFhvJDnNDPdiIPNSNkmWbqS9XznZIj2h
	Sp+NH5BG3pHl0uvUQWMeucox7SRQaaGSQITWER60GX+05UlNO+j5+nvWLqbtQM0JdSNS
	A2LA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=lIoRbxTxa0ieYCvGKM7sS4gRoGWAwO48Mas0ccxPKb4=;
	b=QDmTKO27IVNfDRrFPG4ruNmXvw9OQTf/1Uw4Fxr2kgX37SjKa0v4OCLIMbxR8sKdc7
	gfkOlj2yhPIJslgmgP7rPivVJd4qKmr/O4QnLOZzUTaIo2bHmM48I10tnhnVL9Zkrmv3
	Kkf5NNgDTC9Kij9+5HTz/fnq07lqFbgodEeQpFzsFpk8d+aRSWN+ad+6eLqzVmsvApS9
	pFO13Eyi7fc37kdfedJ4cHL1az7MuwFWgQs/0EKHBEbAZc/cik4JLpNwooOiINSS94je
	EebwCcW3F+kzYU8uvqY3Y79KC2Uy1csVUxBqYqc2f8bfW4rnR2XjsOuqQGQ/sD85VYIA
	e4Ug==
X-Gm-Message-State: AN3rC/6MT4DUAHo2lK+f07vkF2LNVrJKZJ3xDbBBi/0nVWJxAnL863LO
	9WWTg1fd2WNsPx79cD4=
X-Received: by 10.37.36.3 with SMTP id k3mr32136921ybk.169.1493859166219;
	Wed, 03 May 2017 17:52:46 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	p133sm348226ywb.73.2017.05.03.17.52.44 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Wed, 03 May 2017 17:52:45 -0700 (PDT)
Date: Wed, 3 May 2017 20:52:42 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
	<20170503230448.GB57799@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="sih5tu2wunexch6y"
Content-Disposition: inline
In-Reply-To: <20170503230448.GB57799@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::22d
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 00:52:51 -0000


--sih5tu2wunexch6y
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-04T01:04:48+0200, Ingo Schwarze wrote:
> Hi Branden,
>=20
> > .ie c \(lq .ds `` \(lq
> > .el        .ds `` ``
> > .ie c \(rq .ds '' \(rq
> > .el        .ds '' ''
> >=20
> > What do you think?
>=20
> If doesn't work:
>=20
>  $ uname -a
> SunOS unstable11s 5.11 11.2 sun4u sparc SUNW,SPARC-Enterprise
>  $ cat tmp.roff
> .ie c \(lq .ds `` \(lq
> .el        .ds `` ``
> .ie c \(rq .ds '' \(rq
> .el        .ds '' ''
> >>>\*(``hello world!\*(''<<<
>  $ nroff tmp.roff
> >>>hello world!<<<
>  $ troff tmp.roff | /usr/lib/lp/postscript/dpost | sed -n '/>>>/,/<<</p'
> (>>>)720 120 w
> 10 R f
> (hello world!)1 499 1 888 120 t
> 10 S1 f
> (<<<)1387 120 w
>=20
>  $ nroff
> >>>=20
> .ie c \(mi defined
> .el undefined
> <<<
> ^D
> >>> <<<
>  $ echo '>>>\(lqhello world!\(rq<<<' | nroff
> >>>hello world!<<<
>=20
> There are real-world systems (sold today) where neither \(lq
> nor the 'c' conditional is supported.  And yes, that kind
> of nroff may be used for manual page display by default:
>=20
>  $ strings `which man` | grep roff
> /usr/lib/sgml/sgml2roff
> troff
> lp -c -T troff
> nroff -u0 -Tlp

N.B. my comments here are situated in a context _outside_ of the GNU
Troff project.

Why do my man pages need to be more portable the shell scripts or C code
I ship with them?

What is the value in reading the _formatted_ version of a man page for a
tool that won't compile or run correctly on the host?

I refuse to write shell scripts for general-purpose consumption only in
the historical Bourne dialect that Solaris /bin/sh was, and I refuse to
write man pages for general-purpose consumption only in some minimal
common subset that _no one_ has troubled themselves to carefully define.

As I've said before, I fear the talk of "safe subsets" and portability
in groff_man(7) and man(7) are years out of date and in places
anticipated a golden age of direct man-to-HTML rendering that never came
to pass for several reasons.

I want the "man language" to be small, as I also said before, but not
cripplingly so, and I want it to be informed by design, not accidental
overlaps in Venn diagrams of traits supported by unmaintained
implementations.

For example, even if that old Solaris system can render the output of
docbook-to-man legibly, that wouldn't mean that docbook-to-man's output
is well-considered or a model to emulate in any particulars.

Finally, Groff's own portability is sufficiently broad that we should be
able to say, "as a rule, if you want man pages written in the past 25
years to render nicely on Boozix 11.0, Gizmoware's custom hybrid of
4.3BSD and SVr3, please build and install Groff so that its macro
packages can achieve this for you."

Regards,
Branden

--sih5tu2wunexch6y
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkKe0EACgkQ0Z6cfXEm
bc46tw//YDzR2dQUSZdhQ3hfmxLPQHvHapG3YvScNudVQupSK8wxDK3O9QNosXYf
TSaSpKPb4Jpmsnl95L54RxepAnaOGjhT6aqYnCb+jA5C02ja/c74F0fPdabr0Rq5
06wb6ujU/GN+7+0pIRPzTXM1Z2etZ8QoMWfbrrgmJ19c1Pjv6PYkSHf43n2c5w+A
AKSNM1iNmQGnQCckjrjuLMnbVw23siK9z4O54ejCi30/1NLDxwmc0FGOflVb52a0
uDk5DyzOR1ksLIZ5kTwPL6OS75fWyrufhnWgr+Evkyo437HXbobAFR7FQU67q07M
jakSM62vwKWK9Yqr5FiaEgFXoIeNN7Pf083+gZg3NC+0s18YZI6t7nlfHL24lPjl
br6z6XmScYBPLsWiNwN2Htb626y08h755oaffM8H6mgPo7tFIHmITcljJ72SiDOh
i5PoBXu1l0xe0vb6rVcA5TJCHSgevwyesx9fDN4FNJsoqs/iBJw8l0Omd6wDAdrv
Pq6pai770/yDjU/umBz1eaSEaR2CvSYcyfNv5c/+tuSbdbdxS6JuAYKZYmtdHzAT
8TaIS294WCxJQaXOrxc4QPgzi5P7kKqLIA/DyiD7HYz8U5QQzGOV912xbEVZwfeH
3xeum/sUq2071/FJUXph0408I4q8C5N5eM1gid/82LBzDw7Tyd8=
=HdXc
-----END PGP SIGNATURE-----

--sih5tu2wunexch6y--


From MAILER-DAEMON Wed May 03 21:02:43 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d65AJ-0000o1-Ee
	for mharc-groff@gnu.org; Wed, 03 May 2017 21:02:43 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59210)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d65AG-0000lD-0v
	for groff@gnu.org; Wed, 03 May 2017 21:02:41 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d65AC-0002bD-W2
	for groff@gnu.org; Wed, 03 May 2017 21:02:40 -0400
Received: from mail-yb0-x242.google.com ([2607:f8b0:4002:c09::242]:33677)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d65AC-0002b0-SI
	for groff@gnu.org; Wed, 03 May 2017 21:02:36 -0400
Received: by mail-yb0-x242.google.com with SMTP id d72so271916ybh.0
	for <groff@gnu.org>; Wed, 03 May 2017 18:02:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=cQhTxX3xuNMo2Vx4iBfdlt3giRTJdQ24xyxQEHguCNI=;
	b=dIrJ1i73COin5kCoPUmNgurehClFCtlNMbYV2hN4JMcbU0EPuKxXh/2F29cSprzUi7
	i65AA3Q99z0Ye2KNV9Dwap4zLBwMIKJDuxMf9LcAMuOH0/0JQIuWgAgx2wlsm8lnMuFt
	24zrn0LbQFYxu8ZK4XKEKUhdx01rKDBgVTOZCfXhSEbTJ1PlccdLN1axqFIqmU4+k9Fw
	fpS3TZHLxwyZpLihRMTfLayBr+LQR6K8009OTVDKK+2SP2pFXqIyVbWBEniVKHO1ieqg
	93uq7IgInTQVjcgCvNufoz/K4lXDn0HFn48bcnNLEBxfigr1G4UkgrPzaXmm/nQD0UVE
	tWJw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=cQhTxX3xuNMo2Vx4iBfdlt3giRTJdQ24xyxQEHguCNI=;
	b=UYHLlupa41mOila1Aqs4SJB+2TlNylnSw03amNnxTuC5uAb1yxqGrQCglIaATOWK0m
	9VFFM1+tjPy/ikmBa4Sdfs5E+c2mI/nnESWVl6NIOn3RxPZGoTPybKMbq4emUDl9xZMh
	qMkitwNZjwqg3bB0bmVtbIWHStF/SnWaf7aricmZ0FJ0AkrFJ14p1o1784vPVtLyi31Q
	lm2npYFGTiYOgKYOYGJR55i1UImL9KRBqEENe/Ofg4X8YK/EfHvre1heTF5vc2GwZlfU
	7q3rvRSqMuGl33uGiUmYK2YU0vscBrFXueWVd44RAOmWHgsAp0r0N0savAkQS61t663t
	FCEA==
X-Gm-Message-State: AN3rC/5mV0roXuhOeHV7nFwBx/CFxmJ+GSqukylkI5cVjvwuLpEkUBjw
	bVPCv1qYSe2WJPkya18=
X-Received: by 10.37.88.137 with SMTP id m131mr32589953ybb.12.1493859755954;
	Wed, 03 May 2017 18:02:35 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100])
	by smtp.gmail.com with ESMTPSA id j13sm341612ywg.76.2017.05.03.18.02.34
	for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Wed, 03 May 2017 18:02:34 -0700 (PDT)
Date: Wed, 3 May 2017 21:02:32 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170504010230.vvy25nc4g7vh2nnw@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
	<CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
	<2067319.281997.1493841970242@mail.vodafone.de>
	<20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="4gayasxthvntj2uc"
Content-Disposition: inline
In-Reply-To: <20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::242
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 01:02:42 -0000


--4gayasxthvntj2uc
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-03T20:13:29-0400, James K. Lowden wrote:
> On Wed, 3 May 2017 22:06:10 +0200 (CEST)
> Carsten Kunze <carsten.kunze@arcor.de> wrote:
>=20
> > There are ways to detect the formatter but a manpage must not do
> > this. =20
>=20
> Why not?  ISTM we'd have better manpages if they weren't constrained
> to the rendering capability of a VT-100 terminal.

Oh, it can get much worse than that.  If we were to tell man page
writers  target only the common subset of features implemented by
everything that's claimed to be VT-100-compatible over the years, we
would be left only with that which devascii offers, and even that is
probably too sophisticated.

> For example, equations or pictures could augment the text, or replace
> some of it, when "printed".

Yes.  For the past several years, xterm has supported DEC's ReGIS[1] and
Sixel[2] graphics.

Note that when people call something "VT-100-compatible", they generally
mean some smorgasbord of features cribbed from the VT100 and its many
successor terminals (VT220, VT320, VT420, VT520, VT525), whatever seemed
cool and/or was easy to implement.

At the same time, the finer details of getting baseline VT100 emulation
completely correct with respect to, say, ACS ("alternate character set")
and cursor movement were frequently neglected.

[1] https://www.youtube.com/watch?v=3DDmrmj5y72kg

[2] https://upload.wikimedia.org/wikipedia/commons/6/62/W3m-wikipedia.png

Regards,
Branden

--4gayasxthvntj2uc
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkKfaUACgkQ0Z6cfXEm
bc7F2BAAlaG2rLjBzNKITskjKhOjrNqsE/im73VllsQPdj0Yx1Y94G45T/s1XLW3
6fqlxK01Y8ju8SpndYavIPs81ljkj0UD05aIV85q/AFcox6OKl810VOCjIF39mhW
fffVmGE2nz/7OXMwazKWIDde5uDpXZ6clRBgLlgNLaYxGpcFsncX/D1pdhM84kid
ly7FCRbK/ui+Nr+Fg37LRD8tofYs1LSdbevIy2iMp+Mkkgt+steXjPwe5hnUD5fT
obo7Mfq79KMukpxwSg0HWEf6vugw2jJBLPkUg32L+1AThtB8YeD4cqKpayPuqhss
gSiplGZ0C0gUBEP7nWMrzaHJ4qK6Uvd623EFUU+tCuldVpfetjU66eTa8Cj6QwFX
/ZbxvyVL2439FBCwAfiiU82AAyMw5oXC5eo0/oWiRfCGYFhHYTIdMHQI0kWd0wD+
y8GGy0UFLtPFsdrXHVxTaIAb9TbLVho7ZuN+bUldIlS6isrUgFj92w3ugXWCwLwB
x7+pbsSdzUkjORAtMBxvIcby5G6IfvHiNZRv/nSkmiPRf0soXMuZ3SV02fOqQ0v+
zYihzbb/kWqMtRGqVsCSfdD93zncfvyIyTHFhxAU+lL2r0us8F4IjFWsg8FK5w3v
7/JA2ZgJa+KQ274OkvT62uIImg4qvzu2bDd2wUo05i2MByS+/90=
=ulsm
-----END PGP SIGNATURE-----

--4gayasxthvntj2uc--


From MAILER-DAEMON Wed May 03 21:31:16 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d65bw-0000z6-PA
	for mharc-groff@gnu.org; Wed, 03 May 2017 21:31:16 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36348)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d65bs-0000yn-W1
	for groff@gnu.org; Wed, 03 May 2017 21:31:14 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d65br-0001tW-17
	for groff@gnu.org; Wed, 03 May 2017 21:31:13 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:41833)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d65bq-0001s3-N0
	for groff@gnu.org; Wed, 03 May 2017 21:31:10 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d65bn-0004Dh-AC; Thu, 04 May 2017 03:31:08 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d65bm-0007rB-4J; Thu, 04 May 2017 03:31:06 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d65bk-0005kA-UT; Thu, 04 May 2017 03:31:05 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id ab1c7025;
	Thu, 4 May 2017 03:31:04 +0200 (CEST)
Date: Thu, 4 May 2017 03:31:04 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: groff@gnu.org
Message-ID: <20170504013104.GC57799@athene.usta.de>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170503145124.2F08C215A3@orac.inputplus.co.uk>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 01:31:15 -0000

Hi Ralph,

Ralph Corderoy wrote on Wed, May 03, 2017 at 03:51:24PM +0100:

>     -       A hyphen for text, e.g. beer-flavoured ice-cream.
>     \-      A minus sign in the current font.
>     \(mi    A minus sign in the special font.
>     \(hy    Another name for plain `-', so a hyphen for text.
>     \N'45'  Glyph 45 in the current font.

The trouble with \N'45' is that it has not a fixed meaning
and that the resulting glyph varies wildly.

Even if you only look at groff and only at git master HEAD,
\N'45' means:

 -Tascii:   U+002D HYPHEN-MINUS
 -Tlatin1:  U+002D HYPHEN-MINUS
 -Tutf8:    U+002D HYPHEN-MINUS
 -Thtml:    U+002D HYPHEN-MINUS
 -Tcp1047:  nothing useful, a control character (ENQ, enquiry character)
 -Tps:      hyphen; that's the same character as \(hy
 -Tpdf:     hyphen; that's the same character as \(hy
 -Tdvi:     hyphen; that's the same character as \(hy
 -Tlbp:     hyphen; that's the same character as \(hy
 -Tlj4:     undefined, no character at all

While this is clearly what you want for -Tascii, -Tlatin1, -Tutf8,
and -Thtml, and in particular for -Tutf8 where it is a reasonably
wide glyph looking like a minus sign and also the right character
for copy and paste, it is dubious whether \N'45' is what you want
for -Tps, -Tpdf, -Tdvi, and -Tlbp.

First, the fact that the character number agrees with ASCII doesn't
mean much.  While the arrangement of the glyphs for the TR font of
the -Tps device is loosely based on ASCII, the codepoints for several
characters mismatch.  For example, U+0027 APOSTROPHE, which you get
with \(aq, is codepoint 8 in -Tps TR, *not* codepoint 39 as you
would expect, which is instead \(cq = U+2019 RIGHT SINGLE QUOTATION
MARK.  U+0060 GRAVE ACCENT is codepoint 146, not 96, which is instead
\(oq = U+2018 LEFT SINGLE QUOTATION MARK.  U+005E CIRCUMFLEX ACCENT
has two associated codepoints, the expected 94 (produced with ^)
and the unexpected 0 (\(ha).  So has U+007E TILDE, the expected 126
(~) and the unexpected 1 (\(ti).  It is also amusing that in the
appendix below, the character \(en transforms to seven different
glyph numbers in nine different output devices, and only one of
them is related to ASCII, which emphasizes the weak relationship
between glyph numbers (even for -Tps) and ASCII character numbers.

Then, the glyph you get for \N'45' in -Tps TR is *not* similar to
the wide glyph that you would expect for U+002D HYPHEN-MINUS.
Instead, it is a typical, short hyphen.

So, which glyph in -Tps TR does represents U+002D HYPHEN-MINUS?
Asking the question that way, the full dilemma becomes obvious:
Just like in classical typography, there is *none*.

So not only does groff provide no way to request an output glyph
for "ASCII -", worse, the fonts for the important -Tps and -Tpdf
devices do not even contain such a glyph!

Consider a program that wants to copy text out of a groff-generated
PostScript or PDF document and paste it into a Unicode terminal
window.  Such a program could reasonably be expected to translate
-Tps TR codepoint 45 into U+2010 HYPHEN because that's what you get
from the unambiguous \(hy input character, and it could reasonably
be expected to translate -Tps TR codepoint 173 into U+2212 MINUS
SIGN because, as Doug kindly reminded us, \- is the minus sign in
the current font and \(mi is not in the TR font at all.  But now
we have already exhausted the glyphs in -Tps TR and there is no
glyph left that could be converted into U+002D HYPHEN-MINUS.

Many people have said during this discussion that they wouldn't
expect copy and paste from a PDF viewer to a UTF-8 terminal to work.
The above may well be part of the precise reason why indeed it
cannot fully work.

On the other hand, i stumbled because nowadays, we have got used
to the feeling that Unicode might be a superset of everything.  So
i considered \- and \(mi redundant because both map to U+2212, and
so i hoped one of them might be up for grabs.  Yet Doug kindly
reminded us what the distinction is, and that distinction indeed
cannot be represented in terms of Unicode codepoints.

So i have to reluctantly conclude that your original problem, Ralph,
of requesting "a glyph representing U+002D HYPHEN-MINUS" is unsolvable.
At least not without adding yet another glyph to the -Tps TR font.
But even that would hardly help, for two reasons: all PostScript
and PDF viewer software would first have to catch up, correctly
recognize the glyph, and correctly translate it to U+002D HYPHEN-MINUS
- but the ecosystem such software lives in evolves incredibly slowly
nowadays.  And then you would have to define a new character escape
sequence to access the new glyph, since all the existing escapes
already mean something else.  But that's effectively a reductio ad
absurdum: telling all manual page authors to, henceforth, write "wc
\(hml" is not going to fly.  Very few would understand and follow
that, and even i would tend to resist it as excessive complication.


So i fear we are left with the traditional workaround:
Use \- if you mean U+002D HYPHEN-MINUS and live with the
three unsolvable problematic consequences:

 1. The fact that -Tps TR has no glyph for U+002D HYPHEN-MINUS.
 2. The fact that for Unicode output outside manual pages, you get
    U+2212 instead of the U+002D you wanted.  If that is unacceptable
    in some specific situation *and* you are only targeting some
    subset of output devices, there may be a case-by-case workaround,
    but there is no general solution.
 3. For Unicode output of manual pages, the
      .char \- \N'45'
    in the two macro sets needs to be kept for good, even though
    that implies that in manual pages, the occasional \- that *is*
    intended as a mathematical minus sign will also (mis)render as
    U+002D.

Unfortunately, the patch that i submitted to the bugtracker appears
to be wrong.  As no other solution appears to be possible, I should
probably mark it as invalid and close the ticket.

If you agree with this analysis, i'm planning to look through the
documentation and try to make all this clearer whereever needed,
such that people are less likely to waste time again redoing this
analysis in a few years.

Yours,
  Ingo


Appendix:
Rendering of hyphens, minuses, and dashes in all of groff's output devices.

Format of the following list:

Block headers:
column 1: input character
column 2: description in documentation
column 3 (in parentheses): whether provided in a special font

Block bodies:
column 1 (prefix -T, suffix :): device name
column 2: font file name (if any, otherwise src/libs/libgroff/glyphuni.cpp)
column 3: glyph code number (number format is device dependent)
column 4 (after =): output character (provided only if ASCII)
column 5 (in parentheses): exceptions for manual page macro sets

-     hyphen (never special)
\(hy  hyphen (never special)
      -Tascii:  R  45 = -
      -Tutf8:   -  U+2010 HYPHEN (currently U+002D in manuals, to be removed)
      -Thtml:   R  U+002D HYPHEN-MINUS = -
      -Tcp1047: R  0140
      -Tps:     TR 45 hyphen = -
      -Tdvi:    TR 0055
      -Tlbp:    TR 0x2d hyphen
      -Tlj4:    TR 161069 -- 19U 45

\-    minus in current font (special only in -Tdvi)
      -Tascii:  R  45 = -
      -Tutf8:   -  U+2212 MINUS SIGN (U+002D in manuals, for good)
      -Thtml:   -  U+2212 MINUS SIGN = &minus;
      -Tcp1047: R  0140
      -Tps:     TR 173 minus = \255
      -Tdvi:    S  0000
      -Tlbp:    TR 0x2d hyphen
      -Tlj4:    TR 60096 -- 7J 192
+     plus in current font (never special)
      -Tascii:  R  43 = +
      -Tutf8:   -  U+002B PLUS SIGN
      -Thtml:   -  U+002B PLUS SIGN = +
      -Tcp1047: R  0116
      -Tps:     TR 43 plus = +
      -Tdvi:    TR 0053
      -Tlbp:    TR 0x2b plus
      -Tlj4:    TR 161067 -- 19U 43

\(mi  minus in special font (always special)
      -Tascii:  R  45 -
      -Tutf8:   -  U+2212 MINUS SIGN
      -Thtml:   -  U+2212 MINUS SIGN = &minus;
      -Tcp1047: R  0140
      -Tps:     S  45 minus
      -Tdvi:    S  0000
      -Tlbp:    not provided
      -Tlj4:    S  68909 -- 8M 45
\(pl  plus in special font (sometimes special)
      -Tascii:  R  43 +
      -Tutf8:   -  U+002B PLUS SIGN
      -Thtml:   -  U+002B PLUS SIGN
      -Tcp1047: R  0116
      -Tps:     S  43 plus
      -Tdvi:    TR 0053
      -Tlbp:    TR 0x32b plusmath
      -Tlj4:    S  68907 -- 8M 43

\(en  en-dash (never special)
      -Tascii:  R  45 -
      -Tutf8:   -  U+2013 EN DASH
      -Thtml:   -  U+2013 EN DASH = &ndash;
      -Tcp1047: R  0140
      -Tps:     TR 137 endash = \211
      -Tdvi:    TR 0173
      -Tlbp:    TR 0x132 endash
      -Tlj4:    TR 161174 -- 19U 150

\(em  em-dash (never special)
      -Tascii:  -  .fchar \[em] --  \" tty.tmac
      -Tutf8:   -  U+2014 EM DASH
      -Thtml:   -  U+2014 EM DASH = &mdash;
      -Tcp1047: -  .fchar \[em] --  \" tty.tmac
      -Tps:     TR 138 emdash = \212
      -Tdvi:    TR 0174
      -Tlbp:    TR 0x123 emdash
      -Tlj4:    TR 161175 -- 19U 151

Devices using special fonts (* provides at least one of the above glyphs):
  -Tps   S* SS ZD ZDR
  -Tpdf  S* ZD
  -Tdvi  MI S* EX CW
  -Tlj4  S*

Devices not using any special fonts:
  -Tascii
  -Tlatin1
  -Tutf8
  -Thtml
  -Tcp1047
  -Tlbp


From MAILER-DAEMON Wed May 03 22:50:46 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d66qs-0006rO-FL
	for mharc-groff@gnu.org; Wed, 03 May 2017 22:50:46 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:49493)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d66qq-0006rI-MA
	for groff@gnu.org; Wed, 03 May 2017 22:50:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d66qp-0007v4-FH
	for groff@gnu.org; Wed, 03 May 2017 22:50:44 -0400
Received: from scc-mailout-kit-01.scc.kit.edu
	([2a00:1398:9:f712::810d:e751]:38059)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d66qp-0007uK-2y
	for groff@gnu.org; Wed, 03 May 2017 22:50:43 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d66ql-0001ej-D9; Thu, 04 May 2017 04:50:40 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d66ql-0001Tc-2n; Thu, 04 May 2017 04:50:39 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d66qk-0000oG-DL; Thu, 04 May 2017 04:50:38 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 7e887586;
	Thu, 4 May 2017 04:50:38 +0200 (CEST)
Date: Thu, 4 May 2017 04:50:38 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170504025038.GD57799@athene.usta.de>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
	<20170503230448.GB57799@athene.usta.de>
	<20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e751
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 02:50:46 -0000

Hi Branden,

G. Branden Robinson wrote on Wed, May 03, 2017 at 08:52:42PM -0400:

> Why do my man pages need to be more portable the shell scripts
> or C code I ship with them?

They need not, but i would consider aiming for about the same level
of portability reasonable.  Meaning, that they work on systems that
you target.

> What is the value in reading the _formatted_ version of a man page
> for a tool that won't compile or run correctly on the host?

That's indeed not very high priority, but why do you think that
any (reasonably portable) software would not run on Solaris 11?

I do not want to promote Oracle software, and in fact i use none
for my own purposes.  But Solaris 11 is a certified UNIX system
conforming to the 2016 edition of the Single UNIX Specification,
version 4:

  https://www.opengroup.org/openbrand/register/brand3585.htm

That implies that the native compiler conforms to ISO C 99
and that the native /bin/sh is a POSIX shell.

> I refuse to write shell scripts for general-purpose consumption
> only in the historical Bourne dialect that Solaris /bin/sh was,

That doesn't apply to Solaris 11.

> and I refuse to write man pages for general-purpose consumption
> only in some minimal common subset that _no one_ has troubled
> themselves to carefully define.

Admittedly, C and sh(1) are well standardized, and man(7) is not.
All the same, would you want your manual pages to break on systems
where your program compiles and runs just fine?

Yes, Solaris typically does need some porting work for code that
is mostly developed on BSD or Linux, even though it is a POSIX
system.  But porting is usually not a big deal.  At least not for
Solaris 11.  Solaris 9, on the other hand, is a bit more of an
adventure, but i didn't talk about the nroff you might find there,
either.

[...]
> For example, even if that old Solaris system

I often snarkily call any version of Solaris "archaic software"
myself.  All the same, this particular system is a very new system
on sale today.

> can render the output of docbook-to-man legibly,

It absolutely cannot.  On that system, even though it is the newest
that you can buy from Oracle today, any kind of docbook-to-man
output will fall flat on its face before it even finds the time
to be surprised enough to utter a grunt.

[...]
> Finally, Groff's own portability is sufficiently broad that we should be
> able to say, "as a rule, if you want man pages written in the past 25
> years to render nicely on Boozix 11.0, Gizmoware's custom hybrid of
> 4.3BSD and SVr3, please build and install Groff so that its macro
> packages can achieve this for you."

As a matter of fact, groff is already installed on that system:

 $ groff -v | head -n1
GNU groff version 1.19.2

It is a very new Solaris system and not exactly the newest groff
available.  So, you want to use groff?  Fine, read the manual!

 $ man groff 2>&1 | cat
Reformatting page.  Please Wait... done
 $ echo $?
0

Hum.  It looks like that manual page uses features that the native
man(1) cannot handle, likely because it uses the native nroff(1).

So, to read the groff manual pages, you already need to know how to
use groff:

 $ gnroff -c -mandoc /usr/share/man/man1/groff.1 | less

Voila.  Now it works.


I admit such a system is hard to use, and i wouldn't use it for
productive work myself.  But completely dismissing it when
talking about "portable software" is not gonna cut it.

Oh, by the way, if you don't like the native shell:

 $ bash --version | head -n2
GNU bash, version 4.1.17(1)-release (sparc-sun-solaris2.11)
Copyright (C) 2009 Free Software Foundation, Inc.

Same pattern as with groff: Not at all up to date, but *something*
is there that is maybe almost acceptable for some purposes.

Yours,
  Ingo


From MAILER-DAEMON Wed May 03 23:27:57 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d67Qr-0004fX-LH
	for mharc-groff@gnu.org; Wed, 03 May 2017 23:27:57 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:55685)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d67Qm-0004bR-2C
	for groff@gnu.org; Wed, 03 May 2017 23:27:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d67Qg-0000p2-5T
	for groff@gnu.org; Wed, 03 May 2017 23:27:52 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:49279)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d67Qf-0000oa-V8
	for groff@gnu.org; Wed, 03 May 2017 23:27:46 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d67Qb-0002dP-5U; Thu, 04 May 2017 05:27:43 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d67QZ-0004eB-R5; Thu, 04 May 2017 05:27:39 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d67QT-0001il-CX; Thu, 04 May 2017 05:27:39 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id e59ed161;
	Thu, 4 May 2017 05:27:32 +0200 (CEST)
Date: Thu, 4 May 2017 05:27:32 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "James K. Lowden" <jklowden@schemamania.org>
Cc: groff@gnu.org
Message-ID: <20170504032731.GE57799@athene.usta.de>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
	<20170503174255.GA17280@foveal5.foveal.com>
	<20170503201318.7a9d53090467edfe5c7a06e0@schemamania.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170503201318.7a9d53090467edfe5c7a06e0@schemamania.org>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 03:27:56 -0000

Hi James,

James K. Lowden wrote on Wed, May 03, 2017 at 08:13:18PM -0400:

> IIUC, this debate about how to render - and \- stems from a conflict in
> historical practice.  Is the following correct?  
> 
> 	When troff was young, terminals were ascii and the - character
> was 0x2d.  Manpage guidelines encouraged the use of \- for flags because
> they rendered nicely in printed documents with no harm done to nroff
> output.  They did that despite the obvious fact that the manpage is
> there to describe what to type, and basically no one can type the
> denoted character.  
> 
> 	Then Unicode pronounced that 0x2d was neither fish nor fowl,
> and gave us hyphen, minus, and endash characters.  groff dutifully
> mapped - onto hyphen \- onto minus.  But when terminals gained Unicode
> capability, some of them lost cut-and-paste convenience.

So far, that is maybe somewhat simplified, but more or less to the
point.  For details of early runoff/roff history, see

  http://manpages.bsd.lv/history.html

Basically, you are starting your narrative in 1973.  At that point,
the language was about nine years old and had seen at least ten
earlier implementations in about eight different programming languages
on about five different operating systems on about eight different
machines by at least ten different authors.  Finding out how all
those handled "-" when they were young might be non-trivial.

> The debate is over how to recover that convenience.  

No, it is not.  That was solved long ago, at the latest here:

  commit 98acc924f4e32cfc2209df5db0c21921df8cc7ac
  Author: Werner LEMBERG <wl@gnu.org>
  Date:   Fri Jan 2 23:16:20 2009 +0000

    * tmac/an-old.tmac, tmac/doc.tmac: For -Tutf8, map \-, -, ', and `
    conservatively to ASCII for the sake of easy cut and paste.

The debate is over three different topics:

 1. Cut and paste from -Tps, -Tpdf, and -Thtml.

 2. What to use if ASCII HYPHEN-MINUS is desired in the output,
    both in manual pages and in other documents.

 3. What to use if a mathematical minus sign is desired in the
    output.

> Oddly, my system doesn't exibit any cut-and-paste anomaly despite
> using xterm with the "-en UTF-8" option.  Searching for - in less
> also works.

Yes, due to Werner's change in 2009 quoted above.
One of the effects is that in manual pages, "-" and "\-"
in the input always render as U+002D HYPHEN-MINUS in -Tutf8.

> If it's a UI issue we're confronting, perhaps it's really up to the UI
> to deal with.  The man utility can certainly impose on nroff the
> requirement that - and \- both render as 0x2d.  Then it shows up
> correctly in the pager.  It is visually acceptable to the user, and
> DTRT regarding the UI.  (Maybe that's what Ubuntu LTS does for me; I
> don't know.) 

It's not Ubuntu, it's groff itself already doing that for you.

> It's not obvious to me groff should make any change at all.  At most,
> reverting the mapping of - so that it outputs 0x2d again would undo a
> nonobvious, subtle change in favor of simplicity.  

Probably not, because that would break each and every existing
non-manpage roff document.  Besides, i just noticed that it's
completely unclear what "output U+002D HYPHEN-MINUS in a PostScript
or PDF document" is even supposed to mean, see my other mail...

Yours,
  Ingo


From MAILER-DAEMON Thu May 04 04:40:22 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6CJC-0002eE-Gg
	for mharc-groff@gnu.org; Thu, 04 May 2017 04:40:22 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56448)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6CJA-0002d4-Hb
	for groff@gnu.org; Thu, 04 May 2017 04:40:21 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6CJ7-00055y-Ac
	for groff@gnu.org; Thu, 04 May 2017 04:40:20 -0400
Received: from relay01.pair.com ([209.68.5.15]:42129)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d6CJ7-00055e-5Z
	for groff@gnu.org; Thu, 04 May 2017 04:40:17 -0400
Received: from orac.inputplus.co.uk (129.74.189.80.dyn.plus.net
	[80.189.74.129])
	by relay01.pair.com (Postfix) with ESMTP id 5D945D00B1C
	for <groff@gnu.org>; Thu,  4 May 2017 04:40:14 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 950AB21541
	for <groff@gnu.org>; Thu,  4 May 2017 09:40:13 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
	<CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
	<2067319.281997.1493841970242@mail.vodafone.de>
	<20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
Date: Thu, 04 May 2017 09:40:13 +0100
Message-Id: <20170504084013.950AB21541@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 08:40:21 -0000

Hi jkl,

> Carsten Kunze wrote:
> > There are ways to detect the formatter but a manpage must not do
> > this. =20
>
> Why not?  ISTM we'd have better manpages if they weren't constrained
> to the rendering capability of a VT-100 terminal.   For example,
> equations or pictures could augment the text, or replace some of it,
> when "printed". =20

`.if n' and `.if t' are OK since they're available everywhere.  And man
pages may already use eqn(1), etc., if they want.  man(7) mentions the
first line being `\" p' to indicate pic(1) is required, for example.

It's up to those preprocessors to produce output that will have a go at
a good representation given the limitations, and for the author not to
strain them and to keep the alternatives on a par.

    $ p=3D"`printf '%s\n' .PS down box line box right \
    >     'move to last box.e' line line box .PE`"
    $ nroff -p <<<"$p" | uniq
    =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=
=90
    =E2=94=82      =E2=94=82
    =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=AC=E2=94=80=E2=94=80=E2=94=
=98
	=E2=94=82
    =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=B4=E2=94=80=E2=94=80=E2=94=
=90          =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=
=80=E2=94=90
    =E2=94=82      =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=
=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=82      =E2=94=82
    =E2=94=82      =E2=94=82          =E2=94=82      =E2=94=82
    =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=
=98          =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=
=80=E2=94=98

    $ nroff -p -Tascii <<<"$p" | uniq
    +------+
    |      |
    +---+--+
	|
    +---+--+          +------+
    |      +----------|      |
    |      |          |      |
    +------+          +------+

    $

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Thu May 04 05:24:17 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6Czh-0002Oi-L3
	for mharc-groff@gnu.org; Thu, 04 May 2017 05:24:17 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41352)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6Czf-0002Ni-6d
	for groff@gnu.org; Thu, 04 May 2017 05:24:16 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6Czb-0006eE-6n
	for groff@gnu.org; Thu, 04 May 2017 05:24:15 -0400
Received: from relay01.pair.com ([209.68.5.15]:44469)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d6Czb-0006dv-2F
	for groff@gnu.org; Thu, 04 May 2017 05:24:11 -0400
Received: from orac.inputplus.co.uk (129.74.189.80.dyn.plus.net
	[80.189.74.129])
	by relay01.pair.com (Postfix) with ESMTP id DA3E5D00B13
	for <groff@gnu.org>; Thu,  4 May 2017 05:24:09 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 1A03221541
	for <groff@gnu.org>; Thu,  4 May 2017 10:24:09 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
	<20170503230448.GB57799@athene.usta.de>
	<20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
Date: Thu, 04 May 2017 10:24:09 +0100
Message-Id: <20170504092409.1A03221541@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 09:24:16 -0000

Hi Branden,

> Ingo wrote:
> > There are real-world systems (sold today) where neither \(lq nor the
> > 'c' conditional is supported.

And I know from experience that they become much more palatable after
building source for better versions of their binaries, and adding new
programs they don't have.  That source builds, and man pages format, on
these POSIX systems is a real benefit to those stuck using them.  And
`install groff' isn't an answer because permission often needs to be
sought for each.

> Why do my man pages need to be more portable the shell scripts or C
> code I ship with them?

Yours don't, but don't constrain the rest of us, or lead us astray with
non-portable -man extensions that will just increase the problems on
systems you don't use.

> I refuse to write shell scripts for general-purpose consumption only
> in the historical Bourne dialect that Solaris /bin/sh was

Again, that's your choice.  Many of us go to the effort of writing
portable code, and coping with the issues from those using it on less
common systems, including proprietary ones.

> and I refuse to write man pages for general-purpose consumption only
> in some minimal common subset that _no one_ has troubled themselves to
> carefully define.

If your viewpoint is "it's Linux, Mac OS X, or BSD, or it doesn't exist"
then I don't think it counts for much in considering changes to groff,
-man, mdoc, etc., that have a wider impact.

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Thu May 04 06:30:33 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6E1o-00011P-TY
	for mharc-groff@gnu.org; Thu, 04 May 2017 06:30:32 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57165)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6E1m-00011C-HS
	for groff@gnu.org; Thu, 04 May 2017 06:30:31 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d6E1j-0004Co-90
	for groff@gnu.org; Thu, 04 May 2017 06:30:30 -0400
Received: from relay01.pair.com ([209.68.5.15]:46281)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d6E1j-00047D-4g
	for groff@gnu.org; Thu, 04 May 2017 06:30:27 -0400
Received: from orac.inputplus.co.uk (129.74.189.80.dyn.plus.net
	[80.189.74.129])
	by relay01.pair.com (Postfix) with ESMTP id ED7B2D00AF6;
	Thu,  4 May 2017 06:30:20 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 417C621541;
	Thu,  4 May 2017 11:30:20 +0100 (BST)
To: Mike Bianchi <MBianchi@Foveal.com>
cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170503174255.GA17280@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
	<20170503174255.GA17280@foveal5.foveal.com>
Date: Thu, 04 May 2017 11:30:20 +0100
Message-Id: <20170504103020.417C621541@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 10:30:31 -0000

Hi Mike,

> > But - has always meant hyphen in pre-groff troff because it's a lot
> > more common to want a hyphen in writing than a minus sign.
>
> _I_ would claim this interpretation was a mistake.

Well, 7th Ed. documents that have `.if n' and `.if t' use - for an
English hyphen and \- for a numeric minus, e.g.
http://minnie.tuhs.org/cgi-bin/utree.pl?file=3DV7/usr/doc/ratfor/m2

    As a useful example, consider this problem:
    the variable
    .UL f
    is to be set to
    \-1 if
    .UL x
    is less than zero,
    to
    +1
    if
    .UL x
    is greater than 100,
    and to 0 otherwise.

    Following an
    .UL else
    with an
    .UL if
    is one way to write a multi-way branch in Ratfor.

And CSTR 54, 23.2 Font description files says - is the same as \(hy for
the PostScript printer they use as an example.

    Each line following charset describes one character: its name, its
    width..., ..., and a decimal, ... value by which the output device
    knows it (the \N "number" of the character).  ...  If the width
    field contains ", the name is a synonym for the previous character.
    ...

    Here are excerpts from a typical font description file for the same
    Postscript printer.

    hy  33  0  45  hyphen \(hy
    -   "          - is a synonym for \(hy
    Q   72  3  81
    a   44  0  97
    b   50  2  98

I also found in 8th Ed.
http://www.tuhs.org/Archive/Distributions/Research/Dan_Cross_v8/v8.tar.bz=
2
the directory usr/src/cmd/troff/devaps with these entries in R and S
that show - is \(hy and \- has the width of +.

    name R
    hy      35      0       83      font 21
    -       "
    em      96      0       82      font 21
    en      52      0       81
    +       77      0       73      font 21
    \-      77      0       74      font 21

    name S
    special
    pl      72      0       15
    +       "
    mi      72      0       16
    \-      "

So - is a hyphen in troff.  That makes sense since it's for writing, not
just man pages.

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Thu May 04 06:57:37 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6ES1-0007ZL-8J
	for mharc-groff@gnu.org; Thu, 04 May 2017 06:57:37 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34142)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d6ERz-0007UN-8R
	for groff@gnu.org; Thu, 04 May 2017 06:57:36 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.kunze@arcor.de>) id 1d6ERu-00037M-DR
	for groff@gnu.org; Thu, 04 May 2017 06:57:35 -0400
Received: from vsmx012.vodafonemail.xion.oxcs.net ([153.92.174.90]:45565)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <carsten.kunze@arcor.de>)
	id 1d6ERu-00036I-77
	for groff@gnu.org; Thu, 04 May 2017 06:57:30 -0400
Received: from vsmx004.vodafonemail.xion.oxcs.net (unknown [192.168.75.198])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTP id 294A4400322
	for <groff@gnu.org>; Thu,  4 May 2017 10:57:27 +0000 (UTC)
Received: from app-36.app.xion.oxcs.net (app-36.app.xion.oxcs.net [10.10.1.36])
	by mta-8-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 016D0380065
	for <groff@gnu.org>; Thu,  4 May 2017 10:57:22 +0000 (UTC)
Date: Thu, 4 May 2017 12:57:22 +0200 (CEST)
From: Carsten Kunze <carsten.kunze@arcor.de>
To: groff@gnu.org
Message-ID: <1405027608.264735.1493895442918@mail.vodafone.de>
In-Reply-To: <20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<1658250590.281765.1493840807873@mail.vodafone.de>
	<CAGcdajc2x1AYfYjFBFfi3TMZsJtTqWPJSygM18j6jzRmKGg2Ag@mail.gmail.com>
	<2067319.281997.1493841970242@mail.vodafone.de>
	<20170503201329.63f12579c35e4c2e03c11fb0@schemamania.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-Priority: 3
Importance: Medium
X-Mailer: Open-Xchange Mailer v7.8.3-Rev20
X-Originating-Client: com.openexchange.ox.gui.dhtml
X-VADE-STATUS: LEGIT
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 153.92.174.90
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 10:57:36 -0000

> "James K. Lowden" <jklowden@schemamania.org> hat am 4. Mai 2017 um 02:13 geschrieben:
> 
> Why not?  ISTM we'd have better manpages if they weren't constrained to
> the rendering capability of a VT-100 terminal.   For example, equations
> or pictures could augment the text, or replace some of it, when
> "printed".  

Indeed, \(.n and \(.t are an exception.  Should not be used excessively, but in few cases it makes sense.  Also hyperlinks and a table of contents could be used in PDF or HTML format, although this should be implemented in the macro package then and could then also be applied to manpages which had been design with just VT-100 in mind...


From MAILER-DAEMON Thu May 04 10:20:55 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6Hcl-0006tu-GI
	for mharc-groff@gnu.org; Thu, 04 May 2017 10:20:55 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35066)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d6Hcj-0006tc-Tq
	for groff@gnu.org; Thu, 04 May 2017 10:20:54 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mbianchi@foveal.com>) id 1d6Hcf-000838-WE
	for groff@gnu.org; Thu, 04 May 2017 10:20:53 -0400
Received: from relay01.pair.com ([209.68.5.15]:60020)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mbianchi@foveal.com>) id 1d6Hcf-0007yW-Mb
	for groff@gnu.org; Thu, 04 May 2017 10:20:49 -0400
Received: from foveal8 (pool-173-70-89-159.nwrknj.fios.verizon.net
	[173.70.89.159])
	by relay01.pair.com (Postfix) with ESMTP id BAB3AD010A9;
	Thu,  4 May 2017 10:20:43 -0400 (EDT)
Received: by foveal8 (Postfix, from userid 617)
	id 77DBB11E0042; Thu,  4 May 2017 10:20:43 -0400 (EDT)
Date: Thu, 4 May 2017 10:20:43 -0400
From: Mike Bianchi <MBianchi@Foveal.com>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
Message-ID: <20170504142043.GC5053@foveal5.foveal.com>
References: <201705030129.v431TdUT004632@coolidge.cs.Dartmouth.EDU>
	<20170503141554.GB3530@foveal5.foveal.com>
	<20170503145124.2F08C215A3@orac.inputplus.co.uk>
	<20170503174255.GA17280@foveal5.foveal.com>
	<20170504103020.417C621541@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170504103020.417C621541@orac.inputplus.co.uk>
User-Agent: Mutt/1.5.23 (2014-03-12)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 14:20:54 -0000

On Thu, May 04, 2017 at 11:30:20AM +0100, Ralph Corderoy wrote:
> > > But - has always meant hyphen in pre-groff troff because it's a lot
> > > more common to want a hyphen in writing than a minus sign.
> >
> > _I_ would claim this interpretation was a mistake.
> 
> Well, 7th Ed. documents that have `.if n' and `.if t' use - for an
> English hyphen and \- for a numeric minus, e.g.
>	:

Just to be clear, I am _not_ saying that wasn't how it was documented and
implemented.  I am just saying that it has made the world more complicated than
_I_ would like.  Typing \(hy for hyphen would have been a heavy burden,
especially in the absence of the  .char  groff extension.

Probably the best solution available now is fixing any incorrect documentation
so as to speak truth.

-- 
 Mike Bianchi


From MAILER-DAEMON Thu May 04 11:32:48 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6IkJ-0003LL-SA
	for mharc-groff@gnu.org; Thu, 04 May 2017 11:32:47 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59287)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d6IkC-0003Da-4t
	for groff@gnu.org; Thu, 04 May 2017 11:32:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1d6Ik8-0007CE-Rx
	for groff@gnu.org; Thu, 04 May 2017 11:32:40 -0400
Received: from mail.cs.dartmouth.edu ([129.170.212.100]:52196)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <doug@cs.dartmouth.edu>)
	id 1d6Ik8-0007Bf-OQ
	for groff@gnu.org; Thu, 04 May 2017 11:32:36 -0400
Received: from coolidge.cs.Dartmouth.EDU (coolidge.cs.dartmouth.edu
	[129.170.213.217])
	by mail.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTPS id v44FWY8G011046
	(version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO)
	for <groff@gnu.org>; Thu, 4 May 2017 11:32:34 -0400
Received: from coolidge.cs.Dartmouth.EDU (localhost.localdomain [127.0.0.1])
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2) with ESMTP id
	v44FWX7V026767 for <groff@gnu.org>; Thu, 4 May 2017 11:32:33 -0400
Received: (from doug@localhost)
	by coolidge.cs.Dartmouth.EDU (8.15.2/8.15.2/Submit) id v44FWXMx026766
	for groff@gnu.org; Thu, 4 May 2017 11:32:33 -0400
From: Doug McIlroy <doug@cs.dartmouth.edu>
Message-Id: <201705041532.v44FWXMx026766@coolidge.cs.Dartmouth.EDU>
Date: Thu, 04 May 2017 11:32:33 -0400
To: groff@gnu.org
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 129.170.212.100
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 15:32:46 -0000

It would be well to have the Linux manpages project on board for man macro
discussions. Is anyone from that project on this mailing list?

If not, they should probably be invited to participate. A job for Peter Shafter?

Doug



From MAILER-DAEMON Thu May 04 12:43:53 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6Jr7-0004Mq-33
	for mharc-groff@gnu.org; Thu, 04 May 2017 12:43:53 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54344)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <esr@thyrsus.com>) id 1d6Jr4-0004Mh-32
	for groff@gnu.org; Thu, 04 May 2017 12:43:51 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <esr@thyrsus.com>) id 1d6Jr0-0002zq-V3
	for groff@gnu.org; Thu, 04 May 2017 12:43:50 -0400
Received: from static-71-162-243-5.phlapa.fios.verizon.net
	([71.162.243.5]:42322 helo=snark.thyrsus.com)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <esr@thyrsus.com>) id 1d6Jr0-0002y1-QL
	for groff@gnu.org; Thu, 04 May 2017 12:43:46 -0400
Received: by snark.thyrsus.com (Postfix, from userid 1000)
	id 2C04913A021A; Thu,  4 May 2017 12:43:45 -0400 (EDT)
Date: Thu, 4 May 2017 12:43:45 -0400
From: "Eric S. Raymond" <esr@thyrsus.com>
To: Doug McIlroy <doug@cs.dartmouth.edu>
Cc: groff@gnu.org
Message-ID: <20170504164345.GA18230@thyrsus.com>
Reply-To: esr@thyrsus.com
References: <201705041532.v44FWXMx026766@coolidge.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201705041532.v44FWXMx026766@coolidge.cs.Dartmouth.EDU>
Organization: Eric Conspiracy Secret Labs
X-Eric-Conspiracy: There is no conspiracy
User-Agent: Mutt/1.5.24 (2015-08-30)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 71.162.243.5
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 16:43:51 -0000

Doug McIlroy <doug@cs.dartmouth.edu>:
> It would be well to have the Linux manpages project on board for man macro
> discussions. Is anyone from that project on this mailing list?
> 
> If not, they should probably be invited to participate. A job for Peter
> Shafter?

I believe I was the last person to modify the Linux man page macros.
Their current maintainer is not the kind of groff expert to whom it
would occur to modify them; it would work as well to ask me questions
and ask me to push changes through to the project repo, probably.
-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>

Please consider contributing to my Patreon page at https://www.patreon.com/esr
so I can keep the invisible wheels of the Internet turning. Give generously -
the civilization you save might be your own.



From MAILER-DAEMON Thu May 04 14:07:45 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6LAH-0000tW-28
	for mharc-groff@gnu.org; Thu, 04 May 2017 14:07:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:45022)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <cjwatson@debian.org>) id 1d6LAE-0000rw-CM
	for groff@gnu.org; Thu, 04 May 2017 14:07:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <cjwatson@debian.org>) id 1d6LAB-0000BV-6g
	for groff@gnu.org; Thu, 04 May 2017 14:07:42 -0400
Received: from a-painless.mh.aa.net.uk ([81.187.30.51]:42094)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <cjwatson@debian.org>) id 1d6LAB-0000BD-0W
	for groff@gnu.org; Thu, 04 May 2017 14:07:39 -0400
Received: from
	3.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.4.1.b.e.2.f.f.b.0.b.8.0.1.0.0.2.ip6.arpa
	([2001:8b0:bff2:eb14::3] helo=riva.pelham.vpn.ucam.org)
	by a-painless.mh.aa.net.uk with esmtps
	(TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2)
	(envelope-from <cjwatson@debian.org>) id 1d6LAA-0002vq-2c
	for groff@gnu.org; Thu, 04 May 2017 19:07:38 +0100
Received: from ns1.pelham.vpn.ucam.org ([172.20.153.2] helo=riva.ucam.org)
	by riva.pelham.vpn.ucam.org with esmtp (Exim 4.84_2)
	(envelope-from <cjwatson@debian.org>) id 1d6LA0-0007rW-9p
	for groff@gnu.org; Thu, 04 May 2017 19:07:28 +0100
Date: Thu, 4 May 2017 19:07:28 +0100
From: Colin Watson <cjwatson@debian.org>
To: groff@gnu.org
Message-ID: <20170504180728.GA10838@riva.ucam.org>
Mail-Followup-To: groff@gnu.org
References: <20170424150155.f5rga35izh775vxs@crack.deadbeast.net>
	<20170424152237.93942201ED@orac.inputplus.co.uk>
	<20170424154119.c7h6zozyivnoafa7@crack.deadbeast.net>
	<20170424162957.GC47874@athene.usta.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170424162957.GC47874@athene.usta.de>
User-Agent: Mutt/1.5.23 (2014-03-12)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 81.187.30.51
Subject: Re: [Groff] Nesting font macros in man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 18:07:43 -0000

On Mon, Apr 24, 2017 at 06:29:57PM +0200, Ingo Schwarze wrote:
> There is little you can do to make writing legacy man(7) code
> easier for the novice.  The problem is that it always requires
> mixing two different language levels:  man(7) macros and low-level
> roff requests and escapes.  And that it also requires writing
> physical rather than semantic markup, which is obviously harder
> to do in a consistent manner.
> 
> Writing mdoc(7) is much easier for the novice because it's semantic
> and because it does not require mixing in low-level roff features.
> But trying to make man(7) easier to write is bound for disaster.
> The only remaining asset of man(7) is portability,

The main practical reason I've stuck with man(7) in some cases (such as
in man-db) despite generally preferring mdoc(7) is that I think
translations are important, and po4a(1) works rather more gracefully
with man(7).  With mdoc(7), I find that I end up with nonsense like this
in my .pot file, which I really can't expect a translator to have the
slightest clue about:

  #. type: Plain text
  #: madison-lite.1:21
  msgid ""
  "E<.Nm> E<.Op Fl Fl config\\-file Ar file> E<.Op Fl Fl mirror Ar directory> "
  "E<.Op Fl Fl nocache> E<.Op Fl Fl update> E<.Op Fl S> E<.Op Fl r> E<.Op Fl a "
  "Ar architecture Ns Op , Ns Ar ...> E<.Op Fl c Ar component Ns Op , Ns Ar "
  "...> E<.Op Fl s Ar suite Ns Op , Ns Ar ...> E<.Ar package> E<.Op Ar ...>"
  msgstr ""

Locale::Po4a::Man(3pm) does offer some ways to hit this over the head,
but they don't really work very well in practice, I think because it
doesn't understand the way that mdoc(7) parses its argument list for
callable macro names.  An understandable omission given the complexity,
but it does end up being a blocker for me.

This is of course not a deficiency in *roff, but it's a problem in the
wider ecosystem that IMO a serious push towards mdoc(7) ought to
address.

-- 
Colin Watson                                       [cjwatson@debian.org]


From MAILER-DAEMON Thu May 04 17:01:11 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6Ns7-0003xo-91
	for mharc-groff@gnu.org; Thu, 04 May 2017 17:01:11 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:52958)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d6Ns4-0003xK-Jw
	for groff@gnu.org; Thu, 04 May 2017 17:01:09 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d6Ns3-0001hH-7b
	for groff@gnu.org; Thu, 04 May 2017 17:01:08 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:50540)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d6Ns2-0001eJ-UE
	for groff@gnu.org; Thu, 04 May 2017 17:01:07 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d6Nrz-0005rc-DO; Thu, 04 May 2017 23:01:04 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d6Nry-0007Ex-VZ; Thu, 04 May 2017 23:01:02 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d6Nry-0004Yd-R0; Thu, 04 May 2017 23:01:02 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 73ec8e58;
	Thu, 4 May 2017 23:01:02 +0200 (CEST)
Date: Thu, 4 May 2017 23:01:02 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: Colin Watson <cjwatson@debian.org>
Cc: groff@gnu.org
Message-ID: <20170504210102.GA90154@athene.usta.de>
References: <20170424150155.f5rga35izh775vxs@crack.deadbeast.net>
	<20170424152237.93942201ED@orac.inputplus.co.uk>
	<20170424154119.c7h6zozyivnoafa7@crack.deadbeast.net>
	<20170424162957.GC47874@athene.usta.de>
	<20170504180728.GA10838@riva.ucam.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170504180728.GA10838@riva.ucam.org>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Nesting font macros in man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2017 21:01:10 -0000

Hi Colin,

Colin Watson wrote on Thu, May 04, 2017 at 07:07:28PM +0100:

> The main practical reason I've stuck with man(7) in some cases
> (such as in man-db)

Actually, for man-db, the choice of man(7) is somewhat understandable,
since man-db is most relevant in situations where mandoc(1) is not
available or not wanted, and that maybe correlates with a certain
bias against mdoc(7).

> despite generally preferring mdoc(7) is that I think translations
> are important,

In general, i think that translation of documentation is harmful
rather than useful.  Normally, even freshly translated documents
are of lower quality than the original, so readers are usually
better off reading the original than the translation, even if their
command of the english language is weaker.  Over time, translated
documentation almost always gets outdated, at which point it is
definitely very harmful.  I do not think that it is plausible that
tools like po4a will change that.  Even if you had the perfect
translation toolkit, maintaining translations is an awful lot of
work, more than (work for maintaining the original) times (number
of languages to be maintained).  In practically every real-world
project, that kind of manpower definitely isn't available.  In most
projects, even the original manual pages are poorly maintained,
so adding a multiple of that work is out of the question.

While *theoretically*, translation of documentation might be an
interesting idea, the consequence of the above observations is
that i have never encountered any project where translation of
manual pages was even attempted (not even to one single language).

Even FreeBSD never attempted that, even though that's quite a
large project.

> and po4a(1) works rather more gracefully with man(7).
> With mdoc(7), I find that I end up with nonsense like this
> in my .pot file, which I really can't expect a translator to have the
> slightest clue about:
> 
>   #. type: Plain text
>   #: madison-lite.1:21
>   msgid ""
>   "E<.Nm> E<.Op Fl Fl config\\-file Ar file> E<.Op Fl Fl mirror Ar directory> "
>   "E<.Op Fl Fl nocache> E<.Op Fl Fl update> E<.Op Fl S> E<.Op Fl r> E<.Op Fl a "
>   "Ar architecture Ns Op , Ns Ar ...> E<.Op Fl c Ar component Ns Op , Ns Ar "
>   "...> E<.Op Fl s Ar suite Ns Op , Ns Ar ...> E<.Ar package> E<.Op Ar ...>"
>   msgstr ""

That's obviously from a SYNOPSIS.

I don't think it's a good idea to translate anything in a SYNOPSIS.

The point of the SYNOPSIS is documenting the subtleties of the syntax,
and the risk of breaking the syntax in the process of translation
seems too high.

> Locale::Po4a::Man(3pm) does offer some ways to hit this over the head,
> but they don't really work very well in practice,

That doesn't really come as a surprise.  Translation operates on text,
not on formal syntax descriptions.

> I think because it doesn't understand the way that mdoc(7) parses
> its argument list for callable macro names.  An understandable
> omission given the complexity,

I think because of the blocker above - which could probably be solved
by excluding some parts from translation - you have missed the main
problems.  Consider typical manual page text like the following
from the mandoc eqn(7) manual:

  .It Cm sup
  Set the following box as a superscript to the preceding box.
  As a special case, if a
  .Cm sup
  clause immediately follows a
  .Cm sub
  clause as in
  .Pp
  .D1 Ar mainbox Cm sub Ar subbox Cm sup Ar supbox
  .Pp
  both are set with respect to the same
  .Ar mainbox ,
  that is,
  .Ar supbox
  is set above
  .Ar subbox .

That is *one* paragraph (even one sentence), not three paragraphs,
in spite of the two .Pp macros.  So it has to be translated as one
unit.  How is po4a supposed to figure that out?

Next problem: assume we tell translators:  you must never
translate parts enclosed in <<<...>>> (or some other, conspicious
markers to be agreed upon), and you must never change the order
of instances of these (the latter may cause trouble in some
languages, but let's ignore that for a second).  Then the
above paragraph would ideally translate into something like this:

  <<<.It Cm sup
  >>>Set the following box as a superscript to the preceding box.
  As a special case, if a<<<
  .Cm sup
  >>>clause immediately follows a<<<
  .Cm sub
  >>>clause as in<<<
  .Pp
  .D1 Ar >>>mainbox<<< Cm sub Ar >>>subbox<<< Cm sup Ar >>>supbox<<<
  .Pp
  >>>both are set with respect to the same<<<
  .Ar >>>mainbox ,<<<
  >>>that is,<<<
  .Ar >>>supbox<<<
  >>>is set above<<<
  .Ar >>>subbox .

The <<<...>>> scheme proposed here is similar in spirit to the
B<>/I<> scheme used by po4a, but the latter is inadequate for
mdoc(7) because it is too simplistic, so i had to somehow
generalize it.  The tool would check that the translator indeed
left the <<<...>>> unmangled.  Also note that line breaks are
critically significant in mdoc(7), so po4a must *never* do any
folding.

Is something like the above editable for translators?
I'm not sure, but i doubt that much can be simplified.

Besides, should placeholders (.Ar, .Fa, ...) be translated?
If yes, they may also appear unmarked in free text, and the
translation must be consistent, which is likely to fail.  If no,
errors are less likely, but the text might seem harder to end-users.
Or maybe even go a step further an not translate anything on any
macro lines?  That would be safer and simpler, but would occasionally
leave a word that should
.Em really
be translated (like stress emphasis) untranslated.

> but it does end up being a blocker for me.
> 
> This is of course not a deficiency in *roff, but it's a problem in the
> wider ecosystem that IMO a serious push towards mdoc(7) ought to
> address.

If there is a substantial project that wants to do translation,
working through all this would be a serious undertaking.  If some
project *really* wants to do that (and can make it plausible that
they do have the manpower for at least one language), i might
consider helping, even though i expressed serious doubt about the 
usefulness, above.

The point is, unless one seriously tries, doubting the usefulness
is as much conjecture as asserting it.  The outcome of such a
project would supply one real-world data point strengthening either
side of the argument, and the resulting software would make it easier
for others to gather more data points.

Yours,
  Ingo


From MAILER-DAEMON Thu May 04 23:07:46 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6Tas-0004Ss-A3
	for mharc-groff@gnu.org; Thu, 04 May 2017 23:07:46 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56297)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=qbzhcn=4L=schaffter.ca=peter@eigbox.net>)
	id 1d6Tap-0004Sl-Ri
	for groff@gnu.org; Thu, 04 May 2017 23:07:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=qbzhcn=4L=schaffter.ca=peter@eigbox.net>)
	id 1d6Tam-0000rN-Nb
	for groff@gnu.org; Thu, 04 May 2017 23:07:43 -0400
Received: from bosmailout04.eigbox.net ([66.96.186.4]:55756)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71)
	(envelope-from <SRS0=qbzhcn=4L=schaffter.ca=peter@eigbox.net>)
	id 1d6Tam-0000qY-Dk
	for groff@gnu.org; Thu, 04 May 2017 23:07:40 -0400
Received: from bosmailscan14.eigbox.net ([10.20.15.14])
	by bosmailout04.eigbox.net with esmtp (Exim) id 1d6T6R-0007as-HR
	for groff@gnu.org; Thu, 04 May 2017 22:36:19 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
	d=schaffter.ca; s=dkim; h=Sender:In-Reply-To:Content-Type:MIME-Version:
	References:Message-ID:Subject:To:From:Date:Reply-To:Cc:
	Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:
	Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:
	List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive;
	bh=tLCEmxhDunCwl1eveHSC6AJmxaKMrYwhiMddMdRFneU=;
	b=fATvVP6l8sEltCNCzSNqXtLk4
	ZX3UdoFYgtfhPwTmOdMurcJBj2obgwom7EVq7zqWLcdvcA6HNa/U0o5PO5YR8B2qw9E4V68cBAn5g
	Gb2w8ZEOjusp7cHmyqAM/G+6e7MMABpBkT0aha5IgXNwjbNtXHjf7KOG/R1lodR9XZ5L25ll/c2Ke
	gjh+kyefngq3iYgkr398CITYjayZUFs5MSVucbu0TyQJi6x05iE7X1Z/HztST6GXCKuT9tAvDtEv6
	MxWGEV84dXoOFMJruOGCNQohGxSxm0WhXMfpEjQud00iILzbn9yfoECdiH/sVwKysTmH/0HXYyBE5
	jgSqHRTbA==;
Received: from [10.115.3.32] (helo=bosimpout12)
	by bosmailscan14.eigbox.net with esmtp (Exim) id 1d6T6R-0003uK-Dz
	for groff@gnu.org; Thu, 04 May 2017 22:36:19 -0400
Received: from bosauthsmtp14.yourhostingaccount.com ([10.20.18.14])
	by bosimpout12 with 
	id GScD1v0010JCtq201ScGNk; Thu, 04 May 2017 22:36:19 -0400
X-Authority-Analysis: v=2.1 cv=J5Ak7WXS c=1 sm=1 tr=0
	a=AnsiuLKgxXFeB68GILQVjQ==:117 a=0QrQcZiP8N+icOEogWXBJg==:17
	a=L9H7d07YOLsA:10 a=9cW_t1CCXrUA:10 a=s5jvgZ67dGcA:10 a=kj9zAlcOel0A:10
	a=tJ8p9aeEuA8A:10 a=g_SW5-S5AAAA:8 a=f4itC3coQ8R6cvj7Jr4A:9
	a=CjuIK1q_8ugA:10 a=zQDKbV1y6e_a9NbkwXG_:22
Received: from [206.47.117.66] (port=61587 helo=augustus)
	by bosauthsmtp14.eigbox.net with esmtpsa
	(TLSv1.2:DHE-RSA-AES128-SHA:128) (Exim) id 1d6T6L-0007yC-5G
	for groff@gnu.org; Thu, 04 May 2017 22:36:13 -0400
Received: from peter by augustus with local (Exim 4.82)
	(envelope-from <peter@schaffter.ca>) id 1d6T6J-0003Qk-DG
	for groff@gnu.org; Thu, 04 May 2017 22:36:11 -0400
Date: Thu, 4 May 2017 22:36:11 -0400
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20170505023611.GB12847@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <201705041532.v44FWXMx026766@coolidge.cs.Dartmouth.EDU>
	<20170504164345.GA18230@thyrsus.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170504164345.GA18230@thyrsus.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:931c98230c6409dcc37fa7e93b490c27
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 206.47.117.66
X-EN-OrigHost: unknown
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 66.96.186.4
Subject: Re: [Groff] ASCII Minus Sign in man Pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 05 May 2017 03:07:44 -0000

On Thu, May 04, 2017, Eric S. Raymond wrote:
> Doug McIlroy <doug@cs.dartmouth.edu>:
> > It would be well to have the Linux manpages project on board for man macro
> > discussions. Is anyone from that project on this mailing list?
> > 
> > If not, they should probably be invited to participate. A job for Peter
> > Shafter?
> 
> I believe I was the last person to modify the Linux man page macros.
> Their current maintainer is not the kind of groff expert to whom it
> would occur to modify them; it would work as well to ask me questions
> and ask me to push changes through to the project repo, probably.

Notwithstanding, I've alerted the linux-manpages list.  We tend
to go round and round on manpage debates.  A little fresh blood
might be useful.  At the very least, they should be au courant about
proposed changes, even if they're not the people to implement them.

-- 
Peter Schaffter
http://www.schaffter.ca


From MAILER-DAEMON Fri May 05 11:52:23 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6fWp-00086a-Dm
	for mharc-groff@gnu.org; Fri, 05 May 2017 11:52:23 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50579)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6fWm-00086S-HU
	for groff@gnu.org; Fri, 05 May 2017 11:52:22 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6fWi-0001sj-Eq
	for groff@gnu.org; Fri, 05 May 2017 11:52:20 -0400
Received: from mail-qk0-x236.google.com ([2607:f8b0:400d:c09::236]:35290)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d6fWi-0001sI-9P
	for groff@gnu.org; Fri, 05 May 2017 11:52:16 -0400
Received: by mail-qk0-x236.google.com with SMTP id q1so8760677qkd.2
	for <groff@gnu.org>; Fri, 05 May 2017 08:52:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=sCXUOoRrzqUKYOVB3g/e/J7PUfCmoeTQAug5RNDOoB0=;
	b=PYNNZ25kroX+BTv0e0wVHZFqfyR9fycRAXDZ+AeWAnSx0l0q5pyxuYtE9RouLiHIyN
	SFLZaW5z0Q/vNjaBy+QQlnfXEZsFOwm3rM1EASzgd0+I7PM+xFJfBXhKBg5fOswk4wIY
	2nN4d5CifY/6nrdSxSql7U1LtCfTs4yTtecadlyP8OWllO1TLiYUJF0roYgi9MBite0M
	NFGlHFabzIVUo/A90cuNT4i1DRv7lvWQdndbOv2SPhhTWclWTD88KgfbCm5zS3zkRNTZ
	PNKwQoBmGgI5S/VHG8bT9dqHvd/d2tk1iyLTImaqwyale/wQesJIdqdza7LcTLChOQMj
	vFwQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=sCXUOoRrzqUKYOVB3g/e/J7PUfCmoeTQAug5RNDOoB0=;
	b=bTjlFWru5hMacm3hMquD2Jsy4seaeOqXykj2RHjQx2jLQgsVS/6mmFmapyws00Fvr2
	dmRXLsZmtukYGXPKV5t4KsY74Bb07coeSIm1l5r1bvbh0k30zyaBvt9o5QQXrGxZ+32o
	N1PHLUCD5I1Kw785y1ISAl3wkIYD/4i3raGvxZKwChmpV58ifPdmGY0n0N2b/ZTbonf3
	yE92ol67qHHoAjhBhJ2CcUq7IRH1WGozw6GpCBhoFBBRPJ78wQjJ+L1fx3cbIzy0P2XK
	hdywbCG5ZWnKWKjMLLQcbnleX/eqaWdld36To4YWStmrZxaJz4uXiDgcVO3smNNKLTsZ
	QD6w==
X-Gm-Message-State: AN3rC/5PHaQNjTAWk5hZHZY77BrYuaB9SJAIblKL9UMFPYndFX0RShQN
	8K6X84/QqXlrtGps934=
X-Received: by 10.55.20.161 with SMTP id 33mr12713882qku.321.1493999533593;
	Fri, 05 May 2017 08:52:13 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100])
	by smtp.gmail.com with ESMTPSA id t45sm3758774qtt.9.2017.05.05.08.52.11
	for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Fri, 05 May 2017 08:52:12 -0700 (PDT)
Date: Fri, 5 May 2017 11:52:09 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170505155208.bhnt5nafqwaan5dd@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
	<20170503230448.GB57799@athene.usta.de>
	<20170504005239.o5qchr6snzv4yagu@crack.deadbeast.net>
	<20170504092409.1A03221541@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="j2i355owvqt2itbi"
Content-Disposition: inline
In-Reply-To: <20170504092409.1A03221541@orac.inputplus.co.uk>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::236
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 05 May 2017 15:52:22 -0000


--j2i355owvqt2itbi
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hi Ralph,

I think some context might have gotten lost.  As I said at the outset of
this thread, my opinions about the portability of this ".BOLD-ITALIC"
macro are _strictly confined_ to the writing of a non-groff man page for
a highly specialized package that in practice just does not get
installed in legacy environments.

At 2017-05-04T10:24:09+0100, Ralph Corderoy wrote:
> Hi Branden,
>=20
> > Ingo wrote:
> > > There are real-world systems (sold today) where neither \(lq nor the
> > > 'c' conditional is supported.
>=20
> And I know from experience that they become much more palatable after
> building source for better versions of their binaries, and adding new
> programs they don't have.  That source builds, and man pages format, on
> these POSIX systems is a real benefit to those stuck using them.  And
> `install groff' isn't an answer because permission often needs to be
> sought for each.

While thanks to Autoconf, many GNU (and non-GNU) packages--including
groff--build, install, and work just fine with --configure=3D$HOME, I
agree with you.

Tools targeting legacy systems, including GNU tools, should be highly
mindful of portability.

Similarly, there are multiple levels of shell script portability:

1.  You can write to the conventions of a particular shell, and
    preferably document that.  For instance, in my Bash startup files I
    have a conditional like this:
			# Load my shell functions.
			if [ ${BASH_VERSINFO[0]} -ge 3 ]; then
			    . "$HOME"/.${USER}_lib_bash
			else
			    . "$HOME"/.${USER}_lib_bash2
			    warn "very old Bash: $BASH_VERSION"
			fi

2.  You can write to the IEEE/POSIX standard shell.

3.  You can write for maximum portability, forgoing many POSIX features
    and resigning yourself to obfuscated and/or pretzel-like
    constructions to get the functionality you want.  See:
      https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2=
=2E69/html_node/Portable-Shell.html

Autoconf macros and supporting shell scripts are written at level 3
because they have to be, otherwise they lose the plot.

This absolutely, emphatically does not mean that everyone should always
be writing their shell scripts in that lowest-common-denominator,
most-portable dialect.  In fact, doing so makes scripts harder to read,
understand, and maintain.

Personally, I prefer to write in militantly portable POSIX shell unless
the problem domain absolutely screams for a Bash feature.  And if that
keeps happening in the same script (or group thereof), for multiple
features, I start considering if I shouldn't be writing in, say, Python
instead.

In my opinion, a big problem with man page portability is that we don't
have categories as well-defined as those for the shell, above.

A.  There does not exist a document describing many of the bugs and
    caveats in legacy *roff and man macro package implementations that
    a conscientious man page writer needs to know.
B.  *roff (and therefore the macro packages based thereupon) are not
    formally standardized.  I just now re-checked
      http://pubs.opengroup.org/onlinepubs/9699919799/
    to be sure.
C.  Even the very conditional construct we might use in-language to
    test for the availability of features and the identity of
    implementations becomes non-portable if we try to apply it to that
    goal.

> > Why do my man pages need to be more portable the shell scripts or C
> > code I ship with them?
>=20
> Yours don't, but don't constrain the rest of us, or lead us astray with
> non-portable -man extensions that will just increase the problems on
> systems you don't use.

I'm not attempting to constrain anyone else, or lead anyone astray with
what I said in the thread title was a _private_ macro.

My objective in starting this thread was to get expert opinion on
whether the macro was written well or badly, from an audience of *roff
experts.

> > I refuse to write shell scripts for general-purpose consumption only
> > in the historical Bourne dialect that Solaris /bin/sh was
>=20
> Again, that's your choice.  Many of us go to the effort of writing
> portable code, and coping with the issues from those using it on less
> common systems, including proprietary ones.

I value portability intensely as well.  However, the portability of a
software package is often constrained by multiple factors.  To my view,
it makes no sense to write a man page for a software package to a lower
common denominator than is supported by the environments demanded by the
rest of the package.

The macro I set forth in this thread is for a non-groff, non-GNU
package.  I wanted to know if I had written it competently.

If there existed a groff-help mailing list (or better yet, roff-help), I
would have used it.

> > and I refuse to write man pages for general-purpose consumption only
> > in some minimal common subset that _no one_ has troubled themselves to
> > carefully define.
>=20
> If your viewpoint is "it's Linux, Mac OS X, or BSD, or it doesn't exist"
> then I don't think it counts for much in considering changes to groff,
> -man, mdoc, etc., that have a wider impact.

How many times do I have to emphasize that the "bold italic" macro I
pitched in this thread is *** NOT *** something I intend to propose as a
change to groff, man, or mdoc?

You're welcome to disregard my views as a (new) groff contributor, but
you won't do any of us any good if you impute to me attitudes I do not
possess.  Please do me the courtesy of evaluating proposals I actually
make based on principles I actually espouse.

Regards,
Branden

--j2i355owvqt2itbi
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkMn58ACgkQ0Z6cfXEm
bc5LHxAAqeLTU5WDVgEweIm8aQ43gprJWLJL0QB6w5xpPksIgjAcDiDooY/mUJg7
E/hXcVDIzMAZwwdpZR7P9RyUzBqMHA5brPU1MWYLsN1qQhK0346qI4isEQqLajhk
HV7v/0rkKDRG7ng85knZFIvs0l4sbW0bOzTbxkIF/+K8kVeKbeziI3sKsLYVlnFp
3zn1xpR4yarQB/qFH3APE2yuxBcUbWSoA8ozhjFNFYdGGwiUZSLV4mK6Bao/Ruyr
vwwTZi4tPCpk3xelr93UujE8fFmM5fmLcqoRSFceImB1bvMMns8fdgTviRiIBdoO
Mz0tbG8kjX/YhQ8iHBPs29ePKBiloRbXPEp2B77xoO/HreyBy1mz7Gmk+mskovlb
8SbIWkfwZ64YfvRQ0gy0qc112Fe6S8iy33XX9deMjesYsBx5mu3bSIyifmDngW0p
bFP2Cde5Jqz6aHdbQiUAYa7QYLQnObOGD0ZFmYSgBXrGVzzb+HvSaXaRrUCtbbVz
x5DuC9vXym/Se5eLiUuYK54PhIN3ADlLTibL79d81bDQJA33QxCEca/YrBRe9KXF
/SZe54PgnjZeW4BpY7BOQ/gnswFDGujjENJu9CdCmRTNGmDrkt+REFOfdF8oQxkc
NSLWzyn3F+3CKHYOeS1iQX4wz8LNDgADz+hTaCCwm608yVQzE+M=
=xaGJ
-----END PGP SIGNATURE-----

--j2i355owvqt2itbi--


From MAILER-DAEMON Fri May 05 12:26:44 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6g44-0005MU-9P
	for mharc-groff@gnu.org; Fri, 05 May 2017 12:26:44 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:58400)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6g41-0005Lt-Pf
	for groff@gnu.org; Fri, 05 May 2017 12:26:42 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6g3y-0001ic-Ky
	for groff@gnu.org; Fri, 05 May 2017 12:26:41 -0400
Received: from mail-qk0-x230.google.com ([2607:f8b0:400d:c09::230]:36688)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d6g3y-0001iR-GF
	for groff@gnu.org; Fri, 05 May 2017 12:26:38 -0400
Received: by mail-qk0-x230.google.com with SMTP id u75so9513612qka.3
	for <groff@gnu.org>; Fri, 05 May 2017 09:26:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=aYF4XaeubKrzDIRqLqA1w1i5FiLxVQg15v9xY7DdCj8=;
	b=sl8yLl+XSMMRohJTrIX8zjKTECRxh5GJQ1CM6TyzvewptSeiLDr/9WHArq8QTenXp2
	OY+Hs9IlnTiomQm5m/MEg0M0+Iohu1jrX7atJJn1dVZCvFFL+/GrO9S8oaODKwd/wWpq
	Pkk8BqgvK6dNqhIpcbIwAOiQlQFNKOC1bJ8XimpAszz2yBPvqnaE0fLLscxjUUUHkafP
	gVNpxX4BjgBwAcxsCqiwB/GA+daH8yPlVs4KywyWSpbMA6SS+uzEX3f9Km+fHfw5M0mZ
	aAn1yBAOlygB5REvor3GFW8uNSlq5Hwg6Bb4eavvR0eKj9Iv+pdFqJ95OkBfHmKCg+6a
	yccA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=aYF4XaeubKrzDIRqLqA1w1i5FiLxVQg15v9xY7DdCj8=;
	b=GGip3mF/1sAljweUpu8blFe5xg2mtoXr0xOLKpAfTfg1lDIvrbE9mQLpLNZblYbV8B
	yG5W4pPlLIPCxUrolkr2RLAId9o+9i7FJP54zKzeVf1TRvae3XTxixBra4TEYwZTVTeU
	AubKggP42lMpCnato2koVT6ZhemUzspXCQT41nJxPQs2yYGf06wLqMfbtBbzoUgMH5zB
	+U3RD/RSGLwOgWuMyswlvcrzKt4L8kHNjSHR9hDqy3Tl4z+PiZzkYKp5W9mCLWUQAakI
	IuXI05gwTGaWhsJbwLm78tD+cX3JZFCA9r6uWct2kHmF11Igv+BPESg0fpqUeRwC9u1g
	yJtg==
X-Gm-Message-State: AODbwcAyzpaIkLpNQfwXpl/sZAMNQEyniPHoF7mrrBLj8s5DWoUlX29J
	qsxizIdwkE4AQd7/1/E=
X-Received: by 10.55.210.4 with SMTP id f4mr3506793qkj.266.1494001597637;
	Fri, 05 May 2017 09:26:37 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100])
	by smtp.gmail.com with ESMTPSA id 94sm3918722qte.37.2017.05.05.09.26.35
	for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Fri, 05 May 2017 09:26:35 -0700 (PDT)
Date: Fri, 5 May 2017 12:26:33 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: Groff <groff@gnu.org>
Message-ID: <20170505162631.eci3qrjpbcuetvxa@crack.deadbeast.net>
References: <20170429102527.u4plfi33hhcelbkc@crack.deadbeast.net>
	<20170502174750.GA8003@rhi.hi.is>
	<20170502230240.7lpdzeqcujkzxrpm@crack.deadbeast.net>
	<508133548.253388.1493825081893@mail.vodafone.de>
	<20170503153000.x54qxnqhxqrwfhjn@crack.deadbeast.net>
	<1512443572.281651.1493840242048@mail.vodafone.de>
	<20170503204718.ubtww4ams7qfkmzk@crack.deadbeast.net>
	<83632314.282798.1493848265277@mail.vodafone.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="hai5xlpypnlw636r"
Content-Disposition: inline
In-Reply-To: <83632314.282798.1493848265277@mail.vodafone.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::230
Subject: Re: [Groff] Critique this bold-italic private macro for man pages
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 05 May 2017 16:26:42 -0000


--hai5xlpypnlw636r
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

At 2017-05-03T23:51:05+0200, Carsten Kunze wrote:
> Short answer:  We should differ manpages and other typesetting.

I don't know if this a tenable position.  I agree with several of your
recommendations, but man was never implemented with the capability or
the desire to limit the expressiveness of the input file.  *roff
requests and preprocessors were always available.  That horse was out of
the barn on day one, forty-odd years ago.

> Manpages should use the -man or -mdoc macros itself with as few as
> possible low level requests or escapes.

I agree with this as a goal; I think the .it -> itc change was a good
one precisely because it enables this.  With that change, there is no
font-change-related outcome in a man page that can be achieved with
font escapes that cannot be achieved with man macros--as long as one
does not desire to use a font that man did not historically support.

At the risk of stating the obvious, font changes in man pages are
ubiquitous because they are the primary and nearly exclusive convention
for distinguishing running prose from typed literals and substitutions
(variables).

Man has 3 typefaces to offer us, and in a command synopsis or function
signature we use all three:

1. bold for literal text to be typed or input as-is;
2. italics for replaceable, user-determined text;
3. roman for non-literal symbols in a mini-language that tells the
   reader which pieces of text are optional, must be selected from a
   set, or may be repeated.

> If there is an ancient system with an old *roff tool, this tool should
> be replaced.

I'm having trouble reconciling your and Ralph's opinions here; I may
have to pick sides.  ;-)

> To answer your question:  Simply use \(lq etc. (in manpages) and
> assume the tool supports it.

I find it hard to agree.  Undefined character escapes expand to nothing
and that's seldom going to be satisfactory to conscientious writers who
care about the result.

Such people are going to want their man pages to render in some
satisfactory way whether the formatter is GNU Troff or Version 7 troff
or something else.

How can we better accommodate these people?

Regards,
Branden

--hai5xlpypnlw636r
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkMp6sACgkQ0Z6cfXEm
bc5tHQ//anZAkSqKpmvK5xYP1p3gwCRCyhIRg344W+1HstCotHTK9z1ovU/+mJuP
61U+8YP9iyAyb759S10IsYGB2dKUAIVAl05Rug1l9AKxqfe19SOeCg3n9xNjJKMC
TrhOJafmlY478GT44wN9Vypvm+VSKnIvSx/w5l48lKtrzGKd7EN91fd0niE/7SRQ
0kcOrPaNMILbzgG0pbFs6g+nx/8Gw7MjtX9KwCf8SdSp0cq0bdxBVmSd+2HjlYz4
bzgkHm881xfsyfcYeXSdWVeQEyMJ8hI5MPRfnPDixuj90OnSdS09Yx4qMYpj34lI
ayYHaVBTSRiIVD6hOK1/gszA9ch3zJazG2n/qXwYA7UsMrOcFQsdmDzzmoq4dJuR
+e616Z7SgrunzsYhF5fEzkQwbnvqBSECDFUKF8obAw7Vd1S2MLTZljbLu6iC6FVJ
7MTazENlLsgMaYGTXhCKenLAU+/RLZ0YP5dW6O7DPjsTPnxZBzzS5/q2KfBEbFBO
jX/cf6GCt+tpO6j9tx1P880yzUXcyPOZFVVvcD1aVDb+HPVXsiq4QP8zc/Ipazw4
13EWYzqB3T4YCmU4ZrfSCAWmfgFhAycwXE2LCWovgSVvMOF9QdcFmY0np49F3mke
QylO0Lxh2JmIEzlhbox2C205RY4RNCdo1iKQ8nq+tUvw4rigFB8=
=X4Kz
-----END PGP SIGNATURE-----

--hai5xlpypnlw636r--


From MAILER-DAEMON Sat May 06 00:31:03 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d6rN1-00056X-AD
	for mharc-groff@gnu.org; Sat, 06 May 2017 00:31:03 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48259)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6rMx-00054D-Im
	for groff@gnu.org; Sat, 06 May 2017 00:31:01 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1d6rMt-0006HG-Gw
	for groff@gnu.org; Sat, 06 May 2017 00:30:59 -0400
Received: from mail-qk0-x231.google.com ([2607:f8b0:400d:c09::231]:34105)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1d6rMs-0006Fw-Rt
	for groff@gnu.org; Sat, 06 May 2017 00:30:55 -0400
Received: by mail-qk0-x231.google.com with SMTP id k74so20082043qke.1
	for <groff@gnu.org>; Fri, 05 May 2017 21:30:54 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:mime-version:content-disposition
	:user-agent; bh=z9n3hOUKboUlhqOnroYsTDLG9LUFT+RlDvwsRoHnRak=;
	b=SG1h7Mpd7G9aYZpC4TvcD1e8jPy5jAp7CS8D0zf3ibUJSpfvaGZBw6kwixaiaDvoD9
	kiFBRsRqBLdXT6JTffR8kL+qjx9V5tquPWMBOoFCNr6zmAW9dIJdCHWLmuMHdUUHRLRR
	7k5/aIZxczCGFu6tfc+Z2Gu6D8rfAerwM/WPkZOnJaQtQjzU9dvWXjUBg0fXx6WGNFM4
	Cmo1ux3YIn/9okqpteofFd1p3pOmpOxJKTXfpthcrRvr9Py01QIXNeCU9t/Wx+F249FO
	ni257htva02rBz0nq85iqZ9uSWLjzf7UcK+L8UjLkgscRKYsTPqMUEcdkdloWLIwGLeo
	N4Bg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:mime-version
	:content-disposition:user-agent;
	bh=z9n3hOUKboUlhqOnroYsTDLG9LUFT+RlDvwsRoHnRak=;
	b=gztq3NWQk4pxdXnJmxvLztJGpgLLQTnDvs2b7ElfKE3Ptjtsu2qyfOuZhJ03fl7Hue
	Ym4AqlrG1rTA3HSH8sIi82vH9Jf/gzVLz949e8AWjWdArGf00ZKj/452gIn26bXB6e5l
	aG31tVFP/TW3ULr1GUiyXi7zEtHEwAIL+cFwXbc2J9lPUUSw/KKRfLcKa5fU3b14P/rv
	vOzRaNcnSnQE6GlLb3nw97mrUfz3G72+2dqgC8symQ46xqoibcHrEzJsoPd7I3O/cZYS
	kg1vrq1EW/CWgAgAWlPrBeXTUTStn9cBE/oiVGXFxPd7/rhUyZmiVQPcAMjm6wIBo4Kc
	zvFw==
X-Gm-Message-State: AN3rC/4qXflJoh98P5rw0yiyDTIlS+jQBmgb5kowuLY8irb6MK9VJZpo
	fXvNRxWXH/uzf22Tyh4=
X-Received: by 10.55.25.72 with SMTP id k69mr14833009qkh.276.1494045054059;
	Fri, 05 May 2017 21:30:54 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	b77sm3970422qkj.47.2017.05.05.21.30.51 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Fri, 05 May 2017 21:30:52 -0700 (PDT)
Date: Sat, 6 May 2017 00:30:49 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170506043044.5ribpndnrinl4dt7@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="ygg4s6j4sko7ms2n"
Content-Disposition: inline
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:400d:c09::231
Subject: [Groff] Some statistics on man page macro usage
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 06 May 2017 04:31:01 -0000


--ygg4s6j4sko7ms2n
Content-Type: multipart/mixed; boundary="djycwkeko7v64e75"
Content-Disposition: inline


--djycwkeko7v64e75
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hi folks,

I wanted to gather some data on the relative frequencies of man macros,
so I did.

With my own Debian Stretch system's installed man pages as a population
to sample, here are my findings.

The information below is the macro name followed by the number of
occurrences across all installed pages, followed by a comment explaining
the macro, since some of them are a bit obscure.

TH : 6598	# title heading; mandatory
SH : 48773	# section heading
SS : 11633	# subsection
B  : 53372	# bold
I  : 30134	# italic
SM : 686	# small
BI : 9351	# alternating bold and italic
BR : 43565	# alternating bold and roman
IB : 340	# alternating italic and bold
IR : 13349	# alternating italic and roman
RB : 3349	# alternating roman and bold
RI : 2514	# alternating roman and italic
SB : 60		# alternating small and bold
LP : 3847	# new paragraph
P  : 2613	# new paragraph
PP : 67814	# new paragraph
TP : 55832	# tagged paragraph
IP : 64701	# indented paragraph
RS : 27185	# relative-indent start
RE : 27183	# relative-indent end
TQ : 607	# additional tag for tagged paragraph (groff_man(7))
EX : 652	# example begin (groff_man(7))
EE : 655	# example end (groff_man(7))
MT : 108	# "mail-to" (email address) begin (groff_man(7))
ME : 108	# "mail-to" (email address) end (groff_man(7))
UR : 264	# URL begin (groff_man(7))
UE : 276	# URL end (groff_man(7))
OP : 350	# option (groff_man(7))
SY : 82		# synopsis begin (groff_man(7))
YS : 72		# synopsis end (groff_man(7))
HP : 2845	# hanging paragraph
URL: 23		# URL (Linux man-pages man(7)) [1]
AT : 0		# use AT&T footer (groff_man(7))
BT : 0		# print footer string (groff_man(7))
DT : 26		# (go back to) default tabs (groff_man(7))
PD : 8295	# (set) paragraph distance (groff_man(7))
UC : 16		# use UCB footer (groff_man(7))
TS : 1400	# tbl(1) table start
TE : 1400	# tbl(1) table end
EQ : 6		# eqn(1) equation start
EN : 6		# eqn(1) equation end
PS : 3		# pic(1) picture start
PE : 3		# pic(1) picture end
IX : 60339	# "index entry"; spewed aggressively by pod2man
?? : 6722	# macro matching [0-9A-Z]{2} and not in above list

The standout result for me here is the staggering number of non-standard
macros I found.  At first I suspected a bug, but running the same script
over the git HEAD of the man-pages repo, that value was 0.  A closer
look revealed that most of these were pod2man's effusive emission of
".IX" entries.

Note that the pattern used to catch the "??" macros would _not_ detect
macros with digits or lowercase characters in the names, or macro name
lengths other than 2.  This made it easier to avoid counting actual
requests, and avoided counting mdoc macros as "unknown".

man(7)'s "URL" macro is barely used, and sees one-tenth the usage of
groff_man(7)'s UR/UE pair.  Even the man-pages project itself never uses
.URL, not even in its own page documenting it--instead, that very page
marks up URLs with UR/UE when it marks them up at all.  I submitted a
patch to them to un-document .URL so that it can be "retired" from the
domain of the man macro language.

What surprises you about the above list?

Detailed data, for the above and for the man-pages subset, are attached.

Regards,
Branden

--djycwkeko7v64e75
Content-Type: application/gzip
Content-Disposition: attachment; filename="debian-stretch-box-man-page-stats.txt.gz"
Content-Transfer-Encoding: base64

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
NfnHgtz4LAjmv6APhN+B7//y/wJn5d/NlocIAA==

--djycwkeko7v64e75
Content-Type: application/gzip
Content-Disposition: attachment; filename="man-pages-stats.txt.gz"
Content-Transfer-Encoding: base64

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
C2W6AEoqswEA

--djycwkeko7v64e75--

--ygg4s6j4sko7ms2n
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkNUWYACgkQ0Z6cfXEm
bc60wxAAlejFH+6X8KVhynedSdGLlRfEwmjvjjkG1LUYr1GzlGGSbyuFkOE2lx+T
FC0S5h6w4+8BsSGUfDK4sUC4+FEDWeIQUWJGTWKZR3PRpQ0MpONP+hxU9aLwcCYr
z8k1IBak1527eHFjzBWU7RH38L71CkvMG1wzoYTLVDWuC4SY29eBht0Ziv1K1Ong
xiepf023Qb7beMRzevnDzfjyd2pP8XhgzbpKsK/SoUQ3L1CNrHAQi9avqYFk4mHo
DEmzezKK+2Aliscu4VSTIQAkWnD1P7QbDNeZ7cyfUORlaU6WIDDurqQ4mkdUXFyB
EagNsbFEj8jLBUc27auDIxkve4PzrQ31c/GdpwONQs/O719VWvR/jX6OGk+Xp3dl
OMNxqVNTi/6PQQEjKbqPBY4AJBH0keG0bdXil+KVahHgBjm3H2FzTdq0d9ulSpXi
pZwkX74d7rRmUGTLMVQ9c53So0QEpLEX9mBszB4SKEPvuRLhQSXPY1VjE6hlNFVW
ByrELTsKI7qfxRns87fme12Rj21xdjIOTAC7BiTQeTWXBBH9EC2kCPRn7qhyZtXw
hgRl+YQ2pPrc2zPS41W7zN0Qm4Fjd1a0lB49acVJ5CGQiZ+Fu3frGz6Wor20DUeF
FHFNKiFnTHj5Vh4shZzcyrdL9OOlKVM0KPPBrNuQJrj0Ff1UDKs=
=2sWp
-----END PGP SIGNATURE-----

--ygg4s6j4sko7ms2n--


From MAILER-DAEMON Sat May 06 11:41:08 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d71pU-0004iy-9x
	for mharc-groff@gnu.org; Sat, 06 May 2017 11:41:08 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:38960)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d71pS-0004iC-2k
	for groff@gnu.org; Sat, 06 May 2017 11:41:07 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d71pO-0006yr-Ra
	for groff@gnu.org; Sat, 06 May 2017 11:41:06 -0400
Received: from scc-mailout-kit-01-aegee.scc.kit.edu ([129.13.231.90]:43102)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d71pO-0006vr-Jq
	for groff@gnu.org; Sat, 06 May 2017 11:41:02 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d71pI-0006db-7m; Sat, 06 May 2017 17:40:57 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d71pH-0006Bh-UY; Sat, 06 May 2017 17:40:55 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d71pH-0000Kn-Pu; Sat, 06 May 2017 17:40:55 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 39adf377;
	Sat, 6 May 2017 17:40:55 +0200 (CEST)
Date: Sat, 6 May 2017 17:40:55 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170506154055.GA5075@athene.usta.de>
References: <20170506043044.5ribpndnrinl4dt7@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170506043044.5ribpndnrinl4dt7@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 129.13.231.90
Subject: Re: [Groff] Some statistics on man page macro usage
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 06 May 2017 15:41:07 -0000

Hi Branden,

for comparison, here are the numbers for the OpenBSD base system
and for the OpenBSD port of X.org (Xenocara).  I do not include
data for any third party software installed (my main notebook has
2837 additional man(7) and 105 additional mdoc(7) manuals installed
in /usr/local, but that will look completely different on somebody
else's system).

      Debian OpenBSD Xenocara   ports

> Dd :     ?    2861       9    (105)
> TH :  6598     912    1517   (2837)

> PP : 67814   24487    2040
> IP : 64701   29915    3128
> IX P 60339   43036       1
> TP : 55832    1810    9263
> B  : 53372    1726    5242
> SH : 48773    6800    9585
> BR : 43565     247    1084
> I  : 30134     491       0
> RS : 27185    2738     802
> RE : 27183    2739     836
> IR : 13349     145     276
> SS : 11633    4739     148
> BI :  9351      57    2084
> PD :  8295    4996      10
> LP :  3847      76    1851
> RB :  3349     196      38
> HP :  2845       5    1095
> P  :  2613      60       0
> RI :  2514       1     106
> TS :  1400      35     211
> TE :  1400      35     216
> SM :   686      43       8
> EE G   655       0     225
> EX G   652       0     225
> TQ G   607       0      34
> OP G   350       0       0
> IB :   340       0       5
> UE :   276       0       0
> UR G   264       0       0
> MT G   108       0       0
> ME G   108       0       0
> SY :    82       0       0
> YS :    72       0       0
> SB :    60	   0       0
> DT G    26	   2       0
> URL:    23       0       0
> UC :    16       0      19
> EQ :     6       2     450
> EN :     6	   2     452
> PS :     3       0       0
> PE :     3       0       0
> AT :     0       0       0
> BT G     0       0       0

> ?? :  6722     286    5126

  ZN                    4926  # \fI\^\\$1\^\fP\\$2 (similar to .IR)
  D1             248       1  # mdoc(7)
  BP                      68  # undefined
  IN                      49  # similar to .IX
  NS                      37  # similar to .EX (xterm(1) only)
  NE                      37  # end .NS
  SP              37          # = .sp (cvs(5) only)
  other            1       8

> The standout result for me here is the staggering number of
> non-standard macros I found.

As you see above, breaking that down to individual user-defined
macros may be quite easy.  It doesn't seem surprising to me at
all, i might even have suspected more .de use in man(7) manuals.

What stands out to me is the rarity of man-ext GNU extensions, even
though you did this on a Debian GNU/Linux systen.  The most common
GNU extension appears to be .EX, which is a paragraph macro like
.PP .TP .IP .RS - but less than 0.3% of paragraphs use it.  It's
used on average 0.1 times per page on Debian.  For comparison, the
similar mdoc(7) .Bd is used on average 2325/2861 = about one time
per page on OpenBSD.  Another example: .OP is used on average
350/6598 = .05 times per page on Debian.  For comparison, the similar
mdoc(7) .Fl is used on average 12323/2861 = 4.3 times per page on
OpenBSD.

Both examples indicate that man-ext is used in on the order of 1%
of the cases where it could be.

It's also striking that macro frequeny is very different in the
three corpuses.  Macros exist that are heavily used on Debian but
rarely on OpenBSD (.BR .I ...) whereas others have up to five times
the relative frequency (.SS .PD ...).  Another example:  The relative
frequency of .TP in Xenocara is three times as high as in the rest
of OpenBSD, whereas for .IP, it's 15 times lower - so the quotients
of relative frequencies vary up to a factor of 50 even among different
parts of the same operating system!


> man(7)'s "URL" macro is barely used,

This is the first time i even heard of it...

> I submitted a patch to them to un-document .URL so that it can
> be "retired" from the domain of the man macro language.

Sounds good.

> What surprises you about the above list?

The low amount of eqn (.EQ) in your data.
It looks like you have incomplete X11 documentation installed.

Yours,
  Ingo


From MAILER-DAEMON Mon May 08 17:11:28 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d7pwG-0004k9-Nh
	for mharc-groff@gnu.org; Mon, 08 May 2017 17:11:28 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:52555)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1d7pwE-0004jt-IE
	for groff@gnu.org; Mon, 08 May 2017 17:11:27 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1d7pwA-0007xp-IF
	for groff@gnu.org; Mon, 08 May 2017 17:11:26 -0400
Received: from smtpoutz28.laposte.net ([194.117.213.103]:38789
	helo=smtp.laposte.net)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <bertrand.garrigues@laposte.net>)
	id 1d7pwA-0007s0-8V
	for groff@gnu.org; Mon, 08 May 2017 17:11:22 -0400
Received: from smtp.laposte.net (localhost [127.0.0.1])
	by lpn-prd-vrout016 (Postfix) with ESMTP id 4FCA411A3BF
	for <groff@gnu.org>; Mon,  8 May 2017 23:10:53 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=laposte.net; s=mail0;
	t=1494277853; bh=ZdSO5TvXGLi7GNfO9XY1VmKeKuqOxV63cwnLu6NIWV0=;
	h=From:To:To:Cc:Subject:References:Date:In-Reply-To;
	b=CP0BSoSd5+yAx6nM98skSdim25GKzpZGtsdiFofM5xeXTSacOWNsP2jz4bjSt3EE7
	InbtaPD3RnzR7hL8iZkGxrFgddmA3tBupi4BVQ0wix+7azpXvKW9jDOXTE+fce9FyS
	8D1kiPdTtvdieLVmaGYvb/IdnlNwrfDRyRjH/WOnbHnPYsnCH0f7To75nTmacle5b7
	WGdwUh3OdomE3Nb2BQctmf2Mm5Fz0H3QwT0tGuHzen4nuh6aICTXwfb/VoVsA+iHfd
	vx/saEOaZcU1muU5tNMWmogIbVWu2Dmoo/oKvdXJLQoVGueC8WS2NIASpWI5+BvuP5
	BAVC01gYyS1JA==
Received: from smtp.laposte.net (localhost [127.0.0.1])
	by lpn-prd-vrout016 (Postfix) with ESMTP id 2562111A3C1
	for <groff@gnu.org>; Mon,  8 May 2017 23:10:40 +0200 (CEST)
Received: from lpn-prd-vrin001 (lpn-prd-vrin001.prosodie [10.128.63.2])
	by lpn-prd-vrout016 (Postfix) with ESMTP id 2345F11A3C0
	for <groff@gnu.org>; Mon,  8 May 2017 23:10:40 +0200 (CEST)
Received: from lpn-prd-vrin001 (localhost [127.0.0.1])
	by lpn-prd-vrin001 (Postfix) with ESMTP id 0CC9236871A
	for <groff@gnu.org>; Mon,  8 May 2017 23:10:40 +0200 (CEST)
Received: from hsiaomi. (jau72-h04-89-95-237-97.dsl.sta.abo.bbox.fr
	[89.95.237.97])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by lpn-prd-vrin001 (Postfix) with ESMTPSA id C3A22368718;
	Mon,  8 May 2017 23:10:38 +0200 (CEST)
From: Bertrand Garrigues <bertrand.garrigues@laposte.net>
To: Colin Watson <cjwatson@debian.org>
To: Werner LEMBERG <wl@gnu.org>
Cc: groff@gnu.org
References: <20170218025748.GA14800@riva.ucam.org> <8737f9oizz.fsf@laposte.net>
	<20170220.070837.700140414982532940.wl@gnu.org>
Date: Mon, 08 May 2017 23:10:38 +0200
In-Reply-To: <20170220.070837.700140414982532940.wl@gnu.org> (Werner LEMBERG's
	message of "Mon, 20 Feb 2017 07:08:37 +0100 (CET)")
Message-ID: <874lwv8375.fsf@laposte.net>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-VR-SrcIP: 89.95.237.97
X-VR-FullState: 0
X-VR-Score: -95
X-VR-Cause-1: gggruggvucftvghtrhhoucdtuddrfeeliedrjedugddtvdcutefuodetggdotefrodftvfcurfhrohhf
X-VR-Cause-2: ihhlvgemucfntefrqffuvffgnecuuegrihhlohhuthemucehtddtnecusecvtfgvtghiphhivghnthhs
X-VR-Cause-3: ucdlqddutddtmdenogfthfevqddqjfgurhdqufhushhpvggtthdqlhhoficuldehmdenucfjughrpefh
X-VR-Cause-4: vffvufhfffgjkfgfgggtsehttdertddtredtnecuhfhrohhmpeeuvghrthhrrghnugcuifgrrhhrihhg
X-VR-Cause-5: uhgvshcuoegsvghrthhrrghnugdrghgrrhhrihhguhgvsheslhgrphhoshhtvgdrnhgvtheqnecukfhp
X-VR-Cause-6: peekledrleehrddvfeejrdeljeenucfrrghrrghmpehmohguvgepshhmthhpohhuthdphhgvlhhopehh
X-VR-Cause-7: shhirghomhhirddpihhnvghtpeekledrleehrddvfeejrdeljedpmhgrihhlfhhrohhmpegsvghrthhr
X-VR-Cause-8: rghnugdrghgrrhhrihhguhgvsheslhgrphhoshhtvgdrnhgvthdprhgtphhtthhopegtjhifrghtshho
X-VR-Cause-9: nhesuggvsghirghnrdhorhhg
X-VR-AvState: No
X-VR-State: 0
X-VR-State: 0
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 194.117.213.103
Subject: Re: [Groff] BuildFoundries mistakenly installed?
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 08 May 2017 21:11:27 -0000

Hi Colin,

On Mon, Feb 20 2017 at 06:08:37 AM, Werner LEMBERG <wl@gnu.org> wrote:
>> However it seems to me that BuildFoundries is a script only used
>> during the build process, I can't say why it was put back in the
>> list of installed files again.
>> 
>> Maybe Werner or Deri could help on this point.
>
> Uh, oh, I no longer remember, sorry.  Please do whatever you think is
> a good solution.

I forgot about this issue sorry; there is no piont in installing
BuildFoundries, so you can commit your changes.

Regards,

Bertrand Garrigues


From MAILER-DAEMON Mon May 08 23:56:02 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d7wFm-0003Ve-C5
	for mharc-groff@gnu.org; Mon, 08 May 2017 23:56:02 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59537)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d7wFi-0003VU-Bq
	for groff@gnu.org; Mon, 08 May 2017 23:56:00 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d7wFg-0006RS-1O
	for groff@gnu.org; Mon, 08 May 2017 23:55:58 -0400
Received: from mail-yb0-x22d.google.com ([2607:f8b0:4002:c09::22d]:35129)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d7wFf-0006RD-Q1
	for groff@gnu.org; Mon, 08 May 2017 23:55:55 -0400
Received: by mail-yb0-x22d.google.com with SMTP id p143so16437443yba.2
	for <groff@gnu.org>; Mon, 08 May 2017 20:55:55 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc; bh=OLZ8yZy0h9qvlp3V3r4FVFvbF2LA1UDj2Ffe6GIYfhY=;
	b=ZIdf0qFMx0yJOsVF9QRhsLtXnbubc6pZHF/pnSuu/aorURac49idlH6+fBh6MWrpKh
	GChL7Pof4vQSrGz/4m4fbK+EBTGmunCWMjfcPmSC1e68JVa99VVreFEzqy5RerSVjsVe
	QrwovJ3XvFczm1t5PZ8avNzuow/v8MiXw2B6fSO/JVNhrbtp1II2nEyiPhE6WSd/NDzJ
	U3j0s367BXV0/td4dJ949PVJl49bYFqq9OaRFb0UepSjTJm4yCe9VDzuvM68dcJ23y+Z
	UXXGp+vTXGyFeHFqcoGGG8Wt8I/NZ7GwarJMKahDCqMhKkCW8N/eYGm6ppUTIhyrVR7L
	59IQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to:cc;
	bh=OLZ8yZy0h9qvlp3V3r4FVFvbF2LA1UDj2Ffe6GIYfhY=;
	b=hq+IMJ3X9W5YgxIUi3Hh8HLfOf8eBCW2TfXhjDinJhs34Espko7hrzBEdu8ApXg48/
	XaLe8XCV0rUBGmFKTQs5koovang1D0SXSPAuGVht5y8rrUXx4WtRfyv8TyDtNOTqpyYi
	C8aUVXQiuXD+Zg+3aiP5heSRZ8aUo/zunI5qWgOftAwDFcFHkyzmSB2lvPwFKiAp2zuo
	5hQUKM2P9RrmFDV4BIWKaLIAtLacHWVzXCgsxgA2uYcRpggZNbIWq2e/F6LmkUpVNyP2
	rtufw50Hz3o9o4y0jafYutynwpnK6Z6w041C//99VU3aEdJOZN83T/FGgdp4bbdgYPVZ
	F7Dw==
X-Gm-Message-State: AODbwcCXsNtxnyUJu1PKzFazbhS2vdsOn1Rz4JuUoC+AbvJmVKbQSgrs
	Wb96o47tNgmIHDVHrjpRDSGHtBY+hztHcv8=
X-Received: by 10.37.77.138 with SMTP id a132mr9915663ybb.170.1494302154636;
	Mon, 08 May 2017 20:55:54 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Mon, 8 May 2017 20:55:38 -0700 (PDT)
In-Reply-To: <CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<20170428153832.EDB8520302@orac.inputplus.co.uk>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
From: John Gardner <gardnerjohng@gmail.com>
Date: Tue, 9 May 2017 13:55:38 +1000
Message-ID: <CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: groff <groff@gnu.org>
Content-Type: multipart/related; boundary=001a113c2e541d6a18054f0f558d
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::22d
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 03:56:01 -0000

--001a113c2e541d6a18054f0f558d
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Looks like there's a mistake in groff_out(5). It describes its arc-drawing
command as:

*Draw arc from current position to (h1, v1)+(h2, v2) with center at (h1,
> v1);*


However, gropdf.pl tells a different story. To quote line #2791:
<http://git.savannah.gnu.org/cgit/groff.git/tree/src/devices/gropdf/gropdf.=
pl?id=3D453a8aa7c8f8dd0c78160466301f81be8c40df2e#n2791>

*Documentation is wrong. Groff does not use Dh1,Dv1 as centre of the
> circle!*


I noticed something odd when drawing an arc which wasn't an evenly-sized
quarter-circle. For instance, the following Pic code:

.PS
> move down
> A: box
> arc at A.n
> line right
> .PE


... generates the following output:


> =E2=80=A6

V84000

H99000
> Da 0 -36000 18000 54000


Which looks like this in gropdf and my own canvas code, respectively:

[image: Inline images 3]
I've marked the start (A) and end (Z) points in my output on the right. The
circle at the top denotes where the centre-point is. Compare that with an
ordinary arc (e.g., replace `arc at A.n` in the previous Pic code with `arc=
`
instead):

[image: Inline images 5]
gropdf is also drawing each arc in 4 segments, instead of 1. The reasons
why are unclear to me.

Otherwise, I've succeeded in drawing every other (quartercircle-sized) arc
using the following code:

centreX    =3D h1 + startX
> centreY    =3D v1 + startY
> endX       =3D centreX + h2
> endY       =3D centreY + v2
> radius     =3D sqrt(pow(endX - centreX, 2) + pow(endY - centreY, 2))
> startAngle =3D atan2(startY - centreY, startX - centreX)
> endAngle   =3D atan2(endY   - centreY, endX   - centreX)




On 30 April 2017 at 20:18, John Gardner <gardnerjohng@gmail.com> wrote:

> Sorry for the delayed response. Some pull-requests needed tending to
> before I had a chance to go through all this.
>
> First, thank you all so much for your help and patience! It truly means a
> lot. I've not yet got arcs drawing correctly, but I feel I'm coming close=
.
> Branden's pointers on trigonometry cleared some cobwebs that hadn't been
> lifted since high-school trigonometry lessons, making all this slightly
> easier to follow.
>
> Turns out the HTML5 specification
> <https://html.spec.whatwg.org/multipage/scripting.html#dom-context-2d-arc=
> itself
> offers a much clearer description of arc-drawing than the docs I linked t=
o
> earlier:
>
>
>> *Consider an ellipse that has its origin at (x, y), that has a major-axi=
s
>> radius radiusX and a minor-axis radius radiusY, and that is rotated abou=
t
>> its origin such that its semi-major axis is inclined rotation radians
>> clockwise from the x-axis.*
>
>
>> *If anticlockwise is false and endAngle-startAngle is equal to or greate=
r
>> than 2=CF=80, or, if anticlockwise is true and startAngle-endAngle is eq=
ual to
>> or greater than 2=CF=80, then the arc is the whole circumference of this
>> ellipse, and the point at startAngle along this circle's circumference,
>> measured in radians clockwise from the ellipse's semi-major axis, acts a=
s
>> both the start point and the end point.*
>
>
>
> *Otherwise, the points at startAngle and endAngle along this circle's
>> circumference, measured in radians clockwise from the ellipse's semi-maj=
or
>> axis, are the start and end points respectively, and the arc is the path
>> along the circumference of this ellipse from the start point to the end
>> point, going anti-clockwise if anticlockwise is true, and clockwise
>> otherwise. Since the points are on the ellipse, as opposed to being simp=
ly
>> angles from zero, the arc can never cover an angle greater than 2=CF=80 =
radians.*
>
>
> It also explains how arcs and ellipses are drawn using the same
> coordinates:
>
> *The arc() method is equivalent to the ellipse() method in the case where
>> the two radii are equal. When the arc() method is invoked, it must act a=
s
>> if the ellipse() method had been invoked with the radiusX and radiusY
>> arguments set to the value of the radius argument, the rotation argument
>> set to zero, and the other arguments set to the same values as their
>> identically named arguments on the arc() method.*
>
>
> Going forward, I *think* I can work this out.
>
> I hope B-spline drawing doesn't turn out to be as difficult. =3D(
>
> Thank you all again!
>
>
>
> On 29 April 2017 at 01:38, Ralph Corderoy <ralph@inputplus.co.uk> wrote:
>
>> Hi John,
>>
>> > <https://cdn.rawgit.com/Alhadis/language-roff/a7c07744a9d44a
>> df32a546646f7a8d57d52e6e58/preview-tty.html>
>> > <https://cloud.githubusercontent.com/assets/2346707/
>> 25514878/732e09ea-2c23-11e7-97ea-9674d3845dd1.png>
>>
>> Gorgeous.  :-)
>>
>> > Groff's output gives me these coordinates to go by:
>> >
>> >    - startX, startY - Coordinates of the arc's starting point
>> >    - centreX, centreY - Coordinates of the arc's centre
>> >    - endX, endY - Coordinates of the arc's terminal point
>>
>> I'm assuming centreX and centreY are zero as it's just a simple
>> translation to get there.  And for the moment that startX and startY are
>> in the x>0, y>0 quadrant.  This gives a right-angled triangle (0, 0),
>> (startX, 0), (startX, startY).
>>
>> > But the canvas arc method I'm working with requires all of these:
>> >
>> >    - x - The x coordinate of the arc's centre.
>> >    - y - The y coordinate of the arc's centre.
>>
>> 0, 0.
>>
>> >    - radius - The arc's radius.
>>
>> sqrt(startX**2, startY**2) as pic's arcs are always circular.
>>
>> >    - startAngle - The angle at which the arc starts, measured clockwis=
e
>> >    from the positive x axis and expressed in radians.
>>
>> That's the triangle's angle at its origin corner.  That's the arc sine
>> of the opposite edge's length, startY.  But this assumes the radius,
>> i.e. triangle's hypotenuse, is 1.  When it's not, it's
>> asin(startY/radius).
>>
>> This bit of Python might help.
>>
>>     >>> from math import *
>>     >>> def d(r): return r / pi * 180
>>     ...
>>     >>> d(asin(0.001))
>>     0.05729578906238321
>>     >>> d(asin(0.999))
>>     87.43744126687686
>>     >>>
>>     >>> d(asin(1))
>>     90.0
>>     >>> d(asin(-1))
>>     -90.0
>>     >>>
>>     >>> d(asin(-0.001))
>>     -0.05729578906238321
>>     >>> d(asin(-0.999))
>>     -87.43744126687686
>>     >>>
>>     >>> d(asin(0.5))
>>     30.000000000000004
>>     >>> d(asin(sqrt(0.75)))
>>     60.0
>>
>> You can see asin copes with [1, -1], giving [90, -90] in degrees.
>> You'll need to check the signs of start{X,Y}, making =CF=80/2 adjustment=
s to
>> the radians you obtain to handle the other quadrants.
>>
>> Hope that helps.  It's been many decades since I needed this.  :-)
>>
>> --
>> Cheers, Ralph.
>> https://plus.google.com/+RalphCorderoy
>>
>>
>

--001a113c2e541d6a18054f0f558d
Content-Type: image/png; name="figure-1.png"
Content-Disposition: inline; filename="figure-1.png"
Content-Transfer-Encoding: base64
Content-ID: <ii_15beb3e2dc110734>
X-Attachment-Id: ii_15beb3e2dc110734

iVBORw0KGgoAAAANSUhEUgAAAr8AAADSCAMAAAB0MlhxAAAAw1BMVEX///8AAABubm4vLy8kJCT9
/f2hoaGVlZXAwMDy8vJ8fHypqalUVFRxcXFGRkZ+fn7CwsLx8fGDg4Oenp6cnJyFhYXW1tZ3d3cF
BQXk5ORgYGBqampLS0tlZWX5+fnp6em5ublBQUGGhoaBgYELCwv19fXt7e0PDw/a2tqqqqo1NTXL
y8vHx8eurq46OjoUFBRaWlpQUFA+Pj4fHx+MjIyJiYnQ0NApKSkZGRne3t60tLSQkJC9vb2mpqaZ
mZmTk5OkpKQKo9OwAAAHiElEQVR42uzWzU7CUBRF4Z0SK5BbKBjbABVRxJ8UCJA4QFB8/6cysYSZ
SUmugUPXN7l7dEdrcAQAAAAAAAAAAAAAAABcgisBRq03zbQ7EmDRZ6v/PUuz6FmAOWFt+vv23VCA
MckqV2GxE2DMe/NQcqZLkl+bEKtieqO6R1s3nhYrnmVh7PPnXCfVfqoZ8BKpYkYu8Cca1Fx6mMti
+nHX1Um1WzLAVa7fOOg1/OkMNpP9TLKk4dHXrY5Ev1UQBxN5FC609+bkUzjWkei3CuKgI4+G7rEY
yTyXTzfcD/T7//1qvUqTxmQ9m+9EvyXQ73n1q/voIUizZV30Wwb9nlm/Umf78SqJfkuh33Prt0C/
pdAv/f6BfiuAfunXMvqlX8vol34to1/6tYx+6dcy+qVfy+iXfi2jX/q1jH7p1zL6pV/L6Jd+LaNf
+rWMfunXMvqlX8vol35/2KUDEgAAAABB/1+3I9ANnvnr75m//p756++Zv/6e+evvmb/+nvnr75m/
/p756++Zv/6e+evvmb/+nvnr75m//p756++Zv/6e+evvmb/+nvnr75m//p756++Zv/6e+evvmb/+
nvnr75m//p756++Zv/6e+evvmb/+nvnr75m//p756++Zv/6e+evvmb/+nvnr75m//p756++Zv/6e
+evvmb/+nvnr71ns3dtS4kAUheG9OOkgiM6M5ADhIIEACURAAUVL3/+pBkS9ApwqMjW9yfpuqOKi
ucgPdOjQYb/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2
y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sVzP2y341Y7/sV7N/3G/D
Yb8HsV+j+31dOOz3EPZrdL9ZPLDfQ9ivyf1e+Vh02e8h7Nfgfj0AA/Z7APs1uF8nAFBnvwewX4P7
vUXdBiL2ux/7NbffbjCVOuCy3/3Yr7n9vuFMBoDdZ797sV9z+836PenlAIv97sV+je03gisiP4HZ
Nfvdh/0a228JVRHpx8Ar+92H/ZrarxPcyUYGGObZ7x7s19R+X1EOwyiqdgA8sd892K+h/XazeGdj
bZJnv7uxX/P67fZEZITa1WDtpVUDMGe/u7Ff0/oNrUymVpCx7cjWow9k2O9u7Newfh/aVitauXeY
yKcaEDfZ707s16x+78ePsrHESD5FADrsdyf2a1S/YbsvG9UYZ/KlDeQayvv1c0lbxrmk+SnsV5LU
2WbWHwLTr2KbQwClphzjrSP/1byQOC/4VUhaKClz7r1dJGbwUrdGFxej+wCAPS2M3p+bzLAxux8d
MXTlVk7Ntd0SOlJUrBQTU7GG7s36IeNZxXK2XtkO7XrWhlc+5pU6BTk5pTuhI+WTVV5tRpQ1Z9L7
GDyh15KT8+Tr2HsjRUZfK21nrtBhjeWZkFm82jbgp3Ff6BuVrJBZehO35TTD1Xgg9B3HPhcyS351
6dXq7qPQ9+4mQsaZhz2hvxGiKkRqtXmWS4o925xokWJTfgCTYuc2Z8Ck2GVJiNSa25EQqeUOT/DS
DkoNxz/BS+soPR4CR4i0asSeEKl1zlM40sxbdIVIq+tZ6v43TKfk2X4WIrWsZVOItGqML7mKQXo9
xkUhUqtlj4RIrXt/LkRquTOuI5NejXb2hxBp1VtcNoRIK2dW4q9opFc1dhkw6TX32wyY9Br4NQZM
ekWBx4BPRgoPZRiXeDWwUhe5XGBja7m5RU8aN/eozqbc/1Cnn4A/bb+rBwCyqTyQzWEuje/bE2Ch
1JcPWWCZ0gXVbil4ElInPx3LJxfAi6RU/sYupnDqr10vXsmH3wDSvDVjK26n9MtHMafcl61qACxS
fXcpZxpzDqFVYwzgSlLtT3v32pwmEIUB+BwvbWORpgYBXRAUvEAiYrgZL7T//1cVZhJH2w/NhyTD
Tt7nAz8Adpizu2f37XqmjX40ORnM7NFn99DpIJ9IRt+YOUIrIc1bpo1zydJxOsw+VkBrtxuspEln
y8waQW3eMy0kmUpFY2Yks5/pqilQRMhDXzIn+GAX3LbfxwuRxDxkRizwtW7Q9m1UEU23cIiox8yC
4Fp3/8iWiy3lBtvbQoy/B8wczunZPRaBz+5js5OijGiobl/NHnItNpmX+kU2D8GZM+uYyh4/4SYy
tguq2MxmSS9GSyRDXOkeY39n8odC3f0KrrqgSsnMCr3QI74juPYz5Y+FjaRXEBlVdJ+Z29nAqwyG
tsmMYBOQwE0rrx53Cf9t8EV7N+VvtFjA2+ifgmkRttJZZoT9dHZh+G68FOMX3oI72y23Y5dq+haj
CuThHMaRb7VUevYDUVIgh8XqpIRhEq91IiEmVCtx9wFIYOVqSlJMrXQ1p5qjxMHTyO1N0foAzTZa
Z63pZmOJg04Xvlq2bRmf+swmNNnkxnG9saUWu0KU7hP9Y6Vj6gbNMlmMVvmtezKUqN2ehqHVX+cj
3E8HTXZK0ywbej2hqGGR7JLiUVHGxq8jxi3IQESqpcTC6HnZQQuOObr+AAAAAAAAAAAAAAAAAAAA
AADgP/4AEQbZGz61B6wAAAAASUVORK5CYII=
--001a113c2e541d6a18054f0f558d
Content-Type: image/png; name="figure-3.png"
Content-Disposition: inline; filename="figure-3.png"
Content-Transfer-Encoding: base64
Content-ID: <ii_15beb50945585c92>
X-Attachment-Id: ii_15beb50945585c92

iVBORw0KGgoAAAANSUhEUgAAApgAAADlCAMAAADAzHfNAAAAzFBMVEX///+AgIAAAAAvLy+hoaGV
lZUkJCRGRkZUVFRxcXF+fn74+PgWFhb9/f0NDQ0JCQkgICD7+/vt7e0cHByTk5Orq6sEBASjo6Pn
5+fj4+PX19fMzMzJycm6urqFhYVpaWkpKSkRERFjY2NXV1fCwsI2Njbd3d3GxsaYmJh5eXlbW1s/
Pz8yMjKnp6dgYGBPT09DQ0MmJib19fWdnZ18fHxkZGRLS0s7Ozvv7+/a2trU1NS2traMjIywsLBt
bW1lZWXQ0NBISEjx8fEwMDCqn7mqAAAHoklEQVR42uzSwQ0BARRAwb9EsAcVuEj0X6M23o+ZGmYA
AAAAAAAAAAAAAAAAAAD4V+/bCt/Z69hmCs7XdYHPc/Y6lrlMwXmfBR67Y84qYoqZJKaYSWKKmSSm
mEliipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaY
SWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJ
YoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEli
ipkkpphJYoqZJKaYSWKKmSSmmEliipkkpphJYoqZJKaYSWKKmSSmmEliivlj706X0giiMAwfjoRB
aWZhB1lVVLYIBkSNWkbu/54CaAStJExTnKnG/p4f8J96i5npPg1GQpgI00gIE2EaCWEiTCMhTIRp
JISJMI2EMBGmkRAmwjQSwkSYRkKYCNNICBNhGglhIkwjIUyEaSSEiTCNhDARppEQJsI0EsJEmEZC
mAjTSAgTYRoJYSJMIyFMhGkkhIkwjYQwEaaRECbCNBLCRJhGQpgI00gIE2EaCWEiTCMhTIS5Ky+1
AGGGhDAjDPMHXyDMkBBmdGGmDvgkjTDDQZjRhXnGzOcIMxyEGVmY6SQzHyHMcBBmZGFWeE5lEGYo
CDOyMI94IY4wQ0GYUYWZUX6mx+xfI8wwEGZUYRY5R3lm/okww0CYEYUZtN0yZRTzTYAwQ0CYEYV5
sVzDjDHzM8IMAWFGE2b6O1eJ6I6Zn9IIczOEGU2Y5zwK3tYy3TLC3AxhRhNmnQfvuz8PCHMzhBlJ
mBmfud3v99s8l80gzI0QpmyY1dy4ns9Qnt0+LyxfB6FaztfHuarxYXqJXVMqsWsuwvyoNvQn9Y7j
dqZ8T6/umHkU0CbB2HU69Yk/rJkd5nN854bT+M4d0/4SCDPnFmmh5LATrB7Pmc9og/KwW6KFopsz
OkwBT6cEomHm1fl7jO21BU3m0zT9302H3pyrvGVhdm4IRMNs1ujVPWd7ubVxYeY7+q+cQ+9qTcvC
rPcIJMMs/qkrfcWjsxn9ccm8aZJ9dkErTtGuMC+bBJJhTi5pqXzI7NZUhZZuKyc8Vy/Rv1UUrbmc
2BXmY4tgTWzX/JPl21jxgteNLbX5lX8U+6duNrbmxI/9zZcN85hfCOTD9H4t37Ld2AZ6Ye7bMfjw
bvmZQMrqUt56oAVVoY90LuV2UQMCKauHHzWmubM+aeh/evixy3BMIGW1XOQ3lnXl6AON5SLrHlIP
sZApZ7XAfpDUXjT+vMBumYFKEwhZbUn2plTqDsukpbS+JWmbMlcIhKyGOGYtxx0HpGd9iMM+iUsC
YdVcz8tnSNdq7M1GjSsCcbUCgZ5HN0Ugjm8JtFx7PwnEeXECPcnvBOISXQI9eVzLI3A6ItCTamFX
Ul7RI9DUTRCIw7SMthqfE0jLNgg0tff5wO2+6PoEmgZuhkDYxZcdNpcTJI4IpLlfdtpcTtwtEQi7
woKRtuAAd+biqoz1Ym21AhYzxGWxxabvdIp5YWkdl0BXqWXfjHTkPHzG+uIeJtmlXWUJtCVnuDcX
lmLrjpTtQAZ7ZuIc7P5s4aKAWVZh14UfBNq+eXaeeopQUhHoa6gygSgP8zJbCJwmpjlkHeG05DZe
+tNrAkmJNoG+UrYZEAiq8AOBvuPWKcoU1fCw+buNe5XEQruopnW/KLgblWwPT0CSAg9HzLdSbvv7
/N9m5ityjrSkPrH1kpaaeA+4DxL0VKiShmf+zNovjkGrhxO9ghz3Wusblrkfq8eWeO7G3ufT8i+v
busFIwozpRWmOlv/D0pl9QGtohrhV+DkjLIUWsO9ozclxcyPZLXbw4Jj7b3M7/butSdxKAjj+PhU
dzWKLXSpiyC3omJQWCER5Br2+3+oFaxhiRgwkdLI//e2b0/PZWbOme3zfNtQqlpNLfpRSuO93/8/
HwchZe3b8mPTrgzpbtYiHUkerezMCtMg7Bu2wqn0bSNpi/T3+kS+7HYqZ7D3a8d2ND5Zmd12JHGf
7c1gGvjjGmNzC5oq2SfcSerub6TovUznT3B2XH82fLGj4N42diXpnPDyskx24sk/Pshe8sd+pZx3
/mDrLCJF3LJc5eZi8iip4jmNVugqVt93tg41tfWiSFGVHdUHTn/3a6PO8K6pWH3ntoKDs40aRdYl
+ZR9IUbV4LFga/T14taAGGW6ur6xVXIH1678cNQuSyoaEK+ao+uCvXNYKeVnURGnLOkxbZH2Xldx
IFa1e3m/bFndjwbrYPkA2OHGIOKTa7nuU80W8rqMvujFw3/Jc07niNWwrPOfWYs0hzaXakgK8vZm
RF4SsSs6QeCFhymznntqc0eSvPGBvcoMibNjJ66aZVeu71SKD4Vc2/KaaXmTmfETFUbYob8XJcc9
cwPtCD2J8JFbx2ZSNjdoGZAEPTdtCyfMYUiIZtEWKuwrkRDzOGakxAP5SIy6n7dXJ42eAUnRqZQK
81x5SHYcSRJVF+35EwdIolMWcQAAAAAAAAAAAAAAAAAAAAAAAACr/APejIOreuRFRQAAAABJRU5E
rkJggg==
--001a113c2e541d6a18054f0f558d--


From MAILER-DAEMON Tue May 09 07:24:03 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d83FL-0007Qc-7E
	for mharc-groff@gnu.org; Tue, 09 May 2017 07:24:03 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57549)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1d83FJ-0007Pa-CS
	for groff@gnu.org; Tue, 09 May 2017 07:24:02 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1d83FF-0006xA-AI
	for groff@gnu.org; Tue, 09 May 2017 07:24:01 -0400
Received: from smarthost01d.mail.zen.net.uk ([212.23.1.7]:34737)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1d83FF-0006mH-0O
	for groff@gnu.org; Tue, 09 May 2017 07:23:57 -0400
Received: from [82.71.22.80] (helo=pip.chuzzlewit.co.uk)
	by smarthost01d.mail.zen.net.uk with esmtpsa
	(TLS1.0:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.80)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1d83Ez-00009k-TB
	for groff@gnu.org; Tue, 09 May 2017 11:23:42 +0000
From: Deri James <deri@chuzzlewit.myzen.co.uk>
To: groff@gnu.org
Date: Tue, 09 May 2017 12:23:41 +0100
Message-ID: <5662022.FPgKhDyKzp@pip.chuzzlewit.co.uk>
User-Agent: KMail/4.14.5 (Linux/4.4.59-desktop-1.mga5; KDE/4.14.30; x86_64; ; )
In-Reply-To: <CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
	<CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
MIME-Version: 1.0
X-Originating-smarthost01d-IP: [82.71.22.80]
Feedback-ID: 82.71.22.80
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 212.23.1.7
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 11:24:02 -0000

On Tue 09 May 2017 13:55:38 John Gardner wrote:
> Looks like there's a mistake in groff_out(5). It describes its arc-dr=
awing
> command as:
>=20
> *Draw arc from current position to (h1, v1)+(h2, v2) with center at (=
h1,
>=20
> > v1);*
>=20
> However, gropdf.pl tells a different story. To quote line #2791:
> <http://git.savannah.gnu.org/cgit/groff.git/tree/src/devices/gropdf/g=
ropdf.p
> l?id=3D453a8aa7c8f8dd0c78160466301f81be8c40df2e#n2791>
>=20
> *Documentation is wrong. Groff does not use Dh1,Dv1 as centre of the
> circle!*
>=20
> I noticed something odd when drawing an arc which wasn't an evenly-si=
zed
> quarter-circle. For instance, the following Pic code:
>=20
> .PS
>=20
> > move down
> > A: box
> > arc at A.n
> > line right
> > .PE
>=20
> ... generates the following output:
> > =E2=80=A6
>=20
> V84000
>=20
> H99000
>=20
> > Da 0 -36000 18000 54000
>=20
> Which looks like this in gropdf and my own canvas code, respectively:=

>=20

In gropdf I adjust the circle centre using code I found in the geometry=
.cpp=20
library used by the grops driver, so that I could duplicate the output=20=

produced by grops.


From MAILER-DAEMON Tue May 09 07:42:24 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d83X5-0003uk-U4
	for mharc-groff@gnu.org; Tue, 09 May 2017 07:42:23 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:32936)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d83X3-0003sY-8Y
	for groff@gnu.org; Tue, 09 May 2017 07:42:22 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d83X2-0005RA-2E
	for groff@gnu.org; Tue, 09 May 2017 07:42:21 -0400
Received: from mail-yw0-x234.google.com ([2607:f8b0:4002:c05::234]:34864)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d83X1-0005R2-Rh
	for groff@gnu.org; Tue, 09 May 2017 07:42:19 -0400
Received: by mail-yw0-x234.google.com with SMTP id l135so42853790ywb.2
	for <groff@gnu.org>; Tue, 09 May 2017 04:42:19 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc; bh=hBkabCM1pKrZtw4uA7zzNfo4o+lpFa8PvOuhuld2Wmc=;
	b=rzPDYxeOnhWJlBvvr8QtxYcHYlQ6+Crmpnvg4IHl0USeXUjSmT0VHL+XChjfvNcWZ8
	CCpN587K+Ts7CgqfHxqBnfZRqWwSAt5yJ00tuwM3JflljVkhpDlFLfrxxETa4mmMzyzR
	53yP5gypQnpIk150dsMB3YKtRQBzSzs5MzVQsEokWbyil3Su7/yII4AigX0RwUASR0bI
	QEpA7U8TIhMhD0LLqxV6fin3N8tCre4Uo3ExYUA1sfQQtF0vz8c2ztEAumzq1cfjxd8U
	mCK/dqr7aLmiNFio5mz0XCjBPcNApsjSPAzDFGQjp/a7wnDBoSzqTv6WW7Y1c+UxY+mh
	Ci6g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to:cc;
	bh=hBkabCM1pKrZtw4uA7zzNfo4o+lpFa8PvOuhuld2Wmc=;
	b=mBBDC/8jN6DzlhY2Y9y0juYuQq6zBiiwl9haHg2kp/ApjtFP9/vjUXSqe+vjHN+8+9
	ckVNVjWfNVQ2bfQ4Z92vs0687evmZsAIEfOSOrWgpND+rU7Yu9qirgAUpYQ7yVrgTYG3
	Ole56aePrHPnr4sV0Qnc6hEDL/6kKcpSbCMp121u2KFJ3uoz4K/pNPnV0sJCTR8mEAvu
	uLE24EZO1r5f9ApgFnoc/3W0f8ICU1aupXvyEZAerJ90F5FZ3yRZzEWLrsojn5opOgaV
	EF1DoxmWkmBxypdHcGtkbA5qP3jEYZD3zwaaSgVsHGHMYYu4YdD/xKpsQgcvLToq0+ny
	JMTw==
X-Gm-Message-State: AN3rC/7IwacTEu0ZqQ/qGW/+CGyaKU3V9h2wtfiX7ElLWowBQdkzZmj6
	C18ipUV5H29YAkE8flo4az9ZiZT+rtky
X-Received: by 10.129.73.72 with SMTP id w69mr55312447ywa.190.1494330139147;
	Tue, 09 May 2017 04:42:19 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Tue, 9 May 2017 04:42:03 -0700 (PDT)
In-Reply-To: <5662022.FPgKhDyKzp@pip.chuzzlewit.co.uk>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
	<CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
	<5662022.FPgKhDyKzp@pip.chuzzlewit.co.uk>
From: John Gardner <gardnerjohng@gmail.com>
Date: Tue, 9 May 2017 21:42:03 +1000
Message-ID: <CAGcdajd4uNd1bG_9a8OBjMNAMsTNaQtCMMOkV8vb+j8PHg98VQ@mail.gmail.com>
To: Deri James <deri@chuzzlewit.myzen.co.uk>
Cc: groff <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::234
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 11:42:22 -0000

Fair enough.

Well, the grops code worked for me too
<https://github.com/Alhadis/language-roff/commit/ec8e287cb35f7a91924e02e09a=
f68202d8cddade>,
actually.

Thanks to everybody again for their help. =3D)



On 9 May 2017 at 21:23, Deri James <deri@chuzzlewit.myzen.co.uk> wrote:

> On Tue 09 May 2017 13:55:38 John Gardner wrote:
> > Looks like there's a mistake in groff_out(5). It describes its
> arc-drawing
> > command as:
> >
> > *Draw arc from current position to (h1, v1)+(h2, v2) with center at (h1=
,
> >
> > > v1);*
> >
> > However, gropdf.pl tells a different story. To quote line #2791:
> > <http://git.savannah.gnu.org/cgit/groff.git/tree/src/
> devices/gropdf/gropdf.p
> > l?id=3D453a8aa7c8f8dd0c78160466301f81be8c40df2e#n2791>
> >
> > *Documentation is wrong. Groff does not use Dh1,Dv1 as centre of the
> > circle!*
> >
> > I noticed something odd when drawing an arc which wasn't an evenly-size=
d
> > quarter-circle. For instance, the following Pic code:
> >
> > .PS
> >
> > > move down
> > > A: box
> > > arc at A.n
> > > line right
> > > .PE
> >
> > ... generates the following output:
> > > =E2=80=A6
> >
> > V84000
> >
> > H99000
> >
> > > Da 0 -36000 18000 54000
> >
> > Which looks like this in gropdf and my own canvas code, respectively:
> >
>
> In gropdf I adjust the circle centre using code I found in the geometry.c=
pp
> library used by the grops driver, so that I could duplicate the output
> produced by grops.
>
>

From MAILER-DAEMON Tue May 09 08:16:32 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d8447-0002xN-TN
	for mharc-groff@gnu.org; Tue, 09 May 2017 08:16:31 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41595)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d8445-0002um-Cf
	for groff@gnu.org; Tue, 09 May 2017 08:16:30 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d8442-0002PH-7X
	for groff@gnu.org; Tue, 09 May 2017 08:16:29 -0400
Received: from relay01.pair.com ([209.68.5.15]:33549)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d8441-0002P0-SH
	for groff@gnu.org; Tue, 09 May 2017 08:16:26 -0400
Received: from orac.inputplus.co.uk (unknown [84.93.68.25])
	by relay01.pair.com (Postfix) with ESMTP id 3FE52D0108A
	for <groff@gnu.org>; Tue,  9 May 2017 08:16:23 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 1E4F1204E2
	for <groff@gnu.org>; Tue,  9 May 2017 13:16:22 +0100 (BST)
To: groff@gnu.org
mail-followup-to: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<20170428153832.EDB8520302@orac.inputplus.co.uk>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
	<CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
Date: Tue, 09 May 2017 13:16:22 +0100
Message-Id: <20170509121622.1E4F1204E2@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 12:16:30 -0000

Hi John,

> Looks like there's a mistake in groff_out(5). It describes its
> arc-drawing command as:

    Da h1 v1 h2 v2=E2=9F=A8line-break=E2=9F=A9
        Draw arc from current position to (h1, v1)+(h2, v2) with center
        at (h1, v1); then move the current position to the final point
        of the arc.

CSTR 54 says

    Da dh1 dv1 dh2 dv2
        draw arc from current position to dh1 + dh2, dv1 + dv2, center
        at dh1, dv1 from current position

I think they're equivalent.

> However, gropdf.pl tells a different story. To quote line #2791:
> <http://git.savannah.gnu.org/cgit/groff.git/tree/src/devices/gropdf/gro=
pdf.pl?id=3D453a8aa7c8f8dd0c78160466301f81be8c40df2e#n2791>
>
>     Documentation is wrong. Groff does not use Dh1,Dv1 as centre of the
>     circle!

The documentation is correct.  The code is wrong.  Later code copied
earlier code.

> I noticed something odd when drawing an arc which wasn't an
> evenly-sized quarter-circle. For instance, the following Pic code:
>
>     .PS
>     move down
>     A: box
>     arc at A.n
>     line right
>     .PE

I think pic produces correct troff for this, but then grops and many
others interpret it wrongly.  You initial attempt is correct, even
though it produces the "wrong" diagram.  "at" for an arc sets the centre
point;  that's A.n.  It will be anti-clockwise.  We finish the box at
A.s.  The start of the arc is after the implicit move downwards at that
start.

Here's some additions to your test.

    .PS
    move down
    A: box
    arc at A.n
    arc; arc; arc; arc
    line right
    line from A.n to A.n - 0, A.ht * 2
    line from A.n to A.n + arcrad * 2, (-A.ht - arcrad) * 2
    .PE

The four arcs are to draw a circle, returning to the start point, so you
can see grops's arc's radius isn't the default.  The two extra lines
show the correct CSTR 54 interpretation of where the arc should start
and end, as indeed it does when viewed with `groff -pX foo.pic'.

To see groff's interpretation,

    pic foo.pic | perl -pe 's/\\D/$n++; "\\Z%$n%$&"/ge' |
    groff | ps2pdf - foo.pdf

I'd guess gxditview gets it right because it has a pre-groff heritage
and so coded to Kernighan's DIT output, as you originally did.

In the groff source, adjust_arc_center() seems the culprit that many of
the output devices call to mess with arc's calculations.

--
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Tue May 09 12:45:08 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d88G3-0007no-Ti
	for mharc-groff@gnu.org; Tue, 09 May 2017 12:45:07 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56212)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d88Fy-0007m8-SI
	for groff@gnu.org; Tue, 09 May 2017 12:45:07 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gardnerjohng@gmail.com>) id 1d88Fx-0004uT-4M
	for groff@gnu.org; Tue, 09 May 2017 12:45:02 -0400
Received: from mail-yb0-x22a.google.com ([2607:f8b0:4002:c09::22a]:34660)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <gardnerjohng@gmail.com>)
	id 1d88Fw-0004tj-Tz
	for groff@gnu.org; Tue, 09 May 2017 12:45:01 -0400
Received: by mail-yb0-x22a.google.com with SMTP id 8so1719470ybw.1
	for <groff@gnu.org>; Tue, 09 May 2017 09:45:00 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to; 
	bh=0aNEFVrN2IvH7ZEJ7cUcmX9N6cL3dpvLDMqrIAttd40=;
	b=CxBBuWnySYElhV0Rt8U1Ets6o+x/hcoRHWi3fQzOdkXCUXLzZy3X1+xEQXcmuN2pJV
	sZYKX8ldo5Uq9bypcd+aEdMH6l4GaeX5H2FhmyCExmqa+ZfGnIcWr/GIzVpWT9esZFrS
	c/X3VX6v3Op7jPR9S3YCH0rdEuZW91UyZQfEIA3V6rU3x/XOaC2vcK6azidiZtvP5HN7
	cbNQyxqihGwJE+2LuJr33+GLqZ8+bWqG8ifrIufn2gFJHhqeJ6ybiycBlPLt3FmnZptj
	yn2FK+HKxHKP7Gbfadrgy96QnBOxedkr0KG4T8ZUl0DEW/QpjuWO9n53gsYmQ3Ym3V/P
	uA7w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:mime-version:in-reply-to:references:from:date
	:message-id:subject:to;
	bh=0aNEFVrN2IvH7ZEJ7cUcmX9N6cL3dpvLDMqrIAttd40=;
	b=IXnsUMJmcESFBURTfFZVR8GTDg5O8fyJh4Szr3EvUhQqCpm9/l9yv10GDWcMsP6U0y
	vfg/zo7/I8EzuFjISC/6J+OaXIFQ9kU9xB+2r0f3P1LdJM/w+3C8Ep13s+/AGqHV2AZf
	XvSaoYxpZ6tTwYtbRrJvo1Jly+PGYR2hqLVNeLVflezjE68Q08qiSK1YSHqS3+PogllJ
	V5FBGo1FfoQuZjwhg0rzxRRL2mZ5dY3hM/j+VocBiQybgvG7bONCLd+utLEWAhYnkR5D
	CnyT5sNUDjl9xMm65ixV9hI1hapMbNUsVZEIvMX8jVBPiFHBgp/Ucpi5Kt1E0jNEud9i
	ZEFw==
X-Gm-Message-State: AODbwcB/3dsgR1zYdR0nsiA7pJc6hQdCUTI3i9oXZFxbOyp/REPKiQTD
	Y3/rnGK7iflCq7AwYs26eUaZxXtU2qACLgI=
X-Received: by 10.37.77.138 with SMTP id a132mr933814ybb.170.1494348299625;
	Tue, 09 May 2017 09:44:59 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.37.171.14 with HTTP; Tue, 9 May 2017 09:44:43 -0700 (PDT)
In-Reply-To: <20170509121622.1E4F1204E2@orac.inputplus.co.uk>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<20170428153832.EDB8520302@orac.inputplus.co.uk>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
	<CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
	<20170509121622.1E4F1204E2@orac.inputplus.co.uk>
From: John Gardner <gardnerjohng@gmail.com>
Date: Wed, 10 May 2017 02:44:43 +1000
Message-ID: <CAGcdajecXVi13hMbXria3ER2Bhi=id4d9jrrQtPbcLN-yZTGQQ@mail.gmail.com>
To: groff <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c09::22a
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Content-Filtered-By: Mailman/MimeDel 2.1.21
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 16:45:07 -0000

>
> *The documentation is correct. The code is wrong. Later code copied
> earlier code.*


Ugh, that's even more confusing. Looks like gropdf's comments could do with
a clean-up: these lines had me confused as well:

# do it in 4 pieces

my $totang=3D($endang-$startang)/4;


> # Now 1 piece
> my $x0=3Dcos($totang/2);
> my $y0=3Dsin($totang/2);
> =E2=80=A6



*In the groff source, adjust_arc_center() seems the culprit that many of
> the output devices call to mess with arc's calculations.*


Well... right and wrong way aside, I'm simply glad to have achieved parity
with grops/gropdf. Here's a rendering <http://i.imgur.com/M4vwNaN.png> of
Eric Raymond's graph used on page 28 of "*Making Pictures with GNU PIC"*.

Needless to say, it'll be interesting to browse system documentation in
graphical form, with manpage references appropriately linked...


On 9 May 2017 at 22:16, Ralph Corderoy <ralph@inputplus.co.uk> wrote:

> Hi John,
>
> > Looks like there's a mistake in groff_out(5). It describes its
> > arc-drawing command as:
>
>     Da h1 v1 h2 v2=E2=9F=A8line-break=E2=9F=A9
>         Draw arc from current position to (h1, v1)+(h2, v2) with center
>         at (h1, v1); then move the current position to the final point
>         of the arc.
>
> CSTR 54 says
>
>     Da dh1 dv1 dh2 dv2
>         draw arc from current position to dh1 + dh2, dv1 + dv2, center
>         at dh1, dv1 from current position
>
> I think they're equivalent.
>
> > However, gropdf.pl tells a different story. To quote line #2791:
> > <http://git.savannah.gnu.org/cgit/groff.git/tree/src/
> devices/gropdf/gropdf.pl?id=3D453a8aa7c8f8dd0c78160466301f81be8c40df2e#n2=
791
> >
> >
> >     Documentation is wrong. Groff does not use Dh1,Dv1 as centre of the
> >     circle!
>
> The documentation is correct.  The code is wrong.  Later code copied
> earlier code.
>
> > I noticed something odd when drawing an arc which wasn't an
> > evenly-sized quarter-circle. For instance, the following Pic code:
> >
> >     .PS
> >     move down
> >     A: box
> >     arc at A.n
> >     line right
> >     .PE
>
> I think pic produces correct troff for this, but then grops and many
> others interpret it wrongly.  You initial attempt is correct, even
> though it produces the "wrong" diagram.  "at" for an arc sets the centre
> point;  that's A.n.  It will be anti-clockwise.  We finish the box at
> A.s.  The start of the arc is after the implicit move downwards at that
> start.
>
> Here's some additions to your test.
>
>     .PS
>     move down
>     A: box
>     arc at A.n
>     arc; arc; arc; arc
>     line right
>     line from A.n to A.n - 0, A.ht * 2
>     line from A.n to A.n + arcrad * 2, (-A.ht - arcrad) * 2
>     .PE
>
> The four arcs are to draw a circle, returning to the start point, so you
> can see grops's arc's radius isn't the default.  The two extra lines
> show the correct CSTR 54 interpretation of where the arc should start
> and end, as indeed it does when viewed with `groff -pX foo.pic'.
>
> To see groff's interpretation,
>
>     pic foo.pic | perl -pe 's/\\D/$n++; "\\Z%$n%$&"/ge' |
>     groff | ps2pdf - foo.pdf
>
> I'd guess gxditview gets it right because it has a pre-groff heritage
> and so coded to Kernighan's DIT output, as you originally did.
>
> In the groff source, adjust_arc_center() seems the culprit that many of
> the output devices call to mess with arc's calculations.
>
> --
> Cheers, Ralph.
> https://plus.google.com/+RalphCorderoy
>
>

From MAILER-DAEMON Tue May 09 14:31:49 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d89vJ-00056z-NF
	for mharc-groff@gnu.org; Tue, 09 May 2017 14:31:49 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:60642)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d89vH-00056r-Kc
	for groff@gnu.org; Tue, 09 May 2017 14:31:48 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d89vE-0007q7-HZ
	for groff@gnu.org; Tue, 09 May 2017 14:31:47 -0400
Received: from relay01.pair.com ([209.68.5.15]:35164)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d89vE-0007pz-AH
	for groff@gnu.org; Tue, 09 May 2017 14:31:44 -0400
Received: from orac.inputplus.co.uk (unknown [84.93.68.25])
	by relay01.pair.com (Postfix) with ESMTP id 28BEBD00B13
	for <groff@gnu.org>; Tue,  9 May 2017 14:31:41 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id F3BDA1FB1B
	for <groff@gnu.org>; Tue,  9 May 2017 19:31:39 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
In-reply-to: <CAGcdajecXVi13hMbXria3ER2Bhi=id4d9jrrQtPbcLN-yZTGQQ@mail.gmail.com>
References: <CAGcdaje8Nz6oJdnDYfnESwQ1opNN0CGD0+XT9jKAUgvkf3PZRQ@mail.gmail.com>
	<20170428153832.EDB8520302@orac.inputplus.co.uk>
	<CAGcdajd-mz0-a6KQkxpR6XKzGcS=VM9kgHbH=eTNbRNiqcieHg@mail.gmail.com>
	<CAGcdajcC7-Mht7b5QGM2k2g7bS1QfdmK1KbG1qtH+yVvNL7CLw@mail.gmail.com>
	<20170509121622.1E4F1204E2@orac.inputplus.co.uk>
	<CAGcdajecXVi13hMbXria3ER2Bhi=id4d9jrrQtPbcLN-yZTGQQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="----- =_aaaaaaaaaa0"
Content-ID: <29029.1494354678.0@orac.inputplus.co.uk>
Date: Tue, 09 May 2017 19:31:39 +0100
Message-Id: <20170509183139.F3BDA1FB1B@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 18:31:48 -0000

------- =_aaaaaaaaaa0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <29029.1494354678.1@orac.inputplus.co.uk>

Hi John,

> > In the groff source, adjust_arc_center() seems the culprit that many
> > of the output devices call to mess with arc's calculations.
>
> Well... right and wrong way aside, I'm simply glad to have achieved
> parity with grops/gropdf.

CSTR 54 documents the DIT format, `Da' included.  Plan 9, Heirloom
troff, groff, should all implement it the same way.  If groff doesn't,
that's a groff bug AFAICS.

I've run

    .PS
    move down
    A: box
    arc at A.n
    arc; arc; arc; arc
    line right
    line from A.n to A.n - 0, A.ht * 2
    line from A.n to A.n + arcrad * 2, (-A.ht - arcrad) * 2
    .PE

through heirloom-doctools 160217-1's pic|troff|dpost, groff 1.22.3-7's
pic, troff, and grops, and then groff with -X for gxditview.  I'll
attach the PNG, but if it doesn't make it through Mailman then see
https://s18.postimg.org/99hxk3ngp/troff-pic-arc-comparison.png

I think the arc should start at the current position, i.e. A.s, be
centred by the "at" at A.n, and be heading down, anti-clockwise.
heirloom matches this.  groff's grops is just wrong. gxditview is close
to heirloom, but with the wrong start position.

Can anyone shed light on why groff deviates from CSTR 54 theory and
historic practice?

-- 
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


------- =_aaaaaaaaaa0
Content-Type: image/png; name="troff-pic-arc-comparison.png"
Content-Description: troff-pic-arc-comparison.png
Content-Disposition: attachment; filename="troff-pic-arc-comparison.png"
Content-Transfer-Encoding: base64

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

------- =_aaaaaaaaaa0--


From MAILER-DAEMON Tue May 09 14:50:39 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d8ADX-00057Q-50
	for mharc-groff@gnu.org; Tue, 09 May 2017 14:50:39 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39913)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1d8ADU-00056y-Op
	for groff@gnu.org; Tue, 09 May 2017 14:50:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1d8ADP-00084r-Nt
	for groff@gnu.org; Tue, 09 May 2017 14:50:36 -0400
Received: from mout.gmx.net ([212.227.15.15]:49256)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <werner.lemberg@gmx.de>)
	id 1d8ADP-00084F-DY
	for groff@gnu.org; Tue, 09 May 2017 14:50:31 -0400
Received: from gnu.org ([77.119.131.22]) by mail.gmx.com (mrgmx003
	[212.227.17.190]) with ESMTPSA (Nemesis) id 0MJSQ7-1dA4pF0XdL-0035fj;
	Tue, 09 May 2017 20:50:26 +0200
Date: Tue, 09 May 2017 20:50:21 +0200 (CEST)
Message-Id: <20170509.205021.672925770538197375.wl@gnu.org>
To: ralph@inputplus.co.uk
Cc: groff@gnu.org
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20170509183139.F3BDA1FB1B@orac.inputplus.co.uk>
References: <20170509121622.1E4F1204E2@orac.inputplus.co.uk>
	<CAGcdajecXVi13hMbXria3ER2Bhi=id4d9jrrQtPbcLN-yZTGQQ@mail.gmail.com>
	<20170509183139.F3BDA1FB1B@orac.inputplus.co.uk>
X-Mailer: Mew version 6.7 on Emacs 26.0.50 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: <werner.lemberg@gmx.de>
X-Provags-ID: V03:K0:MuYRFV54Q6Y6cHXZpSAhWiHfbvSCKgt3yL01cDvH5V3MdF4n+5d
	ewCgzOuET+NCiAZjUCJFtsNcsElWM1PAdn6iFVG8Q8PzJ7xCsEcZ3YC41QWuRuGx47ixItP
	DPIo9b0tJsrminFyLUIMxx441WGaj4xz77m/UKkSK8DKDJYAUArPrHYUHMGUYAgb1uHEP+e
	a1g9dTyZRum9Dr8c/OO6A==
X-UI-Out-Filterresults: notjunk:1;V01:K0:1Gp6k3YxptY=:EZ3/e6iwKM4GZ4+g6oHt9w
	WfeY1c6AmGmPAyGyKarfsTGXWzxYAumLh8wniluNmPRqSgZ0Hc6S4tmShu+he3uYmhAVJOSzo
	3Z0BH/Bipsyg4+OpwFTo8034RrssiYvKDG0bLpYi/WeLJ4ihDVp5NnxymwpiP7V92VKtH2Brx
	TXFSqnSH2ORJqdrZGb4kLbLKyMKZRXuzj+8ylBb7zSd7kAJtt0FLasW7Oou74rf7DrUAABcdP
	KHBC0XCagCjFG0f9UJHaRvKEUtgPuONyln1wGzqcJgTdiFKxBEN8LdiFRCugtTWlZL2lN7mLa
	uSsa1saF7NUHAqjYpy4aUSbEBfrMDf+3GvXrbAEUhefwFbonuTZXacS46zvPtcd0nHW3SN3Ae
	7qfQ4w//O9B/2K8Tldi9voT0G0ezRKEIti0OiZAHmP5A2umTBai5fA4XtijqePEwprrfKZatq
	j55zLnFFkPXSFPzDmDRcKgkCEbVf5/HakfQiqfudEZW7FF86OhsCpetJg0oT2zSJ1O+Lw684L
	PwTR3DURI+JuEpfB+uRcjHmrlplu6vJlKnBlaaeR556WpYwVmxeszwKnlFIUPbt5nA7e5oxAb
	2owJizjvjMIsT+9TrtET48CuDIsjX8T1n4TFp7Udt4jJhFN8Z34vli2hLJv20W/rGqnCUipZq
	A4J/AXTmexljidTH9723s2Gu/YUKudeRt+giOxu4gIs4OyQMrKSo3TiV9/RblUhClTF7bwMUX
	LNn/IdRnvkI/GdffgGpPOL8HRtwCHOB0RM14IaSa04NRTBS21MObhMheJjLQVTt4J3A+IitxX
	DCiS0eW
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 212.227.15.15
Subject: Re: [Groff] Problems with arcs and angles
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 18:50:37 -0000


> Can anyone shed light on why groff deviates from CSTR 54 theory and
> historic practice?

I guess it's simply a bug.  It would be great if there were a test
suite for the PIC to catch such errors...


    Werner


From MAILER-DAEMON Tue May 09 17:32:56 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d8Cka-000377-Ff
	for mharc-groff@gnu.org; Tue, 09 May 2017 17:32:56 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59279)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1d8CkY-000342-1d
	for groff@gnu.org; Tue, 09 May 2017 17:32:54 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1d8CkU-0004hH-VN
	for groff@gnu.org; Tue, 09 May 2017 17:32:54 -0400
Received: from mout.gmx.net ([212.227.15.19]:64316)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <werner.lemberg@gmx.de>)
	id 1d8CkU-0004gx-Ky
	for groff@gnu.org; Tue, 09 May 2017 17:32:50 -0400
Received: from gnu.org ([77.119.131.22]) by mail.gmx.com (mrgmx001
	[212.227.17.190]) with ESMTPSA (Nemesis) id 0MWkep-1dW9dU2xRL-00XtbC;
	Tue, 09 May 2017 23:32:48 +0200
Date: Tue, 09 May 2017 23:32:43 +0200 (CEST)
Message-Id: <20170509.233243.2284887211736820819.wl@gnu.org>
To: groff@gnu.org, bertrand.garrigues@laposte.net
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20170509211513.73C7020ABA@vcs0.savannah.gnu.org>
References: <20170509211512.23171.32015@vcs0.savannah.gnu.org>
	<20170509211513.73C7020ABA@vcs0.savannah.gnu.org>
X-Mailer: Mew version 6.7 on Emacs 26.0.50 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: <werner.lemberg@gmx.de>
X-Provags-ID: V03:K0:6IpUaaeSBsZ8X854YVhxZF+oH3AhzBj6f56RybcS0FhRzW9wJ5/
	8fJS/SRatu+aYmG+vzRyj/GQiCb/dNQNkRZaAaInlZYOAGIwVIk9viVoKB3NrZ9WyoOLN0M
	VgdUML92t4ldszfwtC+mSnAtnW3ItE7o70okJ3O1HTg1L4/Y6cn/PFrk35YDGwo8OEeBJcF
	CMTuUHW0DDJlHC00PJHbw==
X-UI-Out-Filterresults: notjunk:1;V01:K0:Ff2Kmc13m74=:H3Tcbuh8DRw+s7IQM/saVe
	uOSgo23jBJfN30Y/Ss8xD8LI6KEQSPoGCrK647FIVPNRQ5smVSS5CHT7sZugAH3JT+9jaAklq
	v9NvGEzXACo83XsGMOrncg9FeHIAajow2vcIpSu4oqykKuFhPNkHLFVHTmXV9OvUI8WSopnec
	kIMAtEU5/oSsrpd8letHzxvLXe55nrsnK5lFqPHFEZtsJQ1y0i1ROtnqYm3afwOMgqvz0GgVk
	dx62ci2rdzmhHrJHaWfcsWxFUX8Pr2F4CwVMTJCzpDi+GtGfhkWU6JJnsUSQ8+AD+kLFzOILu
	duzWheufeI9CN8SjKOjwR5qO2LnnMTsNQHtRJV85j2g64SOBxD087FTVJSIQ714CMteMqCeex
	SDqT0kYoXlzB3C87EI91qy44NUv9dmyFV9282U5nNiB7tlMXvRq9NY1uo/IE7CexEesTRUkEq
	lWq2N1NvlUGv9JSV792XlTKcM0nr6d08v2441vXZRhC6vR2epp/OwNTDr9HdMXPzSEssgAEz1
	kd9EG0qadbbvhGrA5ToJyF+UuDpqghv5slZ07Ighz6f+KKcYoNQ4xyK7JQ+3ZtxXQ4XopwX6h
	e+HnXyWzAvHFjWWI1RRiIIwGMCwXzCu7bg7vEaDD0NsXbnUHiZKsFXYAuKqhGO2R0Uhfdokjs
	/tfodje4WJQSaORnbFqJHzR/xeRtFY88X69uEuHIzaQWCS01zUz3bzqNvTZfHGnwpZhEaKdyJ
	JmEl/SGtfsnzWarphZjm3pV8TQ7YGoimk6efORHBXJVmMHIAQOEvbxwQx+ay8XcOU/q0oA8Jr
	jRf6eSQ
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 212.227.15.19
Subject: Re: [Groff] [groff] 01/01: Package `ghostscript' 9.21 renamed some
 fonts installed in `/usr/share/ghostscript/9.21/Resource/Font',
 e.g. URWGothicL-Demi renamed to URWGothic-Demi,
 and droped the installation of URW fonts in
 `/usr/share/fonts/type1/gsfonts/',
 breaking font generation in `font/devpdf/util/BuildFoundries.pl'.
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 21:32:55 -0000


> commit 2b5a438e0c205a5f118b456db7438e35dab50e09
> Author: Bertrand Garrigues <bertrand.garrigues@laposte.net>
> Date:   Mon May 8 21:46:03 2017 +0200
> 
>     Package `ghostscript' 9.21 renamed some fonts installed in
>     `/usr/share/ghostscript/9.21/Resource/Font', e.g. URWGothicL-Demi
>     renamed to URWGothic-Demi, and droped the installation of URW
>     fonts in `/usr/share/fonts/type1/gsfonts/', breaking font
>     generation in `font/devpdf/util/BuildFoundries.pl'.

Thanks for committing!  Please note, however, that the first line of a
commit message should be exactly one line no longer than, say, 75
characters.  The second line should be empty, and then the rest of the
commit message follows.

As you can see in the `Subject' line, it is overlong for this very
commit.


    Werner


From MAILER-DAEMON Tue May 09 17:56:34 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d8D7R-00015w-WE
	for mharc-groff@gnu.org; Tue, 09 May 2017 17:56:34 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36002)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d8D7Q-00014n-64
	for groff@gnu.org; Tue, 09 May 2017 17:56:33 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1d8D7M-0002AL-Ak
	for groff@gnu.org; Tue, 09 May 2017 17:56:32 -0400
Received: from relay01.pair.com ([209.68.5.15]:44544)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ralph@inputplus.co.uk>)
	id 1d8D7M-0002AF-6D
	for groff@gnu.org; Tue, 09 May 2017 17:56:28 -0400
Received: from orac.inputplus.co.uk (unknown [84.93.68.25])
	by relay01.pair.com (Postfix) with ESMTP id F36A2D00B4D
	for <groff@gnu.org>; Tue,  9 May 2017 17:56:26 -0400 (EDT)
Received: from orac.inputplus.co.uk (orac.inputplus.co.uk [IPv6:::1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id D2BA71FB1B
	for <groff@gnu.org>; Tue,  9 May 2017 22:56:25 +0100 (BST)
To: groff@gnu.org
From: Ralph Corderoy <ralph@inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
In-reply-to: <20170509.233243.2284887211736820819.wl@gnu.org>
References: <20170509211512.23171.32015@vcs0.savannah.gnu.org>
	<20170509211513.73C7020ABA@vcs0.savannah.gnu.org>
	<20170509.233243.2284887211736820819.wl@gnu.org>
Date: Tue, 09 May 2017 22:56:25 +0100
Message-Id: <20170509215625.D2BA71FB1B@orac.inputplus.co.uk>
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 209.68.5.15
Subject: Re: [Groff] [groff] 01/01: Package `ghostscript' 9.21 renamed some
 fonts installed in `/usr/share/ghostscript/9.21/Resource/Font',
 e.g. URWGothicL-Demi renamed to URWGothic-Demi,
 and droped the installation of URW fonts in
 `/usr/share/fonts/type1/gsfonts/',
 breaking font generation in `font/devpdf/util/BuildFoundries.pl'.
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 09 May 2017 21:56:33 -0000

Hi,

Werner wrote:
> Please note, however, that the first line of a commit message should
> be exactly one line no longer than, say, 75 characters.

See DISCUSSION in git-commit(1).
(It's length is too short;  Werner's right.)

--=20
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy


From MAILER-DAEMON Wed May 10 15:20:38 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d8XA6-0005KL-8X
	for mharc-groff@gnu.org; Wed, 10 May 2017 15:20:38 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48993)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1d8XA4-0005KF-Lv
	for groff@gnu.org; Wed, 10 May 2017 15:20:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1d8XA1-0000ga-0q
	for groff@gnu.org; Wed, 10 May 2017 15:20:36 -0400
Received: from smtpoutz28.laposte.net ([194.117.213.103]:55848
	helo=smtp.laposte.net)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <bertrand.garrigues@laposte.net>)
	id 1d8XA0-0000Vr-Mm
	for groff@gnu.org; Wed, 10 May 2017 15:20:32 -0400
Received: from smtp.laposte.net (localhost [127.0.0.1])
	by lpn-prd-vrout016 (Postfix) with ESMTP id 00B55119D7C
	for <groff@gnu.org>; Wed, 10 May 2017 21:20:05 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=laposte.net; s=mail0;
	t=1494444005; bh=gkyhCTtBsC5F9FhogEix0ogKq/+uckQ3xNXO4/CtWEk=;
	h=From:To:Cc:Subject:References:Date:In-Reply-To;
	b=f1ZXME39GHnuxRgyGIRipyyxO8ARFAtpUjCRBHwWy+m2xpty1xsJqoXXAa9NBGCYU
	zCtxxS68dgXSvofkjtQCpZdTY3s8jf17IFojGQsBELykq1kbWz6LGTh4LE2e1e/f+i
	qKxOOVSiqxEC1uBzIH1TLC+oiBUc0XsmD4yyGmSatf+SFoxJLW4hFbexYV6Pa/4gEr
	rJSdpWnim8Rp1wm0e93lDIiqASSRH81ShSqw5LsF+5SJP0wroKQqZt/VCFWrmpzZru
	S45sMaH2W9Qx20FEn39Dtpdum0PUQJGpQQbEK0v1ZmoNCTpCjwxqf7MgAQx3iLKaqV
	EangHHhm67f9A==
Received: from smtp.laposte.net (localhost [127.0.0.1])
	by lpn-prd-vrout016 (Postfix) with ESMTP id E83E3119EEF
	for <groff@gnu.org>; Wed, 10 May 2017 21:20:04 +0200 (CEST)
Received: from lpn-prd-vrin001 (lpn-prd-vrin001.laposte [10.128.63.2])
	by lpn-prd-vrout016 (Postfix) with ESMTP id E5D30119FF5
	for <groff@gnu.org>; Wed, 10 May 2017 21:20:04 +0200 (CEST)
Received: from lpn-prd-vrin001 (localhost [127.0.0.1])
	by lpn-prd-vrin001 (Postfix) with ESMTP id CFF713686FF
	for <groff@gnu.org>; Wed, 10 May 2017 21:20:04 +0200 (CEST)
Received: from hsiaomi. (jau72-h04-89-95-237-97.dsl.sta.abo.bbox.fr
	[89.95.237.97])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by lpn-prd-vrin001 (Postfix) with ESMTPSA id 9E7B13686EB;
	Wed, 10 May 2017 21:20:04 +0200 (CEST)
From: Bertrand Garrigues <bertrand.garrigues@laposte.net>
To: Werner LEMBERG <wl@gnu.org>
Cc: groff@gnu.org
References: <20170509211512.23171.32015@vcs0.savannah.gnu.org>
	<20170509211513.73C7020ABA@vcs0.savannah.gnu.org>
	<20170509.233243.2284887211736820819.wl@gnu.org>
Date: Wed, 10 May 2017 21:20:04 +0200
In-Reply-To: <20170509.233243.2284887211736820819.wl@gnu.org> (Werner
	LEMBERG's message of "Tue, 09 May 2017 23:32:43 +0200 (CEST)")
Message-ID: <87shkcmsd7.fsf@laposte.net>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-VR-SrcIP: 89.95.237.97
X-VR-FullState: 0
X-VR-Score: -100
X-VR-Cause-1: gggruggvucftvghtrhhoucdtuddrfeeljedrtdefgddufeekucetufdoteggodetrfdotffvucfrrhho
X-VR-Cause-2: fhhilhgvmecunfetrffquffvgfenuceurghilhhouhhtmecuhedttdenucesvcftvggtihhpihgvnhht
X-VR-Cause-3: shculddquddttddmnecujfgurhephffvufhfffgjkfgfgggtsehttdertddtredtnecuhfhrohhmpeeu
X-VR-Cause-4: vghrthhrrghnugcuifgrrhhrihhguhgvshcuoegsvghrthhrrghnugdrghgrrhhrihhguhgvsheslhgr
X-VR-Cause-5: phhoshhtvgdrnhgvtheqnecukfhppeekledrleehrddvfeejrdeljeenucfrrghrrghmpehmohguvgep
X-VR-Cause-6: shhmthhpohhuthdphhgvlhhopehhshhirghomhhirddpihhnvghtpeekledrleehrddvfeejrdeljedp
X-VR-Cause-7: mhgrihhlfhhrohhmpegsvghrthhrrghnugdrghgrrhhrihhguhgvsheslhgrphhoshhtvgdrnhgvthdp
X-VR-Cause-8: rhgtphhtthhopeiflhesghhnuhdrohhrgh
X-VR-AvState: No
X-VR-State: 0
X-VR-State: 0
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 194.117.213.103
Subject: Re: [Groff] [groff] 01/01: Package `ghostscript' 9.21 renamed some
 fonts installed in `/usr/share/ghostscript/9.21/Resource/Font',
 e.g. URWGothicL-Demi renamed to URWGothic-Demi,
 and droped the installation of URW fonts in
 `/usr/share/fonts/type1/gsfonts/',
 breaking font generation in `font/devpdf/util/BuildFoundries.pl'.
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 10 May 2017 19:20:37 -0000

Werner,
On Tue, May 09 2017 at 11:32:43 PM, Werner LEMBERG <wl@gnu.org> wrote:
> Thanks for committing!  Please note, however, that the first line of a
> commit message should be exactly one line no longer than, say, 75
> characters.  The second line should be empty, and then the rest of the
> commit message follows.
>
> As you can see in the `Subject' line, it is overlong for this very
> commit.

Yes sorry, I think you already told me about that; I'll pay more
attention to it next time.

Regards,

Bertrand Garrigues


From MAILER-DAEMON Sat May 13 19:53:04 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d9gqO-0003a6-NN
	for mharc-groff@gnu.org; Sat, 13 May 2017 19:53:04 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:46634)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d9gqM-0003Zy-5D
	for groff@gnu.org; Sat, 13 May 2017 19:53:03 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d9gqK-0006oV-TN
	for groff@gnu.org; Sat, 13 May 2017 19:53:02 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:40650)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d9gqK-0006l0-KL
	for groff@gnu.org; Sat, 13 May 2017 19:53:00 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>) id 1d9gqF-0003Gd-9h
	for groff@gnu.org; Sun, 14 May 2017 01:52:56 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>) id 1d9gqE-0007sA-Q8
	for groff@gnu.org; Sun, 14 May 2017 01:52:54 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>) id 1d9gqE-0004GG-Kd
	for groff@gnu.org; Sun, 14 May 2017 01:52:54 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 3236bb4a
	for <groff@gnu.org>; Sun, 14 May 2017 01:52:54 +0200 (CEST)
Date: Sun, 14 May 2017 01:52:54 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20170513235254.GA81748@athene.usta.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: [Groff] FWD: [bug #51021] groff_man(7) manual page: recommendations
 for escape sequences
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 13 May 2017 23:53:04 -0000

Also posting the patch here for easy reference, and as a heads-up.

----- Forwarded message from Ingo Schwarze -----

Date: Sat, 13 May 2017 19:29:49 -0400 (EDT)
To: bug-groff@gnu.org
Subject: [bug #51021] [PATCH] groff_man(7) manual page: recommendations for
	escape sequences

URL:
  <http://savannah.gnu.org/bugs/?51021>

It was recently discussed on <groff@gnu.org> that including basic
style recommendations into the groff_man(7) manual page would be
helpful for manual page authors, both to make it easier to find
low-level idioms needed in manual pages without requiring authors
to read all the whole, long groff(7) and groff_char(7) manuals, and
also to discourage excessive use of low level syntax that puts
portability in jeopardy.

That is a very diverse topic, so i'm focussing on one very specific
aspect here: recommendations for escape sequences.

Note that i'm deliberately not attempting to mix any other issues
or improvements into this patch.

I have ordered the list in ASCII-alphabetic order.



diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 2007bbbf..5e7b7758 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1186,6 +1186,168 @@ some viewer that is important to your audience.
 If in doubt, copy the implementation onto your page.
 .
 .
+.PP
+In a way similar to using
+.I groff
+requests, it is possible to use the facilities documented in the
+ESCAPE SEQUENCES section of the
+.BR groff (7)
+manual page and in the
+.BR groff_char (7)
+manual page.
+.
+Regarding portability, similar caveats apply as with respect to
+.I groff
+requests.
+.
+Some escape sequences are however required for correct typesetting
+even in manual pages and usually do not cause portability problems:
+.
+.TP
+.RB \(dq \e\  \(dq
+Unpaddable non-breaking space character.
+.
+.TP
+.B \e&
+Zero-width space.
+.
+Used for different kinds of escaping, for example after abbreviations
+that occur at the end of an input line to prevent misinterpretation
+of the final dot as a full stop ending a sentence, or before an
+apostroph or dot at the beginning of a text input line to prevent
+misinterpretation as a macro line, for example:
+.sp
+.EX
+The
+\&.B .gcolor
+request supports several color names, e.g.\e&
+\e&'green', by default.
+.EE
+.
+.TP
+.B \e(aq
+ASCII apostroph.
+.
+Useful for syntax elements of programming languages because some
+output devices might replace unescaped apostrophes with right single
+quotation marks.
+.
+.TP
+.B \e(dq
+Sometimes needed on macro lines to prevent the interpretation of the
+ASCII quotation mark character \(oq\(dq\(cq as the beginning or end
+of a macro argument.
+.
+.TP
+.B \e(em
+Used as a punctuation mark for an interruption in a sentence\(emlike
+in this one.
+.
+.TP
+.B \e(en
+Used to separate the two ends of a range, in particular between
+numbers, for example: the digits 1\(en9.
+.
+.TP
+.B \e(ga
+ASCII grave accent.
+.
+Useful for syntax elements of programming languages, for example
+shell command substitutions, because some output devices might
+replace unescaped grave accents with left single quotation marks.
+.
+.TP
+.B \e(ha
+ASCII circumflex accent.
+.
+Useful for syntax elements of programming languages because some
+output devices might replace unescaped circumflex accents with
+non-ASCII glyphs like the Unicode U+02C6 modifier letter circumflex.
+.
+.TP
+.B \e(ti
+ASCII tilde.
+.
+Useful for syntax elements of programming languages because some
+output devices might replace unescaped tildes with non-ASCII glyphs
+like the Unicode U+02DC small tilde.
+.
+.TP
+.B \e-
+Minus sign.
+.
+Also use this to display syntax elements that require the ASCII
+hyphen-minus character, for example command line options and C
+language operators.
+.
+The unesacped \(oq\-\(cq input character is not appropriate for
+these cases because it may render as a hyphen on some output devices.
+.
+.TP
+.B \ec
+If this escape sequence occurs at the end of an input line, no
+white space is inserted between the last glyph resulting from this
+and the first glyph resulting from the next input line.
+.
+This is occasionally useful when three different fonts are needed
+in one single word, for example:
+.sp
+.EX
+\&.BR "dd if" =\ec
+\&.I file
+.EE
+.sp
+Alternatively, and with likely better portability, the
+.B \ef
+font escape sequence can be used, see below.
+.sp
+Attempting to use
+.B \ec
+to include the output from more than one macro line into the head of a
+.B .TP
+macro is non-portable and will misrender with groff-1.22.3,
+mandoc-1.14.1, older versions of these programs, and with other
+formatters.
+.
+.TP
+.B \ee
+Widely used in manual pages to represent a backslash output glyph.
+.
+It works reliably as long as the
+.B .ec
+request is not used, which should never happen in manual pages, and
+it is slightly more portable than the more exact
+.B \e(rs
+escape sequence.
+.
+.TP
+.BR \efB ,\  \efI ,\  \efR ,\  \efP
+Switch to bold, italic, roman, or back to the previous font,
+respectively.
+.
+This is needed when three different fonts are required on a single
+input line, for example:
+.sp
+.EX
+\&.TP
+\efBif\efP=\efIfile\efP
+.EE
+.sp
+It can also be used if three different fonts are needed in one
+single word.  It is likely more portable than
+.BR \ec .
+.sp
+As long as only two fonts are needed, using font alternation
+macros like
+.B .BR
+usually results in more readable source code.
+.
+.
+.PP
+For maximum portability, escape sequences and special characters
+not listed above are better avoided in manual pages.
+.
+.
 .\" --------------------------------------------------------------------
 .SH FILES
 .\" --------------------------------------------------------------------


From MAILER-DAEMON Sun May 14 09:15:19 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d9tMl-0006nS-Ml
	for mharc-groff@gnu.org; Sun, 14 May 2017 09:15:19 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43932)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d9tMk-0006mB-36
	for groff@gnu.org; Sun, 14 May 2017 09:15:19 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1d9tMj-00047F-1q
	for groff@gnu.org; Sun, 14 May 2017 09:15:18 -0400
Received: from scc-mailout-kit-02.scc.kit.edu
	([2a00:1398:9:f712::810d:e752]:54431)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1d9tMi-00045F-Rp
	for groff@gnu.org; Sun, 14 May 2017 09:15:16 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1d9tMf-0008Jw-C2; Sun, 14 May 2017 15:15:14 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1d9tMe-0005CF-QD; Sun, 14 May 2017 15:15:12 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1d9tMe-0004k7-KV; Sun, 14 May 2017 15:15:12 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id acd41bdf;
	Sun, 14 May 2017 15:15:12 +0200 (CEST)
Date: Sun, 14 May 2017 15:15:12 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: groff@gnu.org
Message-ID: <20170514131512.GB90505@athene.usta.de>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
	<20170503103708.7698D2156F@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170503103708.7698D2156F@orac.inputplus.co.uk>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:1398:9:f712::810d:e752
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 14 May 2017 13:15:19 -0000

Hi Ralph,

Ralph Corderoy wrote on Wed, May 03, 2017 at 11:37:08AM +0100:
> Ingo wrote:

>> Given that the man(7) .TP .itc hack got committed to groff
> ...
>> Of course, i still don't recommend actually using it, because that
>> would make your manual page misrender on groff <= 1.22.3, on mandoc <=
>> 1.14.1, and on any version of anything else.

> This is sad news.  It's an insufficient improvement due to one man's
> dislike of inline \f.  It shouldn't be used.  Hopefully groff's
> documentation points out in all cases that it's incompatible?

So far, i did not find any place in groff's documentation explaining
that.  In groff(7), the description of \c is very vague.  While

  https://www.gnu.org/software/groff/manual/html_node/Line-Control.html

is considerably more detailed, it is still somewhat unclear, in
particular because the concept of input text lines remains undefined
(apparently, macro lines sometimes count as text lines, but this
is neither said nor obvious) and because it is not completely clear
what "continuation of the same input text line" means (apparently,
a dot in the first column is still treated as a macro invocation,
which it wouldn't be if it were on the same input line).  So it was
already noticed that \c documentation is unclear.  I guess that is
because that escape sequence relies on internal undocumented concepts.
It was also noted that the description of \c doesn't fully match
the description in Heirloom documentation.

In any case, the documentation of \c does not document interaction
with macro sets, and i guess doing so would not be an improvement
because how \c interacts with macro sets depends on implementation
details of the respective macros, and besides, low-level reference
documentation usually shouldn't talk about high-level user facilities.


On the other hand, the groff_man(7) manual page so far doesn't talk
about low-level constructs at all, except for discouraging them in
a wholesale manner.  While that discouragement is clearly of a noble
intention, it is unfortunately unrealistic.

A day ago, i posted a patch with a first step to improve groff_man(7)
in this respect, also mentioning the .TP - \c interaction in passing.

Yours,
  Ingo


From MAILER-DAEMON Sun May 14 11:36:05 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1d9vYz-0007v4-Kc
	for mharc-groff@gnu.org; Sun, 14 May 2017 11:36:05 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36444)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=8AkrWS=4U=schaffter.ca=peter@eigbox.net>)
	id 1d9vYx-0007uu-WD
	for groff@gnu.org; Sun, 14 May 2017 11:36:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=8AkrWS=4U=schaffter.ca=peter@eigbox.net>)
	id 1d9vYu-0002Uq-Pw
	for groff@gnu.org; Sun, 14 May 2017 11:36:03 -0400
Received: from bosmailout04.eigbox.net ([66.96.189.4]:38938)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71)
	(envelope-from <SRS0=8AkrWS=4U=schaffter.ca=peter@eigbox.net>)
	id 1d9vYu-0002Tr-D0
	for groff@gnu.org; Sun, 14 May 2017 11:36:00 -0400
Received: from bosmailscan05.eigbox.net ([10.20.15.5])
	by bosmailout04.eigbox.net with esmtp (Exim) id 1d9v5F-0006If-Gg
	for groff@gnu.org; Sun, 14 May 2017 11:05:21 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
	d=schaffter.ca; s=dkim; h=Sender:In-Reply-To:Content-Type:MIME-Version:
	References:Message-ID:Subject:To:From:Date:Reply-To:Cc:
	Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:
	Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:
	List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive;
	bh=IA4SLo4A/D8IKTjpPV6x5zozSU+yEzSF1lNKB7AkVSI=;
	b=UgJ8j55gIwpszvWh+742S7wWW
	8uJpyVnjj3N7mkKkqB5m5QcMINPNr5U+lqQVkSdn/TxsaH8yO+wxq4ZO9fjJabflP6otVz6d6jGxp
	yPdLOGACOwdfyWM6j7EG5yCL6VhBJkDEumPlshJ8VnZcs9f36D5l4tnwHdNWw4dhRwQxFBA5yPK2C
	ejTS+i1GabNF6Y8NWQ8IfA/eje+i+FacwGh854Op0mfe6K4uxe4nLNSh/lqhf1a0JHV4uw6zKJy/X
	gv6DKo6CfGfJOZE7U8aBauSjXrav55uEXyEF7JrtVsMbbcC4DB0ebBx040mo39ywS7V00sCGJjMDV
	MgtdN+V2Q==;
Received: from [10.115.3.32] (helo=bosimpout12)
	by bosmailscan05.eigbox.net with esmtp (Exim) id 1d9v5F-0005Ju-AM
	for groff@gnu.org; Sun, 14 May 2017 11:05:21 -0400
Received: from bosauthsmtp14.yourhostingaccount.com ([10.20.18.14])
	by bosimpout12 with 
	id LF5E1v00X0JCtq201F5HtA; Sun, 14 May 2017 11:05:21 -0400
X-Authority-Analysis: v=2.2 cv=U6ziNaju c=1 sm=1 tr=0
	a=AnsiuLKgxXFeB68GILQVjQ==:117 a=IWnUUQGFwwBE4wtR9L5isQ==:17
	a=kj9zAlcOel0A:10 a=tJ8p9aeEuA8A:10 a=g_SW5-S5AAAA:8
	a=Hpfi69v9lIqA_OL6zoMA:9
	a=CjuIK1q_8ugA:10 a=zQDKbV1y6e_a9NbkwXG_:22
Received: from [206.47.101.156] (port=60551 helo=augustus)
	by bosauthsmtp14.eigbox.net with esmtpsa
	(TLSv1.2:DHE-RSA-AES128-SHA:128) (Exim) id 1d9v58-0008GP-Sm
	for groff@gnu.org; Sun, 14 May 2017 11:05:14 -0400
Received: from peter by augustus with local (Exim 4.82)
	(envelope-from <peter@schaffter.ca>) id 1d9v55-0004If-DE
	for groff@gnu.org; Sun, 14 May 2017 11:05:11 -0400
Date: Sun, 14 May 2017 11:05:11 -0400
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20170514150511.GA16489@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <20170513235254.GA81748@athene.usta.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170513235254.GA81748@athene.usta.de>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:931c98230c6409dcc37fa7e93b490c27
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 206.47.101.156
X-EN-OrigHost: unknown
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 66.96.189.4
Subject: Re: [Groff] FWD: [bug #51021] groff_man(7) manual page:
 recommendations for escape sequences
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 14 May 2017 15:36:04 -0000

Ingo --

On Sun, May 14, 2017, Ingo Schwarze wrote:
> Also posting the patch here for easy reference, and as a heads-up.

  +apostroph or dot at the beginning of a text input line to prevent
   ^^^^^^^^^

S/b "apostrophe".

Good work on the patch.  Now if we can just get manpage authors to
pay attention...

-- 
Peter Schaffter
http://www.schaffter.ca


From MAILER-DAEMON Tue May 16 04:11:19 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1dAXZf-0002aL-4F
	for mharc-groff@gnu.org; Tue, 16 May 2017 04:11:19 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54422)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1dAXZd-0002aE-K0
	for groff@gnu.org; Tue, 16 May 2017 04:11:18 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1dAXZa-0002l7-Eo
	for groff@gnu.org; Tue, 16 May 2017 04:11:17 -0400
Received: from mail-yw0-x22c.google.com ([2607:f8b0:4002:c05::22c]:33070)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1dAXZa-0002l1-9w
	for groff@gnu.org; Tue, 16 May 2017 04:11:14 -0400
Received: by mail-yw0-x22c.google.com with SMTP id 203so49098120ywe.0
	for <groff@gnu.org>; Tue, 16 May 2017 01:11:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:mime-version:content-disposition
	:user-agent; bh=DfQhHBmKvUKzmzzTC2segPtAPED2W0Eu+kZ0AivH8cg=;
	b=pufJfeL1KqxP+RhZ+JF8cDSyEahLKjfR8mz9CeAidEik4QjRSCd3znrKPh1xO7NuzJ
	x5QuVetAai3WHxhl3TrDgACt5dQWqcYC9+Em/lOYjYPCCv9nHPLhWi0ZJCvTdsDiuq6i
	9HnZGYl7q2EcHTZ+o9nOerhaIXCZCjSSuMEMqGY45NAQ28I6GLU0XT+RbXxW750pBJbq
	NvfaZJ5FYjzSGW8lPG2dKQzesFWOf8nmoU/ALhVhAPahUvTLsE5Bte6GhXQvIN/R6SeL
	6Pie2Re5WNLZrnS9O1RE5Cm+Dn3oRE62rIArL7gmSWIfMCjKlPxXVJsCNr858/5OjYrA
	VjqQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:mime-version
	:content-disposition:user-agent;
	bh=DfQhHBmKvUKzmzzTC2segPtAPED2W0Eu+kZ0AivH8cg=;
	b=hOHkYIWdH7wF4ZBHLNilPF0BoT2Xzsz4wHA4s1L0y2COKZyXErjxS7x5vRY6MVDPYJ
	W57fsJF1uQGTqKxsPvXslnGMESNgC7xYZigGcTqPB1+XaCdKeQzMMkv0yhYHVZyG4s3T
	U2HC5U6UiMsHBrNK243DpLSRHAEOQpOWPYgp0QAKVWEDV0rabgJDHMFS+/WhfICdV6sz
	/S/XswPGqzeNyD9ptc0KOum0S9NdB6WBoddHJ4CzssoVQnKIJmb+cNDvzVwVmX6gPz2Z
	7yn0SWaiTR+JbkKhkq0eah6HlbhdMayNEy9bLBcr9xd675mddgJbG7HerDTc3Ye/6WSX
	JIVw==
X-Gm-Message-State: AODbwcABEvo0nGyKO96nitbl0e2Ex4EmzWih4KEsuuA3XNOjgB8bLOuD
	esBfrqEMPiZImp7ENbc=
X-Received: by 10.129.70.2 with SMTP id t2mr8249515ywa.275.1494922273113;
	Tue, 16 May 2017 01:11:13 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	x203sm6982408ywx.76.2017.05.16.01.11.11 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 16 May 2017 01:11:11 -0700 (PDT)
Date: Tue, 16 May 2017 04:11:09 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170516081107.7n7vafa4sty3kef6@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="pqeb4kspdxv7a7cz"
Content-Disposition: inline
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::22c
Subject: [Groff] [PATCH] groff_man.7: Doc how to get >1 paragraphs under one
 tag
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 16 May 2017 08:11:18 -0000


--pqeb4kspdxv7a7cz
Content-Type: multipart/mixed; boundary="ojq2hnujsqarmzox"
Content-Disposition: inline


--ojq2hnujsqarmzox
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Note how to get >1 paragraphs under one tag.

    I have seen many creative ways of getting this wrong, including blank
    input lines.

    * Use standard English when noting effect of HP macro on fonts.

    * Note superfluity of HP macro as presentation-level; IP and TP can do
      everything it can do, and with slightly better results on some output
      devices.

    * Add Vim modeline information after Emacs mode information.

Regards,
Branden

--ojq2hnujsqarmzox
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="man.7-IP-advice.diff"

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 2007bbbf..4468359a 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -347,9 +347,16 @@ or
 .B .HP
 (or to the default value if none of them have been used yet).
 .
-Font size and face of the paragraph (but not the designator) are reset
-to its default values.
+The font size and face of the paragraph (but not the designator) are
+reset to their default values.
 .
+.IP
+Use
+.B IP
+without arguments if you simply need a new paragraph at the existing
+indentation value; for instance, to continue a multi-paragraph
+discussion after a paragraph tagged with
+.BR .TP .
 .
 .IP
 To start an indented paragraph with a particular indentation but
@@ -377,18 +384,26 @@ package to format lists.
 .
 .
 .IP \(bu 4
-.B HP
+.B TP
 is another.
 .
-This macro produces a paragraph with a left hanging indentation.
+This macro produces an unindented label followed by an indented
+paragraph.
 .
 .
 .IP \(bu 4
-.B TP
+.B HP
 is another.
 .
-This macro produces an unindented label followed by an indented
-paragraph.
+This macro produces a paragraph with a left hanging indentation.
+.
+.IP
+As noted above, use of the
+.B HP
+macro is deprecated as being presentation-level.
+(This paragraph was started with
+.B .IP
+with no arguments.)
 .RE
 .
 .
@@ -1281,3 +1296,4 @@ Local changes and customizations should be put into this file.
 .\" Local Variables:
 .\" mode: nroff
 .\" End:
+.\" vim:set filetype=nroff textwidth=72:

--ojq2hnujsqarmzox--

--pqeb4kspdxv7a7cz
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkatAMACgkQ0Z6cfXEm
bc6C9g/9G7XttfI9LG2ikeAYQSfzL1Lf3kYc8CusDWW5KDCMyrqJs4GJgTQkW+mR
qbk5aGWk/yfDYQfKY2z28kkfQRPhubsGwjWuGb1ToOXzejdFo3usbMcwuk2Tm5VA
BSauQgilEoJ9cSQIf3sQehXA4ujvObSYzXn6ncIP1GjvMB7JSxnKRaTaRu5syBbv
7szvQxHIU76bcZ5yave84tTHDqcP4lYgZ2X9gfBZsamlgRcWbUzWKOWpHqaJ3H8O
CxcAFZUHUo5MO5r7xkelOBYnWPiAXQNYS8Q6EPGV3oJkxwvXYLKGrDUuQKDslPt7
9HFATSsFFII/LX51HII042LTJhlvSvNG12l65vcFaeWHHRG4YSQxm2qK2HkK/g55
hKgb+RxJZK1A1+rsP6hxapW/hd0GNBimsTCFVmS7xQgaeSL9nmWGOP7nPWimJxG1
AEtJsa0jcZzHfbYYKNfABdQv41z1jXGu1+29KKLxPfLLrEhiAUmhUHOJi6K5FxOx
SOkt8okrFucSgf7/k4PTEmXZhjiNkwT5i70b4ru0Cxdz/vEw9OSCzRIy1FAAM5R+
iUWBPvkMyUK9+CMDtip1ATnvILjoQohrBMXpi07HdZ+piMKfSYkRMDfH6WjGL9sU
5DeJ48BPJC26HGn4YQIoYX19SLEtrWA0SWLIZPL9IDQJX7HDm6g=
=HGMz
-----END PGP SIGNATURE-----

--pqeb4kspdxv7a7cz--


From MAILER-DAEMON Tue May 16 04:26:33 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1dAXoO-0000DD-Ua
	for mharc-groff@gnu.org; Tue, 16 May 2017 04:26:32 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:58342)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1dAXoM-0000D4-PE
	for groff@gnu.org; Tue, 16 May 2017 04:26:31 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1dAXoH-0001gd-Sl
	for groff@gnu.org; Tue, 16 May 2017 04:26:30 -0400
Received: from mail-yw0-x241.google.com ([2607:f8b0:4002:c05::241]:34547)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <g.branden.robinson@gmail.com>)
	id 1dAXoH-0001g7-Od
	for groff@gnu.org; Tue, 16 May 2017 04:26:25 -0400
Received: by mail-yw0-x241.google.com with SMTP id 17so7440940ywk.1
	for <groff@gnu.org>; Tue, 16 May 2017 01:26:25 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=date:from:to:subject:message-id:references:mime-version
	:content-disposition:in-reply-to:user-agent;
	bh=KATPKqYASzJ6jNKKvnmj4DARHRG0HnQIVAyZVrLl9Ao=;
	b=TYjWzHxkWk7CXo6Wgkey1GWf0v4bVmvOov3IMuWkhCLq+N/H2rbp1o9n+SZFJB/Vta
	nV/wkcTzSc3+LFZ9yhmsEtxmK7Suvkn9A6ZE2eGlb2JNbqlEGVNpI8hP5Eye91HtHJ6L
	c8k1LjPXSvyeN9D2HMnsdJo4qDf7NIIkLkCTW0jomGKfeu5CuBtilCkqdEnq1MgdviRO
	3o1Nvdbsk0bx4tbhQQCKClsrpbuAq5tmdvZ9sNmMFxvJaNOwPgZVfuhlejhPremg3Htf
	Ahy1IIrBxSOl6NeA7kGrYUePkIGDCw15PHobiX6Q3Fbjs8NsTKl/4ck225F9rC3wB6XB
	sfGw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:date:from:to:subject:message-id:references
	:mime-version:content-disposition:in-reply-to:user-agent;
	bh=KATPKqYASzJ6jNKKvnmj4DARHRG0HnQIVAyZVrLl9Ao=;
	b=AxTL3bCI5+UiOfi8PMxDJLDJgM06+yaglW33r5QztKwgImu7Sa2RqxGyqpebkPUZIK
	b/TwSLfnuqXtPn8RDUymqKxfA3ewopPbQagaZCtSBj7pUZ5IFJE/lXLAjpVf5TauBvN8
	oDmvH/SazcN46SJB/XDbYGkMvynOWXalnkNtbQ09XjDHcYaWOjT1H/4QxwCL21jfHFSi
	g7k9Rb2C2/joTWtbljjZ382btGnKOyqwjtPwa2oRODXavJQb1X1UsN/YdWZqc7ZBv+ST
	e+Aexjv8tEpYr35jf/d//HGftRqDQr43rQtB60ayEa7dwJzyJWAqK8kzPzwTQhaOfoAr
	iJHg==
X-Gm-Message-State: AODbwcBnhg5OIdYghYiJ9Zfx3IqHzEH9irdHszrGQuGgpqkTdqdF5CBq
	ERpKrm6dDfTFLQ27HJw=
X-Received: by 10.129.182.100 with SMTP id h36mr8357093ywk.318.1494923184815; 
	Tue, 16 May 2017 01:26:24 -0700 (PDT)
Received: from crack.deadbeast.net (rrcs-24-171-184-100.midsouth.biz.rr.com.
	[24.171.184.100]) by smtp.gmail.com with ESMTPSA id
	a16sm4044388ywh.21.2017.05.16.01.26.23 for <groff@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Tue, 16 May 2017 01:26:23 -0700 (PDT)
Date: Tue, 16 May 2017 04:26:21 -0400
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
To: groff@gnu.org
Message-ID: <20170516082619.h63yievjpiztjs77@crack.deadbeast.net>
References: <20170428192801.18560.82048@vcs0.savannah.gnu.org>
	<20170428192802.6CA04210A1@vcs0.savannah.gnu.org>
	<20170501235754.GI28290@athene.usta.de>
	<20170503103708.7698D2156F@orac.inputplus.co.uk>
	<20170514131512.GB90505@athene.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="glxso67cdmgfbgcu"
Content-Disposition: inline
In-Reply-To: <20170514131512.GB90505@athene.usta.de>
User-Agent: NeoMutt/20170113 (1.7.2)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 2607:f8b0:4002:c05::241
Subject: Re: [Groff] Macro "itc" is needed to make escape "\c" useful
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 16 May 2017 08:26:32 -0000


--glxso67cdmgfbgcu
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2017-05-14T15:15:12+0200, Ingo Schwarze wrote:
> So far, i did not find any place in groff's documentation explaining
> that.  In groff(7), the description of \c is very vague.  While
>=20
>   https://www.gnu.org/software/groff/manual/html_node/Line-Control.html
>=20
> is considerably more detailed, it is still somewhat unclear, in
> particular because the concept of input text lines remains undefined
> (apparently, macro lines sometimes count as text lines, but this
> is neither said nor obvious) and because it is not completely clear
> what "continuation of the same input text line" means (apparently,
> a dot in the first column is still treated as a macro invocation,
> which it wouldn't be if it were on the same input line).
[...]

As best I can tell from experiments, \c means simply(!) "if \c is the
last token on the line, suppress any word break that would normally be
implied by the line break at the end of this line".

I've seen some cases of \c followed by ordinary trailing spaces on a
line in non-groff man pages, and that rendered the \c useless.

But I haven't worked up a suite of test cases to prove that my
interpretation is true in all contexts.

I find the description "Interrupt text processing." (groff(7)) almost
completlely uninformative.  CSTR #54 does better with "Connect to next
input text", but that's still confusing to me.  'Connect' might be a
useful mnemonic but unfortunately the idea is not further elucidated.

Regards,
Branden

--glxso67cdmgfbgcu
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAlkat5wACgkQ0Z6cfXEm
bc4N2g/+OASuY5bemu0hcs5sHqv31xJwNypoRTyN51lgsw57Ih1TfeZTcMX2ATIP
nbs6S4CICK73DjHAymIemiYqQBZmlM4XoB03d/meXusrmOk48n2yur2PUbHtzHiz
MzHQvElMeXiEEH8iDbbYXvYYo7QI0g+KcVJR4STzB2YnGvevs5NorS6cGWFEpUX7
0qgTk9TAGij/MaVrPzKx2NFk/wuBBhtlJqTjnGjLg5e1kX2Ii0ltfOK6O1+LOPrx
zdbLntshNKVnVYDwrS/39cZp8lFRNkL0XFC/CJEF62oWUqDgrZLOgCKjkaSGvGd6
6oFWAk/zTRbOwfZ3U5or4u4M9dB78c1Y5ycjpjZY8zuWKSHbMDdJ00SBGX3Yppdh
339qePAps/wUvEHHuXqk49Q7gzaVjZxsgIsvcFPrQIvcDOUQwXeJwO+BEhAq0GLg
NjVvNKOSxt0hX+xCQidlmwGZxxQ6omVTT/WIOoXCIsxqM8jEV1o2fspwTtZdg/0p
J7Uy8yw+SmrDJyni8694PZXNKlwdgF8VEwv7rXNu1y/v+9rhmXHhdt23dLT3MXsf
jRpGWC0SAov/JfvCUh60cS0LZWy7DoMRCARPHeNxT3N3PPaEyat/eQHzgpg88YQB
n7eT+nFpakZPUP6bzUyvPl9SiAUS1JCvYYGa6leh54AG+TL7f+c=
=Htl5
-----END PGP SIGNATURE-----

--glxso67cdmgfbgcu--


From MAILER-DAEMON Tue May 16 12:02:38 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1dAevl-0001aJ-WA
	for mharc-groff@gnu.org; Tue, 16 May 2017 12:02:38 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:49417)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1dAevj-0001Yf-Tb
	for groff@gnu.org; Tue, 16 May 2017 12:02:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1dAeve-0003op-Cl
	for groff@gnu.org; Tue, 16 May 2017 12:02:35 -0400
Received: from scc-mailout-kit-01-aegee.scc.kit.edu ([129.13.231.90]:35066)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <schwarze@usta.de>) id 1dAeve-0003nT-6K
	for groff@gnu.org; Tue, 16 May 2017 12:02:30 -0400
Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82]
	helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps
	(TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(envelope-from <schwarze@usta.de>)
	id 1dAevX-0004h0-Nn; Tue, 16 May 2017 18:02:24 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1dAevX-0003NR-Ij; Tue, 16 May 2017 18:02:23 +0200
Received: from athene.usta.de ([172.24.96.10])
	by donnerwolke.usta.de with esmtp (Exim 4.84_2)
	(envelope-from <schwarze@usta.de>)
	id 1dAevX-0004qZ-CU; Tue, 16 May 2017 18:02:23 +0200
Received: from localhost (athene.usta.de [local])
	by athene.usta.de (OpenSMTPD) with ESMTPA id 6c43e79d;
	Tue, 16 May 2017 18:02:23 +0200 (CEST)
Date: Tue, 16 May 2017 18:02:23 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: groff@gnu.org
Message-ID: <20170516160223.GD30737@athene.usta.de>
References: <20170516081107.7n7vafa4sty3kef6@crack.deadbeast.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20170516081107.7n7vafa4sty3kef6@crack.deadbeast.net>
User-Agent: Mutt/1.6.2 (2016-07-01)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
	[fuzzy]
X-Received-From: 129.13.231.90
Subject: Re: [Groff] [PATCH] groff_man.7: Doc how to get >1 paragraphs under
 one tag
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 16 May 2017 16:02:37 -0000

Hi Branden,

i think this patch improves the manual page.
See inline for some nits.

Yours,
  Ingo


G. Branden Robinson wrote on Tue, May 16, 2017 at 04:11:09AM -0400:

> Note how to get >1 paragraphs under one tag.
> 
> I have seen many creative ways of getting this wrong, including blank
> input lines.

I tend to just use .sp, but you are probably right that .IP without
arguments is cleaner.


[...]
> diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
> index 2007bbbf..4468359a 100644
> --- a/tmac/groff_man.7.man
> +++ b/tmac/groff_man.7.man
> @@ -347,9 +347,16 @@ or
>  .B .HP
>  (or to the default value if none of them have been used yet).
>  .
> -Font size and face of the paragraph (but not the designator) are reset
> -to its default values.
> +The font size and face of the paragraph (but not the designator) are
> +reset to their default values.

Sure.


>  .
> +.IP
> +Use
> +.B IP
> +without arguments if you simply need a new paragraph at the existing
> +indentation value; for instance, to continue a multi-paragraph
> +discussion after a paragraph tagged with
> +.BR .TP .

That's a very helpful addition.


>  .
>  .IP
>  To start an indented paragraph with a particular indentation but
> @@ -377,18 +384,26 @@ package to format lists.
>  .
>  .
>  .IP \(bu 4
> -.B HP
> +.B TP
>  is another.
>  .
> -This macro produces a paragraph with a left hanging indentation.
> +This macro produces an unindented label followed by an indented
> +paragraph.
>  .
>  .
>  .IP \(bu 4
> -.B TP
> +.B HP
>  is another.
>  .
> -This macro produces an unindented label followed by an indented
> -paragraph.
> +This macro produces a paragraph with a left hanging indentation.
> +.
> +.IP
> +As noted above, use of the
> +.B HP
> +macro is deprecated as being presentation-level.
> +(This paragraph was started with
> +.B .IP
> +with no arguments.)
>  .RE
[...]

All this is merely an example, and it is of excessive length for an
example in the first place.  So i would suggest to simply delete
the middle paragraph about .HP without replacement, and maybe also
delete the "three" from the .IP entry if it bothers you after the
deletion.  Examples should be concise and not repeat unrelated
content discussed elsewhere.

In general, i think examples ought to display source code, *not*
the result when formatted.  As it stands, the example still keeps
you guessing what the source code might look like.  If you show
the source code instead, everyone can easily run it through nroff
and look at how it gets formatted.  But that would be an unrelated
change.

Again, these are just nits, your changes make the page better in
any case.

Yours,
  Ingo


From MAILER-DAEMON Wed May 24 09:57:09 2017
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1dDWmj-0004jH-4D
	for mharc-groff@gnu.org; Wed, 24 May 2017 09:57:09 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:37087)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bjarniig@hi.is>) id 1dDWmh-0004iL-6w
	for groff@gnu.org; Wed, 24 May 2017 09:57:08 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bjarniig@hi.is>) id 1dDWmg-0005zV-LD
	for groff@gnu.org; Wed, 24 May 2017 09:57:07 -0400
Received: from mx2.hi.is ([2a00:c88:4000:1650::165:104]:45990)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <bjarniig@hi.is>) id 1dDWmg-0005wB-8d
	for groff@gnu.org; Wed, 24 May 2017 09:57:06 -0400
Received: from hekla.rhi.hi.is (hekla.rhi.hi.is
	[IPv6:2a00:c88:4000:1650::165:2])
	by mx2.hi.is (8.14.7/8.14.7) with ESMTP id v4ODuvSp014689
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256
	verify=NO) for <groff@gnu.org>; Wed, 24 May 2017 13:56:59 GMT
Received: from hekla.rhi.hi.is (localhost [127.0.0.1])
	by hekla.rhi.hi.is (8.14.4/8.14.4) with ESMTP id v4ODuuYC017079
	for <groff@gnu.org>; Wed, 24 May 2017 13:56:57 GMT
Received: (from bjarniig@localhost)
	by hekla.rhi.hi.is (8.14.4/8.14.4/Submit) id v4ODuuw6017078
	for groff@gnu.org; Wed, 24 May 2017 13:56:56 GMT
Date: Wed, 24 May 2017 13:56:56 +0000
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: groff@gnu.org
Message-ID: <20170524135656.GA16872@rhi.hi.is>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.5.20 (2009-12-10)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2a00:c88:4000:1650::165:104
Subject: [Groff] Need of protecting significant space at end of lines and
 removing others
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff/>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 24 May 2017 13:57:08 -0000

  There are a lot of lines (about 3500?) that end with one or more space
characters. Some of them are significant, and may thus not be removed. 
Those in the directory "tmac" have been protected (\" ...) with a patch, see
bug #51106 ("[PATCH] Protect significant space at the end of lines").

  Those who fix something, should also remove insignificant space at the
end of lines in those files they patch, and protect those space characters
that are not.

  "git" issues a warning when there is a space character at the end of an
updated line.

-- 
Bjarni I. Gislason


