[postgis-devel] Docbook ID's and <a name> links

[Kevin Neufeld]

Ok Regina, I've committed my changes to SVN.  I added a new 
"reference_new.xml" file to temporarily hold chapter 7.  Once the 
migration is complete and all the functions have been moved over to this 
file using the <refentry> concept, we can drop reference.xml and rename 
reference_new.xml to take it's place.

I added a template.xml file simply to show how we can structure each 
refentry.  Please feel free to make any modifications you see fit to the 
template or the new major section headings.

Mark, FYI, it seems the fix you recently made to the doc Makefile does 
not work on my FC3 system.  It can't seem to parse the file:
Makefile:41: Extraneous text after `else' directive
Makefile:43: *** only one `else' per conditional.  Stop.

Dane, I love the new stylesheet. It looks good. I have one suggestion, 
though.  Perhaps the <programlisting> tags should use a fixed-width font 
so code examples look a little better.

Cheers,
Kevin

Obe, Regina wrote:
> Okay that's good so we can have meaningful names.  So what goes in 
> Chapter  6?  I can start moving my changes into chapter 7 and putting 
> in the refentry replacement when you are ready.
>  
> So would we just delete whatever we have in chapter 6 once we move it 
> to chapter 7?
>  
> Thanks,
> Regina
>
> ------------------------------------------------------------------------
> *From:* postgis-devel-bounces at postgis.refractions.net on behalf of 
> Kevin Neufeld
> *Sent:* Mon 7/14/2008 5:40 PM
> *To:* PostGIS Development Discussion
> *Subject:* Re: [postgis-devel] Docbook ID's and <a name> links
>
> Yup, we can.
> http://docbook.sourceforge.net/release/xsl/current/doc/html/use.id.as.filename.html
> -- Kevin
>
> Kevin Neufeld wrote:
> > :)  That's a good point.  I hadn't considered that.  I wonder if there
> > is a way to specify the filename used ... I suspect so, but clearly more
> > investigation is in order.
> > -- Kevin
> >
> > Paul Ramsey wrote:
> >> Hm, goodish and badish... the direct links are nice, the fact that the
> >> names are meaningless is not, particularly since inserting a new
> >> function will probably result in the re-numbering of all the other
> >> pages...
> >>
> >> P.
> >>
> >>
> > _______________________________________________
> > postgis-devel mailing list
> > postgis-devel at postgis.refractions.net
> > http://postgis.refractions.net/mailman/listinfo/postgis-devel
> _______________________________________________
> postgis-devel mailing list
> postgis-devel at postgis.refractions.net
> http://postgis.refractions.net/mailman/listinfo/postgis-devel
>
> ------------------------------------------------------------------------
>
> *The substance of this message, including any attachments, may be 
> confidential, legally privileged and/or exempt from disclosure 
> pursuant to Massachusetts law. It is intended solely for the 
> addressee. If you received this in error, please contact the sender 
> and delete the material from any computer. *
>
> ------------------------------------------------------------------------
>
> * Help make the earth a greener place. If at all possible resist 
> printing this email and join us in saving paper. *
>
> * *
>
> * *
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> postgis-devel mailing list
> postgis-devel at postgis.refractions.net
> http://postgis.refractions.net/mailman/listinfo/postgis-devel
>