WIP
This commit is contained in:
8
debian/README.Debian
vendored
Normal file
8
debian/README.Debian
vendored
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
yavsc for Debian
|
||||||
|
|
||||||
|
Please edit this to provide information specific to
|
||||||
|
this yavsc Debian package.
|
||||||
|
|
||||||
|
(Automatically generated by debmake Version 4.5.1)
|
||||||
|
|
||||||
|
-- Paul Schneider <paul@localhost> Sun, 08 Jun 2025 01:41:54 +0100
|
14
debian/README.source
vendored
Normal file
14
debian/README.source
vendored
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
yavsc for Debian
|
||||||
|
|
||||||
|
See Debian policy manual section 4.14.
|
||||||
|
https://www.debian.org/doc/debian-policy/ch-source.html#source-package-handling-debian-readme-source
|
||||||
|
|
||||||
|
If running dpkg-source -x on a source package doesn’t produce the source of the
|
||||||
|
package, ready for editing, and allow one to make changes and run
|
||||||
|
dpkg-buildpackage to produce a modified package without taking any additional
|
||||||
|
steps, creating this file explain how to do all of these is recommended.
|
||||||
|
Otherwise, remove this file.
|
||||||
|
|
||||||
|
(Automatically generated by debmake Version 4.5.1)
|
||||||
|
|
||||||
|
-- Paul Schneider <paul@localhost> Sun, 08 Jun 2025 01:41:54 +0100
|
6
debian/changelog
vendored
Normal file
6
debian/changelog
vendored
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
yavsc (1.1.0-1) UNRELEASED; urgency=low
|
||||||
|
|
||||||
|
* Initial release. Closes: #nnnn
|
||||||
|
<nnnn is the bug number of your ITP>
|
||||||
|
|
||||||
|
-- Paul Schneider <paul@localhost> Sun, 08 Jun 2025 01:41:54 +0100
|
1
debian/clean
vendored
Normal file
1
debian/clean
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
# You must remove unused comment lines for the released package.
|
21
debian/control
vendored
Normal file
21
debian/control
vendored
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
Source: yavsc
|
||||||
|
Section: unknown
|
||||||
|
Priority: optional
|
||||||
|
Maintainer: Paul Schneider <paul@localhost>
|
||||||
|
Build-Depends:
|
||||||
|
debhelper-compat (= 13),
|
||||||
|
Standards-Version: 4.7.0
|
||||||
|
Homepage: <insert the upstream URL, if relevant>
|
||||||
|
Rules-Requires-Root: no
|
||||||
|
#Vcs-Git: https://salsa.debian.org/debian/yavsc.git
|
||||||
|
#Vcs-Browser: https://salsa.debian.org/debian/yavsc
|
||||||
|
|
||||||
|
Package: yavsc
|
||||||
|
Architecture: any
|
||||||
|
Multi-Arch: foreign
|
||||||
|
Depends:
|
||||||
|
${misc:Depends},
|
||||||
|
${shlibs:Depends},
|
||||||
|
Description: auto-generated package by debmake
|
||||||
|
This Debian binary package was auto-generated by the
|
||||||
|
debmake(1) command provided by the debmake package.
|
2092
debian/copyright
vendored
Normal file
2092
debian/copyright
vendored
Normal file
File diff suppressed because it is too large
Load Diff
2
debian/dirs
vendored
Normal file
2
debian/dirs
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
|
||||||
|
# You must remove unused comment lines for the released package.
|
2
debian/install
vendored
Normal file
2
debian/install
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
|
||||||
|
# You must remove unused comment lines for the released package.
|
2
debian/links
vendored
Normal file
2
debian/links
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
|
||||||
|
# You must remove unused comment lines for the released package.
|
7
debian/maintscript.ex
vendored
Normal file
7
debian/maintscript.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# see: dh_installdeb(1), dpkg-maintscript-helper(1)
|
||||||
|
# For renaming a conffile, you are advised to uncomment and edit the following
|
||||||
|
#dpkg-maintscript-helper mv_conffile old-conffile new-conffile prior-version package
|
||||||
|
# For switching a symlink to directory, you are advised to uncomment and edit the following
|
||||||
|
#dpkg-maintscript-helper symlink_to_dir pathname old-target prior-version package
|
||||||
|
# For switching a directory to symlink, you are advised to uncomment and edit the following
|
||||||
|
#dpkg-maintscript-helper dir_to_symlink pathname new-target prior-version package
|
73
debian/manpage.1.ex
vendored
Normal file
73
debian/manpage.1.ex
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
.\" Hey, EMACS: -*- nroff -*-
|
||||||
|
.\" (C) Copyright 2025 Paul Schneider <paul@localhost>,
|
||||||
|
.\"
|
||||||
|
.\" See man(1), man(7) and man-pages(7), https://www.tldp.org/HOWTO/Man-Page/
|
||||||
|
.\" for the documentation about man-pages and man-page-formatting:
|
||||||
|
.\"
|
||||||
|
.\" 1. Use this as the template for the manpage for <commandname> after
|
||||||
|
.\" renaming this file to <commandname>.1 (if it is for section 1).
|
||||||
|
.\"
|
||||||
|
.\" 2. List the path to this file in debian/<packagename>.manpages to
|
||||||
|
.\" install this manpage to the target binary package.
|
||||||
|
.\"
|
||||||
|
.\" First parameter, YAVSC, should be all caps
|
||||||
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||||
|
.\" other parameters are allowed: see man(7), man(1)
|
||||||
|
.\"
|
||||||
|
.\" Easier way to make an initial manpage for commands is the use of help2man
|
||||||
|
.\" command provided by help2man package while using this file as an tutorial
|
||||||
|
.\" to understand what was created or to make touch-up edits.
|
||||||
|
.\"
|
||||||
|
.\" Other template files (manpage.*) created by debmake command are secondary
|
||||||
|
.\" helper files to create an initial manpage.
|
||||||
|
.\"
|
||||||
|
.TH YAVSC SECTION "08 Jun 2025"
|
||||||
|
.\" 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
|
||||||
|
yavsc \- program to do something
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B yavsc
|
||||||
|
.RI [ options ] " files" ...
|
||||||
|
.br
|
||||||
|
.B bar
|
||||||
|
.RI [ options ] " files" ...
|
||||||
|
.SH DESCRIPTION
|
||||||
|
This manual page documents briefly the
|
||||||
|
.B yavsc
|
||||||
|
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.
|
||||||
|
\fByavsc\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.
|
44
debian/manpage.asciidoc.ex
vendored
Normal file
44
debian/manpage.asciidoc.ex
vendored
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
= @UPACKAGE@(1)
|
||||||
|
:man source: YAVSC
|
||||||
|
:man version: 1.1.0-1
|
||||||
|
:man manual: YAVSC Manual
|
||||||
|
|
||||||
|
// Secondary template file to make manpage.1
|
||||||
|
//
|
||||||
|
// See "AsciiDoc Syntax Quick Reference"
|
||||||
|
// https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/
|
||||||
|
// https://docs.asciidoctor.org/asciidoctor/latest/manpage-backend/
|
||||||
|
|
||||||
|
// convert by:
|
||||||
|
// $ asciidoctor --doctype manpage -b manpage -a 'newline=\n' yavsc.asciidoc
|
||||||
|
|
||||||
|
== NAME
|
||||||
|
|
||||||
|
yavsc - program to do something
|
||||||
|
|
||||||
|
== SYNOPSIS
|
||||||
|
|
||||||
|
*yavsc* [*-h*] ...
|
||||||
|
|
||||||
|
|
||||||
|
== DESCRIPTION
|
||||||
|
|
||||||
|
*yavsc* do something.
|
||||||
|
|
||||||
|
=== optional arguments:
|
||||||
|
|
||||||
|
*-h*, *--help*::
|
||||||
|
show this help message and exit.
|
||||||
|
|
||||||
|
|
||||||
|
== AUTHOR
|
||||||
|
|
||||||
|
Copyright © 2025 Paul Schneider <paul@localhost>
|
||||||
|
|
||||||
|
== LICENSE
|
||||||
|
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
== SEE ALSO
|
||||||
|
|
||||||
|
See also ...
|
129
debian/manpage.md.ex
vendored
Normal file
129
debian/manpage.md.ex
vendored
Normal file
@ -0,0 +1,129 @@
|
|||||||
|
% YAVSC(SECTION) | User Commands
|
||||||
|
%
|
||||||
|
% "08 Jun 2025"
|
||||||
|
|
||||||
|
[comment]: # Secondary template file to make manpage.1
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # The lines above form a Pandoc metadata block. They must be
|
||||||
|
[comment]: # the first ones in the file.
|
||||||
|
[comment]: # See https://pandoc.org/MANUAL.html#metadata-blocks for details.
|
||||||
|
|
||||||
|
[comment]: # pandoc -s -f markdown -t man package.md -o package.1
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # A manual page package.1 will be generated. You may view the
|
||||||
|
[comment]: # manual page with: nroff -man package.1 | less. A typical entry
|
||||||
|
[comment]: # in a Makefile or Makefile.am is:
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # package.1: package.md
|
||||||
|
[comment]: # pandoc --standalone --from=markdown --to=man $< --output=$@
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # The pandoc binary is found in the pandoc package. Please remember
|
||||||
|
[comment]: # that if you create the nroff version in one of the debian/rules
|
||||||
|
[comment]: # file targets, such as build, you will need to include pandoc in
|
||||||
|
[comment]: # your Build-Depends control field.
|
||||||
|
|
||||||
|
[comment]: # lowdown is a low dependency, lightweight alternative to
|
||||||
|
[comment]: # pandoc as a markdown to manpage translator. Use with:
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # package.1: package.md
|
||||||
|
[comment]: # lowdown -s -Tman -o $@ $<
|
||||||
|
[comment]: #
|
||||||
|
[comment]: # And add lowdown to the Build-Depends control field.
|
||||||
|
|
||||||
|
[comment]: # Remove the lines starting with '[comment]:' in this file in order
|
||||||
|
[comment]: # to avoid warning messages.
|
||||||
|
|
||||||
|
# NAME
|
||||||
|
|
||||||
|
yavsc - short summary
|
||||||
|
|
||||||
|
# SYNOPSIS
|
||||||
|
|
||||||
|
**yavsc** **-e** _this_ [**\-\-example=that**] [{**-e** | **\-\-example**} _this_]
|
||||||
|
[{**-e** | **\-\-example**} {_this_ | _that_}]
|
||||||
|
|
||||||
|
**yavsc** [{**-h** | *\-\-help**} | {**-v** | **\-\-version**}]
|
||||||
|
|
||||||
|
# DESCRIPTION
|
||||||
|
|
||||||
|
**yavsc** is a program that...
|
||||||
|
|
||||||
|
# OPTIONS
|
||||||
|
|
||||||
|
The program follows the usual GNU command line syntax, with long options
|
||||||
|
starting with two dashes ('-'). A summary of options is included below.
|
||||||
|
|
||||||
|
**-e** _this_, **\-\-example=**_that_
|
||||||
|
: Does this and that.
|
||||||
|
|
||||||
|
**-h**, **\-\-help**
|
||||||
|
: Show summary of options.
|
||||||
|
|
||||||
|
**-v**, **\-\-version**
|
||||||
|
: Show version of program.
|
||||||
|
|
||||||
|
# FILES
|
||||||
|
|
||||||
|
/etc/foo.conf
|
||||||
|
: The system-wide configuration file to control the behaviour of
|
||||||
|
yavsc. See **foo.conf**(5) for further details.
|
||||||
|
|
||||||
|
${HOME}/.foo.conf
|
||||||
|
: The per-user configuration file to control the behaviour of
|
||||||
|
yavsc. See **foo.conf**(5) for further details.
|
||||||
|
|
||||||
|
# ENVIRONMENT
|
||||||
|
|
||||||
|
**FOO_CONF**
|
||||||
|
: If used, the defined file is used as configuration file (see also
|
||||||
|
the section called “FILES”).
|
||||||
|
|
||||||
|
# DIAGNOSTICS
|
||||||
|
|
||||||
|
The following diagnostics may be issued on stderr:
|
||||||
|
|
||||||
|
Bad configuration file. Exiting.
|
||||||
|
: The configuration file seems to contain a broken configuration
|
||||||
|
line. Use the **\-\-verbose** option, to get more info.
|
||||||
|
|
||||||
|
**yavsc** provides some return codes, that can be used in scripts:
|
||||||
|
|
||||||
|
Code Diagnostic
|
||||||
|
0 Program exited successfully.
|
||||||
|
1 The configuration file seems to be broken.
|
||||||
|
|
||||||
|
# BUGS
|
||||||
|
|
||||||
|
The program is currently limited to only work with the foobar library.
|
||||||
|
|
||||||
|
The upstream BTS can be found at https://bugzilla.foo.tld.
|
||||||
|
|
||||||
|
# SEE ALSO
|
||||||
|
|
||||||
|
**bar**(1), **baz**(1), **foo.conf**(5)
|
||||||
|
|
||||||
|
The programs are documented fully by The Rise and Fall of a Fooish Bar
|
||||||
|
available via the **info**(1) system.
|
||||||
|
|
||||||
|
# AUTHOR
|
||||||
|
|
||||||
|
Paul Schneider <paul@localhost>
|
||||||
|
: Wrote this manpage for the Debian system.
|
||||||
|
|
||||||
|
# COPYRIGHT
|
||||||
|
|
||||||
|
Copyright © 2025 Paul Schneider
|
||||||
|
|
||||||
|
This manual page was written 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 or (at your option)
|
||||||
|
any later version published by the Free Software Foundation.
|
||||||
|
|
||||||
|
On Debian systems, the complete text of the GNU General Public License
|
||||||
|
can be found in /usr/share/common-licenses/GPL.
|
||||||
|
|
||||||
|
[comment]: # Local Variables:
|
||||||
|
[comment]: # mode: markdown
|
||||||
|
[comment]: # End:
|
144
debian/manpage.sgml.ex
vendored
Normal file
144
debian/manpage.sgml.ex
vendored
Normal file
@ -0,0 +1,144 @@
|
|||||||
|
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Install docbook-to-man package and see docbook-to-man(1)
|
||||||
|
|
||||||
|
Secondary template file to make manpage.1
|
||||||
|
-->
|
||||||
|
|
||||||
|
<!-- 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>08 Jun 2025</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>paul@localhost</email>">
|
||||||
|
<!ENTITY dhusername "Paul Schneider">
|
||||||
|
<!ENTITY dhucpackage "<refentrytitle>YAVSC</refentrytitle>">
|
||||||
|
<!ENTITY dhpackage "yavsc">
|
||||||
|
|
||||||
|
<!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:
|
||||||
|
-->
|
267
debian/manpage.xml.ex
vendored
Normal file
267
debian/manpage.xml.ex
vendored
Normal file
@ -0,0 +1,267 @@
|
|||||||
|
<?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" [
|
||||||
|
|
||||||
|
<!--
|
||||||
|
|
||||||
|
Secondary template file to make manpage.1
|
||||||
|
|
||||||
|
Install docbook-xsl and docbook-xsl-doc-html and see
|
||||||
|
/usr/share/doc/docbook-xsl/examples/foo.1.example_manpage.xml
|
||||||
|
/usr/share/doc/docbook-xsl-doc-html/doc/manpages/index.html
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
|
||||||
|
|
||||||
|
General documentation about man-pages and man-page-formatting:
|
||||||
|
man(1), man(7), man-pages(7), https://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 "Paul Schneider">
|
||||||
|
<!ENTITY dhemail "paul@localhost">
|
||||||
|
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
|
||||||
|
allowed: see man(7), man(1) and
|
||||||
|
https://www.tldp.org/HOWTO/Man-Page/q2.html. -->
|
||||||
|
<!ENTITY dhsection "SECTION">
|
||||||
|
<!-- TITLE should be something like "User commands" or similar (see
|
||||||
|
https://www.tldp.org/HOWTO/Man-Page/q2.html). -->
|
||||||
|
<!ENTITY dhtitle "yavsc User Manual">
|
||||||
|
<!ENTITY dhucpackage "YAVSC">
|
||||||
|
<!ENTITY dhpackage "yavsc">
|
||||||
|
]>
|
||||||
|
|
||||||
|
<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="https://bugzilla.foo.tld"/>.</para>
|
||||||
|
</refsect1>
|
||||||
|
<refsect1 id="see_also">
|
||||||
|
<title>SEE ALSO</title>
|
||||||
|
<!-- In alphabetical 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>
|
1
debian/patches/series
vendored
Normal file
1
debian/patches/series
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
# You must remove unused comment lines for the released package.
|
7
debian/postinst.ex
vendored
Normal file
7
debian/postinst.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# If no user provided script is activated in this file, you should remove this file.
|
||||||
|
set -e
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
7
debian/postrm.ex
vendored
Normal file
7
debian/postrm.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# If no user provided script is activated in this file, you should remove this file.
|
||||||
|
set -e
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
7
debian/preinst.ex
vendored
Normal file
7
debian/preinst.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# If no user provided script is activated in this file, you should remove this file.
|
||||||
|
set -e
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
7
debian/prerm.ex
vendored
Normal file
7
debian/prerm.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# If no user provided script is activated in this file, you should remove this file.
|
||||||
|
set -e
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
15
debian/rules
vendored
Executable file
15
debian/rules
vendored
Executable file
@ -0,0 +1,15 @@
|
|||||||
|
#!/usr/bin/make -f
|
||||||
|
# You must remove unused comment lines for the released package.
|
||||||
|
#export DH_VERBOSE = 1
|
||||||
|
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
|
||||||
|
#export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic
|
||||||
|
#export DEB_LDFLAGS_MAINT_APPEND = -Wl,-O1
|
||||||
|
|
||||||
|
%:
|
||||||
|
dh $@
|
||||||
|
|
||||||
|
#override_dh_auto_install:
|
||||||
|
# dh_auto_install -- prefix=/usr
|
||||||
|
|
||||||
|
#override_dh_install:
|
||||||
|
# dh_install --list-missing -X.pyc -X.pyo
|
25
debian/salsa-ci.yml
vendored
Normal file
25
debian/salsa-ci.yml
vendored
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
# For more information on what jobs are run see:
|
||||||
|
# https://salsa.debian.org/salsa-ci-team/pipeline
|
||||||
|
#
|
||||||
|
# To enable the jobs, go to your repository (at salsa.debian.org)
|
||||||
|
# and click over Settings > CI/CD > Expand (in General pipelines).
|
||||||
|
# In "CI/CD configuration file" write debian/salsa-ci.yml and click
|
||||||
|
# in "Save Changes". The CI tests will run after the next commit.
|
||||||
|
---
|
||||||
|
include:
|
||||||
|
- https://salsa.debian.org/salsa-ci-team/pipeline/raw/master/recipes/debian.yml
|
||||||
|
|
||||||
|
# # This commented-out sample disables all default tests, only disable those
|
||||||
|
# # CI tests that is required to get the CI process to succeed.
|
||||||
|
#
|
||||||
|
# variables:
|
||||||
|
# SALSA_CI_DISABLE_APTLY: 1
|
||||||
|
# SALSA_CI_DISABLE_AUTOPKGTEST: 1
|
||||||
|
# SALSA_CI_DISABLE_BLHC: 1
|
||||||
|
# SALSA_CI_DISABLE_LINTIAN: 1
|
||||||
|
# SALSA_CI_DISABLE_PIUPARTS: 1
|
||||||
|
# SALSA_CI_DISABLE_REPROTEST: 1
|
||||||
|
# SALSA_CI_DISABLE_BUILD_PACKAGE_ALL: 1
|
||||||
|
# SALSA_CI_DISABLE_BUILD_PACKAGE_ANY: 1
|
||||||
|
# SALSA_CI_DISABLE_BUILD_PACKAGE_I386: 1
|
||||||
|
# SALSA_CI_DISABLE_CROSSBUILD_ARM64: 1
|
1
debian/source/format
vendored
Normal file
1
debian/source/format
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
3.0 (quilt)
|
2
debian/source/lintian-overrides.ex
vendored
Normal file
2
debian/source/lintian-overrides.ex
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
# See dh_lintian(1)
|
||||||
|
# cut and paste the lintian(1) outputs without leading "E: ", "W: ", ...
|
47
debian/source/local-options.ex
vendored
Normal file
47
debian/source/local-options.ex
vendored
Normal file
@ -0,0 +1,47 @@
|
|||||||
|
# Uncomment to active options. See dpkg-source(1)
|
||||||
|
#
|
||||||
|
# This file contains a list of long options that should be automatically
|
||||||
|
# prepended to the set of command line options of a dpkg-source --build call.
|
||||||
|
|
||||||
|
# This is normally for the non-native Debian packaging.
|
||||||
|
|
||||||
|
# Whenever possible, use this instead of debian/local-options to make
|
||||||
|
# dpkg-source long options applied for the team builds based on the VCS
|
||||||
|
# repository while NMU builds based on the Debian source package are not
|
||||||
|
# affected.
|
||||||
|
|
||||||
|
# == Patch unapplied strategy (dquilt, gbp, ...) ==
|
||||||
|
#
|
||||||
|
# The source outside of debian/ directory is unmodified from the upstream one:
|
||||||
|
# * Workflow using diff -u
|
||||||
|
# https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html#diff-u
|
||||||
|
# * Workflow using dquilt
|
||||||
|
# https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html#dquilt
|
||||||
|
# * Workflow using dpkg-source commit (commit only patch to VCS after dpkg-source commit)
|
||||||
|
# https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html#dpkg-source-commit
|
||||||
|
# * Workflow to use gbp-buildpackage(1) with pristine-tar
|
||||||
|
# * Workflow described in dgit-maint-gbp(7)
|
||||||
|
#
|
||||||
|
# Uncomment following if you use this strategy
|
||||||
|
#abort-on-upstream-changes
|
||||||
|
#unapply-patches
|
||||||
|
|
||||||
|
# == Patch applied strategy (merge) ==
|
||||||
|
#
|
||||||
|
# The source outside of debian/ directory is modified by maintainer and
|
||||||
|
# different from the upstream one:
|
||||||
|
# * Workflow using dpkg-source commit (commit all to VCS after dpkg-source commit)
|
||||||
|
# https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html#dpkg-source-commit
|
||||||
|
# * Workflow described in dgit-maint-merge(7)
|
||||||
|
#
|
||||||
|
# uncomment following if you use this strategy
|
||||||
|
#single-debian-patch
|
||||||
|
#auto-commit
|
||||||
|
|
||||||
|
# == Patch applied strategy (debrebase) ==
|
||||||
|
#
|
||||||
|
# The source outside of debian/ directory is modified by maintainer and
|
||||||
|
# different from the upstream one:
|
||||||
|
# * Workflow described in dgit-maint-debrebase(7)
|
||||||
|
#
|
||||||
|
# Remove this file if you use this strategy
|
26
debian/source/local-patch-header.ex
vendored
Normal file
26
debian/source/local-patch-header.ex
vendored
Normal file
@ -0,0 +1,26 @@
|
|||||||
|
The automatically generated patch by dpkg-source(1) puts this free form text on
|
||||||
|
top of it.
|
||||||
|
|
||||||
|
This is normally for the non-native Debian packaging.
|
||||||
|
|
||||||
|
Whenever possible, use this instead of debian/patch-header to make dpkg-source
|
||||||
|
long options applied for the team builds based on the VCS repository while NMU
|
||||||
|
builds based on the Debian source package are not affected.
|
||||||
|
|
||||||
|
== Patch applied strategy (merge) ==
|
||||||
|
|
||||||
|
The source outside of debian/ directory is modified by maintainer and
|
||||||
|
different from the upstream one:
|
||||||
|
* Workflow using dpkg-source commit (commit all to VCS after dpkg-source commit)
|
||||||
|
https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html#dpkg-source-commit
|
||||||
|
* Workflow described in dgit-maint-merge(7)
|
||||||
|
|
||||||
|
Keep this file after updating its content if you use this strategy
|
||||||
|
|
||||||
|
== Other strategies ==
|
||||||
|
|
||||||
|
Remove this file if you use this strategy
|
||||||
|
|
||||||
|
===
|
||||||
|
|
||||||
|
A single combined diff, containing all the changes, follows.
|
10
debian/source/options.ex
vendored
Normal file
10
debian/source/options.ex
vendored
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
# Uncomment to active options. See dpkg-source(1)
|
||||||
|
#
|
||||||
|
# This file contains a list of long options that should be automatically
|
||||||
|
# prepended to the set of command line options of a dpkg-source --build call.
|
||||||
|
|
||||||
|
# This is normally for the non-native Debian packaging.
|
||||||
|
|
||||||
|
# Whenever possible, use debian/local-options instead to make dpkg-source long
|
||||||
|
# options applied for the team builds based on the VCS repository while NMU
|
||||||
|
# builds based on the Debian source package are not affected.
|
12
debian/source/patch-header.ex
vendored
Normal file
12
debian/source/patch-header.ex
vendored
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
The automatically generated patch by dpkg-source(1) puts this free form text on
|
||||||
|
top of it.
|
||||||
|
|
||||||
|
This is normally for the non-native Debian packaging.
|
||||||
|
|
||||||
|
Whenever possible, use debian/local-patch-header instead to make dpkg-source long
|
||||||
|
options applied for the team builds based on the VCS repository while NMU
|
||||||
|
builds based on the Debian source package are not affected.
|
||||||
|
|
||||||
|
A single combined diff, containing all the changes, follows.
|
||||||
|
|
||||||
|
===
|
9
debian/tests/control
vendored
Normal file
9
debian/tests/control
vendored
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
#
|
||||||
|
# DEP-8: autopkgtest - automatic as-installed package testing
|
||||||
|
# Please check * https://dep-team.pages.debian.net/deps/dep8/
|
||||||
|
# * /usr/share/doc/autopkgtest
|
||||||
|
#
|
||||||
|
# !!! Please make sure to edit this to a valid test, otherwise build will fails
|
||||||
|
#
|
||||||
|
#Tests: testcode.sh
|
||||||
|
#Restrictions: allow-stderr, breaks-testbed, needs-internet, needs-root
|
16
debian/upstream/metadata
vendored
Normal file
16
debian/upstream/metadata
vendored
Normal file
@ -0,0 +1,16 @@
|
|||||||
|
#
|
||||||
|
# DEP-12: Per-package machine-readable metadata about Upstream
|
||||||
|
# Please check * https://dep-team.pages.debian.net/deps/dep12/
|
||||||
|
# * https://wiki.debian.org/UpstreamMetadata
|
||||||
|
Reference:
|
||||||
|
Author: <please use full names and separate multiple author by the keyword "and">
|
||||||
|
Title:
|
||||||
|
Journal:
|
||||||
|
Year:
|
||||||
|
Volume:
|
||||||
|
Number:
|
||||||
|
Pages:
|
||||||
|
DOI:
|
||||||
|
PMID:
|
||||||
|
URL:
|
||||||
|
eprint:
|
3
debian/watch
vendored
Normal file
3
debian/watch
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
# You must remove unused comment lines for the released package.
|
||||||
|
# Compulsory line, this is a version 4 file
|
||||||
|
version=4
|
3
debian/yavsc.bug-control.ex
vendored
Normal file
3
debian/yavsc.bug-control.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
# Installed as usr/share/bug/yavsc/control in yavsc
|
||||||
|
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
|
||||||
|
# It is the bug control file containing some directions for the bug reporting tool.
|
3
debian/yavsc.bug-presubj.ex
vendored
Normal file
3
debian/yavsc.bug-presubj.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
# Installed as usr/share/bug/yavsc/presubj in yavsc
|
||||||
|
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
|
||||||
|
# The contents of this file are displayed to the user by the bug reporting tool.
|
3
debian/yavsc.bug-script.ex
vendored
Normal file
3
debian/yavsc.bug-script.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
# Installed as usr/share/bug/yavsc or usr/share/bug/yavsc/script in yavsc
|
||||||
|
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
|
||||||
|
# This is the script to be run by the bug reporting program for generating a bug report template.
|
10
debian/yavsc.conffiles.ex
vendored
Normal file
10
debian/yavsc.conffiles.ex
vendored
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
# See dh_installdeb(1).
|
||||||
|
# This file will be installed into the DEBIAN directory. The provided file will
|
||||||
|
# be enriched by debhelper to include all the conffiles auto-detected by
|
||||||
|
# debhelper (the maintainer should not list there as debhelper assumes it
|
||||||
|
# should handle that part).
|
||||||
|
#
|
||||||
|
# This file is primarily useful for using "special" entries such as the
|
||||||
|
# remove-on-upgrade feature from dpkg.
|
||||||
|
#
|
||||||
|
# For most packages, this file doesn’t need to exist.
|
5
debian/yavsc.cron.d.ex
vendored
Normal file
5
debian/yavsc.cron.d.ex
vendored
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
#
|
||||||
|
# Regular cron jobs for the yavsc package
|
||||||
|
# See dh_installcron(1) and crontab(5).
|
||||||
|
#
|
||||||
|
#0 4 * * * root [ -x /usr/bin/yavsc_maintenance ] && /usr/bin/yavsc_maintenance
|
3
debian/yavsc.cron.daily.ex
vendored
Normal file
3
debian/yavsc.cron.daily.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Daily cron jobs shell script for the yavsc package
|
||||||
|
#true
|
3
debian/yavsc.cron.hourly.ex
vendored
Normal file
3
debian/yavsc.cron.hourly.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Hourly cron jobs shell script for the yavsc package
|
||||||
|
#true
|
3
debian/yavsc.cron.monthly.ex
vendored
Normal file
3
debian/yavsc.cron.monthly.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Monthly cron jobs shell script for the yavsc package
|
||||||
|
#true
|
3
debian/yavsc.cron.weekly.ex
vendored
Normal file
3
debian/yavsc.cron.weekly.ex
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Weekly cron jobs shell script for the yavsc package
|
||||||
|
#true
|
7
debian/yavsc.default.ex
vendored
Normal file
7
debian/yavsc.default.ex
vendored
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# Defaults for yavsc initscript
|
||||||
|
|
||||||
|
#
|
||||||
|
# This is a POSIX shell fragment
|
||||||
|
#
|
||||||
|
|
||||||
|
#DAEMON_OPTS=""
|
47
debian/yavsc.emacsen-install.ex
vendored
Normal file
47
debian/yavsc.emacsen-install.ex
vendored
Normal file
@ -0,0 +1,47 @@
|
|||||||
|
#! /bin/sh -e
|
||||||
|
# /usr/lib/emacsen-common/packages/install/yavsc
|
||||||
|
|
||||||
|
# Written by Jim Van Zandt <jrv@debian.org>, borrowing heavily
|
||||||
|
# from the install scripts for gettext by Santiago Vila
|
||||||
|
# <sanvila@ctv.es> and octave by Dirk Eddelbuettel <edd@debian.org>.
|
||||||
|
|
||||||
|
FLAVOR=$1
|
||||||
|
PACKAGE=yavsc
|
||||||
|
|
||||||
|
if [ ${FLAVOR} = emacs ]; then exit 0; fi
|
||||||
|
|
||||||
|
echo install/${PACKAGE}: Handling install for emacsen flavor ${FLAVOR}
|
||||||
|
|
||||||
|
#FLAVORTEST=`echo $FLAVOR | cut -c-6`
|
||||||
|
#if [ ${FLAVORTEST} = xemacs ] ; then
|
||||||
|
# SITEFLAG="-no-site-file"
|
||||||
|
#else
|
||||||
|
# SITEFLAG="--no-site-file"
|
||||||
|
#fi
|
||||||
|
FLAGS="${SITEFLAG} -q -batch -l path.el -f batch-byte-compile"
|
||||||
|
|
||||||
|
ELDIR=/usr/share/emacs/site-lisp/${PACKAGE}
|
||||||
|
ELCDIR=/usr/share/${FLAVOR}/site-lisp/${PACKAGE}
|
||||||
|
ELRELDIR=../../../emacs/site-lisp/${PACKAGE}
|
||||||
|
|
||||||
|
# Install-info-altdir does not actually exist.
|
||||||
|
# Maybe somebody will write it.
|
||||||
|
if test -x /usr/sbin/install-info-altdir; then
|
||||||
|
echo install/${PACKAGE}: install Info links for ${FLAVOR}
|
||||||
|
install-info-altdir --quiet --section "" "" --dirname=${FLAVOR} /usr/share/info/${PACKAGE}.info.gz
|
||||||
|
fi
|
||||||
|
|
||||||
|
install -m 755 -d ${ELCDIR}
|
||||||
|
cd ${ELDIR}
|
||||||
|
FILES=`echo *.el`
|
||||||
|
cd ${ELCDIR}
|
||||||
|
ln -sf ${ELRELDIR}/*.el .
|
||||||
|
|
||||||
|
cat << EOF > path.el
|
||||||
|
(debian-pkg-add-load-path-item ".")
|
||||||
|
(setq byte-compile-warnings nil)
|
||||||
|
EOF
|
||||||
|
${FLAVOR} ${FLAGS} ${FILES}
|
||||||
|
rm -f path.el
|
||||||
|
|
||||||
|
exit 0
|
15
debian/yavsc.emacsen-remove.ex
vendored
Normal file
15
debian/yavsc.emacsen-remove.ex
vendored
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
#!/bin/sh -e
|
||||||
|
# /usr/lib/emacsen-common/packages/remove/yavsc
|
||||||
|
|
||||||
|
FLAVOR=$1
|
||||||
|
PACKAGE=yavsc
|
||||||
|
|
||||||
|
if [ ${FLAVOR} != emacs ]; then
|
||||||
|
if test -x /usr/sbin/install-info-altdir; then
|
||||||
|
echo remove/${PACKAGE}: removing Info links for ${FLAVOR}
|
||||||
|
install-info-altdir --quiet --remove --dirname=${FLAVOR} /usr/share/info/yavsc.info.gz
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo remove/${PACKAGE}: purging byte-compiled files for ${FLAVOR}
|
||||||
|
rm -rf /usr/share/${FLAVOR}/site-lisp/${PACKAGE}
|
||||||
|
fi
|
26
debian/yavsc.emacsen-startup.ex
vendored
Normal file
26
debian/yavsc.emacsen-startup.ex
vendored
Normal file
@ -0,0 +1,26 @@
|
|||||||
|
;; -*-emacs-lisp-*-
|
||||||
|
;;
|
||||||
|
;; Emacs startup file, e.g. /etc/emacs/site-start.d/50yavsc.el
|
||||||
|
;; for the Debian yavsc package
|
||||||
|
;;
|
||||||
|
;; Originally contributed by Nils Naumann <naumann@unileoben.ac.at>
|
||||||
|
;; Modified by Dirk Eddelbuettel <edd@debian.org>
|
||||||
|
;; Adapted for dh-make by Jim Van Zandt <jrv@debian.org>
|
||||||
|
|
||||||
|
;; The yavsc package follows the Debian/GNU Linux 'emacsen' policy and
|
||||||
|
;; byte-compiles its elisp files for each 'emacs flavor' (emacs19,
|
||||||
|
;; xemacs19, emacs20, xemacs20...). The compiled code is then
|
||||||
|
;; installed in a subdirectory of the respective site-lisp directory.
|
||||||
|
;; We have to add this to the load-path:
|
||||||
|
(let ((package-dir (concat "/usr/share/"
|
||||||
|
(symbol-name debian-emacs-flavor)
|
||||||
|
"/site-lisp/yavsc")))
|
||||||
|
;; If package-dir does not exist, the yavsc package must have
|
||||||
|
;; removed but not purged, and we should skip the setup.
|
||||||
|
(when (file-directory-p package-dir)
|
||||||
|
(if (fboundp 'debian-pkg-add-load-path-item)
|
||||||
|
(debian-pkg-add-load-path-item package-dir)
|
||||||
|
(setq load-path (cons package-dir load-path)))
|
||||||
|
(autoload 'yavsc-mode "yavsc-mode"
|
||||||
|
"Major mode for editing yavsc files." t)
|
||||||
|
(add-to-list 'auto-mode-alist '("\\.yavsc$" . yavsc-mode))))
|
2
debian/yavsc.lintian-overrides.ex
vendored
Normal file
2
debian/yavsc.lintian-overrides.ex
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
# See dh_lintian(1) and Lintian User Manual (/usr/share/doc/lintian/lintian.html)
|
||||||
|
# cut and paste the lintian(1) outputs without leading "E: ", "W: ", ...
|
2
debian/yavsc.service.ex
vendored
Normal file
2
debian/yavsc.service.ex
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
# If this exists, it is installed into lib/systemd/system/yavsc.service in yavsc
|
||||||
|
# See dh_systemd_enable(1).
|
2
debian/yavsc.tmpfile.ex
vendored
Normal file
2
debian/yavsc.tmpfile.ex
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
# If this exists, it is installed into usr/lib/tmpfiles.d/yavsc.conf in yavsc
|
||||||
|
# See dh_installtmpfiles(1).
|
@ -1,11 +0,0 @@
|
|||||||
<Project>
|
|
||||||
<PropertyGroup>
|
|
||||||
<Version>1.0.8</Version>
|
|
||||||
<Authors>paul</Authors>
|
|
||||||
<Copyright>WFPL</Copyright>
|
|
||||||
<PackageLicenseExpression></PackageLicenseExpression>
|
|
||||||
<ProjectUrl></ProjectUrl>
|
|
||||||
<RepositoryUrl></RepositoryUrl>
|
|
||||||
<RepositoryType>git</RepositoryType>
|
|
||||||
</PropertyGroup>
|
|
||||||
</Project>
|
|
Reference in New Issue
Block a user