kc3-lang/pkgconf/man
Branch :
Log
| Author | Commit | Date | CI | Message |
|---|---|---|---|---|
 |
7ba494a0 | 2025-09-05 12:33:55 | man/pc.5: Add documentation for Source-tag to pc.5 man page Add more documentation to pc.5 man page to make sure that there is clear description how to use Source-tag | |
|
790ac897 | 2025-09-05 12:32:09 | man/pkgconf.1: Small mention of Source-tag to pkgconf.1 man page Add similar mentioning of Source-tag than License-tag has to pkgconf.1 man page. | |
 |
d3e94155 | 2025-06-03 19:44:28 | man/pkgconf.1: mention that --list-all exits early | |
|
f0be161c | 2025-06-03 19:27:38 | man/pkgconf.1: mention that --atleast-pkgconfig-version exits early | |
|
509c34fa | 2025-06-03 19:05:06 | man/pkgconf.1: mention that PKG_CONFIG_SYSROOT_DIR sets pc_sysrootdir | |
|
8886d839 | 2025-06-03 19:03:27 | man/pkgconf.1: describe DESTDIR more precisely | |
|
54019358 | 2025-06-03 16:56:50 | man/pkgconf.1: document PKG_CONFIG_ALLOW_SYSTEM_{CFLAGS,LIBS} | |
|
efdeb71d | 2025-06-04 21:09:13 | man/pkgconf.1: improve the beginning of the DESCRIPTION Replace the first paragraph with an adequate description of what the program actually does, mention the main use case, and avoid vague wordings like "helps to" and "allow" and misleading wordings like "development libraries" (this is perfectly adequate for production builds, too) and "detect" (nothing is automatically detected, everything has to be specified explicitly in pc(5) configuration files). Add a second paragraph introducing the module search path because that concept is really crucial for the program. After that, add three paragraphs explaining the classification of options, in particular how they behave with respect to early exit and dependency resolution. Admittedly, this requires rather lengthy text, which is clearly undesirable at this place in a manual page. But the atrocious user interface design only leaves the choice of either bothering the reader with a long, complicated description, or not describing how the program behaves at all. Postponing the description of these interactions until after the option list would not be better. Understanding the classification up front helps to understand the descriptions and purposes of the individual options. What is still sorely missing is a precise definition of what the three different versions of the crucial term "dependency" mean, and how resolution actually works. | |
|
5729e1dd | 2025-06-04 20:54:54 | man/pkgconf.1: document --dump-personality --help --solution | |
|
11ea807f | 2025-06-03 20:33:48 | man/pkgconf.1: correctly describe the module version check options The options --atleast-version, --exact-version, and --max-version short-circuit to both success and failure, which implies that the result depends on the the order of the arguments and that a simple description is not possible. In particular, it is not possible to describe the behaviour with any sentence of the form "(succeed|fail) if (any|each) argument satisfies (condition)". |