Re: [go-nuts] godoc and generic code

2022-11-04 Thread Marcel Huijkman
Perhaps update godoc:
go install golang.org/x/tools/cmd/godoc@latest

On Friday, November 4, 2022 at 7:18:28 AM UTC+1 tapi...@gmail.com wrote:

> You may also try Golds: https://github.com/go101/golds.
> Still not perfect in handling custom generic things,
> but it is generally usable.
>
> On Friday, November 4, 2022 at 1:26:26 AM UTC+8 Hotei wrote:
>
>> Thanks for the very helpful replies. < go doc -all pkg > should meets my 
>> needs for printed documentation.  I guess I will have to weigh the 
>> convenience of navigating which the godoc html version provides vs the 
>> inconvenience of "instantiating" the methods required by the types [T] I 
>> use in this project.  The pkgsite option doesn't seem workable in my case 
>> for the reasons eloquently described by one of the posters to issue 49212.  
>> At any rate, problem solved and thanks again to the golang-nuts group for 
>> the assistance!
>>
>> On Thursday, November 3, 2022 at 9:32:09 AM UTC-4 Sebastien Binet wrote:
>>
>>> On Thu Nov 3, 2022 at 14:02 CET, Jan Mercl wrote: 
>>> > On Thu, Nov 3, 2022 at 12:49 PM Hotei  wrote: 
>>> > 
>>> > > I added some generic code to a project and godoc doesn't seem to 
>>> like that and stops working when it sees the generics. It's a 4 year old 
>>> version of godoc so that's perhaps not a surprise. What is a surprise is 
>>> that godoc isn't shipped with go any longer. Is there a version that 
>>> handles generics and if so where can I find it? A quick search of github 
>>> came up empty but I know things have been moved around so some hints would 
>>> be much appreciated. 
>>> > 
>>> > I'm not in favor of the fact, but It's been deprecated a year ago: 
>>> > https://github.com/golang/go/issues/49212 
>>>
>>> one can use godocs.io for a maintained "godoc-like" binary: 
>>>
>>> - https://godocs.io/go-hep.org/x/hep/sliceop 
>>> - https://sr.ht/~sircmpwn/godocs.io/ 
>>>
>>> (otherwise, 'go doc' does support "generics") 
>>>
>>> hth, 
>>> -s 
>>>
>>

-- 
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 golang-nuts+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/golang-nuts/d407dd97-993f-4511-a373-802c55e4fc70n%40googlegroups.com.


Re: [go-nuts] godoc and generic code

2022-11-04 Thread tapi...@gmail.com
You may also try Golds: https://github.com/go101/golds.
Still not perfect in handling custom generic things,
but it is generally usable.

On Friday, November 4, 2022 at 1:26:26 AM UTC+8 Hotei wrote:

> Thanks for the very helpful replies. < go doc -all pkg > should meets my 
> needs for printed documentation.  I guess I will have to weigh the 
> convenience of navigating which the godoc html version provides vs the 
> inconvenience of "instantiating" the methods required by the types [T] I 
> use in this project.  The pkgsite option doesn't seem workable in my case 
> for the reasons eloquently described by one of the posters to issue 49212.  
> At any rate, problem solved and thanks again to the golang-nuts group for 
> the assistance!
>
> On Thursday, November 3, 2022 at 9:32:09 AM UTC-4 Sebastien Binet wrote:
>
>> On Thu Nov 3, 2022 at 14:02 CET, Jan Mercl wrote:
>> > On Thu, Nov 3, 2022 at 12:49 PM Hotei  wrote:
>> >
>> > > I added some generic code to a project and godoc doesn't seem to like 
>> that and stops working when it sees the generics. It's a 4 year old version 
>> of godoc so that's perhaps not a surprise. What is a surprise is that godoc 
>> isn't shipped with go any longer. Is there a version that handles generics 
>> and if so where can I find it? A quick search of github came up empty but I 
>> know things have been moved around so some hints would be much appreciated.
>> >
>> > I'm not in favor of the fact, but It's been deprecated a year ago:
>> > https://github.com/golang/go/issues/49212
>>
>> one can use godocs.io for a maintained "godoc-like" binary:
>>
>> - https://godocs.io/go-hep.org/x/hep/sliceop
>> - https://sr.ht/~sircmpwn/godocs.io/
>>
>> (otherwise, 'go doc' does support "generics")
>>
>> hth,
>> -s
>>
>

-- 
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 golang-nuts+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/golang-nuts/fc14224a-6325-4cd1-a313-af6bfb7e1f67n%40googlegroups.com.


Re: [go-nuts] godoc and generic code

2022-11-03 Thread Hotei
Thanks for the very helpful replies. < go doc -all pkg > should meets my 
needs for printed documentation.  I guess I will have to weigh the 
convenience of navigating which the godoc html version provides vs the 
inconvenience of "instantiating" the methods required by the types [T] I 
use in this project.  The pkgsite option doesn't seem workable in my case 
for the reasons eloquently described by one of the posters to issue 49212.  
At any rate, problem solved and thanks again to the golang-nuts group for 
the assistance!

On Thursday, November 3, 2022 at 9:32:09 AM UTC-4 Sebastien Binet wrote:

> On Thu Nov 3, 2022 at 14:02 CET, Jan Mercl wrote:
> > On Thu, Nov 3, 2022 at 12:49 PM Hotei  wrote:
> >
> > > I added some generic code to a project and godoc doesn't seem to like 
> that and stops working when it sees the generics. It's a 4 year old version 
> of godoc so that's perhaps not a surprise. What is a surprise is that godoc 
> isn't shipped with go any longer. Is there a version that handles generics 
> and if so where can I find it? A quick search of github came up empty but I 
> know things have been moved around so some hints would be much appreciated.
> >
> > I'm not in favor of the fact, but It's been deprecated a year ago:
> > https://github.com/golang/go/issues/49212
>
> one can use godocs.io for a maintained "godoc-like" binary:
>
> - https://godocs.io/go-hep.org/x/hep/sliceop
> - https://sr.ht/~sircmpwn/godocs.io/
>
> (otherwise, 'go doc' does support "generics")
>
> hth,
> -s
>

-- 
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 golang-nuts+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/golang-nuts/d5612970-6ad5-4e47-a45e-1e61f9cb648an%40googlegroups.com.


Re: [go-nuts] godoc and generic code

2022-11-03 Thread 'Sebastien Binet' via golang-nuts
On Thu Nov 3, 2022 at 14:02 CET, Jan Mercl wrote:
> On Thu, Nov 3, 2022 at 12:49 PM Hotei  wrote:
>
> > I added some generic code to a project and godoc doesn't seem to like that 
> > and stops working when it sees the generics.  It's a 4 year old version of 
> > godoc so that's perhaps not a surprise.  What is a surprise is that godoc 
> > isn't shipped with go any longer.  Is there a version that handles generics 
> > and if so where can I find it?  A quick search of github came up empty but 
> > I know things have been moved around so some hints would be much 
> > appreciated.
>
> I'm not in favor of the fact, but It's been deprecated a year ago:
> https://github.com/golang/go/issues/49212

one can use godocs.io for a maintained "godoc-like" binary:

- https://godocs.io/go-hep.org/x/hep/sliceop
- https://sr.ht/~sircmpwn/godocs.io/

(otherwise, 'go doc' does support "generics")

hth,
-s

-- 
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 golang-nuts+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/golang-nuts/CO2P4Z1G01II.LR5IDHBBGWME%40clrinfopc42.


Re: [go-nuts] godoc and generic code

2022-11-03 Thread Jan Mercl
On Thu, Nov 3, 2022 at 12:49 PM Hotei  wrote:

> I added some generic code to a project and godoc doesn't seem to like that 
> and stops working when it sees the generics.  It's a 4 year old version of 
> godoc so that's perhaps not a surprise.  What is a surprise is that godoc 
> isn't shipped with go any longer.  Is there a version that handles generics 
> and if so where can I find it?  A quick search of github came up empty but I 
> know things have been moved around so some hints would be much appreciated.

I'm not in favor of the fact, but It's been deprecated a year ago:
https://github.com/golang/go/issues/49212

-j

-- 
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 golang-nuts+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/golang-nuts/CAA40n-WA7DgrswXk_QrCBYX24au--MTEKbraQFALt-_YHwmC0A%40mail.gmail.com.