| www.delorie.com/archives/browse.cgi | search |
| DMARC-Filter: | OpenDMARC Filter v1.4.2 delorie.com 614LXrvN685090 |
| 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 614LXrvN685090 |
| 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=ua3EsmeO | |
| X-Recipient: | archive-cygwin AT delorie DOT com |
| DKIM-Filter: | OpenDKIM Filter v2.11.0 sourceware.org 274394BA2E0C |
| DKIM-Signature: | v=1; a=rsa-sha256; c=relaxed/relaxed; d=cygwin.com; |
| s=default; t=1770240832; | |
| bh=E+6NrO+mJsNBRaBPbZvt7oRxUzwpgVQ48FQd1vjn4gg=; | |
| h=Date:Subject:To:References:In-Reply-To:List-Id:List-Unsubscribe: | |
| List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: | |
| From; | |
| b=ua3EsmeOE3hl+NEeSz8M4/t6MzamhVxyrP1++YEZ8jUiAt0OFCki9VI7WN+/t2tr8 | |
| ex+U507iuhzYV+LsnDDKdk610JEbDTEOedanFyjP39yLOlxnmGPI/pHvoBXPCwXLwk | |
| g9JVMfd+ZUAwFB0BnKU8bXgFnDFZotVzvyS2v6v4= | |
| X-Original-To: | cygwin AT cygwin DOT com |
| Delivered-To: | cygwin AT cygwin DOT com |
| DMARC-Filter: | OpenDMARC Filter v1.4.2 sourceware.org DDB554BA23C2 |
| ARC-Filter: | OpenARC Filter v1.0.0 sourceware.org DDB554BA23C2 |
| ARC-Seal: | i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1770240813; cv=none; |
| b=flXXCTuPtCtKQwk5X+3kPoek5z7sxy/WRYQHMaiahTJBTlnGad26j6QUBiRET+CoBgAnSrHTrRH2HXZxzEviY7w4f1cotmMSdnUPkyGzczHR98S7mNfdvrr5SF8VIxa8mtrxlCoXh9FxWmjZWiC/rVKKR02KzSP2zq/t2cQM2Ac= | |
| ARC-Message-Signature: | i=1; a=rsa-sha256; d=sourceware.org; s=key; |
| t=1770240813; c=relaxed/simple; | |
| bh=s1eOQbkjIgKAEJTb70KnEg+7mqNrOkFSH/xeNr80dBY=; | |
| h=Message-ID:Date:MIME-Version:From:Subject:To:DKIM-Signature; | |
| b=Cv3iXgPPEiJuzGVB7w0DCHUlKP3tmMoNLoIemL6fQPzSPguYLtbhPVCAmHsAwslvyVJstzV0js648RtdlLUrbssqphDf++i5PWKbxJevPOjwjYOl+wAs1nMcGC405qsi/eqeJhA/pf3g0RhFDOSiK6uRlywjVBbI0WRv8+eRvoY= | |
| ARC-Authentication-Results: | i=1; server2.sourceware.org |
| DKIM-Filter: | OpenDKIM Filter v2.11.0 sourceware.org DDB554BA23C2 |
| Message-ID: | <943e0dd6-cde5-4195-94f6-e5c15c5895f5@SystematicSW.ab.ca> |
| Date: | Wed, 4 Feb 2026 14:33:30 -0700 |
| MIME-Version: | 1.0 |
| User-Agent: | Mozilla Thunderbird |
| Subject: | Re: [FLAC 1.5.0-1] Man pages use HYPHEN character instead of |
| HYPHEN-MINUS. | |
| To: | 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> | |
| Organization: | Systematic Software |
| In-Reply-To: | <2eb7528d-babd-4bc8-9c0d-b2f77499a627@towo.net> |
| X-Rspamd-Queue-Id: | 0792D2000E |
| X-Stat-Signature: | nibp3nox71ahpb9xqin99zitie5inus9 |
| X-Rspamd-Server: | rspamout05 |
| X-Session-Marker: | 427269616E2E496E676C69734053797374656D6174696353572E61622E6361 |
| X-Session-ID: | U2FsdGVkX1/MdxtOeUo3EyEsxBGAyReUM/UTZDPwkkw= |
| X-HE-Tag: | 1770240810-951108 |
| X-HE-Meta: | U2FsdGVkX1/LfMbZd/Tko9he7mMX8KDHGqAasGQz/zlsDF7/LMWNxe60fYuwqqIcO3M2qCtpapfBloxixqTngjKFPYd2AebdRjBxzgJ19UclJ9UFfYs8tSBTmQ0d7xmhZiapf9CUQb4vPGSaG8oQjBc+hG5Ks8o2cFU97lTr7Uyux4mJpgBkBvKHrauNCzZ5pe+VVlcUe948ztGS3hsmV1t/vnO2FvhQtQVFHsb71IhUfIGD1QlY/wQy41SidbRDFPFIeoNjL0ELIzlqlEq6i/BIhU3DaTbJAFPYRM/i0QIltuR+iU1S2JPQqnnX2b5YghXPtO/urEc2ns70lSuLR60kBVnnUgb4KTdpFPPin2CPqWSu7Os0evZei2arHoqGAYjkKOtbwM8= |
| 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: | Brian Inglis via Cygwin <cygwin AT cygwin DOT com> |
| Reply-To: | cygwin AT cygwin DOT com |
| Cc: | Brian Inglis <Brian DOT Inglis AT SystematicSW DOT ab DOT ca> |
| 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 614LXrvN685090 |
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]
>> ```
--
Take care. Thanks, Brian Inglis Calgary, Alberta, Canada
La perfection est atteinte Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher but when there is no more to cut
-- Antoine de Saint-Exupéry
--
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
| webmaster | delorie software privacy |
| Copyright 2019 by DJ Delorie | Updated Jul 2019 |