English Portuguese (Brazil)
Autodoc
Add-ons that use Autodoc to build documentation MUST include `+BuildRequires: gap-pkg-autodoc+`. Such packages do not need to include `+BuildRequires: GAPDoc-latex+`, as the Autodoc package `+Requires: GAPDoc-latex+`.
Requires, Recommends, and Suggests
All add-ons MUST include `+Requires: gap-core+`, either directly or transitively. In addition, dependencies on other GAP packages, as recorded in `+PackageInfo.g+`, MUST be specified, with the exception of `+GAPDoc+`, as noted above. GAP has a 2-level dependency system, specified with `+NeededOtherPackages+` and `+SuggestedOtherPackages+` tags in `+PackageInfo.g+`. How these dependencies map onto the 3-level RPM dependency system of Requires, Recommends, and Suggests is left to the discretion of the Fedora packager.
Unnecessary Files
GAP add-ons are intended to be unpacked in place within a GAP directory tree. Ordinarily, the entire distribution directory is copied into `+%{_gap_dir}/pkg+`. This includes the documentation directories, which are consumed by the tools contained in gap-online-help. However, some files are not needed in the final install directory. Files that should not appear there include:
Textual descriptions of the add-on, such as a README
License files (COPYING, COPYRIGHT, LICENSE, etc.)
Files for building documentation, often called `+make_doc+`
Files generated by LaTeX, including files with these suffixes:
.aux
.bbl
.blg
.idx
.ilg
.ind
.log
.toc
Note that License files MUST still be included in the package with the %license tag, and other documentation such as README files can be included as %doc.
The `+%gap_copy_docs+` macro is intended to make installation of documentation files easier. For most packages, ensure that the `doc` subdirectory exists in the buildroot, then invoke the macro without arguments in `+%install+`. For special cases, two optional arguments can be given: