タグ付けされた質問 「doc-strings」

一致するファイル内の任意のsexpsからdocstringを取得する関数を記述しようとしています(def.*)。 定義されている変数だけでなく、関数/マクロも取得できるようにしたいと思います。変数の場合はdocstringが必要ですが、関数の場合は引数リストも必要です。

11 elisp  doc-strings 

Emacsのドキュメントは、ドキュメント文字列が中に置かれるlambdaかdefun、「関数オブジェクトに直接保存される」と述べています。ただし、次のように名前付き関数のドキュメントを変更できます。 (put 'my-function-name 'function-documentation "Blah.") しかし、同じトリックはラムダでは機能しません。ラムダにドキュメントを追加する方法はありますか？または、どういうわけか動的にドキュメント文字列リテラルを生成しますか？ 明確にするために、次の状況を想像してください。 (let ((foo 1) (bar 2)) (lambda () (+ foo bar))) ラムダにfooおよびの値を説明するドキュメント文字列が欲しいbarです。

10 elisp  doc-strings 

elisp（一般的にLISPかどうかは不明）が複数行のdocstringを処理する方法が嫌いです。 (defun foo () "This is a multi liner docstring" (do-stuff)) 私は私が何かをすることができることを願っています (defun foo () (eval-when-compile (concat "This is\n" "a multi\n" "line\n" "docstring")) (do-stuff)) インデントが一貫するように。 残念ながら、eval-when-compileは機能しません。 誰かアイデアはありますか？

9 elisp  doc-strings 

メソッドのPython docstringを自動的に挿入するelispパッケージを探しています。私の目的に非常に近いパッケージを見つけました。ただし、Googleスタイルではなく、reStructuredテキストです。 sphinx-doc.el https://github.com/naiquevin/sphinx-doc.el docstringsでの引数の記述（Google pythonスタイルガイド） https://www.chromium.org/chromium-os/python-style-guidelines#TOC-Describing-arguments-in-docstrings 私の期待はM-x sphinx-doc-google、次の関数内で呼び出すときです。 def some_function(a, b, c): このような結果が必要です。 def some_function(a, b, c): """ Args: a: b: c: Returns: """ 自分で実装するのは難しくないことはわかっています。再発明を避けるためにこの質問をしたいだけです。

8 python  doc-strings