From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 33672 invoked by alias); 7 May 2017 12:47:03 -0000 Mailing-List: contact kawa-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: kawa-owner@sourceware.org Received: (qmail 33652 invoked by uid 89); 7 May 2017 12:47:02 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.4 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_SPAM autolearn=no version=3.3.2 spammy=HTo:U*kawa, jessie, epub, Perhaps X-HELO: homiemail-a75.g.dreamhost.com Received: from sub3.mail.dreamhost.com (HELO homiemail-a75.g.dreamhost.com) (69.163.253.7) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sun, 07 May 2017 12:47:01 +0000 Received: from homiemail-a75.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a75.g.dreamhost.com (Postfix) with ESMTP id CC5BF5EC079 for ; Sun, 7 May 2017 05:47:02 -0700 (PDT) Received: from vereq.eip10.org (cpe-74-75-122-130.maine.res.rr.com [74.75.122.130]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: chaw@eip10.org) by homiemail-a75.g.dreamhost.com (Postfix) with ESMTPSA id A1CF95EC072 for ; Sun, 7 May 2017 05:47:02 -0700 (PDT) Received: from chaw by vereq.eip10.org with local (Exim 4.84_2) (envelope-from ) id 1d7LaX-0005zm-EA for kawa@sourceware.org; Sun, 07 May 2017 08:47:01 -0400 To: kawa Subject: (minor) Installing docs built from source From: "Sudarshan S Chawathe" Reply-To: "Sudarshan S Chawathe" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <23048.1494161221.1@vereq.eip10.org> Date: Sun, 07 May 2017 12:47:00 -0000 Message-ID: <23049.1494161221@vereq.eip10.org> X-IsSubscribed: yes X-SW-Source: 2017-q2/txt/msg00050.txt.bz2 This items mentioned below are all minor (and a bit nebulous/rambling), related to installing (not building) the documentation. It is also possible that I'm the wrong make targets. Building the documentation (epub, pdf, and two HTML varieties) works fine with the current gitlab sources (on invoke branch). However, installing the documentation (using some combination of make install-html etc. as suggested by the Makefile targets) doesn't work properly. Based on a quick look at doc/Makefile, it seems that the variable KAWA_HTML_PARTS which is used by the install-html target is not defined. I'm guessing that variable should be set to the web and/or kawa-html subdirectories of doc where the 'fancy' and 'plain' HTML docs get built, but perhaps there is more to it. In particular, there is also the Javadoc HTML API documentation produced by 'make install-html' in the main Kawa directory. (I discovered this quite accidentally.) Perhaps those should be included in KAWA_HTML_PARTS too? These API docs get built in $HOME/Kawa but perhaps they should be built under Kawa/doc in the source directory (and then optionally installed elsewhere) instead. Perhaps it would also be useful to add a note about building the API docs to the "installing from source" section of the manual. They may not be of interest to many users, but users building from source may like to have them. (I find them nice to have for reference.) It may also be useful to allow the HTML docs to be installed somewhere relative to the value of the --prefix configure option instead of under $HOME/public_html. All the rest (make; make check; make install, etc.) works very smoothly with the current version in gitlab. (Testing on Debian 8/Jessie.) Regards, -chaw