1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
5 <!ENTITY dhfirstname "<firstname>Enrico</firstname>">
6 <!ENTITY dhsurname "<surname>Tassi</surname>">
7 <!ENTITY dhdate "<date>21 Jun 2007</date>">
8 <!ENTITY dhsection "<manvolnum>1</manvolnum>">
9 <!ENTITY dhemail "<email>gareuselesinge@debian.org</email>">
10 <!ENTITY dhusername "Enrico Tassi">
11 <!ENTITY dhucpackage "<refentrytitle>matita</refentrytitle>">
12 <!ENTITY dhpackage "matita">
14 <!ENTITY debian "<productname>Debian</productname>">
15 <!ENTITY gnu "<acronym>GNU</acronym>">
16 <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
30 <holder>&dhusername;</holder>
40 <refname>&dhpackage;</refname>
42 <refpurpose>creates XML data file for Vim7 omni completion from
47 <command>&dhpackage;</command>
48 <arg choice="req"><replaceable>filename</replaceable>.dtd</arg>
49 <arg choice="opt"><replaceable>dialectname</replaceable></arg>
54 <title>DESCRIPTION</title>
56 <para> This manual page documents brieftly the
57 <command>&dhpackage;</command> program. For more information see its HTML
59 <filename>/usr/share/doc/vim-scripts/html/dtd2vim.html</filename>.
62 <para>Starting from version 7 Vim supports context aware completion of XML
63 files (and others). In particular, when the file being edited is an XML
64 file, completion can be driven by the grammar extracted from a Document
65 Type Definition (DTD). </para>
67 <para>For this feature to work the user should put an XML data file
68 corresponding to the desired DTD in a <filename>autoload/xml</filename>
69 directory contained in a directory belonging to Vim's
70 <varname>'runtimepath'</varname> (for example
71 <filename>~/.vim/autoload/xml/</filename>). </para>
73 <para><command>&dhpackage;</command> is the program that creates XML data
74 files from DTDs. Given as input a DTD
75 <filename><replaceable>file</replaceable>.dtd</filename> it will create a
76 <filename>file.vim</filename> XML data file.
77 <replaceable>dialectname</replaceable> will be part of dictionary name
78 and will be used as argument for the <command>:XMLns</command> command.
84 <title>OPTIONS</title>
90 <title>SEE ALSO</title>
94 <para>In the Vim online help: <userinput>:help compl-omni</userinput>,
95 <userinput>:help ft-xml-omni</userinput>, <userinput>:help
96 :XMLns</userinput>. </para>
98 <para>dtd2vim is fully documented in
99 <filename>/usr/share/doc/vim-scripts/html/dtd2vim.html</filename>.
104 <title>AUTHOR</title>
106 <para>This manual page was written by &dhusername; &dhemail; for the
107 &debian; system (but may be used by others). Permission is granted to
108 copy, distribute and/or modify this document under the terms of the &gnu;
109 General Public License, Version 2 any later version published by the Free
110 Software Foundation. </para>
112 <para> On Debian systems, the complete text of the GNU General Public
113 License can be found in /usr/share/common-licenses/GPL. </para>