https://jira.opendaylight.org This file is an XML representation of an issue en-us 8.20.10 820010 22-06-2022 https://jira.opendaylight.org/browse/YANGTOOLS-175 yangtools <p>In yang, typically a description field will be formatted something like this:<br/> {<br/> description <br/> "Lorem ipsum dolor sit amet, consectetur adipisicing elit,<br/> sed do eiusmod tempor incididunt ut labore et dolore<br/> magna aliqua. Ut enim ad minim veniam, quis nostrud<br/> exercitation ullamco laboris nisi ut aliquip ex ea<br/> commodo consequat. Duis aute irure dolor in reprehenderit<br/> in voluptate velit esse cillum dolore eu fugiat nulla<br/> pariatur. Excepteur sint occaecat cupidatat non proident,<br/> sunt in culpa qui officia deserunt mollit anim id est<br/> laborum.";<br/> }</p> <p>The generated javadoc then comes out like:</p> <p>/**<br/> Lorem ipsum dolor sit amet, consectetur adipisicing elit,<br/> sed do eiusmod tempor incididunt ut labore et dolore<br/> magna aliqua. Ut enim ad minim veniam, quis nostrud<br/> exercitation ullamco laboris nisi ut aliquip ex ea<br/> commodo consequat. Duis aute irure dolor in reprehenderit<br/> in voluptate velit esse cillum dolore eu fugiat nulla<br/> pariatur. Excepteur sint occaecat cupidatat non proident,<br/> sunt in culpa qui officia deserunt mollit anim id est<br/> laborum.<br/> */</p> <p>We should be smarter about formatting these comments into nice paragraphs. I would propose that we look for paragraphs and reformat them into properly line-wrapped 80-column paragraphs.</p> <p>Also it would be nice to format with the leading * characters:<br/> /**</p> <ul> <li>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed</li> <li>do eiusmod tempor incididunt ut labore et dolore magna</li> <li>aliqua. Ut enim ad minim veniam, quis nostrud exercitation</li> <li>ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis</li> <li>aute irure dolor in reprehenderit in voluptate velit esse</li> <li>cillum dolore eu fugiat nulla pariatur. Excepteur sint</li> <li>occaecat cupidatat non proident, sunt in culpa qui officia</li> <li>deserunt mollit anim id est laborum.<br/> */</li> </ul> <p>Operating System: Linux<br/> Platform: PC</p> YANGTOOLS-175

Generated javadoc comments poorly formatted

Bug Resolved Done Ladislav Borak Rob Adams Thu, 29 May 2014 23:40:55 +0000 Sun, 10 Apr 2022 18:35:06 +0000 Tue, 22 Jul 2014 09:10:04 +0000 Mon, 14 Jul 2014 00:00:00 +0000 0 2 <p>proposed patch <a href="https://git.opendaylight.org/gerrit/#/c/8592/" class="external-link" target="_blank" rel="nofollow noopener">https://git.opendaylight.org/gerrit/#/c/8592/</a></p> Development External issue ID 1102 External issue URL ODL SR Target Milestone Rank 0|i025lr: