Bug 229576

Summary: textproc/libe-book option should reference doxygen rather than common docs
Product: Ports & Packages Reporter: sid
Component: Individual Port(s)Assignee: FreeBSD Office Team <office>
Status: New ---    
Severity: Affects Only Me CC: sid, w.schwarzenfeld
Priority: --- Flags: bugzilla: maintainer-feedback? (office)
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
textproc/libe-book/Makefile diff, clarifying Doxygen as type of Doc for dependency use none

Description sid 2018-07-07 01:01:33 UTC
Proposal to change all DOCS references to DOXYGEN in Makefile. It better describes the option, and it allows for conformity in choosing types of documentation used. Both doxygen and docs descriptions are defined in /usr/ports/Mk/bsd.options.desc.mk

The proposed edit allows the choice of DOXYGEN or DOCS documentation options to be set by using OPTIONS_SET or OPTIONS_UNSET in make.conf. These are two wholly different types of documentations. Without this, DOXYGEN has to be unset with the argument textproc_libe-book_UNSET=DOCS from make.conf.

I sent the proposal twice last month, and there hasn't been a response.

Here is the proposed edit, which is also common in other makefiles:

19c19
< OPTIONS_DEFINE= DOCS
---
> OPTIONS_DEFINE= DOXYGEN
31,32c31,32
< DOCS_BUILD_DEPENDS= doxygen:devel/doxygen
< DOCS_CONFIGURE_OFF= --without-docs
---
> DOXYGEN_BUILD_DEPENDS= doxygen:devel/doxygen
> DOXYGEN_CONFIGURE_OFF= --without-doxygen
Comment 1 Walter Schwarzenfeld freebsd_triage 2019-08-11 18:26:41 UTC
Maintainer feedback,please!
Comment 2 sid 2021-10-12 04:59:20 UTC
Created attachment 228612 [details]
textproc/libe-book/Makefile diff, clarifying Doxygen as type of Doc for dependency use

Sending diff-u as an attachment. This is recently done, while it's identical to original submission.