問題タブ [groovydoc]

Gradle 1.5 を使用して Groovy スクリプトをテストしています。build.gradle の groovyDoc タスクは次のように設定されます。

このタスクの実行中に発生するエラーは次のとおりです。

これは、クラスの 1 つに小さなコード変更 (単一の If ステートメントを追加) を行った後にのみ発生し始めました。以前のコミットに戻しましたが、この問題はありません。クラスの変更を削除して、同じファイルを再コミットしようとしましたが、まだ失敗しています。

あなたはなにか考えはありますか？

私はGroovyでクラスを書いています.Groovydocを（コマンドラインから）生成したいと思っています. 私のクラスでは、次のようなメソッドのドキュメントを作成しました。

しかし、私が走るときgroovydoc -classpath C:\groovyStuff\ -d . *.groovy

HTML テンプレートを生成しますが、実際のコンテンツは生成しません。

私は何を間違えましたか？

Groovy ソースでカスタム ドックレットを作成したいのですが、groovydocツールには-tagletパラメータがないため、可能性が見つかりません。APIを少し掘り下げましたが、うまくいきませんでした。カスタムドックレットを作成する方法はありますか?

Groovy javadocs (groovydocs など) を検索すると、Google で見つかりますが、それらはすべて Groovy の優れた機能を示す一種の Groovy スプラッシュ ページにリダイレクトされます。たとえば、「groovy uribuilder api」を検索すると、次のリンクが表示されます。

http://groovy.codehaus.org/modules/http-builder/apidocs/groovyx/net/http/URIBuilder.html

ただし、そのリンクは次の場所にリダイレクトされます。

http://beta.groovy-lang.org/modules/http-builder/apidocs/groovyx/net/http/URIBuilder.html

実際の API ドキュメントを取得するために Google のキャッシュ バージョンを参照することはできますが、ある時点でこれがなくなり、未完成の Groovy コードとドキュメントなしで立ち往生するのではないかと心配しています。どこかにホストされている Groovy ドキュメントの新しいルートはありますか?

ありがとうございました

更新: ドキュメントが再表示されましたが、それでも回答は有益な情報です。

作業中のライブラリ用に Groovydoc の生成を開始したところです。ただし、メソッド シグネチャ内のjava.langandjava.utilおよびその他の一般的なパッケージ プレフィックスが優勢であるため、メソッドの真の意図がわかりにくくなっています。これらなしでGroovydocを生成できるようにしたいと思います。（構成された）例のように：

それよりも：

(私の実際の例の中にはもっと悪いものもあり、3 つまたは 4 つのsomething.entirely.Obvious引数と戻り値があります。)

Javadoc では、-noqualifierオプションを使用してこれを実現します。ただし、同様のオプションはリストされていませんgroovydoc --help。

Groovydoc でこれを行う方法はありますか? そうでない場合、これを行うための他の信頼できる方法を思いついた人はいますか? （まだ試す機会がなかった私のフォールバックは、Antのタスクで生成されたドキュメントの後処理を試みるreplaceことですが、より良い方法があるかどうか疑問に思いました。）

Groovy ファミリーのどこかで、新しい groovydoc マークアップ (コメントの構文) を見ました。Javadoc ではなく、Wiki マークアップ言語に似ていました。私は URL を失い、Google で見つけることができませんでした :(。このドキュメント フォーマッタの名前は非常に単純で、通常の英単語でした。誰か思い出させてくれませんか?

多くのグルーヴィーなビジネス ルール スクリプトを文書化します。これは役に立ちます。

親ディレクトリの下のさまざまな場所にグルーヴィーなスクリプトがあります。ディレクトリ構造は次のようなものです。

Groovy ドキュメントを生成し、親ディレクトリの下にすべての Groovy スクリプトを含めたいと考えています。

親ディレクトリでコマンドを実行しようとしましたが、その中のものだけが取得され、明らかにサブフォルダのものは含まれていません:

コマンドライン以外に良い方法があれば教えてください。このプラグインも試しましたが、うまくいきませんでしたhttps://github.com/rvowles/groovydoc-maven-plugin

ありがとう！

Groovy または Java のクラスまたはメソッドの場合、API レベルのドキュメントは通常、通常のコメントではなくドキュメント コメント (別名 Javadoc コメント) に含めます。Groovy スクリプトについてそのようなコメントを追加する類似の方法は何ですか?

個人的には、Javadoc ツールがドキュメントを取得するかどうかはあまり気にしません。ただし、Groovy スクリプトの目的に関するドキュメントは、クラスのドキュメント コメントに概念的に類似しているように見えます。したがって、私は直感的にそれらがドキュメントのコメントにあると期待しています。私の直感が間違っていて、doc タグが Groovy スクリプトの意図をコメントする標準的な方法ではない場合、スクリプトの目的を文書化するための推奨される方法は何ですか?

grails 2.x doc 機能は非常に役立つ/有望に見えます: http://grails.github.io/grails-doc/2.5.3/ref/Command%20Line/doc.html

コマンド »grails doc« - »は、現在の Grails プロジェクトのユーザー ガイドと Javadoc + Groovydoc API ドキュメントを生成します。

ただし、マニュアルのこのセクションは Grails 3.0.10 でなくなりました。changelog に関連情報が見つかりませんでした。また、grails インタラクティブ コンソールは doc コマンドについて何も知りません。私はグーグルを使用しましたが、これについて何も見つかりませんでした。（私はgroovydocについて知っていて、現在それを使用していますが、すぐに使えるgrailsの内部については知らないので、私の質問は立っています）

それはどこに行きましたか？なぜ削除されたのですか？戻ってきますか？