Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 369991 - media-libs/fontconfig should install man pages for fc-* utilities by default
Summary: media-libs/fontconfig should install man pages for fc-* utilities by default
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: AMD64 Linux
: Normal enhancement with 1 vote (vote)
Assignee: Gentoo Fonts Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-06-04 07:29 UTC by Donald
Modified: 2013-02-08 15:02 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
Build log for fontconfig-2.8.0-r1 (fontconfig.log,46.62 KB, text/plain)
2013-01-31 08:03 UTC, C W Rose
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Donald 2011-06-04 07:29:50 UTC
Looks like the only documentation <=media-libs/fontconfig-2.8.0-r1 installs by default (i.e., without the "doc" flag) is about fonts-conf. Nothing about fc-cache, fc-cat, fc-list, fc-match, fc-query, or fc-scan.


Reproducible: Always

Steps to Reproduce:
1. fc-[TAB][TAB] on command line, and note all the nice utilities
2. whatis <any of them>
3. man <any of them>

Actual Results:  
No information on what these utilities do.

Expected Results:  
The usual kind of info given by whatis and man. (Note that "man fonts-conf" lists the other utilities in SEE ALSO, which makes it especially annoying not to have man pages for them, too.)

Basic usage info is available using the "-h" command-line option with each utility, but not enough context for people like me to figure out how/why to use these things.

I don't want to enable the "doc" USE flag, since it depends on "app-text/docbook-sgml-utils[jadetex]" (wants to install 13 new packages).

Hmm... the more I look into this, the more it looks like this might be an upstream problem.

Can someone say what docs are actually installed with the "doc" flag, and do they include useful man pages for fc-* (like http://www.x.org/releases/X11R7.0/doc/html/fc-list.1.html), or useless ones (like http://www.xfree86.org/current/fc-list.1.html), or none at all?
Comment 1 C W Rose 2013-01-31 08:03:23 UTC
Created attachment 337388 [details]
Build log for fontconfig-2.8.0-r1

Build log for fontconfig showing (missing) man pages.
Comment 2 C W Rose 2013-01-31 08:06:03 UTC
Confirmed.  The only man page installed is fonts-conf.5
The man pages in the package are:
    fc-list.1
    fc-cat.1
    fc-match.1
    fc-scan.1
    fc-cache.1
    fc-query.1

Will
Comment 3 Ben de Groot (RETIRED) gentoo-dev 2013-02-08 15:02:33 UTC
Fixed in 2.10.2. Thanks for reporting!