[postgis-devel] [PostGIS] #313: Remove reference.xml and autogenerate from new separate xml docos

[PostGIS]

#313: Remove reference.xml and autogenerate from new separate xml docos
----------------------+-----------------------------------------------------
  Reporter:  robe     |       Owner:  colivier     
      Type:  defect   |      Status:  new          
  Priority:  medium   |   Milestone:  PostGIS 1.5.0
 Component:  postgis  |     Version:  trunk        
Resolution:           |    Keywords:               
----------------------+-----------------------------------------------------
Comment (by robe):

 I was thinking we store the entity definitions in a separate file and we
 use Kevin's (or I assume Kevin wrote that ) -- sed trick to macro replace
 some <identifiers go here>
 with these new items -- that way we can reuse it twice and only define the
 identifiers once.

 So have cat stitched standalone reference_parser.xml that has the
 identifies stitched in.

 Then redo it without the identifiers stitched in -- and include this
 version in the docs as we have always done.


 --- Olivier's NOTE ---
 Regina,

 > I am totally confused.  All the xmls seem invalid since they use
 > strange
 > new xml terms not defined so can't stand on their own. Is that what
 > you
 > are talking about Olivier? Where are things like &Z_support;  defined?

 That's the entity stuff

 To avoid to have lot of redundant text, we use entities instead.
 But you're right as i have to revert my postgis.xml commit,
 entities are no more defined for the moment !

 > I was actually thinking we don't use an xml parser to glue
 > reference_postgis.xml together

 Yeap that's also could be an idea.

 But we have also to retrieve the entity stuff from postgis.xml
 file, so no sure that will be the best/easy way to do

 --
 Olivier

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/313#comment:6>
PostGIS <http://trac.osgeo.org/postgis/>
The PostGIS Trac is used for bug, enhancement & task tracking, a user and developer wiki, and a view into the subversion code repository of PostGIS project.