samples/debian.ros to make debian package(not tested)

This commit is contained in:
SANO Masatoshi 2015-02-07 16:58:39 +09:00
parent 617d5c3af7
commit ad7bab957d
30 changed files with 1191 additions and 0 deletions

6
debian/README.Debian vendored Normal file
View file

@ -0,0 +1,6 @@
roswell for Debian
------------------
<possible notes regarding this package - if none, delete this file>
-- Masatoshi SANO <snmsts@gmail.com> Thu, 05 Feb 2015 07:16:40 +0900

10
debian/README.source vendored Normal file
View file

@ -0,0 +1,10 @@
roswell for Debian
------------------
<this file describes information about the source package, see Debian policy
manual section 4.14. You WILL either need to modify or delete this file>
-- Masatoshi SANO <snmsts@gmail.com> Thu, 05 Feb 2015 07:16:40 +0900

59
debian/autoreconf.after vendored Normal file
View file

@ -0,0 +1,59 @@
d41d8cd98f00b204e9800998ecf8427e ./ChangeLog
f4aafb270c2f983f35b365aad5fe8870 ./depcomp
a51ce79fe49445aa60e79fae36f0c039 ./autom4te.cache/output.1
a51ce79fe49445aa60e79fae36f0c039 ./autom4te.cache/output.0
a89a4bdfe4950b57beb60ae5eae2d933 ./autom4te.cache/traces.1
d88ef801448e44792e1cfd97c2c9e255 ./autom4te.cache/requests
3a0c94efdbe18b14677b1c3bdaa97133 ./autom4te.cache/traces.0
fb4a52483d431c545505e2710473a773 ./Makefile.in
c11467c002de0c28fd1e35a3eb1d7d0b ./COPYING
1be6cc4f7e7bd8d2ac9a63cd47dfeaad ./README.md
6e5fe73723cd40a28adc5b7b5650c8d1 ./install-sh
7ce728e42b3b23fa41b0e81f7f2d11be ./Makefile.am
a45c51b165fc7f4116286e36ff367c0b ./config.h.in
0a298977cf0d0530af6353b479ec166a ./.travis.yml
377abdf1e4af9322ce9e550e44600880 ./bootstrap
f32346e88eccb61d8bfe5eb2bce3b2ae ./t/roswell.ros
d41d8cd98f00b204e9800998ecf8427e ./NEWS
04491ae35ea9f4fb4ee549701d6830d8 ./samples/hello.ros
f068e161cd8fd38188749b417b9d1d42 ./configure
c9f67adba3ab387ba8faa7e9a43400ae ./aclocal.m4
61b9e18e0c5673839afd588124e70afd ./configure.ac
d41d8cd98f00b204e9800998ecf8427e ./AUTHORS
0c8b042f99995c11aeb81bccc23c4c05 ./compile
a318addb45af3676ecc3d5b46c713e83 ./src/cmd-help.c
43498c93848988dea5f067662c38442c ./src/cmd-setup.c
6fc5843c203e8ac2df2cb05e68e419b7 ./src/opt.h
b1083bb38503f4e64774bfd495cc7873 ./src/html.c
65a0ff8c4ef6364f72adf17f5f8ca40c ./src/download.c
5ab756c4d5626dac1baf282c77c8365e ./src/cmd-run-sbcl.c
bff61fc93151b110177c66402e958329 ./src/util.h
3cde6819f0945cd9677d310a26c9bad8 ./src/Makefile.in
3ae6ed3977e7815f34ff29f727e073a5 ./src/opt.c
370d9742bd5cc64aa915e35b823d4434 ./src/internal.c
f60d136d068ac26f9e8731113f6fa1c2 ./src/cmd-config.c
c804eab0c0ab4ff7320a5ea009546d32 ./src/cmd-run.c
1c4a7773a316708f9e884e77a74f70f0 ./src/cmd-version.c
9e0ed112cf5f23b9b6830472c296f0e9 ./src/Makefile.am
2399e5d2c325e2094c75de6d960f35e1 ./src/cmd-run-ccl.c
2db9f81327612299b2bb05097f171921 ./src/archive.c
7d99aa596e031504f4126628324dd1fa ./src/cmd-install.h
2b88ba4d3d113d1e604f4ea76fd218f7 ./src/cmd-install-sbcl-bin.c
31eea4bee509e0704fbcfd9759dc1c72 ./src/lsp.c
a0164f37c1d8eaa4e18dcc4351c0802c ./src/cmd-install-quicklisp.c
c478b875ebf63da2cd444b58f686197a ./src/cmd-install.c
bc83c8ac32fb2fc9f6f4f1cfb95f8756 ./src/lisp/use.ros
2a2ea7d4a3f1136178a80d10320d27d1 ./src/lisp/init.lisp
be736be8c8ac6455b07854e330955d15 ./src/lisp/install/7zip.lisp
48136b149af96759fc7239970f9fa061 ./src/lisp/install/sbcl-bin.lisp
af286347938e0b0881ac29ff136827e1 ./src/lisp/install/msys.lisp
52e095b3c41ac1135b90e6ccf32ecd9f ./src/lisp/install/quicklisp.lisp
8963f49eba8110fbd0b967447c5a7f15 ./src/lisp/install/ccl-bin.lisp
d736b816bf78e803e324f204df07c24f ./src/lisp/install/sbcl.lisp
e492835b971288e122d455f45e99b8e5 ./src/lisp/list.ros
ee3fca1adb0772f04c79cf353f1a4336 ./src/lisp/delete.ros
325fe0671440b03f078826ed78b76e6d ./src/lisp/dump.ros
7caceaa87d22f3b1cbca0c29482edfc0 ./src/lisp/init.ros
32bf2a7fee6f17fd690d4002b621960b ./src/lisp/install.ros
3d90058647decac14efd2b8c07aeaf0f ./src/util.c
1ad54e190e8322176a47a48621ad0887 ./missing

45
debian/autoreconf.before vendored Normal file
View file

@ -0,0 +1,45 @@
d41d8cd98f00b204e9800998ecf8427e ./ChangeLog
c11467c002de0c28fd1e35a3eb1d7d0b ./COPYING
1be6cc4f7e7bd8d2ac9a63cd47dfeaad ./README.md
7ce728e42b3b23fa41b0e81f7f2d11be ./Makefile.am
0a298977cf0d0530af6353b479ec166a ./.travis.yml
377abdf1e4af9322ce9e550e44600880 ./bootstrap
f32346e88eccb61d8bfe5eb2bce3b2ae ./t/roswell.ros
d41d8cd98f00b204e9800998ecf8427e ./NEWS
04491ae35ea9f4fb4ee549701d6830d8 ./samples/hello.ros
61b9e18e0c5673839afd588124e70afd ./configure.ac
d41d8cd98f00b204e9800998ecf8427e ./AUTHORS
a318addb45af3676ecc3d5b46c713e83 ./src/cmd-help.c
43498c93848988dea5f067662c38442c ./src/cmd-setup.c
6fc5843c203e8ac2df2cb05e68e419b7 ./src/opt.h
b1083bb38503f4e64774bfd495cc7873 ./src/html.c
65a0ff8c4ef6364f72adf17f5f8ca40c ./src/download.c
5ab756c4d5626dac1baf282c77c8365e ./src/cmd-run-sbcl.c
bff61fc93151b110177c66402e958329 ./src/util.h
3ae6ed3977e7815f34ff29f727e073a5 ./src/opt.c
370d9742bd5cc64aa915e35b823d4434 ./src/internal.c
f60d136d068ac26f9e8731113f6fa1c2 ./src/cmd-config.c
c804eab0c0ab4ff7320a5ea009546d32 ./src/cmd-run.c
1c4a7773a316708f9e884e77a74f70f0 ./src/cmd-version.c
9e0ed112cf5f23b9b6830472c296f0e9 ./src/Makefile.am
2399e5d2c325e2094c75de6d960f35e1 ./src/cmd-run-ccl.c
2db9f81327612299b2bb05097f171921 ./src/archive.c
7d99aa596e031504f4126628324dd1fa ./src/cmd-install.h
2b88ba4d3d113d1e604f4ea76fd218f7 ./src/cmd-install-sbcl-bin.c
31eea4bee509e0704fbcfd9759dc1c72 ./src/lsp.c
a0164f37c1d8eaa4e18dcc4351c0802c ./src/cmd-install-quicklisp.c
c478b875ebf63da2cd444b58f686197a ./src/cmd-install.c
bc83c8ac32fb2fc9f6f4f1cfb95f8756 ./src/lisp/use.ros
2a2ea7d4a3f1136178a80d10320d27d1 ./src/lisp/init.lisp
be736be8c8ac6455b07854e330955d15 ./src/lisp/install/7zip.lisp
48136b149af96759fc7239970f9fa061 ./src/lisp/install/sbcl-bin.lisp
af286347938e0b0881ac29ff136827e1 ./src/lisp/install/msys.lisp
52e095b3c41ac1135b90e6ccf32ecd9f ./src/lisp/install/quicklisp.lisp
8963f49eba8110fbd0b967447c5a7f15 ./src/lisp/install/ccl-bin.lisp
d736b816bf78e803e324f204df07c24f ./src/lisp/install/sbcl.lisp
e492835b971288e122d455f45e99b8e5 ./src/lisp/list.ros
ee3fca1adb0772f04c79cf353f1a4336 ./src/lisp/delete.ros
325fe0671440b03f078826ed78b76e6d ./src/lisp/dump.ros
7caceaa87d22f3b1cbca0c29482edfc0 ./src/lisp/init.ros
32bf2a7fee6f17fd690d4002b621960b ./src/lisp/install.ros
3d90058647decac14efd2b8c07aeaf0f ./src/util.c

5
debian/changelog vendored Normal file
View file

@ -0,0 +1,5 @@
roswell (0.0.2.22-1) unstable; urgency=low
* Initial release (Closes: #nnnn) <nnnn is the bug number of your ITP>
-- Masatoshi SANO <snmsts@gmail.com> Thu, 05 Feb 2015 07:16:40 +0900

1
debian/compat vendored Normal file
View file

@ -0,0 +1 @@
9

14
debian/control vendored Normal file
View file

@ -0,0 +1,14 @@
Source: roswell
Section: lisp
Priority: optional
Maintainer: Masatoshi SANO <snmsts@gmail.com>
Build-Depends: debhelper (>= 9)
Standards-Version: 3.9.5
Homepage: https://github.com/snmsts/roswell
Vcs-Git: https://github.com/snmsts/roswell.git
Package: roswell
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: <insert up to 60 chars description>
<insert long description, indented with spaces>

36
debian/copyright vendored Normal file
View file

@ -0,0 +1,36 @@
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: roswell
Source: <url://example.com>
Files: *
Copyright: <years> <put author's name and email here>
<years> <likewise for another author>
License: MIT
Files: debian/*
Copyright: 2015 Masatoshi SANO <snmsts@gmail.com>
License: MIT
License: MIT
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
.
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
# Please also look if there are files or directories which have a
# different copyright/license attached and list them here.
# Please avoid to pick license terms that are more restrictive than the
# packaged work, as it may make Debian's contributions unacceptable upstream.

2
debian/docs vendored Normal file
View file

@ -0,0 +1,2 @@
NEWS
README.md

1
debian/files vendored Normal file
View file

@ -0,0 +1 @@
roswell_0.0.2.22-1_amd64.deb lisp optional

166
debian/init.d.ex vendored Normal file
View file

@ -0,0 +1,166 @@
#!/bin/sh
### BEGIN INIT INFO
# Provides: roswell
# Required-Start: $local_fs $network $remote_fs $syslog
# Required-Stop: $local_fs $network $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: <Enter a short description of the software>
# Description: <Enter a long description of the software>
# <...>
# <...>
### END INIT INFO
# Author: Masatoshi SANO <snmsts@gmail.com>
# Do NOT "set -e"
# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="roswell"
NAME=roswell
DAEMON=/usr/sbin/roswell
DAEMON_ARGS=""
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0
# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME
# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh
# Define LSB log_* functions.
# Depend on lsb-base (>= 3.2-14) to ensure that this file is present
# and status_of_proc is working.
. /lib/lsb/init-functions
#
# Function that starts the daemon/service
#
do_start()
{
# Return
# 0 if daemon has been started
# 1 if daemon was already running
# 2 if daemon could not be started
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
|| return 1
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
$DAEMON_ARGS \
|| return 2
# The above code will not work for interpreted scripts, use the next
# six lines below instead (Ref: #643337, start-stop-daemon(8) )
#start-stop-daemon --start --quiet --pidfile $PIDFILE --startas $DAEMON \
# --name $NAME --test > /dev/null \
# || return 1
#start-stop-daemon --start --quiet --pidfile $PIDFILE --startas $DAEMON \
# --name $NAME -- $DAEMON_ARGS \
# || return 2
# Add code here, if necessary, that waits for the process to be ready
# to handle requests from services started subsequently which depend
# on this one. As a last resort, sleep for some time.
}
#
# Function that stops the daemon/service
#
do_stop()
{
# Return
# 0 if daemon has been stopped
# 1 if daemon was already stopped
# 2 if daemon could not be stopped
# other if a failure occurred
start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
RETVAL="$?"
[ "$RETVAL" = 2 ] && return 2
# Wait for children to finish too if this is a daemon that forks
# and if the daemon is only ever run from this initscript.
# If the above conditions are not satisfied then add some other code
# that waits for the process to drop all resources that could be
# needed by services started subsequently. A last resort is to
# sleep for some time.
start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
[ "$?" = 2 ] && return 2
# Many daemons don't delete their pidfiles when they exit.
rm -f $PIDFILE
return "$RETVAL"
}
#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
#
# If the daemon can reload its configuration without
# restarting (for example, when it is sent a SIGHUP),
# then implement that here.
#
start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
return 0
}
case "$1" in
start)
[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
do_start
case "$?" in
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
esac
;;
stop)
[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
do_stop
case "$?" in
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
esac
;;
status)
status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
;;
#reload|force-reload)
#
# If do_reload() is not implemented then leave this commented out
# and leave 'force-reload' as an alias for 'restart'.
#
#log_daemon_msg "Reloading $DESC" "$NAME"
#do_reload
#log_end_msg $?
#;;
restart|force-reload)
#
# If the "reload" option is implemented then remove the
# 'force-reload' alias
#
log_daemon_msg "Restarting $DESC" "$NAME"
do_stop
case "$?" in
0|1)
do_start
case "$?" in
0) log_end_msg 0 ;;
1) log_end_msg 1 ;; # Old process is still running
*) log_end_msg 1 ;; # Failed to start
esac
;;
*)
# Failed to stop
log_end_msg 1
;;
esac
;;
*)
#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
exit 3
;;
esac
:

56
debian/manpage.1.ex vendored Normal file
View file

@ -0,0 +1,56 @@
.\" Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2015 Masatoshi SANO <snmsts@gmail.com>,
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH ROSWELL SECTION "February 5, 2015"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
roswell \- program to do something
.SH SYNOPSIS
.B roswell
.RI [ options ] " files" ...
.br
.B bar
.RI [ options ] " files" ...
.SH DESCRIPTION
This manual page documents briefly the
.B roswell
and
.B bar
commands.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBroswell\fP is a program that...
.SH OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.SH SEE ALSO
.BR bar (1),
.BR baz (1).
.br
The programs are documented fully by
.IR "The Rise and Fall of a Fooish Bar" ,
available via the Info system.

154
debian/manpage.sgml.ex vendored Normal file
View file

@ -0,0 +1,154 @@
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!-- Process this file with docbook-to-man to generate an nroff manual
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
less'. A typical entry in a Makefile or Makefile.am is:
manpage.1: manpage.sgml
docbook-to-man $< > $@
The docbook-to-man binary is found in the docbook-to-man package.
Please remember that if you create the nroff version in one of the
debian/rules file targets (such as build), you will need to include
docbook-to-man in your Build-Depends control field.
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>FIRSTNAME</firstname>">
<!ENTITY dhsurname "<surname>SURNAME</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>February 5, 2015</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>SECTION</manvolnum>">
<!ENTITY dhemail "<email>snmsts@gmail.com</email>">
<!ENTITY dhusername "Masatoshi SANO">
<!ENTITY dhucpackage "<refentrytitle>ROSWELL</refentrytitle>">
<!ENTITY dhpackage "roswell">
<!ENTITY debian "<productname>Debian</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
]>
<refentry>
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2003</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>program to do something</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<arg><option>-e <replaceable>this</replaceable></option></arg>
<arg><option>--example <replaceable>that</replaceable></option></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>This manual page documents briefly the
<command>&dhpackage;</command> and <command>bar</command>
commands.</para>
<para>This manual page was written for the &debian; distribution
because the original program does not have a manual page.
Instead, it has documentation in the &gnu;
<application>Info</application> format; see below.</para>
<para><command>&dhpackage;</command> is a program that...</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<para>These programs follow the usual &gnu; command line syntax,
with long options starting with two dashes (`-'). A summary of
options is included below. For a complete description, see the
<application>Info</application> files.</para>
<variablelist>
<varlistentry>
<term><option>-h</option>
<option>--help</option>
</term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-v</option>
<option>--version</option>
</term>
<listitem>
<para>Show version of program.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>bar (1), baz (1).</para>
<para>The programs are documented fully by <citetitle>The Rise and
Fall of a Fooish Bar</citetitle> available via the
<application>Info</application> system.</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>This manual page was written by &dhusername; &dhemail; for
the &debian; system (and may be used by others). Permission is
granted to copy, distribute and/or modify this document under
the terms of the &gnu; General Public License, Version 2 any
later version published by the Free Software Foundation.
</para>
<para>
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

291
debian/manpage.xml.ex vendored Normal file
View file

@ -0,0 +1,291 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!--
`xsltproc -''-nonet \
-''-param man.charmap.use.subset "0" \
-''-param make.year.ranges "1" \
-''-param make.single.year.ranges "1" \
/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
manpage.xml'
A manual page <package>.<section> will be generated. You may view the
manual page with: nroff -man <package>.<section> | less'. A typical entry
in a Makefile or Makefile.am is:
DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
manpage.1: manpage.xml
$(XP) $(DB2MAN) $<
The xsltproc binary is found in the xsltproc package. The XSL files are in
docbook-xsl. A description of the parameters you can use can be found in the
docbook-xsl-doc-* packages. Please remember that if you create the nroff
version in one of the debian/rules file targets (such as build), you will need
to include xsltproc and docbook-xsl in your Build-Depends control field.
Alternatively use the xmlto command/package. That will also automatically
pull in xsltproc and docbook-xsl.
Notes for using docbook2x: docbook2x-man does not automatically create the
AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
<refsect1> ... </refsect1>.
To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
found in the docbook-xsl-doc-html package.
Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
General documentation about man-pages and man-page-formatting:
man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "FIRSTNAME">
<!ENTITY dhsurname "SURNAME">
<!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
<!ENTITY dhusername "Masatoshi SANO">
<!ENTITY dhemail "snmsts@gmail.com">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1) and
http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
<!ENTITY dhsection "SECTION">
<!-- TITLE should be something like "User commands" or similar (see
http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
<!ENTITY dhtitle "roswell User Manual">
<!ENTITY dhucpackage "ROSWELL">
<!ENTITY dhpackage "roswell">
]>
<refentry>
<refentryinfo>
<title>&dhtitle;</title>
<productname>&dhpackage;</productname>
<authorgroup>
<author>
<firstname>&dhfirstname;</firstname>
<surname>&dhsurname;</surname>
<contrib>Wrote this manpage for the Debian system.</contrib>
<address>
<email>&dhemail;</email>
</address>
</author>
</authorgroup>
<copyright>
<year>2007</year>
<holder>&dhusername;</holder>
</copyright>
<legalnotice>
<para>This manual page was written for the Debian system
(and may be used by others).</para>
<para>Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License,
Version 2 or (at your option) any later version published by
the Free Software Foundation.</para>
<para>On Debian systems, the complete text of the GNU General Public
License can be found in
<filename>/usr/share/common-licenses/GPL</filename>.</para>
</legalnotice>
</refentryinfo>
<refmeta>
<refentrytitle>&dhucpackage;</refentrytitle>
<manvolnum>&dhsection;</manvolnum>
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>program to do something</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<!-- These are several examples, how syntaxes could look -->
<arg choice="plain"><option>-e <replaceable>this</replaceable></option></arg>
<arg choice="opt"><option>--example=<parameter>that</parameter></option></arg>
<arg choice="opt">
<group choice="req">
<arg choice="plain"><option>-e</option></arg>
<arg choice="plain"><option>--example</option></arg>
</group>
<replaceable class="option">this</replaceable>
</arg>
<arg choice="opt">
<group choice="req">
<arg choice="plain"><option>-e</option></arg>
<arg choice="plain"><option>--example</option></arg>
</group>
<group choice="req">
<arg choice="plain"><replaceable>this</replaceable></arg>
<arg choice="plain"><replaceable>that</replaceable></arg>
</group>
</arg>
</cmdsynopsis>
<cmdsynopsis>
<command>&dhpackage;</command>
<!-- Normally the help and version options make the programs stop
right after outputting the requested information. -->
<group choice="opt">
<arg choice="plain">
<group choice="req">
<arg choice="plain"><option>-h</option></arg>
<arg choice="plain"><option>--help</option></arg>
</group>
</arg>
<arg choice="plain">
<group choice="req">
<arg choice="plain"><option>-v</option></arg>
<arg choice="plain"><option>--version</option></arg>
</group>
</arg>
</group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="description">
<title>DESCRIPTION</title>
<para>This manual page documents briefly the
<command>&dhpackage;</command> and <command>bar</command>
commands.</para>
<para>This manual page was written for the Debian distribution
because the original program does not have a manual page.
Instead, it has documentation in the GNU <citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> format; see below.</para>
<para><command>&dhpackage;</command> is a program that...</para>
</refsect1>
<refsect1 id="options">
<title>OPTIONS</title>
<para>The program follows the usual GNU command line syntax,
with long options starting with two dashes (`-'). A summary of
options is included below. For a complete description, see the
<citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> files.</para>
<variablelist>
<!-- Use the variablelist.term.separator and the
variablelist.term.break.after parameters to
control the term elements. -->
<varlistentry>
<term><option>-e <replaceable>this</replaceable></option></term>
<term><option>--example=<replaceable>that</replaceable></option></term>
<listitem>
<para>Does this and that.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option></term>
<term><option>--help</option></term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-v</option></term>
<term><option>--version</option></term>
<listitem>
<para>Show version of program.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="files">
<title>FILES</title>
<variablelist>
<varlistentry>
<term><filename>/etc/foo.conf</filename></term>
<listitem>
<para>The system-wide configuration file to control the
behaviour of <application>&dhpackage;</application>. See
<citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for further details.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>${HOME}/.foo.conf</filename></term>
<listitem>
<para>The per-user configuration file to control the
behaviour of <application>&dhpackage;</application>. See
<citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for further details.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="environment">
<title>ENVIRONMENT</title>
<variablelist>
<varlistentry>
<term><envar>FOO_CONF</envar></term>
<listitem>
<para>If used, the defined file is used as configuration
file (see also <xref linkend="files"/>).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="diagnostics">
<title>DIAGNOSTICS</title>
<para>The following diagnostics may be issued
on <filename class="devicefile">stderr</filename>:</para>
<variablelist>
<varlistentry>
<term><errortext>Bad configuration file. Exiting.</errortext></term>
<listitem>
<para>The configuration file seems to contain a broken configuration
line. Use the <option>--verbose</option> option, to get more info.
</para>
</listitem>
</varlistentry>
</variablelist>
<para><command>&dhpackage;</command> provides some return codes, that can
be used in scripts:</para>
<segmentedlist>
<segtitle>Code</segtitle>
<segtitle>Diagnostic</segtitle>
<seglistitem>
<seg><errorcode>0</errorcode></seg>
<seg>Program exited successfully.</seg>
</seglistitem>
<seglistitem>
<seg><errorcode>1</errorcode></seg>
<seg>The configuration file seems to be broken.</seg>
</seglistitem>
</segmentedlist>
</refsect1>
<refsect1 id="bugs">
<!-- Or use this section to tell about upstream BTS. -->
<title>BUGS</title>
<para>The program is currently limited to only work
with the <package>foobar</package> library.</para>
<para>The upstreams <acronym>BTS</acronym> can be found
at <ulink url="http://bugzilla.foo.tld"/>.</para>
</refsect1>
<refsect1 id="see_also">
<title>SEE ALSO</title>
<!-- In alpabetical order. -->
<para><citerefentry>
<refentrytitle>bar</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>baz</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry></para>
<para>The programs are documented fully by <citetitle>The Rise and
Fall of a Fooish Bar</citetitle> available via the <citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> system.</para>
</refsect1>
</refentry>

2
debian/menu.ex vendored Normal file
View file

@ -0,0 +1,2 @@
?package(roswell):needs="X11|text|vc|wm" section="Applications/see-menu-manual"\
title="roswell" command="/usr/bin/roswell"

39
debian/postinst.ex vendored Normal file
View file

@ -0,0 +1,39 @@
#!/bin/sh
# postinst script for roswell
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postinst> `configure' <most-recently-configured-version>
# * <old-postinst> `abort-upgrade' <new version>
# * <conflictor's-postinst> `abort-remove' `in-favour' <package>
# <new-version>
# * <postinst> `abort-remove'
# * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
# <failed-install-package> <version> `removing'
# <conflicting-package> <version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
configure)
;;
abort-upgrade|abort-remove|abort-deconfigure)
;;
*)
echo "postinst called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

37
debian/postrm.ex vendored Normal file
View file

@ -0,0 +1,37 @@
#!/bin/sh
# postrm script for roswell
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postrm> `remove'
# * <postrm> `purge'
# * <old-postrm> `upgrade' <new-version>
# * <new-postrm> `failed-upgrade' <old-version>
# * <new-postrm> `abort-install'
# * <new-postrm> `abort-install' <old-version>
# * <new-postrm> `abort-upgrade' <old-version>
# * <disappearer's-postrm> `disappear' <overwriter>
# <overwriter-version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
;;
*)
echo "postrm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

35
debian/preinst.ex vendored Normal file
View file

@ -0,0 +1,35 @@
#!/bin/sh
# preinst script for roswell
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <new-preinst> `install'
# * <new-preinst> `install' <old-version>
# * <new-preinst> `upgrade' <old-version>
# * <old-preinst> `abort-upgrade' <new-version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
install|upgrade)
;;
abort-upgrade)
;;
*)
echo "preinst called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

38
debian/prerm.ex vendored Normal file
View file

@ -0,0 +1,38 @@
#!/bin/sh
# prerm script for roswell
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <prerm> `remove'
# * <old-prerm> `upgrade' <new-version>
# * <new-prerm> `failed-upgrade' <old-version>
# * <conflictor's-prerm> `remove' `in-favour' <package> <new-version>
# * <deconfigured's-prerm> `deconfigure' `in-favour'
# <package-being-installed> <version> `removing'
# <conflicting-package> <version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
remove|upgrade|deconfigure)
;;
failed-upgrade)
;;
*)
echo "prerm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

1
debian/roswell-doc.docs vendored Normal file
View file

@ -0,0 +1 @@
#DOCS#

1
debian/roswell-doc.install vendored Normal file
View file

@ -0,0 +1 @@
#DOCS#

4
debian/roswell.cron.d.ex vendored Normal file
View file

@ -0,0 +1,4 @@
#
# Regular cron jobs for the roswell package
#
0 4 * * * root [ -x /usr/bin/roswell_maintenance ] && /usr/bin/roswell_maintenance

21
debian/roswell.debhelper.log vendored Normal file
View file

@ -0,0 +1,21 @@
override_dh_autoreconf dh_autoreconf
dh_autoreconf
dh_auto_configure
dh_auto_build
dh_auto_test
dh_prep
dh_auto_install
dh_installdocs
dh_installchangelogs
dh_perl
dh_link
dh_compress
dh_fixperms
dh_strip
dh_makeshlibs
dh_shlibdeps
dh_installdeb
dh_gencontrol
dh_md5sums
dh_builddeb
dh_builddeb

10
debian/roswell.default.ex vendored Normal file
View file

@ -0,0 +1,10 @@
# Defaults for roswell initscript
# sourced by /etc/init.d/roswell
# installed at /etc/default/roswell by the maintainer scripts
#
# This is a POSIX shell fragment
#
# Additional options that are passed to the Daemon.
DAEMON_OPTS=""

20
debian/roswell.doc-base.EX vendored Normal file
View file

@ -0,0 +1,20 @@
Document: roswell
Title: Debian roswell Manual
Author: <insert document author here>
Abstract: This manual describes what roswell is
and how it can be used to
manage online manuals on Debian systems.
Section: unknown
Format: debiandoc-sgml
Files: /usr/share/doc/roswell/roswell.sgml.gz
Format: postscript
Files: /usr/share/doc/roswell/roswell.ps.gz
Format: text
Files: /usr/share/doc/roswell/roswell.text.gz
Format: HTML
Index: /usr/share/doc/roswell/html/index.html
Files: /usr/share/doc/roswell/html/*.html

2
debian/roswell.substvars vendored Normal file
View file

@ -0,0 +1,2 @@
shlibs:Depends=libc6 (>= 2.14), libcurl3 (>= 7.16.2)
misc:Depends=

15
debian/rules vendored Executable file
View file

@ -0,0 +1,15 @@
#!/usr/bin/make -f
# -*- makefile -*-
# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1
# This has to be exported to make some magic below work.
export DH_OPTIONS
override_dh_autoreconf:
dh_autoreconf
%:
dh "$@" --with=autoreconf

1
debian/source/format vendored Normal file
View file

@ -0,0 +1 @@
3.0 (quilt)

23
debian/watch.ex vendored Normal file
View file

@ -0,0 +1,23 @@
# Example watch control file for uscan
# Rename this file to "watch" and then you can run the "uscan" command
# to check for upstream updates and more.
# See uscan(1) for format
# Compulsory line, this is a version 3 file
version=3
# Uncomment to examine a Webpage
# <Webpage URL> <string match>
#http://www.example.com/downloads.php roswell-(.*)\.tar\.gz
# Uncomment to examine a Webserver directory
#http://www.example.com/pub/roswell-(.*)\.tar\.gz
# Uncommment to examine a FTP server
#ftp://ftp.example.com/pub/roswell-(.*)\.tar\.gz debian uupdate
# Uncomment to find new files on sourceforge, for devscripts >= 2.9
# http://sf.net/roswell/roswell-(.*)\.tar\.gz
# Uncomment to find new files on GooglePages
# http://example.googlepages.com/foo.html roswell-(.*)\.tar\.gz

96
samples/debian.ros Executable file
View file

@ -0,0 +1,96 @@
#!/bin/sh
#|-*- mode: lisp -*-|#
#|
exec ros -Q -L sbcl-bin -- $0 "$@"
|#
(ql:quickload '(:cl-emb :cl-html-parse :drakma :ironclad :uiop) :silent t)
(defvar *pwd* (make-pathname :defaults cl:*load-pathname* :name nil :type nil))
(defvar *package-name* "roswell")
(defun get-newest-url (base)
(block nil
(multiple-value-bind (body res)
(drakma:http-request
(format nil "https://github.com/~A/releases/" base))
(when (= res 200)
(net.html.parser:parse-html
body
:callbacks
(list (cons :a (lambda (arg)
(let ((href (getf (cdr (car arg)) :href)))
(when (and (> (length href) 6)
(equal (subseq href (-(length href) 6))
"tar.gz"))
(return-from nil (format nil "https://github.com~A" href)))))))
:callback-only t)))))
(defun download (uri path)
(with-open-file (out path :direction :output
:if-does-not-exist :create
:if-exists :supersede
:element-type '(unsigned-byte 8))
(multiple-value-bind (in status)
(drakma:http-request uri :want-stream t :force-binary t)
(unwind-protect
(when (= status 200)
(loop :with seq := (make-array 4096 :element-type '(unsigned-byte 8))
:for read := (read-sequence seq in)
:until (= read 0)
:do (write-sequence seq out :end read)))
(when in
(close in))))))
(defun fetch-upstream ()
(let* ((url (get-newest-url "snmsts/roswell"))
(path (merge-pathnames (subseq url (1+ (position #\/ url :from-end t))) *pwd*)))
(download url path)
path))
(defun rename-upstream (path &optional (package-name *package-name*))
(let* ((name (pathname-name path))
(version (subseq name (position-if #'digit-char-p name)
(1+ (position-if #'digit-char-p name :from-end t))))
(new (make-pathname :name (format nil "~A_~A.orig.tar" package-name version)
:defaults path)))
(when (probe-file new)
(delete-file new))
(uiop/os:chdir *pwd*)
(uiop/run-program:run-program (format nil "tar xf ~A" (namestring path)))
(rename-file path new)
new))
(defun cp-debian ()
(let ((path (namestring
(first ;; should be sort.
(remove-if-not
#'(lambda (x)
(and (not (pathname-name x))
(string-equal "roswell"
(first (last (pathname-directory x)))
:end2 (min 7 (length (first (last
(pathname-directory x))))))))
(directory (merge-pathnames "*.*" *pwd*)))))))
(uiop/run-program:run-program
(format nil "cp -r ../debian ~A" path))
path))
(defun dpkg-buildpackage (path)
(uiop/os:chdir path)
(uiop/run-program:run-program "dpkg-buildpackage -us -uc"))
(defun main (&optional (arg0 "all") &rest argv)
(declare (ignore argv))
(cond ((equal arg0 "all")
(let* ((upstream (fetch-upstream)))
(rename-upstream upstream))
(dpkg-buildpackage (cp-debian)))
((equal arg0 "clean")
(format *error-output* "hoge~%"))))
;;(sb-posix:setenv "DEBFULLNAME" "Masatoshi SANO" 1)
;;(sb-posix:setenv "DEBEMAIL" "snmsts@gmail.com" 1)
;;"dh_make --yes -c mit -C=m --f ../roswell-0.0.2.22.tar.gz"
;;"dpkg-buildpackage -us -uc"