We could also revisit the idea of using the Confluence wiki for documentation....it can export to PDF (but only a page at a time I think).

Clinton


On 9/20/06, Clinton Begin <[EMAIL PROTECTED]> wrote:
There was a change from Microsoft Word to Open Office format.  But other than that, I haven't touched the documentation since August 2005 (I'm ashamed to say).

But looking through the current one on the website...no it doesn't have section numbers....but it has a TOC and section headers....it's not a Tom Clancy novel, it's tech docs, so don't expect a fun read.  That's not an excuse, just the way it is.

I don't recommend reading it front to back anyway.  It's a reference.  Try the examples and look up/search for what you need.

I somewhat agree with Larry about DocBook....but does anyone know of a good, simple docbook tool?  Ted uses a commercial one that I tried and hated (but I suppose that was 3 years ago). 

Any others?  (I know OOo supports DocBook, but it doesn't do such a great job...it hosed the document completely when I tried the conversion).

Cheers,
Clinton


On 9/20/06, Larry Meadors < [EMAIL PROTECTED]> wrote:
LOL, I like that "rambles on like a drunk".

I am not sure what the status is of the dev guide, but I do know that
it has needed work for some time, and has been neglected because of
other projects.

IMO, it would be best if we could somehow convert it to something like
docbook, and generate it from that. Any volunteers?

Larry


On 9/20/06, Richard Sullivan < [EMAIL PROTECTED]> wrote:
> Hi Clinton,
>
> Sometime last year I downloaded the devguide.  Sorry I've no idea
> which version it was from but the file is dated August 5 2005. I'm
> going to try attaching it here.
> It has section numbering and prints beautifully.  It is a pleasure to
> read.  Unfortunately I can't say the same for the current version (no
> offense meant but it rambles on like a drunk :=).  Did you somehow
> change your documentation generation ?
> Hope it helps,
> Richard
>
>
>
> On 9/20/06, Clinton Begin < [EMAIL PROTECTED]> wrote:
> >
> > I don't think there ever was section numbering.  There are section headers,
> > page numbers and a Table of Contents.
> >
> > Clinton
> >
> >
> > On 9/19/06, Richard Sullivan < [EMAIL PROTECTED]> wrote:
> > > Hi folks,
> > >
> > > The section numbering for the developer guide of Data Mapper 2.2 seems
> > > to have got lost.
> > > This makes reading the documentation quite difficult.
> > >
> > > I downloaded from the guide from
> > >
> > http://cvs.apache.org/dist/ibatis/ibatis.java/docs/iBATIS-SqlMaps-2_en.pdf
> > > which is the link on the "iBATIS for Java Downloads" page.
> > >
> > > The OpenOffice version from Subversion seems to have the same problem.
> > > Hopefully somebody can fix this (I am a complete ibatis newbie).
> > >
> > > Hope it helps,
> > > Richard Sullivan
> > >
> >
> >
>
>
>


Reply via email to