Re: [REMINDER] Package Proposal: XML_SaxFilters
| From: | Jesus M. Castagnetto | Date: | Wed, 25 Jun 2003 21:30:56 +0000 |
| Subject: | Re: [REMINDER] Package Proposal: XML_SaxFilters | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-17731@lists.php.net to get a copy of this message | ||
--- Harry Fuecks <hfuecks@phppatterns.com> wrote:
> On Wed, 25 Jun 2003 21:02:07 +0200, Martin Jansen <mj@php.net> wrote:
>
> > On Wed Jun 25, 2003 at 07:3448PM +0200, Harry Fuecks wrote:
> >> OK - the first round of this proposal happened here:
> >>
> >>
> >> http://marc.theaimsgroup.com/?l=pear-dev&m=105650833122300&w=2
> >>
> >> Please take a moment to add your + or - so I know whether to go
> >> forward with this.
> >
> > +1
>
> Many thanks.
>
> >
> > Do you feel strong enough to write some documentation for the PEAR
> > manual?
> >
>
> No problem. Just got to work out what the process is ;) Looking at
> the contrib guide it talks about docbook xml (which I have to confess
> I've never worked with before);
>
> - is there a good (free) docbook editor which can be recommended?
> - where should I place the documentation? Seems is might perhaps
> fit in the package.xml file or under the package docs directory.
I tend to favor vim/gvim for XML editing. There are docbook plugins for that
editor at www.vim.org that will make your life easier. The main feature you
will love from gvim/vim is the folding that uses the syntax file definition.
As for the where to put the documentation, it should reside in the appropriate
directory in the peardoc CVS tree (see cvs.php.net/cvs.php/peardoc).
Also, you might want to subscribe to the pear-doc mailing list for the
discussions on thist topic.
I would recommend reading the howto we have for the PHP manual documentation,
you can get it from: http://www.php.net/get/dochowto
That should get you started w/ the whole Docbook stuff. I tend to also keep a
local copy of the Docbook reference from www.docbook.org, to make sure I am
using the correct tags (I also have the O'reilly book for when I am not close
to a internet connection, no wireless yet).
Ah!, before I forget: +1 on your proposed package.
HTH
=====
--
Jesus M. Castagnetto (jcastagnetto@yahoo.com)
Research: http://metallo.scripps.edu/
Personal: http://www.castagnetto.org/
__________________________________
Do you Yahoo!?
SBC Yahoo! DSL - Now only $29.95 per month!
http://sbc.yahoo.com