-Ttree: non-ASCII characters

-Ttree: non-ASCII characters

[Thomas Klausner]

Hi!

apropos in NetBSD is using the mandoc library (currently 1.13.0). I
noted a problem with apropos midi output and asked the author (Abhinav
Upadhyay) to take a look at it.

He reported the mandoc -Ttree /usr/share/man/man4/midi.4 already gave
back mangled output:

root (root) 0:0
        Sh (block) *33:1-35
                Sh (block-head) 33:1
                        NAME (text) 33:4
                Sh (block-body) 33:1-35
                        Nm (elem) *34:1
                                midi (text) 34:4
                        Nd (block) *35:1
                                Nd (block-head) 35:1
                                Nd (block-body) 35:1
                                        device^^independent MIDI driver layer (text) 35:4


The "^^" are reversed, and they correspond to this (from "mandoc midi.4" output):

NAME
     midi -- device-independent MIDI driver layer

I see that the mandoc man page says under "Mdoc Abstract Syntax Tree"
     TEXT       <- [[:ascii:]]*

There seems to be a bug here, or?
 Thomas
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

Re: -Ttree: non-ASCII characters

[Abhinav Upadhyay]

Thanks for the clarification Ingo.

Thomas, I guess I will have to handle this in makemandb itself. I will
send a patch soon.

Thanks
Abhinav



On Mon, May 19, 2014 at 7:29 PM, Ingo Schwarze <schwarze@usta.de> wrote:
> Hi,
>
> Thomas Klausner wrote on Sun, May 18, 2014 at 12:47:12PM +0200:
>
>> apropos in NetBSD is using the mandoc library (currently 1.13.0). I
>> noted a problem with apropos midi output and asked the author (Abhinav
>> Upadhyay) to take a look at it.
>>
>> He reported the mandoc -Ttree /usr/share/man/man4/midi.4 already gave
>> back mangled output:
>>
>> root (root) 0:0
>>         Sh (block) *33:1-35
>>                 Sh (block-head) 33:1
>>                         NAME (text) 33:4
>>                 Sh (block-body) 33:1-35
>>                         Nm (elem) *34:1
>>                                 midi (text) 34:4
>>                         Nd (block) *35:1
>>                                 Nd (block-head) 35:1
>>                                 Nd (block-body) 35:1
>>                                         device^^independent MIDI driver layer (text) 35:4
>>
>>
>> The "^^" are reversed, and they correspond to this (from "mandoc midi.4" output):
>>
>> NAME
>>      midi -- device-independent MIDI driver layer
>>
>> I see that the mandoc man page says under "Mdoc Abstract Syntax Tree"
>>      TEXT       <- [[:ascii:]]*
>>
>> There seems to be a bug here, or?
>
> Yes, i should probably fix the manual.
>
> Some hyphens (ASCII 45) are replaced by ASCII_HYPH (30)
> to tell the formatters that hyphenation is allowed at these
> places.  ASCII 29 and 31 may also occur, see mandoc.h:
>
> #define ASCII_NBRSP      31  /* non-breaking space */
> #define ASCII_HYPH       30  /* breakable hyphen */
> #define ASCII_BREAK      29  /* breakable zero-width space */
>
> I will be slow to respond for a few weeks, i'm going to be offline
> until June 10.
>
> Yours,
>   Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

Re: -Ttree: non-ASCII characters

[Ingo Schwarze]

Hi Abhinav,

Abhinav Upadhyay wrote on Mon, May 19, 2014 at 11:30:32PM +0530:

> Thomas, I guess I will have to handle this in makemandb itself.

Yes, that approach makes sense to me.  Our makewhatis(8) tools
ahndles these special cases, too.

> I will send a patch soon.

Feel free to look at mandocdb.c for inspiration, searching for "ASCII_".

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv