1. ホーム
  2. clojure

Clojureのコードコメントにおける;と;;の違いは何ですか?

2023-09-28 22:40:41

質問

の違いは何ですか? ;;; でコメントを開始した場合、Clojureではどうなるのでしょうか? 私は、私の テキストエディター はそれらを異なるように着色していることを確認し、私は概念的に何らかの違いがあると仮定しています。

また、私は マージナル はそれらを異なるものとして扱います。

; Stripped entirely
;; Appears in text section of marginalia
(defn foobar []
   ; Appears in code section of marginalia output
   ;; Again, appears in code section of marginalia output
   6)

どのように解決するのですか?

インタープリタに関しては、違いはありません。次のように考えてください。 ; ;; ;;; そして ;;;; を異なる見出しレベルとして指定します。

以下は、私の個人的な使用法です。

;;;; Top-of-file level comments, such as a description of the whole file/module/namespace

;;; Documentation for major code sections (i.e. groups of functions) within the file.

;; Documentation for single functions that extends beyond the doc string (e.g. an explanation of the algorithm within the function)

; In-line comments possibly on a single line, and possibly tailing a line of code