[Pkg-octave-commit] [octave-queueing.git] 02/04: Allow building of documentation
Rafael Laboissière
rlaboiss-guest at moszumanska.debian.org
Wed Aug 31 14:16:49 UTC 2016
This is an automated email from the git hooks/post-receive script.
rlaboiss-guest pushed a commit to branch master
in repository octave-queueing.git.
commit ff074e88539db635559332104e746b967dd03269
Author: Rafael Laboissiere <rafael at debian.org>
Date: Wed Aug 31 11:05:22 2016 -0300
Allow building of documentation
* d/p/compile-documentation.patch: New patch
* d/rules: Add commands for cleaning and building the doc/* files
* .gitignore: Add list of exclusions for Git
* d/octave-queueing.docs: Install PDF form of documentation
* d/octave-queueing.info: Install info form of documentation
* d/octave-queueing.doc-base: Register PDF form of documentation
* d/s/options: Exclude files generated during building of the documentation
Gbp-Dch: Ignore
---
.gitignore | 20 ++++
debian/octave-queueing.doc-base | 14 +++
debian/octave-queueing.docs | 1 +
debian/octave-queueing.info | 1 +
debian/patches/compile-documentation.patch | 155 +++++++++++++++++++++++++++++
debian/patches/series | 1 +
debian/rules | 6 ++
debian/source/options | 1 +
8 files changed, 199 insertions(+)
diff --git a/.gitignore b/.gitignore
index 6fd9d7e..158c5bc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,23 @@
/debian/octave-queueing.debhelper.log
/debian/octave-queueing.substvars
/debian/octave-queueing/
+/doc/conf.texi
+/doc/power.pdf
+/doc/qn_closed_multi.pdf
+/doc/qn_closed_multi_apl.pdf
+/doc/qn_closed_multi_cs.pdf
+/doc/qn_closed_single.pdf
+/doc/qn_open_single.pdf
+/doc/qn_web_model.pdf
+/doc/queueing.au
+/doc/queueing.aus
+/doc/queueing.aux
+/doc/queueing.cp
+/doc/queueing.cps
+/doc/queueing.fn
+/doc/queueing.fns
+/doc/queueing.info
+/doc/queueing.log
+/doc/queueing.toc
+/doc/web.pdf
+/.pc/
diff --git a/debian/octave-queueing.doc-base b/debian/octave-queueing.doc-base
new file mode 100644
index 0000000..288cdce
--- /dev/null
+++ b/debian/octave-queueing.doc-base
@@ -0,0 +1,14 @@
+Document: octave-queueing-manual
+Title: Queueing Networks and Markov chains analysis package for Octave
+Author: Moreno Marzolla
+Abstract: This document describes the queueing package for GNU Octave
+ queueing in short). The queueing package, previously known as
+ qnetworks, is a collection of functions written in GNU Octave for
+ analyzing queueing networks and Markov chains. Specifically, queueing
+ contains functions for analyzing Jackson networks, open, closed or
+ mixed product-form BCMP networks, and computation of performance
+ bounds.
+Section: Science/Mathematics
+
+Format: PDF
+Files: /usr/share/doc/octave-queueing/queueing.pdf.gz
diff --git a/debian/octave-queueing.docs b/debian/octave-queueing.docs
new file mode 100644
index 0000000..7f5899b
--- /dev/null
+++ b/debian/octave-queueing.docs
@@ -0,0 +1 @@
+doc/queueing.pdf
diff --git a/debian/octave-queueing.info b/debian/octave-queueing.info
new file mode 100644
index 0000000..3a72e86
--- /dev/null
+++ b/debian/octave-queueing.info
@@ -0,0 +1 @@
+doc/queueing.info
diff --git a/debian/patches/compile-documentation.patch b/debian/patches/compile-documentation.patch
new file mode 100644
index 0000000..120b9e1
--- /dev/null
+++ b/debian/patches/compile-documentation.patch
@@ -0,0 +1,155 @@
+Description: Allow compilation of documentation files
+Author: Rafael Laboissiere <rafael at debian.org>
+Origin: upstream, https://sourceforge.net/p/octave/queueing/ci/default/tree/doc/
+Forwarded: https://savannah.gnu.org/bugs/index.php?48959
+Last-Update: 2016-08-30
+
+--- /dev/null
++++ octave-queueing-1.2.3/doc/Makefile
+@@ -0,0 +1,61 @@
++DOC=queueing
++CHAPTERS=$(patsubst %.txi, %.texi, $(wildcard *.txi))
++FIGS=qn_open_single qn_closed_single qn_web_model qn_closed_multi web power qn_closed_multi_apl qn_closed_multi_cs
++FIGS_EPS=$(FIGS:%=%.eps)
++FIGS_PDF=$(FIGS:%=%.pdf)
++FIGS_PNG=$(FIGS:%=%.png)
++DISTFILES=README INSTALL $(DOC).pdf $(DOC).html $(DOC).texi $(CHAPTERS) $(FIGS_EPS) $(wildcard *.fig)
++
++.PHONY: clean dist
++
++ALL: pdf INSTALL
++
++html: $(DOC).html
++
++pdf: $(DOC).pdf
++
++info: $(DOC).info
++
++INSTALL: installation.texi
++ -$(MAKEINFO) -D INSTALLONLY \
++ --no-validate --no-headers --no-split --output INSTALL $<
++
++$(DOC).html: $(DOC).texi conf.texi $(CHAPTERS) $(FIGS_PNG)
++ -$(MAKEINFO) --html --no-split $(DOC).texi
++
++$(DOC).pdf: $(DOC).texi conf.texi $(CHAPTERS) $(FIGS_PDF)
++ texi2pdf -o $(DOC).pdf $(DOC).texi
++
++$(DOC).info: $(DOC).texi conf.texi $(CHAPTERS)
++ -$(MAKEINFO) $(DOC).texi
++
++%.texi: %.txi
++ octave -p../inst/ -q munge-texi.m $< ../inst/ > $@
++
++%.png: %.fig
++ fig2dev -L png -m 3 $< $@
++
++%.pdf: %.fig
++ fig2dev -L pdf $< $@
++
++%.eps: %.fig
++ fig2dev -L eps $< $@
++
++web.eps power.eps: demo_web.m
++ octave -p../inst/ -q $<
++
++%.pdf: %.eps
++ epstopdf $<
++
++%.png: %.eps
++ convert -density 300 -background white -flatten $< $@
++
++dist: $(DISTFILES)
++ ln $(DISTFILES) ../`cat ../fname`/doc/
++
++clean:
++ \rm -f *.fns *.pdf *.aux *.log *.dvi *.out *.info *.html *.ky *.tp *.toc *.vr *.cp *.fn *.pg *.op *.au *.aus *.cps x.log *~ DOCSTRINGS INSTALL $(CHAPTERS)
++
++distclean: clean
++ \rm -f $(FIGS_PDF) $(FIGS_EPS) $(FIGS_PNG)
++
+--- /dev/null
++++ octave-queueing-1.2.3/doc/demo_web.m
+@@ -0,0 +1,82 @@
++## Copyright (C) 2012 Moreno Marzolla
++##
++## This file is part of the queueing toolbox.
++##
++## The queueing toolbox is free software: you can redistribute it and/or
++## modify it under the terms of the GNU General Public License as
++## published by the Free Software Foundation, either version 3 of the
++## License, or (at your option) any later version.
++##
++## The queueing toolbox is distributed in the hope that it will be
++## useful, but WITHOUT ANY WARRANTY; without even the implied warranty
++## of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
++## General Public License for more details.
++##
++## You should have received a copy of the GNU General Public License
++## along with the queueing toolbox. If not, see <http://www.gnu.org/licenses/>
++
++1; # not a function file
++
++figure (1, "visible", "off"); # do not show plot window
++
++page_screen_output(0); # avoid output pagination
++
++N = 100; # total population size
++beta = linspace(0.1,0.9,18); # population mix for class 1
++D = [12 14 23 20 80 31; ...
++ 2 20 14 90 30 33 ];
++V = ones(size(D));
++X1 = X1 = XX = zeros(size(beta));
++R1 = R2 = RR = zeros(size(beta));
++for i=1:length(beta)
++ pop = [fix(beta(i)*N) N-fix(beta(i)*N)];
++ [U R Q X] = qncmmva( pop, D, V );
++ X1(i) = X(1,1) / V(1,1);
++ X2(i) = X(2,1) / V(2,1);
++ XX(i) = X1(i) + X2(i);
++ R1(i) = dot(R(1,:), V(1,:));
++ R2(i) = dot(R(2,:), V(2,:));
++ RR(i) = N / XX(i);
++endfor
++
++## Plot throughput and response times
++set(gcf,"paperorientation","landscape");
++papersize=[4 3] * 0.7; margin=[0 0];
++set(gcf,"papersize",papersize);
++set(gcf,"paperposition", [margin papersize-margin*2]);
++
++subplot(2,1,1);
++plot(beta, X1, "--", "linewidth", 2, ...
++ beta, X2, ":", "linewidth", 2, ...
++ beta, XX, "-", "linewidth", 2 );
++ylabel("Throughput");
++subplot(2,1,2);
++plot(beta, R1, "--", "linewidth", 2, ...
++ beta, R2, ":", "linewidth", 2, ...
++ beta, RR, "-", "linewidth", 2 );
++ax = axis();
++ax(3) = 0;
++axis(ax);
++legend({"Class 1", "Class 2", "System"}, "location","south");
++xlabel("Population mix \\beta_1 for Class 1");
++ylabel("Response Time");
++
++print("web.eps", "-deps2", "-mono", "-tight");
++
++clf;
++
++## Plot system power
++set(gcf,"paperorientation","landscape");
++papersize=[4 2.5] * 0.7; margin=[0 0];
++set(gcf,"papersize",papersize);
++set(gcf,"paperposition", [margin papersize-margin*2]);
++
++plot(beta, X1./R1, "--;Class 1;", "linewidth", 2, ...
++ beta, X2./R2, ":;Class 2;", "linewidth", 2, ...
++ beta, XX./RR, "-;System;", "linewidth", 2);
++xlabel("Population mix \\beta_1 for Class 1");
++ylabel("Power");
++
++print("power.eps", "-deps2", "-mono", "-tight");
++
++
diff --git a/debian/patches/series b/debian/patches/series
index a77478f..2f94590 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -1 +1,2 @@
+compile-documentation.patch
typo-in-ctmc-docstring.patch
diff --git a/debian/rules b/debian/rules
index 71fb86c..95d7e39 100755
--- a/debian/rules
+++ b/debian/rules
@@ -2,3 +2,9 @@
# -*- makefile -*-
include /usr/share/cdbs/1/class/octave-pkg.mk
+
+build/octave-queueing::
+ make -C doc pdf info
+
+clean::
+ make -C doc clean
diff --git a/debian/source/options b/debian/source/options
new file mode 100644
index 0000000..20237ff
--- /dev/null
+++ b/debian/source/options
@@ -0,0 +1 @@
+extend-diff-ignore=doc/conf.texi|doc/power.pdf|doc/qn_closed_multi.pdf|doc/qn_closed_multi_apl.pdf|doc/qn_closed_multi_cs.pdf|doc/qn_closed_single.pdf|doc/qn_open_single.pdf|doc/qn_web_model.pdf|doc/queueing.pdf|doc/web.pdf|doc/power.eps|doc/queueing.au|doc/queueing.aus|doc/queueing.aux|doc/queueing.cp|doc/queueing.cps|doc/queueing.fn|doc/queueing.fns|doc/queueing.log|doc/queueing.toc|doc/web.eps
\ No newline at end of file
--
Alioth's /home/groups/pkg-octave/bin/git-commit-notice on /srv/git.debian.org/git/pkg-octave/octave-queueing.git.git
More information about the Pkg-octave-commit
mailing list