r894 - in /trunk/packages/vim-scripts/debian: TODO.Debian changelog control dtd2vim.xml manpages patches/00list patches/usagestring-dtd2vim.dpatch rules

zack at users.alioth.debian.org zack at users.alioth.debian.org
Mon Feb 5 09:31:45 CET 2007


Author: zack
Date: Mon Feb  5 09:31:45 2007
New Revision: 894

URL: http://svn.debian.org/wsvn/pkg-vim/?sc=1&rev=894
Log:
added the manpage for dtd2vim, other cosmetic things for dtd2vim

Added:
    trunk/packages/vim-scripts/debian/dtd2vim.xml
    trunk/packages/vim-scripts/debian/manpages
    trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch   (with props)
Modified:
    trunk/packages/vim-scripts/debian/TODO.Debian
    trunk/packages/vim-scripts/debian/changelog
    trunk/packages/vim-scripts/debian/control
    trunk/packages/vim-scripts/debian/patches/00list
    trunk/packages/vim-scripts/debian/rules

Modified: trunk/packages/vim-scripts/debian/TODO.Debian
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/TODO.Debian?rev=894&op=diff
==============================================================================
--- trunk/packages/vim-scripts/debian/TODO.Debian (original)
+++ trunk/packages/vim-scripts/debian/TODO.Debian Mon Feb  5 09:31:45 2007
@@ -1,7 +1,3 @@
-- write the manpage for dtd2vim
-
- -- Stefano Zacchiroli <zack at debian.org>  Sat, 20 Jan 2007 13:24:19 +0100
-
 - write a script debian/find-missing which compares files listed in
   debian/vim-scripts.status with all the files shipped in the vim-scripts
   package to ensure that no file is not listed in the status file (and hence

Modified: trunk/packages/vim-scripts/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/changelog?rev=894&op=diff
==============================================================================
--- trunk/packages/vim-scripts/debian/changelog (original)
+++ trunk/packages/vim-scripts/debian/changelog Mon Feb  5 09:31:45 2007
@@ -1,38 +1,45 @@
 vim-scripts (7.0.5) UNRELEASED; urgency=low
 
-  * debian/rules
-    - bugfix: let the "build" target depend on the "patch" target (from
-      dpatch) and chain dependencies from "binary-indep" down to "build", so
-      that shipped files are actually patched
-  * debian/control
-    - use abbreviated form ("XS-Vcs-Svn") for the svn field
-    - set maintainer to Debian VIM Maintainers and Uploaders to me and Michael
-    - added suggest on perlsgml, required by dtd2vim (added below)
-    - bumped debhelper dependency to > 5, changed debian/compat accordingly
-  * debian/README.debian
-    - mention the requirement of perlsgml for using dtd2vim
-    - rewritten usage notes pointing to vim-addon-manager
   * addons adds/removals/upgrades(/other changes)
     - added binary dtd2vim to generate XML data file for Vim 7 DTD-based omni
       completion
     - moved games from games/ to plugin/ so that they are automatically loaded
       (if enabled); affected addon: tetris, sokoban
     - moved sokoban levels to /usr/share/vim-scripts/sokoban-levels/
+  * debian/rules
+    - bugfix: let the "build" target depend on the "patch" target (from
+      dpatch) and chain dependencies from "binary-indep" down to "build", so
+      that shipped files are actually patched
+    - invoke dh_installman to install dtd2vim manpage
+  * debian/control
+    - use abbreviated form ("XS-Vcs-Svn") for the svn field
+    - set maintainer to Debian VIM Maintainers and Uploaders to me and Michael
+    - added suggest on perlsgml, required by dtd2vim
+    - bumped debhelper dependency to > 5, changed debian/compat accordingly
+    - added build-deps on xsltproc and docbook-xsl, used to compile manpages
+  * debian/README.debian
+    - mention the requirement of perlsgml for using dtd2vim
+    - rewritten usage notes pointing to vim-addon-manager
   * debian/vim-scripts.status
     - fixed typo on the vcscommand addon: vcscommit.vim resides under syntax/
-  * debian/patches
+  * debian/patches/*
     - added several debian/patches/disabledby-* patches which add support for
       disabling (viz. avoiding double-loading) of shipped plugins. Added
       corresponding "disabledby:" fields to debian/vim-script.status
     - renamed patch 01_sokoban to sokoboan_path
     - changed debian/patches/00list accordingly
+    - added patch usagestring-dtd2vim which fix the usage string of dtd2vim so
+      that the .pl extension is not shown
   * debian/vim-scripts.pl
     - added support for generating the "disabledby:" registry field
   * html/index.html
     - added a description of what the shipped html pages are and a stamp
       marking when they have been downloaded
-
- -- Stefano Zacchiroli <zack at debian.org>  Sun,  4 Feb 2007 19:23:14 +0100
+  * debian/dtd2vim.xml
+    - added a manpage for the dtd2vim binary (and the companions
+      debian/manpages file)
+
+ -- Stefano Zacchiroli <zack at debian.org>  Mon,  5 Feb 2007 09:20:05 +0100
 
 vim-scripts (7.0.4) unstable; urgency=low
 

Modified: trunk/packages/vim-scripts/debian/control
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/control?rev=894&op=diff
==============================================================================
--- trunk/packages/vim-scripts/debian/control (original)
+++ trunk/packages/vim-scripts/debian/control Mon Feb  5 09:31:45 2007
@@ -3,7 +3,7 @@
 Priority: optional
 Maintainer: Debian VIM Maintainers <pkg-vim-maintainers at lists.alioth.debian.org>
 Uploaders: Stefano Zacchiroli <zack at debian.org>, Michael Piefel <piefel at debian.org>
-Build-Depends: debhelper (>> 5.0.0), dpatch
+Build-Depends: debhelper (>> 5.0.0), dpatch, xsltproc, docbook-xsl
 Standards-Version: 3.7.2
 XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-vim/trunk/packages/vim-scripts
 

Added: trunk/packages/vim-scripts/debian/dtd2vim.xml
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/dtd2vim.xml?rev=894&op=file
==============================================================================
--- trunk/packages/vim-scripts/debian/dtd2vim.xml (added)
+++ trunk/packages/vim-scripts/debian/dtd2vim.xml Mon Feb  5 09:31:45 2007
@@ -1,0 +1,118 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+  <!ENTITY dhfirstname "<firstname>Stefano</firstname>">
+  <!ENTITY dhsurname   "<surname>Zacchiroli</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>05 Feb 2007</date>">
+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
+  <!ENTITY dhemail     "<email>zack at debian.org</email>">
+  <!ENTITY dhusername  "Stefano Zacchiroli">
+  <!ENTITY dhucpackage "<refentrytitle>dtd2vim</refentrytitle>">
+  <!ENTITY dhpackage   "dtd2vim">
+
+  <!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>2007</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+
+    <refpurpose>creates XML data file for Vim7 omni completion from
+      DTDs</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <arg choice="req"><replaceable>filename</replaceable>.dtd</arg>
+      <arg choice="opt"><replaceable>dialectname</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para> This manual page documents brieftly the
+      <command>&dhpackage;</command> program. For more information see its HTML
+      documentation in
+      <filename>/usr/share/doc/vim-scripts/html/dtd2vim.html</filename>.
+    </para>
+
+    <para>Starting from version 7 Vim supports context aware completion of XML
+      files (and others). In particular, when the file being edited is an XML
+      file, completion can be driven by the grammar extracted from a Document
+      Type Definition (DTD). </para>
+
+    <para>For this feature to work the user should put an XML data file
+      corresponding to the desired DTD in a <filename>autoload/xml</filename>
+      directory contained in a directory belonging to Vim's
+      <varname>'runtimepath'</varname> (for example
+      <filename>~/.vim/autoload/xml/</filename>). </para>
+
+    <para><command>&dhpackage;</command> is the program that creates XML data
+      files from DTDs. Given as input a DTD
+      <filename><replaceable>file</replaceable>.dtd</filename> it will create a
+      <filename>file.vim</filename> XML data file.
+      <replaceable>dialectname</replaceable> will be part of dictionary name
+      and will be used as argument for the <command>:XMLns</command> command.
+    </para>
+
+  </refsect1>
+
+  <refsect1>
+    <title>OPTIONS</title>
+
+    <para>None. </para>
+  </refsect1>
+
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>vim (1).</para>
+
+    <para>In the Vim online help: <userinput>:help compl-omni</userinput>,
+      <userinput>:help ft-xml-omni</userinput>, <userinput>:help
+	:XMLns</userinput>. </para>
+
+    <para>dtd2vim is fully documented in
+      <filename>/usr/share/doc/vim-scripts/html/dtd2vim.html</filename>.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by &dhusername; &dhemail; for the
+      &debian; system (but 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>
+

Added: trunk/packages/vim-scripts/debian/manpages
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/manpages?rev=894&op=file
==============================================================================
--- trunk/packages/vim-scripts/debian/manpages (added)
+++ trunk/packages/vim-scripts/debian/manpages Mon Feb  5 09:31:45 2007
@@ -1,0 +1,1 @@
+dtd2vim.1

Modified: trunk/packages/vim-scripts/debian/patches/00list
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/patches/00list?rev=894&op=diff
==============================================================================
--- trunk/packages/vim-scripts/debian/patches/00list (original)
+++ trunk/packages/vim-scripts/debian/patches/00list Mon Feb  5 09:31:45 2007
@@ -1,10 +1,11 @@
-disabledby-calendar.dpatch
-disabledby-closetag.dpatch
-disabledby-cvsmenu.dpatch
-disabledby-info.dpatch
-disabledby-po.dpatch
-disabledby-tetris.dpatch
-disabledby-themes.dpatch
-disabledby-whatdomain.dpatch
-disabledby-xml.dpatch
+disabledby-calendar
+disabledby-closetag
+disabledby-cvsmenu
+disabledby-info
+disabledby-po
+disabledby-tetris
+disabledby-themes
+disabledby-whatdomain
+disabledby-xml
 sokoboan_path
+usagestring-dtd2vim

Added: trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch?rev=894&op=file
==============================================================================
--- trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch (added)
+++ trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch Mon Feb  5 09:31:45 2007
@@ -1,0 +1,19 @@
+#! /bin/sh /usr/share/dpatch/dpatch-run
+## usagestring-dtd2vim.dpatch by Stefano Zacchiroli <zack at debian.org>
+##
+## All lines beginning with `## DP:' are a description of the patch.
+## DP: No description.
+
+ at DPATCH@
+diff -urNad vim-scripts~/bin/dtd2vim vim-scripts/bin/dtd2vim
+--- vim-scripts~/bin/dtd2vim	2007-01-20 13:20:23.000000000 +0100
++++ vim-scripts/bin/dtd2vim	2007-02-05 09:25:27.000000000 +0100
+@@ -76,7 +76,7 @@
+ if ( $#ARGV < 0 ){
+ 	print "Script generating XML omni completion data file for Vim7\n";
+ 	print "USAGE:\n";
+-	print "  dtd2vim.pl <filename> [<dialectname>]\n";
++	print "  dtd2vim <filename> [<dialectname>]\n";
+ 	exit 1;
+ }
+ 

Propchange: trunk/packages/vim-scripts/debian/patches/usagestring-dtd2vim.dpatch
------------------------------------------------------------------------------
    svn:executable = *

Modified: trunk/packages/vim-scripts/debian/rules
URL: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim-scripts/debian/rules?rev=894&op=diff
==============================================================================
--- trunk/packages/vim-scripts/debian/rules (original)
+++ trunk/packages/vim-scripts/debian/rules Mon Feb  5 09:31:45 2007
@@ -11,13 +11,16 @@
 # in so that people not looking into this file are not surprised when
 # they try "debian/rules build" and such.
 
-build: patch
+build: patch dtd2vim.1
+dtd2vim.1: debian/dtd2vim.xml
+	xsltproc /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl $<
 
 clean: patch clean1 unpatch
 clean1:
 	dh_testdir
 	dh_testroot
 	dh_clean
+	rm -f dtd2vim.1
 
 install: build
 
@@ -39,6 +42,7 @@
 	dh_installdirs
 	dh_install
 	dh_installdocs
+	dh_installman
 	test -L debian/vim-scripts$(OLD_DESTDIR) || \
 	  ln -s ../../vim-scripts debian/vim-scripts$(OLD_DESTDIR)
 	dh_installchangelogs 




More information about the pkg-vim-maintainers mailing list