Opened 3 years ago

Last modified 20 months ago

#19381 new enhancement

wish: conditionally build man page (tor.1) and html doc using independent configure options

Reported by: toralf Owned by: atagar
Priority: Medium Milestone: Tor: unspecified
Component: Core Tor/Tor Version:
Severity: Minor Keywords: easy docs lorax tor-docs build autotools
Cc: jryans@… Actual Points:
Parent ID: Points: .2
Reviewer: Sponsor:

Description

Currently it is practice in Gentoo Linux to install at least the the man page.
However that creation is coupled to the html files too (right ?) and therefore forces the Tor package to pull in more - otherwise completely unneeded - dependent packages.

De-coupling tor.1 from the html docs would at least allow us in the Gentoo Linux universe to get rid of packages like libxslt and friends at a dedicated Tor relay.

Child Tickets

Change History (7)

comment:1 Changed 3 years ago by toralf

Summary: wish: conditionally build man page (tor.1) and html doc using independend configure optionswish: conditionally build man page (tor.1) and html doc using independent configure options

comment:2 Changed 3 years ago by atagar

Component: Core Tor/DocTorCore Tor/Tor

DocTor is the monitoring framework - sending this on to Nick.

comment:3 Changed 3 years ago by nickm

Keywords: easy docs lorax added
Points: .2

I'd take a patch for this, sure. The right way to do it is to add --disable-html-manual and --disable-manpage options to configure.ac, and use them to subdivide the case in doc/include.am that is currently controlled by USE_ASCIIDOC.

comment:4 Changed 3 years ago by nickm

Milestone: Tor: unspecified

comment:5 Changed 2 years ago by jryans

Cc: jryans@… added

It appears that a2x calls xsltproc even for manpages. The separate configure flags could still be added, but it seems like you'd still need the same libs to create the manpage (if I am following correctly).

comment:6 in reply to:  5 Changed 2 years ago by cypherpunks

Replying to jryans:

It appears that a2x calls xsltproc even for manpages.

The a2x manual backs your claim by listing xsltproc as one of its requisites.

The separate configure flags could still be added, but it seems like you'd still need the same libs to create the manpage (if I am following correctly).

FWIW AsciiDoc generates the html documentation and a2x generates the manpages. a2x depends on AsciiDoc (see the manual link above) and is part of the AsciiDoc package. I don't see how the dependencies are decreased by introducing the proposed configure options.

comment:7 Changed 20 months ago by nickm

Keywords: tor-docs build autotools added
Note: See TracTickets for help on using tickets.