Hmm .. you can still generate html docs in a round-about fashion by 
spinning up the godoc server and storing the response of the http request 
of the package path.

Otherwise, you are free to use the godoc2md tool 
- https://github.com/davecheney/godoc2md, which generates markdown pages 
from a package path. It's a great way to generate static docs.

On Friday, 31 August 2018 01:39:06 UTC+5:30, Justin Israel wrote:
>
>
>
> On Thu, Aug 30, 2018, 9:54 PM Agniva De Sarker <[email protected] 
> <javascript:>> wrote:
>
>> I had filed https://github.com/golang/go/issues/26827 to list the 
>> changes that godoc needs to make. Please feel free to add your comments 
>> there.
>>
>> Also - note that godoc cli mode is going to go away. So "godoc -links=0 
>> -html domain.com/group/project/v3/lib/foo" is not going to work after 
>> 1.12. You should be using the http server. If you want command line help, 
>> use "go doc".
>>
>
> Fair enough. I should just discontinue the feature we have in our build 
> systems Go tool. It was neat to generate html docs with our deploys. 
>
>
>> - Agniva
>>
>>
>> On Thursday, 30 August 2018 01:02:48 UTC+5:30, Justin Israel wrote:
>>>
>>> Thanks for that update, Paul!
>>>
>>> On Thu, Aug 30, 2018, 2:07 AM Paul Jolly <[email protected]> wrote:
>>>
>>>> Perhaps better (because of the automatic linking, status updates etc)
>>>> is to create issues in respective tools under the umbrella of
>>>> https://github.com/golang/go/issues/24661
>>>>
>>>> Indeed I know there are a number of such issues, so it's just a case
>>>> of linking those from #24661.
>>>> On Wed, 29 Aug 2018 at 07:46, wilk <[email protected]> wrote:
>>>> >
>>>> >
>>>> > It could be fine to start a wiki page to list the tools and ide
>>>> > (not)ready for modules with the linked issues.
>>>> >
>>>> > In https://github.com/golang/go/wiki/Modules or a new page ?
>>>> >
>>>> > On 29-08-2018, Paul Jolly wrote:
>>>> > > --00000000000050127c057491b176
>>>> > > Content-Type: text/plain; charset="UTF-8"
>>>> > >
>>>> > > Please see https://github.com/golang/gddo/issues/567
>>>> > >
>>>> > > On Tue, 28 Aug 2018, 18:59 Justin Israel, <[email protected]> 
>>>> wrote:
>>>> > >
>>>> > >> I've been trying out converting some of our internal projects to 
>>>> go 1.11
>>>> > >> using modules instead of glide. We have a build system that 
>>>> provides the
>>>> > >> ability to generate html docs via "godoc" and I am wondering if 
>>>> godoc has
>>>> > >> been made "module-aware" in go 1.11?
>>>> > >>
>>>> > >> My particular project is using the migration approach of setting 
>>>> "v3" at
>>>> > >> in the go.mod, and in all import paths within the project. But it 
>>>> seems
>>>> > >> godoc is not happy about this:
>>>> > >>
>>>> > >> godoc -links=0 -html domain.com/group/project/v3/lib/foo
>>>> > >>
>>>> > >> 2018/08/29 11:52:12 error while importing build package: cannot 
>>>> find package "domain.com/group/project/v3/lib/foo" in any of:
>>>> > >>         /path/to/go/1.11.0/src/domain.com/group/project/v3/lib/foo 
>>>> (from $GOROOT)
>>>> > >>         /usr/home/justin/src/go/src/
>>>> domain.com/group/project/v3/lib/foo (from $GOPATH)
>>>> > >> 2018/08/29 11:52:12 cannot find package "." in:
>>>> > >>         /src/domain.com/group/project/v3/lib/foo
>>>> > >>
>>>> > >>
>>>> > >> It seems to only care about the filesystem structure and not the 
>>>> module import path naming?
>>>> > >>
>>>> > >>
>>>> > >> Justin
>>>> > >>
>>>> > >>
>>>> > >> --
>>>> > >> 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 [email protected].
>>>> > >> For more options, visit https://groups.google.com/d/optout.
>>>> > >>
>>>> > >
>>>> >
>>>> >
>>>> > --
>>>> > William
>>>> >
>>>> > --
>>>> > 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 [email protected].
>>>> > For more options, visit https://groups.google.com/d/optout.
>>>>
>>>> -- 
>>>> 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 [email protected].
>>>
>>>
>>>> For more options, visit https://groups.google.com/d/optout.
>>>>
>>> -- 
>> 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 [email protected] <javascript:>.
>> For more options, visit https://groups.google.com/d/optout.
>>
>

-- 
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 [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to