# comment

fun comment(content: String, position: AbstractQuery.CommentPosition = CommentPosition.FRONT): T

Appends an SQL comment, with content wrapped by `/* */`, at the specified CommentPosition in this `SELECT` query.

Adding some comments may be useful for tracking, embedding metadata, or for special instructions, like using `/*FORCE_MASTER*/` for some cloud databases to force the statement to run in the master database or using optimizer hints.

#### Throws

IllegalStateException

If a comment has already been appended at the specified position. An existing comment can be removed or altered by adjustComments.

#### Samples

org.jetbrains.exposed.v1.tests.shared.dml.SelectTests.testSelectWithComment