[Pkg-emboss-commits] r56 - emboss/trunk/debian

charles-guest at alioth.debian.org charles-guest at alioth.debian.org
Wed Jul 4 14:59:21 UTC 2007


Author: charles-guest
Date: 2007-07-04 14:59:21 +0000 (Wed, 04 Jul 2007)
New Revision: 56

Added:
   emboss/trunk/debian/acd2docbook.pl
Modified:
   emboss/trunk/debian/changelog
   emboss/trunk/debian/control
Log:
Initial import, the program is not fully functional yet

Added: emboss/trunk/debian/acd2docbook.pl
===================================================================
--- emboss/trunk/debian/acd2docbook.pl	                        (rev 0)
+++ emboss/trunk/debian/acd2docbook.pl	2007-07-04 14:59:21 UTC (rev 56)
@@ -0,0 +1,247 @@
+#!/usr/bin/perl
+
+use strict;
+use warnings;
+
+use EMBOSS::ACD;
+
+my $acdfile = shift; 
+my $embossversion = shift;
+my $date = qx(822-date);
+chop $date;
+
+my $acd = EMBOSS::ACD->new($acdfile) ;
+
+my $name = $acd->name or die "No name !";
+my $NAME = $name;
+$NAME =~ s/(.)/\U$1/g;
+my $purpose = $acd->documentation;
+
+
+foreach my $parameter( $acd->param) {
+		print %$parameter, "\n";
+		}
+
+print <<"__XML__";
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<?xml-stylesheet type="text/xsl"
+	href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+	"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+
+<!-- Autogenerated by the acd2docbook.pl script from the emboss Debian pacakge.    -->
+<!-- Template from docbook-xsl version 1.72.0.dfsg.1-1                             -->
+
+  <!ENTITY dhemail     "pkg-emboss-devel\@lists.alioth.debian.org">
+  <!ENTITY dhusername  "Debian EMBOSS Packaging Team">
+  <!ENTITY dhrelease   "$embossversion">
+  <!ENTITY dhdate      "$date">
+  <!ENTITY dhtitle     "EMBOSS Manual for Debian">
+  <!ENTITY dhucpackage "$NAME">
+  <!ENTITY dhpackage   "$name">
+  <!ENTITY dhproduct   "EMBOSS">
+  <!ENTITY dhsection   "1">
+]>
+
+<refentry>
+	<refentryinfo>
+		<title>&dhtitle;</title>
+		<productname>&dhpackage;</productname>
+		<releaseinfo role="version">&dhrelease;</releaseinfo>
+		<date>&dhdate;</date>
+		<authorgroup>
+			<author>
+				<othername>&dhusername;</othername>
+				<contrib>Wrote the script used to autogenerate this manual page.</contrib>
+				<address>
+					<email>&dhemail;</email>
+				</address>
+			</author>
+		</authorgroup>
+		<copyright>
+			<year>2007</year>
+			<holder>&dhusername;</holder>
+		</copyright>
+		<legalnotice>
+			<para>This manual page was autogenerated from an Ajax Control Definition of the EMBOSS package. It can be redistributed under the same terms as EMBOSS itself.</para>
+		</legalnotice>
+	</refentryinfo>
+
+	<refmeta>
+		<refentrytitle>&dhucpackage;</refentrytitle>
+		<manvolnum>&dhsection;</manvolnum>
+	</refmeta>
+
+	<refnamediv>
+		<refname>&dhpackage;</refname>
+		<refpurpose>$purpose</refpurpose>
+	</refnamediv>
+
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&dhpackage;</command>
+			<arg choice="opt"><option>-bar</option></arg>
+			<group choice="opt">
+				<arg choice="plain"><option>-b</option></arg>
+				<arg choice="plain"><option>--busy</option></arg>
+			</group>
+			<group choice="opt">
+				<arg choice="plain"><option>-c <replaceable>config-file</replaceable></option></arg>
+				<arg choice="plain"><option>--config=<replaceable>config-file</replaceable></option></arg>
+			</group>
+			<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>
+			<arg choice="plain" rep="repeat"><replaceable>file(s)</replaceable></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><command>&dhpackage;</command> frobnicates the <application>bar</application> library by tweaking internal symbol tables. By default it parses all baz segments and rearranges them in reverse order by time for the <citerefentry><refentrytitle>xyzzy</refentrytitle><manvolnum>1</manvolnum></citerefentry> linker to find them. The symdef entry is then compressed using the <abbrev>WBG</abbrev> (Whiz-Bang-Gizmo) algorithm. All files are processed in the order specified.</para>
+	</refsect1>
+	<refsect1 id="options">
+		<title>OPTIONS</title>
+		<variablelist>
+			<!-- Use the variablelist.term.separator and the
+			     variablelist.term.break.after parameters to
+			     control the term elements. -->
+			<varlistentry>
+				<term><option>-b</option></term>
+				<term><option>--busy</option></term>
+				<listitem>
+					<para>Do not write <quote>busy</quote> to <filename class="devicefile">stdout</filename> while processing.</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><option>-c <replaceable class="parameter">config-file</replaceable></option></term>
+				<term><option>--config=<replaceable class="parameter">config-file</replaceable></option></term>
+				<listitem>
+					<para>Use the alternate system wide <replaceable>config-file</replaceable> instead of the <filename>/etc/foo.conf</filename>. This overrides any <envar>FOOCONF</envar> environment variable.</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><option>-a</option></term>
+				<listitem>
+					<para>In addition to the baz segments, also parse the <citerefentry><refentrytitle>blurfl</refentrytitle><manvolnum>3</manvolnum></citerefentry> headers.</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><option>-r</option></term>
+				<listitem>
+					<para>Recursive mode. Operates as fast as lightning at the expense of a megabyte of virtual memory.</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. 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. See <citerefentry><refentrytitle>foo.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> for further details.</para>
+				</listitem>
+			</varlistentry>
+		</variablelist>
+	</refsect1>
+	<refsect1 id="environment">
+		<title>ENVIONMENT</title>
+		<variablelist>
+			<varlistentry>
+			<term><envar>FOOCONF</envar></term>
+				<listitem>
+					<para>The full pathname for an alternate system wide configuration file <citerefentry><refentrytitle>foo.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> (see also <xref linkend="files"/>). Overridden by the <option>-c</option> option.</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><quote><errortext>Bad magic number.</errortext></quote></term>
+				<listitem>
+					<para>The input file does not look like an archive file.</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><quote><errortext>Old style baz segments.</errortext></quote></term>
+				<listitem>
+					<para><command>&dhpackage;</command> can only handle new style baz segments. <acronym>COBOL</acronym> object libraries are not supported in this version.</para>
+				</listitem>
+			</varlistentry>
+		</variablelist>
+		<para>The following return codes can be used in scripts:</para>
+		<segmentedlist>
+			<segtitle>Errorcode</segtitle>
+			<segtitle>Errortext</segtitle>
+			<segtitle>Diagnostic</segtitle>
+			<seglistitem>
+				<seg><errorcode>0</errorcode></seg>
+				<seg><errortext>Program exited normally.</errortext></seg>
+				<seg>No error. Program ran successfully.</seg>
+			</seglistitem>
+			<seglistitem>
+				<seg><errorcode>1</errorcode></seg>
+				<seg><errortext>Bad magic number.</errortext></seg>
+				<seg>The input file does not look like an archive file.</seg>
+			</seglistitem>
+			<seglistitem>
+				<seg><errorcode>2</errorcode></seg>
+				<seg><errortext>Old style baz segments.</errortext></seg>
+				<seg><command>&dhpackage;</command> can only handle new style baz segments. <acronym>COBOL</acronym> object libraries are not supported in this version.</seg>
+			</seglistitem>
+		</segmentedlist>
+	</refsect1>
+	<refsect1 id="bugs">
+		<!-- Or use this section to tell about upstream BTS. -->
+		<title>BUGS</title>
+		<para>The command name should have been chosen more carefully to reflect its purpose.</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>
+		<para>The programs are documented fully via the <application>tfm</application> system.</para>
+	</refsect1>
+</refentry>
+__XML__


Property changes on: emboss/trunk/debian/acd2docbook.pl
___________________________________________________________________
Name: svn:executable
   + *

Modified: emboss/trunk/debian/changelog
===================================================================
--- emboss/trunk/debian/changelog	2007-07-04 13:18:50 UTC (rev 55)
+++ emboss/trunk/debian/changelog	2007-07-04 14:59:21 UTC (rev 56)
@@ -14,8 +14,10 @@
   * Applying a dbiflat.c fix from
     http://lists.open-bio.org/pipermail/emboss/2007-May/002941.html
     to inded lowercase IDs in EMBL-formatted databases.
+  * Build-depend on libemboss-acd-perl to generate manpages with
+    acd2docbook.pl, written especially for this package.
 
- -- Charles Plessy <charles-debian-nospam at plessy.org>  Wed,  4 Jul 2007 22:14:29 +0900
+ -- Charles Plessy <charles-debian-nospam at plessy.org>  Wed,  4 Jul 2007 23:54:30 +0900
 
 emboss (4.1.0-1) experimental; urgency=low
 

Modified: emboss/trunk/debian/control
===================================================================
--- emboss/trunk/debian/control	2007-07-04 13:18:50 UTC (rev 55)
+++ emboss/trunk/debian/control	2007-07-04 14:59:21 UTC (rev 56)
@@ -3,7 +3,7 @@
 Priority: optional
 Maintainer: Debian EMBOSS Packaging Team <pkg-emboss-devel at lists.alioth.debian.org>
 Uploaders: Charles Plessy <charles-debian-nospam at plessy.org>, Matt Hope <dopey at debian.org>, Nelson A. de Oliveira <naoliv at debian.org>
-Build-Depends: debhelper (>= 5), quilt, libx11-dev, x-dev, libgdchart-gd2-xpm-dev, zlib1g-dev, libpng12-dev, libpcre3-dev
+Build-Depends: debhelper (>= 5), quilt, libx11-dev, x-dev, libgdchart-gd2-xpm-dev, zlib1g-dev, libpng12-dev, libpcre3-dev, libemboss-acd-perl
 XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-emboss/emboss/trunk/debian
 XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-emboss/emboss/
 Standards-Version: 3.7.2




More information about the Pkg-emboss-commits mailing list