*: disclaimer at the top of doc

Author: gyuho

main.go

@@ -116,6 +116,9 @@ func init() {
 
 func CommandFunc(cmd *cobra.Command, args []string) error {
 	var rs string
+	if len(disclaimer) > 0 {
+		rs += disclaimer + "\n\n\n"
+	}
 	if len(targetDirectories) == 0 {
 		log.Println("opening", targetDirectory)
 		proto, err := parse.ReadDir(targetDirectory, "")
@@ -132,7 +135,7 @@ func CommandFunc(cmd *cobra.Command, args []string) error {
 			}
 		}
 		log.Println("converting to markdown", title)
-		rs, err = proto.Markdown(disclaimer, title, opts, languageOptions...)
+		rs, err = proto.Markdown(title, opts, languageOptions...)
 		if err != nil {
 			return err
 		}
@@ -150,7 +153,7 @@ func CommandFunc(cmd *cobra.Command, args []string) error {
 			if err != nil {
 				return err
 			}
-			ms, err := proto.Markdown(disclaimer, "", elem.options, languageOptions...)
+			ms, err := proto.Markdown("", elem.options, languageOptions...)
 			if err != nil {
 				return err
 			}

parse/markdown.go

@@ -29,13 +29,10 @@ const (
 
 // Markdown saves 'Proto' to markdown documentation.
 // lopts are a slice of language options (C++, Java, Python, Go, Ruby, C#).
-func (p *Proto) Markdown(disclaimer, title string, parseOpts []ParseOption, lopts ...string) (string, error) {
+func (p *Proto) Markdown(title string, parseOpts []ParseOption, lopts ...string) (string, error) {
 	p.Sort()
 
 	buf := new(bytes.Buffer)
-	if len(disclaimer) > 0 {
-		buf.WriteString(fmt.Sprintf("%s\n\n\n", disclaimer))
-	}
 	if len(title) > 0 {
 		buf.WriteString(fmt.Sprintf("### %s\n\n\n", title))
 	}

parse/markdown_test.go

@@ -21,7 +21,7 @@ func TestMarkdown(t *testing.T) {
 	if err != nil {
 		t.Fatal(err)
 	}
-	if txt, err := proto.Markdown("this is test...", "etcdserverpb", []ParseOption{ParseService, ParseMessage}, "Go", "Java", "Python", "C++"); err != nil {
+	if txt, err := proto.Markdown("etcdserverpb", []ParseOption{ParseService, ParseMessage}, "Go", "Java", "Python", "C++"); err != nil {
 		t.Fatal(err)
 	} else {
 		err = toFile(txt, "testdata/README.md")