I think it would be a good idea to add a new subsection to liblouis.texi under Programming in liblouis. It could be called Language bindings and would have sub-subsections for the various bindings, such as Puthon Java, etc. John On Thu, Feb 11, 2010 at 03:23:36PM +0000, Michael Whapples wrote: > I have committed a change doing what I described. I am just thinking > this probably needs documenting as I can foresee the questions of "when > I hand in a list X happens but when I hand in a tuple Y happens". I am > wondering whether the python docstring is really the place for this sort > of detail or if it would be better in something like the userguide. > Doctests would be really good to demonstrate the behavior. > > Michael Whapples > On 02/11/2010 02:56 PM, Christian Egli wrote: > >Michael Whapples<mwhapples@xxxxxxx> writes: > > > > > >>As the issue with using typeforms has only been raised recently I > >>assume not many are even using typeforms, so is backwards > >>compatibility a concern? > >> > >I would assume that there are hardly any users that use the typeform > >currently, so I wouldn't worry about it. > > > > > >>Also there was the suggestion of people possibly not handing in a > >>list, which raises its own issues. The docs actually say list, but > >>currently a tuple would be accepted fine. > >> > >I would make sure that you handle the case when a tuple is passed in > >e.g. the way you suggest below. > > > > > >>I personally quite like the idea of, if you want typeform data back > >>then use a list, if you use a tuple then typeform data won't be > >>modified (it fits with python's mutable and immutable objects). > >> > >Thanks > >Christian > > > > For a description of the software and to download it go to > http://www.jjb-software.com -- John J. Boyer; President, Chief Software Developer Abilitiessoft, Inc. http://www.abilitiessoft.com Madison, Wisconsin USA Developing software for people with disabilities For a description of the software and to download it go to http://www.jjb-software.com