strip doc.go files

broker/broker.go

@@ -1,3 +1,4 @@
+// Package broker is an interface used for asynchronous messaging
 package broker
 
 // Broker is an interface used for asynchronous messaging.

broker/doc.go

@@ -1,4 +0,0 @@
-/*
-Package broker is an interface used for asynchronous messaging.
-*/
-package broker

client/client.go

@@ -1,3 +1,4 @@
+// Package client is an interface for an RPC client
 package client
 
 import (

client/doc.go

@@ -1,23 +0,0 @@
-/*
-Package client is an interface for making requests.
-
-It provides a method to make synchronous, asynchronous and streaming requests to services.
-By default json and protobuf codecs are supported.
-
-        import "github.com/micro/go-micro/client"
-
-        c := client.NewClient()
-
-        req := c.NewRequest("go.micro.srv.greeter", "Greeter.Hello", &greeter.Request{
-                Name: "John",
-        })
-
-        rsp := &greeter.Response{}
-
-        if err := c.Call(context.Background(), req, rsp); err != nil {
-                return err
-        }
-
-        fmt.Println(rsp.Msg)
-*/
-package client

cmd/cmd.go

@@ -1,3 +1,4 @@
+// Package cmd is an interface for parsing the command line
 package cmd
 
 import (

cmd/doc.go

@@ -1,4 +0,0 @@
-/*
-Package cmd is an interface for parsing the command line.
-*/
-package cmd

codec/codec.go

@@ -1,3 +1,4 @@
+// Package codec is an interface for encoding messages
 package codec
 
 import (

codec/doc.go

@@ -1,4 +0,0 @@
-/*
-Package codec is an interface for encoding messages.
-*/
-package codec

errors/doc.go

@@ -1,4 +0,0 @@
-/*
-Package errors is an interface for defining detailed errors.
-*/
-package errors

errors/errors.go

@@ -1,3 +1,4 @@
+// Package errors is an interface for defining detailed errors
 package errors
 
 import (

metadata/doc.go

@@ -1,4 +0,0 @@
-/*
-Package metadata is a way of defining message headers.
-*/
-package metadata

metadata/metadata.go

@@ -1,3 +1,4 @@
+// Package metadata is a way of defining message headers
 package metadata
 
 import (

registry/doc.go

@@ -1,4 +0,0 @@
-/*
-Package registry is an interface for service discovery.
-*/
-package registry

registry/registry.go

@@ -1,3 +1,4 @@
+// Package registry is an interface for service discovery
 package registry
 
 import (

selector/doc.go

@@ -1,8 +0,0 @@
-/*
-Package selector is a way to load balance service nodes.
-
-It algorithmically filter and return nodes required by the client or any other system.
-Selector's implemented by Micro build on the registry but it's of optional use. One could
-provide a static Selector that has a fixed pool.
-*/
-package selector

selector/selector.go

@@ -1,3 +1,4 @@
+// Package selector is a way to load balance service nodes
 package selector
 
 import (

server/doc.go

@@ -1,31 +0,0 @@
-/*
-Package server is an interface for a micro server.
-
-It represents a server instance in go-micro which handles synchronous
-requests via handlers and asynchronous requests via subscribers that
-register with a broker.
-
-The server combines the all the packages in go-micro to create a whole unit
-used for building applications including discovery, client/server communication
-and pub/sub.
-
-        import "github.com/micro/go-micro/server"
-
-        type Greeter struct {}
-
-        func (g *Greeter) Hello(ctx context.Context, req *greeter.Request, rsp *greeter.Response) error {
-                rsp.Msg = "Hello " + req.Name
-                return nil
-        }
-
-        s := server.NewServer()
-
-
-        s.Handle(
-                s.NewHandler(&Greeter{}),
-        )
-
-        s.Start()
-
-*/
-package server

server/server.go

@@ -1,3 +1,4 @@
+// Package server is an interface for a micro server
 package server
 
 import (

transport/doc.go

@@ -1,4 +0,0 @@
-/*
-Package is an interface for synchronous communication.
-*/
-package transport

transport/transport.go

@@ -1,3 +1,4 @@
+// Package is an interface for synchronous communication
 package transport
 
 import (