more patches for linking docs

[Gaetan Nadon]

On Fri, 2011-07-01 at 13:11 -0600, Matt Dew wrote:

> A couple quick patches to allow some links in the shapelib doc.
> 
> Also,
> Up until now all, and including these patches, the id attributes have been 
> all lowercase rather than matching the case of the text their for,
> IE: MapError:  id='maperror' instead of 'id='MapError'.   xml is case sensitive so 
> everything that links to these must match the case.
> 
> I thought this would be more consistent however after thinking about it and seeing someone 
> comment on the irc about a function and a declared constant being identical except 
> for capitolization, I think now  I made the wrong choice.
> 
> Thoughts?  Should I stop making the id attributes all lowercase and
> instead make them match whatever item they are for? That will require going back
> and updating all the previous ids at some point.
> 

One could write a book on this topic. I prefer libX11 to libx11. If this
id matches something else which is camel cased, say XOpen, I would
prefer camel casing. It's a judgment call. If you follow a hard and fast
rule, you will get more "wrongs" than if you apply your judgment.

> marcoz
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110705/bc7d858f/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110705/bc7d858f/attachment.pgp>