Feature #975
Feature #418: === Configuration & Build ===
Envelope task #1402: cmake tasks (OS independent)
man page should be built at release time
| Status: | Resolved | Start date: | 18 Feb 2015 | |
|---|---|---|---|---|
| Priority: | Low | Due date: | ||
| Assignee: | wuttke | % Done: | 100% | |
| Category: | - | Estimated time: | 2.00 hours | |
| Target version: | - |
Description
Right now, the man page bornagain.1 is built as part of the normal release process, provided the flag BORNAGAIN_MANPAGE is set ON, and the program pod2man is available. There are two problems with this:
- Unless the user explicitly sets BORNAGAIN_MANPAGE=ON, nothing will happen.
- Presence of pod2man is not checked by cmake.
Instead, we should build the man page at release time; distribute it (in standard troff format) with the source archive; and let the user command 'make install' install the man page to its standard location.
Hence TODO:
- modify cmake release actions to include "compilation" of bornagain.pod into bornagain.1
- modify cmake default actions to let 'make install' install bornagain.1 to the standard location man/man1.
History
#1 Updated by wuttke over 4 years ago
- Parent task set to #418
#2 Updated by herck over 4 years ago
- Tracker changed from Bug to Feature
#3 Updated by wuttke over 3 years ago
- Parent task changed from #418 to #1402
#4 Updated by wuttke over 3 years ago
- Status changed from New to Backlog
- Priority changed from Normal to Low
#5 Updated by wuttke over 3 years ago
Implemented in branch cmake, commit e33ded6da34, except for testing presence of pod2man.
#7 Updated by wuttke over 3 years ago
- Status changed from Sprint to Resolved
- Assignee set to wuttke
- % Done changed from 0 to 100
- Estimated time set to 2.00