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

[Kevin Harwell (JIRA)]

     [ https://issues.asterisk.org/jira/browse/ASTERISK-25527?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Kevin Harwell updated ASTERISK-25527:
-------------------------------------

    Target Release Version/s: 11.21.0

> 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
>      Target Release: 11.21.0
>
>         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)