埋め込み変数コメントに関してドキュメントを修正

Author: nakamura-to

docs/sources/sql.rst

@@ -269,7 +269,7 @@ Dao の呼び出し例は次の通りです。
 埋め込み変数コメント
 --------------------
 
-埋め込み変数を示す式コメントを埋め込み変数コメントと呼びます。
+埋め込み変数を示す式コメントを *埋め込み変数* コメントと呼びます。
 埋め込み変数の値は SQL を組み立てる際に SQL の一部として直接埋め込まれます。
 
 SQL インジェクションを防ぐため、埋め込み変数の値に以下の値を含めることは禁止しています。
@@ -281,7 +281,7 @@ SQL インジェクションを防ぐため、埋め込み変数の値に以下
 
 埋め込み変数は ``/*#～*/`` というブロックコメントで示します。
 埋め込み変数の名前は Dao メソッドのパラメータ名にマッピングされます。
-埋め込み変数は ``ORDER BY`` 句など SQL の一部をプログラムで組み立てたい場合に使用できます。
+
 Dao のメソッドと対応する SQL の例は次のとおりです。
 
 .. code-block:: java
@@ -307,6 +307,10 @@ Dao の呼び出し例は次の通りです。
 
   select * from employee where salary > ? order by salary asc, employee_name
 
+.. note::
+
+  埋め込み変数コメントは、 ORDER BY 句など SQL の一部をプログラムで組み立てたい場合に使用できます。
+
 条件コメント
 ------------