[Vim-latex-devel] Whats the best way to write vim documentation?

[Srinath A. <sr...@fa...>]

Hello,

I have recently decided to revamp the documentation of latex-suite to
make it more comprehensive and easily navigable. I would ideally like to
do the following:

1. Maintain documentation in a single format. This could be one of
   vim-help, html, latex, xml or whatever. I have actually never done
   xml before, but have heard lots about it... I don't know if there are
   any nice xml tools for windows platforms...

2. From this one file, I would like to create the vim-help file and the
   html documentation for the web-page.

The only way I know of to maintain a single source of documentation is:

Always edit the vim help file. Use the 2html.vim script to convert to
html and use that in the web-page. I don't like this approach because
the html page generated by this method..., well.. quite frankly sucks.
It is also a hassle to maintain pages which look like:

|ls_1| Basic editing
    |ls_1_1| Environments
    |ls_1_1| Fonts
|ls_2| Compiling from vim
.
.
.

I would prefer to maintain something like:

\section{Basic Editing}
\label{sec:basicediting}
  \subsection{Environments}
.
.
.

I really like the html generated by latex2html but unfortunately I do
not know of anything like latex2vim. Infact that would be ideal...
Ofcourse even if I do get a latex2vim I wouldn't know how to make it
generate links in the html file...

Is there any other better way?

Basically, I am asking the exact same thing Peter Karp asks in this
post:

http://groups.google.com/groups?q=latex+%2Bto+vim+help&hl=en&lr=&ie=UTF-8&selm=79jkluc1tacttnf4lm2osr28fedqvt5o4b%404ax.com&rnum=1

Unfortunately I am working on too many things right now to be also
working on a latex2vim or similar scipt...


Srinath