From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mail.sgregoratto.me (mail.sgregoratto.me [149.28.166.45])
	by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id ad9e889b
	for <discuss@mandoc.bsd.lv>;
	Sun, 21 Apr 2019 06:26:37 -0500 (EST)
Received: from mail.sgregoratto.me (localhost [127.0.0.1])
	by mail.sgregoratto.me (Postfix) with ESMTP id D3C7B3E8BE
	for <discuss@mandoc.bsd.lv>; Sun, 21 Apr 2019 21:26:33 +1000 (AEST)
Authentication-Results: mail.sgregoratto.me (amavisd-new);
	dkim=pass (1024-bit key) reason="pass (just generated, assumed good)"
	header.d=sgregoratto.me
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=sgregoratto.me;
	 h=user-agent:in-reply-to:content-disposition:content-type
	:content-type:mime-version:references:message-id:subject:subject
	:to:from:from:date:date; s=dkim; t=1555845993; x=1558437994; bh=
	PWULCTxR3arI1o8LSAqmB7iOi9+vw8zlN9o1dsqod/8=; b=nFAPnSAI6RlaCUYx
	6S1yNPlDZnvjgLUL95DIcaz4QPYBMJwq0+3BIq8ZSbmbiNUE6lYgCjQGGYdCSZAz
	vFf3PvezmXG6Nfl46FlgU4imM09/wQmtcvwDArdGBTcHTDCLZ7ShNWZ9BdbZWC21
	bm2bo9scBDg6yUR3bQvsw8GpuMA=
X-Virus-Scanned: Debian amavisd-new at mail.sgregoratto.me
Received: from mail.sgregoratto.me ([127.0.0.1])
	by mail.sgregoratto.me (mail.sgregoratto.me [127.0.0.1]) (amavisd-new, port 10026)
	with ESMTP id v944b7Ve1CMM for <discuss@mandoc.bsd.lv>;
	Sun, 21 Apr 2019 21:26:33 +1000 (AEST)
Received: from localhost (172.44.179.58.sta.dodo.net.au [58.179.44.172])
	by mail.sgregoratto.me (Postfix) with ESMTPSA id 1DEF93E82B
	for <discuss@mandoc.bsd.lv>; Sun, 21 Apr 2019 21:26:33 +1000 (AEST)
Date: Sun, 21 Apr 2019 21:26:32 +1000
From: Stephen Gregoratto <dev@sgregoratto.me>
To: discuss@mandoc.bsd.lv
Subject: Re: docbook2mdoc-1.0.0 released
Message-ID: <20190421112632.z7fawjteacah4ypt@BlackBox>
Mail-Followup-To: discuss@mandoc.bsd.lv
References: <20190417192435.GA10272@athene.usta.de>
 <20190420190331.GA36463@www.stare.cz>
X-Mailinglist: mandoc-discuss
Reply-To: discuss@mandoc.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <20190420190331.GA36463@www.stare.cz>
User-Agent: NeoMutt/20180716

My vote goes to Fl -option due to how mandoc handles Fl Fl in HTML 
output. Take this example:

  .Bl -tag -width Ds
  .It Fl Fl option
  Foo
  .It Fl -option
  Bar
  .El

On mandoc 1.14.5, the option list is output as follows:

<dl class="Bl-tag">
  <dt>
    <code class="Fl">-</code><code class="Fl">-option</code>
  </dt>
  <dd>Foo</dd>
  <dt>
    <a class="permalink" href="#-option">
      <code class="Fl" id="-option">--option</code>
    </a>
  </dt>
  <dd>Bar</dd>
</dl>

Notice how the Fl -option gets enclosed in an "<a>" link whilst the Fl 
Fl option doesn't? This comes in handy when you have to reference the 
option later as it can link to it's definition in the option list.

On reflection this does seem like a workaround for buggy output.
-- 
Stephen Gregoratto
PGP: 3FC6 3D0E 2801 C348 1C44 2D34 A80C 0F8E 8BAB EC8B
--
 To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv