[ovs-dev] [PATCH v2 11/11] doc: Remove documentation from distdoc target

Russell Bryant russell at ovn.org
Tue Dec 13 20:07:00 UTC 2016


On Tue, Dec 13, 2016 at 3:01 PM, Lance Richardson <lrichard at redhat.com>
wrote:

> > From: "Stephen Finucane" <stephen at that.guru>
> > To: dev at openvswitch.org
> > Sent: Thursday, December 8, 2016 7:55:30 AM
> > Subject: [ovs-dev] [PATCH v2 11/11] doc: Remove documentation from
> distdoc    target
> >
> > Basic Sphinx integration is now complete. Remove the documentation
> > aspects of the 'dist-docs' target in favor of the htmldocs target.
> >
> > Signed-off-by: Stephen Finucane <stephen at that.guru>
> > ---
> >  Documentation/automake.mk |  4 +---
> >  Makefile.am               |  7 +------
> >  build-aux/dist-docs       | 50
> >  +----------------------------------------------
> >  debian/rules.modules      |  2 +-
> >  third-party/automake.mk   |  5 +++--
> >  5 files changed, 7 insertions(+), 61 deletions(-)
> >
> > diff --git a/Documentation/automake.mk b/Documentation/automake.mk
> > index 58cd650..6657b70 100644
> > --- a/Documentation/automake.mk
> > +++ b/Documentation/automake.mk
> > @@ -1,7 +1,5 @@
> > -docs += \
> > -     Documentation/group-selection-method-property.txt
> > -
>
> With the initialization of "docs" gone, "make dist-docs" now fails. Is
> this intentional?
>
> $ make dist-docs
> VERSION=2.6.90 MAKE='make' ./build-aux/dist-docs .
> ./build-aux/dist-docs: HTML documentation generator for Open vSwitch
> usage: ./build-aux/dist-docs srcdir docfile...
>
> The VERSION environment variable should be set to the Open vSwitch version.
> Must be invoked from an Open vSwitch build directory.
> Most conveniently invoked via "make dist-docs".
> Makefile:6103: recipe for target 'dist-docs' failed
> make: *** [dist-docs] Error 1


We still need the dist-docs target for rendering all of the man pages,
right?

-- 
Russell Bryant


More information about the dev mailing list