Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
F
fontconfig
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 153
    • Issues 153
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 19
    • Merge Requests 19
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
  • Operations
    • Operations
    • Incidents
    • Environments
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • CI / CD
    • Repository
    • Value Stream
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • fontconfig
  • fontconfig
  • Issues
  • #269

Closed
Open
Opened Dec 16, 2020 by ratijas@ratijasContributor

fonts-conf(5): issues with automatic generation by docbook2man

Seems like docbook2man isn't perfect when it comes to XML. Can't blame it for that, since XML is a mess anyway, but it goes.

Subsections in the CONFIGURATION FILE FORMAT section are wrong. They get uppercased (although subsections are usually lowercase), and converted to groff without proper quoting.

Steps to reproduce

  1. Open man 5 fonts-conf
  2. Scroll down.

Expected output

   <include ignore_missing="no" prefix="default">

Actual output

Rendered man page:

   <INCLUDE IGNORE_MISSING= NO" PREFIX="DEFAULT">"

Groff source:

.SS "<INCLUDE IGNORE_MISSING=\&"NO\&" PREFIX=\&"DEFAULT\&">"

Solution

The proper way to generate groff source for that is to char-escape double quotes. According to groff_char(7), ASCII double quote can be unambiguously represented as \[dq].

.SS <include ignore_missing=\&\[dq]no\&\[dq] prefix=\&\[dq]default\&\[dq]>

Also, would be better to highlight attribute values with underline style, which in man pages often stands for user input placeholder. That would require breaking up ` in source *.sgml sources and possibly inventing new elements.

image

To upload designs, you'll need to enable LFS and have admin enable hashed storage. More information
Assignee
Assign to
None
Milestone
None
Assign milestone
Time tracking
None
Due date
None
Reference: fontconfig/fontconfig#269