From patchwork Sun Feb 14 03:42:18 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Holmes X-Patchwork-Id: 61911 Delivered-To: patch@linaro.org Received: by 10.112.43.199 with SMTP id y7csp375063lbl; Sat, 13 Feb 2016 19:46:19 -0800 (PST) X-Received: by 10.140.102.14 with SMTP id v14mr11806903qge.48.1455421578987; Sat, 13 Feb 2016 19:46:18 -0800 (PST) Return-Path: Received: from lists.linaro.org (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTP id m69si25943955qge.48.2016.02.13.19.46.18; Sat, 13 Feb 2016 19:46:18 -0800 (PST) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.225.227.206 as permitted sender) client-ip=54.225.227.206; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.225.227.206 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dkim=neutral (body hash did not verify) header.i=@linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id 80D48617EB; Sun, 14 Feb 2016 03:46:18 +0000 (UTC) Authentication-Results: lists.linaro.org; dkim=fail reason="verification failed; unprotected key" header.d=linaro.org header.i=@linaro.org header.b=isKZHTS6; dkim-adsp=none (unprotected policy); dkim-atps=neutral X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252 X-Spam-Level: X-Spam-Status: No, score=-2.5 required=5.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H2,T_DKIM_INVALID,URIBL_BLOCKED autolearn=disabled version=3.4.0 Received: from [127.0.0.1] (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id 356CC61700; Sun, 14 Feb 2016 03:43:35 +0000 (UTC) X-Original-To: lng-odp@lists.linaro.org Delivered-To: lng-odp@lists.linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id 794206171A; Sun, 14 Feb 2016 03:43:05 +0000 (UTC) Received: from mail-qg0-f53.google.com (mail-qg0-f53.google.com [209.85.192.53]) by lists.linaro.org (Postfix) with ESMTPS id 2CA24617EB for ; Sun, 14 Feb 2016 03:42:30 +0000 (UTC) Received: by mail-qg0-f53.google.com with SMTP id b35so89976578qge.0 for ; Sat, 13 Feb 2016 19:42:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=8hu2E4F/hd3oqCmlFzjYtx+tcvKPB6Jykkn6WuUphKQ=; b=isKZHTS6M6tYbTw3mne0k3uemU0D18zMDAwZBb3RphJ+TncAYrS19o5CK59hkZn/PW odsnu8AZ/cVZyY4zyXAxms58Tzi4I+zkhVB4WhRW42ZQMB4xoOSpa6HckjNIJOgSNVwi xStrLD0tNL7X86m3Z9Dn7bx/zQ7yEdcXvLSxs= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=8hu2E4F/hd3oqCmlFzjYtx+tcvKPB6Jykkn6WuUphKQ=; b=V5cFbjXbSTelpDKHyrwH3rcndPsOx6buAQ7L2hE6Cm7cOovLkWQ/xGj7kHBKBA2/ON myf8+gBiX7a+Q2UaBcKNnM9FmBduARQe0lxXWg7PHz4OhfyG8za6gwusgbCHrA9/huGZ 1wXY0NPrHJzTWbCc+GIpbC+Rua56DMIKLYdmuEtfAzXUEQ+rc6LD+vWI2ppVQgfL3+2O 4gJ5F4rTbxL5BJEz/kZHqpH4w4dYVZ97XOs4QXwpR++3tG5Cv0lpgnQ0HinfI+zRM76D g0uwvoX1XfweA0UQpu4PPky0UK3W5s8yfKalrfL6efbmratczkgzEtv80jW4ZuQ4lgBC iuog== X-Gm-Message-State: AG10YOQlPPIQRj0lQ7s2pmpLl+aSTTdbvnfywCBgaHy0jxRzPTVJnXj2E8cBJQaqOkb8nDdBTFM= X-Received: by 10.140.32.203 with SMTP id h69mr12021928qgh.55.1455421349944; Sat, 13 Feb 2016 19:42:29 -0800 (PST) Received: from localhost.localdomain (c-98-221-136-245.hsd1.nj.comcast.net. [98.221.136.245]) by smtp.gmail.com with ESMTPSA id e11sm8612456qkb.39.2016.02.13.19.42.29 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Sat, 13 Feb 2016 19:42:29 -0800 (PST) From: Mike Holmes To: lng-odp@lists.linaro.org Date: Sat, 13 Feb 2016 22:42:18 -0500 Message-Id: <1455421338-9593-4-git-send-email-mike.holmes@linaro.org> X-Mailer: git-send-email 2.5.0 In-Reply-To: <1455421338-9593-1-git-send-email-mike.holmes@linaro.org> References: <1455421338-9593-1-git-send-email-mike.holmes@linaro.org> X-Topics: patch Subject: [lng-odp] [PATCH 4/4] doc: depend the docs on the images X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "The OpenDataPlane \(ODP\) List" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" Signed-off-by: Mike Holmes --- configure.ac | 1 - doc/Makefile.am | 2 +- doc/Makefile.inc | 8 ++++++-- doc/images/Makefile.am | 16 ---------------- doc/implementers-guide/Makefile.am | 8 +++++--- doc/process-guide/Makefile.am | 21 ++++++++++++++------- doc/users-guide/Makefile.am | 22 +++++++++++++++++++--- 7 files changed, 45 insertions(+), 33 deletions(-) delete mode 100644 doc/images/Makefile.am diff --git a/configure.ac b/configure.ac index c0c2af3..ebe64e2 100644 --- a/configure.ac +++ b/configure.ac @@ -323,7 +323,6 @@ AC_CONFIG_FILES([Makefile doc/implementers-guide/Makefile doc/users-guide/Makefile doc/process-guide/Makefile - doc/images/Makefile example/Makefile example/classifier/Makefile example/generator/Makefile diff --git a/doc/Makefile.am b/doc/Makefile.am index ec05764..8af8070 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,3 +1,3 @@ if user_guide -SUBDIRS = images implementers-guide users-guide process-guide +SUBDIRS = implementers-guide users-guide process-guide endif diff --git a/doc/Makefile.inc b/doc/Makefile.inc index 3f31e9a..cab5286 100644 --- a/doc/Makefile.inc +++ b/doc/Makefile.inc @@ -1,2 +1,6 @@ -.adoc.html: - asciidoc -a data-uri -b html5 -a icons -a toc2 -a max-width=55em --out-file=$@ $< +VPATH=$(top_builddir)/doc/images + +.msc.svg: + mscgen -T svg -i $^ -o $@ + +ASCIIDOC_FLAGS =-a data-uri -b html5 -a icons -a toc2 -a max-width=55em diff --git a/doc/images/Makefile.am b/doc/images/Makefile.am deleted file mode 100644 index 8fb8a99..0000000 --- a/doc/images/Makefile.am +++ /dev/null @@ -1,16 +0,0 @@ -.msc.svg: - mscgen -T svg -i $^ -o $@ - -MSG_SRCS = resource_management.msc -MSG_TARGETS = $(MSG_SRCS:msc=svg) - -EXTRA_DIST = $(MSG_SRCS) - -if HAVE_MSCGEN -TARGETS = $(MSG_TARGETS) -endif - -all-local: $(TARGETS) - -clean-local: - rm -f $(MSG_TARGETS) diff --git a/doc/implementers-guide/Makefile.am b/doc/implementers-guide/Makefile.am index eb614e1..6a614ce 100644 --- a/doc/implementers-guide/Makefile.am +++ b/doc/implementers-guide/Makefile.am @@ -1,10 +1,12 @@ include ../Makefile.inc +SRC = $(top_srcdir)/doc/implementers-guide/implementers-guide.adoc TARGET = implementers-guide.html -EXTRA_DIST = implementers-guide.adoc +EXTRA_DIST = $(SRC) -all-local: $(TARGET) +all-local: $(SRC) + asciidoc $(ASCIIDOC_FLAGS) --out-file=$(TARGET) $(SRC) clean-local: - rm -f $(TARGET) + rm -f $(builddir)/$(TARGET) diff --git a/doc/process-guide/Makefile.am b/doc/process-guide/Makefile.am index 9fc3b80..efef04d 100644 --- a/doc/process-guide/Makefile.am +++ b/doc/process-guide/Makefile.am @@ -1,12 +1,19 @@ include ../Makefile.inc -TARGET = bylaws-guide.html \ - release-guide.html +EXTRA_DIST = $(top_srcdir)/doc/process-guide/bylaws-guide.adoc \ + $(top_srcdir)/doc/process-guide/release-guide.adoc -EXTRA_DIST = bylaws-guide.adoc \ - release-guide.adoc - -all-local: $(TARGET) +all-local: bylaws-guide.html \ + release-guide.html clean-local: - rm -f $(TARGET) + rm -f $(builddir)/bylaws-guide.html + rm -f $(builddir)/release-guide.html + +release-guide.html: $(top_srcdir)/doc/process-guide/release-guide.adoc \ + $(top_srcdir)/doc/images/simple_release_git.svg \ + $(top_srcdir)/doc/images/release_git.svg + asciidoc $(ASCIIDOC_FLAGS) --out-file=$@ $< + +bylaws-guide.html: $(top_srcdir)/doc/process-guide/bylaws-guide.adoc + asciidoc $(ASCIIDOC_FLAGS) --out-file=$@ $< diff --git a/doc/users-guide/Makefile.am b/doc/users-guide/Makefile.am index 960a90f..4f5b1fe 100644 --- a/doc/users-guide/Makefile.am +++ b/doc/users-guide/Makefile.am @@ -1,10 +1,26 @@ include ../Makefile.inc +SRC = $(top_srcdir)/doc/users-guide/users-guide.adoc TARGET = users-guide.html +IMAGES = $(top_srcdir)/doc/images/overview.svg \ + $(top_srcdir)/doc/images/odp_components.svg \ + $(top_srcdir)/doc/images/odp_rx_processing.svg \ + $(top_srcdir)/doc/images/odp_scheduling.svg \ + $(top_srcdir)/doc/images/odp_traffic_manager.svg \ + $(top_srcdir)/doc/images/parallel_queue.svg \ + $(top_srcdir)/doc/images/atomic_queue.svg \ + $(top_srcdir)/doc/images/ordered_queue.svg -EXTRA_DIST = users-guide.adoc +if HAVE_MSCGEN +IMAGES += $(top_srcdir)/doc/images/resource_management.svg +endif -all-local: $(TARGET) +EXTRA_DIST = $(SRC) $(IMAGES) + +all-local: $(SRC) + asciidoc $(ASCIIDOC_FLAGS) --out-file=$(TARGET) $(SRC) clean-local: - rm -f $(TARGET) + rm -f $(builddir)/$(TARGET) + +$(SRC): $(IMAGES)