[go-nuts] Re: various odd, to me, at best undocumented, behaviour of automatic formatting in go doc

2017-11-23 Thread 'simon place' via golang-nuts
what you are describing is what i expected from the start, a form of duck-typing, in that if it looks like a Title then format it as a Title, fine, simple and efficient. i don't expect all the cases where the documentation is wrong that could easy, simply and usefully not be. -- You received

[go-nuts] Re: various odd, to me, at best undocumented, behaviour of automatic formatting in go doc

2017-11-23 Thread Volker Dobler
On Wednesday, 22 November 2017 19:09:46 UTC+1, simon place wrote: > > trying to work around these issues, i find another undocumented 'feature' > > https://play.golang.org/p/dzcq5XKpgG > > It is the same logic: A heading is a heading to a normal text paragraph. Lines are not headings by

[go-nuts] Re: various odd, to me, at best undocumented, behaviour of automatic formatting in go doc

2017-11-22 Thread 'simon place' via golang-nuts
trying to work around these issues, i find another undocumented 'feature' https://play.golang.org/p/dzcq5XKpgG -- You received this message because you are subscribed to the Google Groups "golang-nuts" group. To unsubscribe from this group and stop receiving emails from it, send an email to

[go-nuts] Re: various odd, to me, at best undocumented, behaviour of automatic formatting in go doc

2017-11-22 Thread 'simon place' via golang-nuts
thanks for looking, you have understood and argued well against my points being significant. i was trying to show-up, and see if there was agreement, that this code could benefit from some re-factoring/simplification. but my problem is; i have an html doc that looks quite poor, but according

[go-nuts] Re: various odd, to me, at best undocumented, behaviour of automatic formatting in go doc

2017-11-21 Thread Volker Dobler
On Tuesday, 21 November 2017 21:26:56 UTC+1, simon place wrote: > > see; > > https://play.golang.org/p/kPWJzm1rQi > > see comments for details, found more than i banked on whilst investigating > a formatting issue on GitHub docs (turned out to be example 7.). > Just some thoughts and my