Skip to content

curl.1: Problem with '-' #6698

Description

@alejandro-colomar

Where's the source code for curl.1? I was trying to fix this myself, but I couldn't find it.

The '-' symbol is not being used correctly (you should use '-', which I guess you're not using). How it matters to me: I was searching for option '-s' in the manual page, for which I simply typed '/ -s' in the pager, and to my surprise it didn't show anything; the rendered '-' character is a different character from the one I'm typing, so it doesn't find it. A simple '/-' search only showed 2 appearances, which is weird.

See also:

$ man 7 man-pages | sed -n '/Generating optimal glyphs/,+32p'
   Generating optimal glyphs
       Where a real minus character is required (e.g., for numbers such  as  -1,  for  man
       page cross references such as utf-8(7), or when writing options that have a leading
       dash, such as in ls -l), use the following form in the man page source:

           \-

       This guideline applies also to code examples.

       The use of real minus signs serves the following purposes:

       *  To provide better renderings on various targets other than ASCII terminals,  no‐
          tably in PDF and on Unicode/UTF-8‐capable terminals.

       *  To  generate glyphs that when copied from rendered pages will produce real minus
          signs when pasted into a terminal.

       To produce unslanted single quotes that render well in ASCII, UTF‐8, and  PDF,  use
       "\(aq" ("apostrophe quote"); for example

           \(aqC\(aq

       where  C  is  the  quoted character.  This guideline applies also to character con‐
       stants used in code examples.

       Where a proper caret (^) that renders well in both a terminal and PDF is  required,
       use "\(ha".  This is especially necessary in code samples, to get a nicely rendered
       caret when rendering to PDF.

       Using a naked "~" character results in  a  poor  rendering  in  PDF.   Instead  use
       "\(ti".   This  is  especially  necessary in code samples, to get a nicely rendered
       tilde when rendering to PDF.

and also: https://lore.kernel.org/linux-man/20210122170217.kndzit52utaoisfa@localhost.localdomain/T/.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions