From owner-freebsd-doc@FreeBSD.ORG Wed Mar 19 16:47:21 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 459A8BA8; Wed, 19 Mar 2014 16:47:21 +0000 (UTC) Received: from dmz-mailsec-scanner-3.mit.edu (dmz-mailsec-scanner-3.mit.edu [18.9.25.14]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id AF003EBA; Wed, 19 Mar 2014 16:47:20 +0000 (UTC) X-AuditID: 1209190e-f79ee6d000000c40-8a-5329c8e49c90 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP id C0.4C.03136.4E8C9235; Wed, 19 Mar 2014 12:42:12 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id s2JGgAaL010973; Wed, 19 Mar 2014 12:42:11 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s2JGg8RU028843 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 19 Mar 2014 12:42:09 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s2JGg5Jl020345; Wed, 19 Mar 2014 12:42:05 -0400 (EDT) Date: Wed, 19 Mar 2014 12:42:05 -0400 (EDT) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: Bruce Evans Subject: em dashes in mdoc (was Re: Hello fdclose) In-Reply-To: <20140319071034.H996@besplex.bde.org> Message-ID: References: <201403181404.52197.jhb@freebsd.org> <20140319071034.H996@besplex.bde.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrPIsWRmVeSWpSXmKPExsUixG6novvkhGawwYF/AhYtC36zWpw608Vq sffIdWYHZo8Zn+azeLw+v449gCmKyyYlNSezLLVI3y6BK+P2rkXsBRO4KraffcfYwPiAvYuR k0NCwERi+9RHrBC2mMSFe+vZuhi5OIQEZjNJ3H3WD+VsZJRYvGUCO4RziEliafMPZgingVFi 5oNpQP0cHCwC2hKdnUwgo9gE1CQe722GGqsosfnUJGYQWwQovvzCfLAaZgFriWd77jGC2MIC RhIHV20Ei3MC2Td27AE7j1fAUeL5sW0sUCcxSsw4vRdsqKiAjsTq/VNYIIoEJU7OfMICMdRS 4tyf62wTGIVmIUnNQpJawMi0ilE2JbdKNzcxM6c4NVm3ODkxLy+1SNdYLzezRC81pXQTIyic OSX5djB+Pah0iFGAg1GJh3fFHs1gIdbEsuLK3EOMkhxMSqK8nUeBQnxJ+SmVGYnFGfFFpTmp xYcYJTiYlUR4X4GU86YkVlalFuXDpKQ5WJTEefvOSgQLCaQnlqRmp6YWpBbBZGU4OJQkeA2B cSskWJSanlqRlplTgpBm4uAEGc4DNFwfpIa3uCAxtzgzHSJ/ilFRSpzX5DhQQgAkkVGaB9cL SzevGMWBXhHmdQBp5wGmKrjuV0CDmYAGL5quBjK4JBEhJdXAuDZEbMFmpqMPjLxCbZZ5CGxP 4N6ok2zwvLZtymehiWL/N+u9P9MVwajHrd45RWLlZx3+6h8xHaJZ3spTa+eHL5r95whXf3vp gfsCV0Q5jFNXM16XNvp1ddPyfV/EnmedeyKqHit+VYNT59CKXar6aqX5WdELVgby/nmbZSbr 4nH03NNapoSDSizFGYmGWsxFxYkAgAdaGRIDAAA= Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Mar 2014 16:47:21 -0000 [changing cc list dramatically] On Wed, 19 Mar 2014, Bruce Evans wrote: > On Tue, 18 Mar 2014, John Baldwin wrote: > >> @@ -84,7 +130,9 @@ >> .Sh NOTES >> The >> .Fn fclose >> -function >> +and >> +.Fn fdclose >> +functions >> does not handle NULL arguments; they will result in a segmentation >> violation. >> This is intentional - it makes it easier to make sure programs written >> > > In the old version: > > Em-dash seems to be handled poorly by mdoc. It seems to be necessary > to hard code it. It shouldn't be hard coded as a hyphen. I seem to remember looking into mdoc's handling of em dashes a month or two ago, and concluding that mdoc did not handle em dashes at all. That is, I did not see any macros that attempted to render as a dash of any type, so that the man page author is required to hard code a dash as either one or two (or three, I suppose) hyphens. A scan of the prior art suggested that most existing instances use a single hyphen, and the double hyphen is quite rare. Warren did note that it is probably best to write in a style that avoids the need for the em dash, which I cannot really argue against. Bruce, do you have any details you can add about mdoc's interaction with em (or en) dashes? Thanks, Ben