Oh, come on now...who edits the XML by hand?
Let's look at it if you are using somthing like XMLMind's (free) XXE:
Edit > Insert After... > programlisting > (paste sample code)
No, it's not "mother-in-law simple", but we're all pretty technical
people or we'd be using Access to "develop applications" instead of
Java or C#.
This argument doesn't hold much water, IMO. :-)
However, on the flip side of this, we can then use SVN to easily see
the changes in the file over time. We can also take that example code
and generate HTML help for windows, Java help, an Eclipse help file, a
M$ Word doc, an RTF, a PDF, or plain old html.
Larry
On 9/21/06, Clinton Begin <[EMAIL PROTECTED]> wrote:
Let's look at how much fun it is to do XML examples with DocBook...
<programlisting><?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE sqlMapConfig
PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"
"http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
<!-- Always ensure to use the correct XML header as above! -->
<sqlMapConfig>
...
Eww....this would not make me want to update our docs more often..... ;-)
Clinton
On 9/20/06, Larry Meadors <[EMAIL PROTECTED]> wrote:
> OK, just for fun I converted the tutorial to docbook. The dev guide is
> going to be a bigger project that I wanted to do this morning.
>
> I have not committed it yet, but it is attached in case anyone wants
> to look at it or try to tweak the build to generate a PDF from it. It
> looks like you can generate Javahelp and Eclipse help files from this,
> too. That might be interesting...
>
> If anyone has an example of how to generate a pdf from it using ant,
> I'd convert the dev guide and wire the generation into the build.
>
> Larry
>
>
> 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
> > > > >
> > > >
> > > >
> > >
> > >
> > >
> >
>
>
>
