diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index 8a69ae0b9e..9f344a63cd 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml | |||
@@ -524,6 +524,54 @@ | |||
524 | Any <filename>.pc</filename> file containing these paths is incorrect | 524 | Any <filename>.pc</filename> file containing these paths is incorrect |
525 | since <filename>pkg-config</filename> itself adds the correct sysroot prefix | 525 | since <filename>pkg-config</filename> itself adds the correct sysroot prefix |
526 | when the files are accessed.</para></listitem> | 526 | when the files are accessed.</para></listitem> |
527 | <listitem><para><emphasis><filename>textrel:</filename></emphasis> | ||
528 | Checks for ELF binaries that contain relocations in their | ||
529 | <filename>.text</filename> sections, which can result in a | ||
530 | performance impact at runtime.</para></listitem> | ||
531 | <listitem><para><emphasis><filename>pkgvarcheck:</filename></emphasis> | ||
532 | Checks through the variables | ||
533 | <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>, | ||
534 | <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>, | ||
535 | <filename>RSUGGESTS</filename>, | ||
536 | <link linkend='var-RCONFLICTS'><filename>RCONFLICTS</filename></link>, | ||
537 | <filename>RPROVIDES</filename>, | ||
538 | <link linkend='var-RREPLACES'><filename>RREPLACES</filename></link>, | ||
539 | <link linkend='var-FILES'><filename>FILES</filename></link>, | ||
540 | <link linkend='var-ALLOW_EMPTY'><filename>ALLOW_EMPTY</filename></link>, | ||
541 | <filename>pkg_preinst</filename>, | ||
542 | <filename>pkg_postinst</filename>, | ||
543 | <filename>pkg_prerm</filename> | ||
544 | and <filename>pkg_postrm</filename>, and reports if there are | ||
545 | variable sets that are not package-specific. | ||
546 | Using these variables without a package suffix is bad practice, | ||
547 | and might unecessarily complicate dependencies of other packages | ||
548 | within the same recipe or have other unintended consequences. | ||
549 | </para></listitem> | ||
550 | <listitem><para><emphasis><filename>xorg-driver-abi:</filename></emphasis> | ||
551 | Checks that all packages containing Xorg drivers have ABI | ||
552 | dependencies. | ||
553 | The <filename>xserver-xorg</filename> recipe provides driver | ||
554 | ABI names. | ||
555 | All drivers should depend on the ABI versions that they have | ||
556 | been built against. | ||
557 | Driver recipes that include | ||
558 | <filename>xorg-driver-input.inc</filename> | ||
559 | or <filename>xorg-driver-video.inc</filename> will | ||
560 | automatically get these versions. | ||
561 | Consequently, you should only need to explicitly add | ||
562 | dependencies to binary driver recipes. | ||
563 | </para></listitem> | ||
564 | <listitem><para><emphasis><filename>libexec:</filename></emphasis> | ||
565 | Checks if a package contains files in | ||
566 | <filename>/usr/libexec</filename>. | ||
567 | This check is not performed if the | ||
568 | <filename>libexecdir</filename> variable has been set | ||
569 | explicitly to <filename>/usr/libexec</filename>. | ||
570 | </para></listitem> | ||
571 | <listitem><para><emphasis><filename>staticdev:</filename></emphasis> | ||
572 | Checks for static library files (<filename>*.a</filename>) in | ||
573 | non-<filename>staticdev</filename> packages. | ||
574 | </para></listitem> | ||
527 | <listitem><para><emphasis><filename>la:</filename></emphasis> | 575 | <listitem><para><emphasis><filename>la:</filename></emphasis> |
528 | Checks <filename>.la</filename> files for any <filename>TMPDIR</filename> | 576 | Checks <filename>.la</filename> files for any <filename>TMPDIR</filename> |
529 | paths. | 577 | paths. |