Rasmus <ras...@gmx.us> writes: > Kosyrev Serge <_deepf...@feelingofgreen.ru> writes: >> +(defun org-taskjuggler-multivalued-property (property element) >> + "Obtain PROPERTY of ELEMENT, treating it as a multi-valued property. > > Isn't the docstring a bit tautological? Does property mean the same in > the beginning and the end of the sentence? Sorry if I’m missing something > obvious here...
The first occurence "binds" the parameter name within the semantic structure of the sentence, so to speak, whereas the second one provides the description of what is done to the obtained entity. Coming from the Common Lisp background, the uppercased argument names are often used for this kind of semantic "binding", and in these cases the need to explain what is done to the "bound" names isn't obviated. It's merely a cultural default, so I have no particularly strong feeling about the docstring. If you have a better idea, we can discuss that : -) -- с уважениeм, Косырев Сергей руководитель отдела технологий виртуализации Positive Technologies
