[asterisk-bugs] [JIRA] (ASTERISK-25527) Quirky xmldoc description wrapping

[Rusty Newton (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-25527?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=228178#comment-228178 ] 

Rusty Newton commented on ASTERISK-25527:
-----------------------------------------

Thanks Walter!

> Quirky xmldoc description wrapping
> ----------------------------------
>
>                 Key: ASTERISK-25527
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-25527
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Documentation
>    Affects Versions: 11.20.0, 13.6.0
>            Reporter: Walter Doekes
>         Attachments: ASTERISK-25527-11.patch, new-nocolor.txt, old-nocolor.txt
>
>
> Example, the output of {{core show application Dial}} says:
> {noformat}
> timeout
>     Specifies the number of seconds we attempt to dial the specified
> ^-- 68 columns
>     devices
>     If not specified, this defaults to 136 years.
> options
>     A(x):
>         x - The file to play to the called party
> Play an announcement to the called party, where <x> is the prompt to be played
> ^-- 78 columns
> {noformat}
> Because of quirky behaviour, word wrapping feels random.
> Expected output:
> {noformat}
> timeout
>     Specifies the number of seconds we attempt to dial the specified devices
> ^-- 76 columns
>     If not specified, this defaults to 136 years.
> options
>     A(x):
>         x - The file to play to the called party
> Play an announcement to the called party, where <x> is the prompt to be played
> ^-- 78 columns
> {noformat}
> The attached patch {{ASTERISK-25527-11.patch}} fixes it. And deletes lots of nasty code. It could certainly be improved still:
> * not copying the data one char at a time
> * taking escape sequences into account when counting back 30 characters
> But for now this is better than it was.
> Compare {{new-nocolor.txt}} with {{old-nocolor.txt}} to see the changed output. (Also includes a few typo fixes. Those will be fixed elsewhere.)



--
This message was sent by Atlassian JIRA
(v6.2#6252)