[列表中的上一个][列表中的下一个][线程中的前一个][线程中的下一个]列表:openbsd-techSubject:clarityFrom:<;johnc()armadilloSpace!COM>;日期:2020-05-16 19:13:37消息-ID:20200516121337.533b97457880de85c8001c140e636eb6.035aeb57e5.wbe()电子邮件18!好爸爸!com[下载原始消息或正文](不确定这是属于tech@还是misc@)关于非功能代码更改的想法是什么,这些更改只是为了在不更改功能的情况下提高清晰度?例如,在wsdisplay_mulops结构中,有int(*alloc_attr)(void*c,int fg,int bg,int flag,long*attrp);void(*unpack_attr)(void*c,long attr,int*fg,int*bg,int*ul);在结构的末尾是这样的注释,这表明至少有人(除了我之外)被它弄糊涂了:/*XXX需要一个free_attr()?*/我建议alloc_attr应该重命名为pack_attr,但是在39个独特的文件中,alloc_attr上有84个匹配项。同样,我在阅读代码时会做笔记,并且在各种文件和函数中添加一些注释可以帮助其他人更快地掌握未来的工作,但是我是这样做的。我希望写一篇关于我的探索的像样的文章,但内联注释是更持久的文档。[列表中的上一个][列表中的下一个][线程中的上一个][线程中的下一个]