On Wed, 2007-09-05 at 07:31 -0700, Scott Shawcroft wrote: > Peter, > Makes sense to me. I had never thought of it that way. Thanks for all > your hard work. > ~Scott
This sounds like a good change Peter... Jon > Peter Miller wrote: > > Hi All, > > > > I have finished up first pass of adding Doxygen comments to the > > functions in the liblicense.h file, and I've moed on to documenting > > *how* to actually use the library, for simple use cases like > > > > - how to obtain the license attached to a file > > - how to display the attributes of a license > > > > real beginner stuff. I'll have a commit in a couple of hours. > > > > > > But I've noticed an inconsistency, a big one. The module functions have > > "module" in them, and the jurisdiction functions have "jurisdiction" in > > them, etc. But the license functions don't have "license" in them. > > > > For example, ll_verify_uri is used to confirm that its argument is a > > valid license URI. But attributes are also URIs, so going by this > > function name it would be reasonable to expect that you could pass an > > attribute URI to ll_verify_uri. I would like to suggest adding the word > > "license" to license specific functions. > > > > (We could keep the old names as well, but add the gcc "deprecated" > > attribute, to encourage use of the new names.) > > > > What do folks think? > > > > Regards > > Peter Miller <[EMAIL PROTECTED]> > > /\/\* http://miller.emu.id.au/pmiller/ > > > > PGP public key ID: 1024D/D0EDB64D > > fingerprint = AD0A C5DF C426 4F03 5D53 2BDB 18D8 A4E2 D0ED B64D > > See http://www.keyserver.net or any PGP keyserver for public key. > > > > "This code is like a gob of peanut butter for the roof of your > > brain." -- Final Cut Pro easter egg > > > > ------------------------------------------------------------------------ > > > > _______________________________________________ > > cc-devel mailing list > > [email protected] > > http://lists.ibiblio.org/mailman/listinfo/cc-devel > > > _______________________________________________ > cc-devel mailing list > [email protected] > http://lists.ibiblio.org/mailman/listinfo/cc-devel -- Jon Phillips San Francisco, CA USA PH 510.499.0894 [EMAIL PROTECTED] http://www.rejon.org MSN, AIM, Yahoo Chat: kidproto Jabber Chat: [EMAIL PROTECTED] IRC: [EMAIL PROTECTED] _______________________________________________ cc-devel mailing list [email protected] http://lists.ibiblio.org/mailman/listinfo/cc-devel
