Mail Archives: cygwin/2026/02/04/18:22:56

Dr Bean via Cygwin <cygwin AT cygwin DOT com> · Wed, 4 Feb 2026 23:22:32 +0000

On Wed, 04 Feb 2026, Brian Inglis via Cygwin wrote:

> On 2026-02-04 12:03, Thomas Wolff via Cygwin wrote:
> > Am 04.02.2026 um 18:10 schrieb Brian Inglis via Cygwin:
> > > On 2026-02-04 02:56, Vincent via Cygwin wrote:
> > > > My request is related to an issue I opened in the FLAC Github :
> > > > https://github.com/xiph/flac/issues/861

> > > > After some investigations, the issue is related to the build release of the
> > > > FLAC package provided by Cygwin : the man pages of flac(1) and metaflac(1)
> > > > use the HYPHEN (U+2010 )  character instead of the HYPHEN-MINUS (U+002D)
> > > > character.

> > > > These two commands expect HYPHEN-MINUS character, so if you copy-paste the
> > > > man page options in your terminal, it will fail.

> > > > Example : flac ‐‐version
> > > > will return an error : « can't open input file ‐‐version: No such file or
> > > > directory », because of  « ‐‐version » with HYPHEN copied-pasted from the
> > > > man pages.

> > > > The right string is « --version » with HYPHEN-MINUS (U+002D).

> > > > Example : flac --version
> > > > will return : « flac 1.5.0 »

> > > > Please, feel free to read the issue in Github (
> > > > https://github.com/xiph/flac/issues/861 ) for more details, as it's easier
> > > > to read code and quotes with the markdown formatting.

> > > > This is a very pretty nasty kind of bug, because it's very difficult to
> > > > distinguish HYPHEN-MINUS and HYPHEN in a terminal. It's also very difficult
> > > > to figure out why the command has failed, as the « No such file or
> > > > directory » is not the root cause of the problem.

> > > > I think a new build release to fix this, would be very welcome.

> > > > Thank you very much for your time and your great work. :)
> > It’s really a nuisance that man (presumably gnu man, but I don’t
> > remember the details of a previous discussion) changed interpretation of
> > some important characters into „glyphs“ that some witty people thought
> > to be nice but are completely non-functional.
> > It applies not only to „-“ but also to „~“. Look at `man bash` and
> > search for bashrc and you'll see the tilde symbol replaced by an ugly
> > superscript „small tilde“. Why??
> > Package maintainers are forced to adapt their man pages and either
> > replace all occurrences of these characters by corresponding escapes or
> > apply these two global tricks per man page:

> > .char ^ \(ha
> > .char - \N'45'

> It appears to be a consequence more of groff -man being upgraded to produce
> better quality typographic output more consistently with other macro
> packages, output devices, and more comprehensive font, character, and glyph
> sets, while not penalizing the other existing macro packages originally
> designed and intended to produce quality output: see groff(7),
> groff_rfc1345(7), and groff_char(7), for example:
> "The developers of AT&T /troff/ chose mappings for them that would be useful
> for typesetting technical literature in a broad range of scientific
> disciplines
> ...
> Keycap  Appearance and meaning   Special character and meaning
>   "     " neutral double quote   \[dq] neutral double quote
>   '     ’ closing single quote   \[aq] neutral apostrophe
>   -     ‐ hyphen                 \- or \[-] minus sign/Unix dash
>   \     (escape character)       \e or \[rs] reverse solidus
>   ^     ˆ modifier circumflex    \(ha circumflex/caret/“hat”
>   `     ‘ opening single quote   \(ga grave accent
>   ~     ˜ modifier tilde         \(ti tilde"

> Really this tension between compatibility with tty input and basic/draft and
> typographic quality output has existed since the earliest days of
> computerized text formatting and typesetting with various levels of higher
> quality output devices from dot matrix, daisy wheel, phototypesetter,
> electrostatic, laser, and higher quality rendering devices.

> [Note: \N'#' refers to the current output font glyph index *NOT* an input code.]

> > > Upstream sources seems to provide only .md man sources and no b-r
> > > package for conversion (pandoc unavailable from Cygwin) so man pages
> > > are generated for the upstream sources, and this conversion
> > > generates man page options with plain text hyphen-minus, which are
> > > treated by man as normal text *hyphen* `‐` not plain text *minus*
> > > `-`.
> > > In man pages you use escaped hyphen-minus `\fB\-v\fR` to treat them
> > > as minus text `-` as used in options `-v`.
> > > We see this use of unescaped hyphens in the upstream tar files,
> > > below, so please complain upstream about their man page generation,
> > > and reopen their issue:
> > > ```
> > > $ wget https://mirror.../x86_64/release/flac/flac-1.5.0-1-src.tar.xz
> > > $ tar -xvf flac-1.5.0-1-src.tar.xz
> > > flac-1.5.0-1.src/
> > > flac-1.5.0-1.src/flac-1.5.0.tar.xz            # upstream sources
> > > flac-1.5.0-1.src/FLAC.cygport
> > > $ tar -xvf flac-1.5.0-1.src/flac-1.5.0.tar.xz flac-1.5.0/man/{,meta}flac.1
> > > flac-1.5.0/man/flac.1
> > > flac-1.5.0/man/metaflac.1
> > > $ grep -m5 '\\f[[{]\?B[]}]\\\?-' flac-1.5.0/man/{,meta}flac.1
> > > flac-1.5.0/man/flac.1:\f[B]-\f[R] \f[I]\&...\f[R] ]
> > > flac-1.5.0/man/flac.1:\f[B]flac\f[R] [ \f[B]-d\f[R] |
> > > \f[B]--decode\f[R] | \f[B]-t\f[R] |
> > > flac-1.5.0/man/flac.1:\f[B]--test\f[R] | \f[B]-a\f[R] | \f[B]--analyze\f[R] ] [
> > > flac-1.5.0/man/flac.1:\f[I]infile.ogg\f[R] | \f[B]-\f[R] \f[I]\&...\f[R] ]
> > > flac-1.5.0/man/flac.1:\f[B]-d\f[R], analysis with \f[B]-a\f[R] or
> > > testing with \f[B]-t\f[R].
> > > flac-1.5.0/man/metaflac.1:\f[B]-o\f[R] \f[I]filename\f[R]\f[B],
> > > --output- name=\f[R]\f[I]filename\f[R]
> > > flac-1.5.0/man/metaflac.1:\f[B]--preserve-modtime\f[R]
> > > flac-1.5.0/man/metaflac.1:\f[B]--with-filename\f[R]
> > > flac-1.5.0/man/metaflac.1:\f[B]--no-filename\f[R]
> > > flac-1.5.0/man/metaflac.1:\f[B]--no-utf8-convert\f[R]
> > > ```
> -- 

My experience with the man page of `which`, which 
mirrors that of Vincent with FLAC

http://drbean.sdf.org/LooksLikeHyphen.html

-- 
Greg "Dr Bean" Matheson		God's review committee:
http://drbean.sdf.org		You've overloaded the reproductive
drbean AT freeshell DOT org		functions on the eliminatory functions!
				God: We'll fix it in software.

-- 
Problem reports:      https://cygwin.com/problems.html
FAQ:                  https://cygwin.com/faq/
Documentation:        https://cygwin.com/docs.html
Unsubscribe info:     https://cygwin.com/ml/#unsubscribe-simple

DMARC-Filter:	OpenDMARC Filter v1.4.2 delorie.com 614NMuMg736406
Authentication-Results:	delorie.com; dmarc=pass (p=none dis=none) header.from=cygwin.com
Authentication-Results:	delorie.com; spf=pass smtp.mailfrom=cygwin.com
DKIM-Filter:	OpenDKIM Filter v2.11.0 delorie.com 614NMuMg736406
Authentication-Results:	delorie.com;
	dkim=pass (1024-bit key, unprotected) header.d=cygwin.com header.i=@cygwin.com header.a=rsa-sha256 header.s=default header.b=jFQJsJvw
X-Recipient:	archive-cygwin AT delorie DOT com
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org 380474BA2E08
DKIM-Signature:	v=1; a=rsa-sha256; c=relaxed/relaxed; d=cygwin.com;
	s=default; t=1770247375;
	bh=j1CSSLVD07+LB+Vt4Dmd5TmxsD29Jf85bRt8d5pxRAw=;
	h=Date:To:Subject:References:In-Reply-To:List-Id:List-Unsubscribe:
	List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:
	From;
	b=jFQJsJvw5Np+3wNHE8axFq2RpPGsIdZbcPf2qjzt+GB+Z01DLeBGlYrUWMfHUgv7F
	on9R69u2WN1B6glALAsLHHni2P+BHbn3XA6t4d69u5F31o5braJKy5NxpfHBoH0xUL
	udpzqwudEnKklIRhxCDCtAC4BM/pbnH+LVUE7iNY=
X-Original-To:	cygwin AT cygwin DOT com
Delivered-To:	cygwin AT cygwin DOT com
DMARC-Filter:	OpenDMARC Filter v1.4.2 sourceware.org 4B8014BA543C
ARC-Filter:	OpenARC Filter v1.0.0 sourceware.org 4B8014BA543C
ARC-Seal:	i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1770247355; cv=none;
	b=XUi9iMEyDVmN2B5xelIeWSRimQIRwWp0nPwbncEGtrAZfKrZlUYNOh0KM0VIk5uVCl6Bd7IxDrp79bXK7uGMOmg2aOkSrx9VD1SdiMApji2mE9E98QbZxrf40LtCgldFLmSVZDZk8uZhTJOm1PugeEdnWX4EB6/W8MtIKQNuAdg=
ARC-Message-Signature:	i=1; a=rsa-sha256; d=sourceware.org; s=key;
	t=1770247355; c=relaxed/simple;
	bh=TmErFpg9q3hgx4u4dBTF844pYDXdgSBehGrUOs1YpfM=;
	h=Date:From:To:Subject:Message-ID:MIME-Version;
	b=S6v5V7kuRu7WZHEW31mVxurnQZTaOHUjkD1NTc54rYSLALmKSltXkwvXudGqvdtelg6p9PX9NB1sO5v1X2D5CmVppEcRgHM3FEkEAq9jUzr3NUevcpR8na/DnceEvZPznA30NH3WD3//ZdO0ZfeZIUVkn6X/+HIr+2MD6I4DnEI=
ARC-Authentication-Results:	i=1; server2.sourceware.org
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org 4B8014BA543C
Date:	Wed, 4 Feb 2026 23:22:32 +0000
To:	Brian Inglis via Cygwin <cygwin AT cygwin DOT com>
Subject:	Re: [FLAC 1.5.0-1] Man pages use HYPHEN character instead of
	HYPHEN-MINUS.
Message-ID:	<aYPUuBjYmf-HoTAn@sdf.org>
Mail-Followup-To:	Brian Inglis via Cygwin <cygwin AT cygwin DOT com>
References:	<CAAA95V9-WVQh5hbOvtZhCOBU8JpmfR98E+=aQyeOa+b1H2S_-Q AT mail DOT gmail DOT com>
	<bb351b4c-cf88-4480-b58a-46301a084c17 AT SystematicSW DOT ab DOT ca>
	<2eb7528d-babd-4bc8-9c0d-b2f77499a627 AT towo DOT net>
	<943e0dd6-cde5-4195-94f6-e5c15c5895f5 AT SystematicSW DOT ab DOT ca>
MIME-Version:	1.0
In-Reply-To:	<943e0dd6-cde5-4195-94f6-e5c15c5895f5@SystematicSW.ab.ca>
User-Agent:	Mutt/2.2.14 (2025-02-20)
X-BeenThere:	cygwin AT cygwin DOT com
X-Mailman-Version:	2.1.30
List-Id:	General Cygwin discussions and problem reports <cygwin.cygwin.com>
List-Unsubscribe:	<https://cygwin.com/mailman/options/cygwin>,
	<mailto:cygwin-request AT cygwin DOT com?subject=unsubscribe>
List-Archive:	<https://cygwin.com/pipermail/cygwin/>
List-Post:	<mailto:cygwin AT cygwin DOT com>
List-Help:	<mailto:cygwin-request AT cygwin DOT com?subject=help>
List-Subscribe:	<https://cygwin.com/mailman/listinfo/cygwin>,
	<mailto:cygwin-request AT cygwin DOT com?subject=subscribe>
From:	Dr Bean via Cygwin <cygwin AT cygwin DOT com>
Reply-To:	Dr Bean <drbean AT freeshell DOT org>
Errors-To:	cygwin-bounces~archive-cygwin=delorie DOT com AT cygwin DOT com
Sender:	"Cygwin" <cygwin-bounces~archive-cygwin=delorie DOT com AT cygwin DOT com>
X-MIME-Autoconverted:	from base64 to 8bit by delorie.com id 614NMuMg736406

webmaster	delorie software privacy
Copyright � 2019 by DJ Delorie	Updated Jul 2019