[postgis-devel] [PostGIS] #1511: Duplicate named case-insensitive XML refentry ids / HTML files (was: Duplicate HTML files in 2.0.0alpha3SVN.tar.gz)

[PostGIS]

#1511: Duplicate named case-insensitive XML refentry ids / HTML files
---------------------------+------------------------------------------------
 Reporter:  mwtoews        |       Owner:  robe         
     Type:  defect         |      Status:  new          
 Priority:  medium         |   Milestone:  PostGIS 2.0.0
Component:  documentation  |     Version:  trunk        
 Keywords:                 |  
---------------------------+------------------------------------------------
Changes (by mwtoews):

  * version:  2.0.x => trunk


Comment:

 Ok, I did some more digging, and found out what is going on. From a case-
 sensitive perspective, there is nothing wrong. Here is the structure of
 documentation of the culprit types:

  * {{{reference_misc.xml}}} - functions
    * {{{<refentry id="Box2D">}}}
    * {{{<refentry id="Box3D">}}}

  * {{{reference_type.xml}}} - types
    * {{{<refentry id="box2d">}}}
    * {{{<refentry id="box3d">}}}

 Although these are distinct file names for most (all?) POSIX systems, they
 are not for Microsoft Windows, where PostGIS is supported. Thus, a Windows
 user that downloads the tar.gz source cannot view the HTML documentation
 for, e.g., both box2d types and the Box2D function.

 Fortunately, the Refractions webserver provides the correct case-sensitive
 documents:
  * http://postgis.refractions.net/documentation/manual-svn/Box2D.html
  * http://postgis.refractions.net/documentation/manual-svn/box2d.html

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/1511#comment:1>
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.