Duplicate named case-insensitive XML refentry ids / HTML files

[Mike Taves]

From postgis-2.0.0alpha3SVN.tar.gz, in doc/html there two extra case sensitive files:

• box2d.html
• Box2D.html
• box3d.html
• Box3D.html

[Mike Taves]

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

[pramsey]

Looks like box2d and box3d are the only instances…

cd doc
grep "<refentry id=" *.xml | tr -d "\t" | tr -d " " | tr A-Z a-z | cut -f2 -d: | sort | uniq -c | sort -g

[pramsey]

Fixed at r9045