[翻訳] LLVMコーディング標準3.9.1（３/４）機械的なソースの問題 - Qiitaこの記事は、LLVM Coding Standards 翻訳の３/４です。 前：言語、ライブラリ、および標準 | 目次 | 次：スタイルの問題 機械的なソースの問題 ソースコードのフォーマット コメント コメントは、可読性と保守性について重要な部分のひとつです。皆さんご存知の通り、コードにはコメントすべきです。コメントを書く場合、適切な句読点と大小文字の英文で書きます。コードがなにを行おうとしているのか、またなぜ行おうとしているのかを記載することに焦点を絞り、微細に どうやるか を書くことは避けてください。ここでは、文書に重要な事柄がいくつかあります： ファイルのヘッダ すべてのソースファイルには、ファイルの基本的な目的を説明するヘッダが必要です。ファイルにヘッダがない場合、ツリーにチェックインしてはいけません。標準のヘッダは次のようになります： //===-- llvm/Instruct
![[翻訳] LLVMコーディング標準3.9.1（３/４）機械的なソースの問題 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/1bb20e58944f07630e48704869e45141c3c800e1/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fqiita-user-contents.imgix.net%252Fhttps%25253A%25252F%25252Fcdn.qiita.com%25252Fassets%25252Fpublic%25252Farticle-ogp-background-afbab5eb44e0b055cce1258705637a91.png%253Fixlib%253Drb-4.0.0%2526w%253D1200%2526blend64%253DaHR0cHM6Ly9xaWl0YS11c2VyLXByb2ZpbGUtaW1hZ2VzLmltZ2l4Lm5ldC9odHRwcyUzQSUyRiUyRnFpaXRhLWltYWdlLXN0b3JlLnMzLmFwLW5vcnRoZWFzdC0xLmFtYXpvbmF3cy5jb20lMkYwJTJGMTQyNjM3JTJGcHJvZmlsZS1pbWFnZXMlMkYxNjA1ODEwNzUyP2l4bGliPXJiLTQuMC4wJmFyPTElM0ExJmZpdD1jcm9wJm1hc2s9ZWxsaXBzZSZmbT1wbmczMiZzPTdhNWQ3NjFhNDAyOTMyYzk3Y2EwNGQ4NTA0NDI2NTVj%2526blend-x%253D120%2526blend-y%253D467%2526blend-w%253D82%2526blend-h%253D82%2526blend-mode%253Dnormal%2526s%253D91f5d467cdfa8150e27b3a0f875d5c17%3Fixlib%3Drb-4.0.0%26w%3D1200%26fm%3Djpg%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk2MCZoPTMyNCZ0eHQ9JTVCJUU3JUJGJUJCJUU4JUE4JUIzJTVEJTIwTExWTSVFMyU4MiVCMyVFMyU4MyVCQyVFMyU4MyU4NyVFMyU4MiVBMyVFMyU4MyVCMyVFMyU4MiVCMCVFNiVBOCU5OSVFNiVCQSU5NjMuOS4xJUVGJUJDJTg4JUVGJUJDJTkzJTJGJUVGJUJDJTk0JUVGJUJDJTg5JUU2JUE5JTlGJUU2JUEyJUIwJUU3JTlBJTg0JUUzJTgxJUFBJUUzJTgyJUJEJUUzJTgzJUJDJUUzJTgyJUI5JUUzJTgxJUFFJUU1JTk1JThGJUU5JUExJThDJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmdHh0LXBhZD0wJnM9ZTJhMDhlNTU1MTI2MGE4OTNmODA5NzMzMTJjMzgzODI%26mark-x%3D120%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTgzOCZoPTU4JnR4dD0lNDB0ZW5teW8mdHh0LWNvbG9yPSUyMzFFMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtcGFkPTAmcz1jZjJlZjY0MjIwNGU4YThkNmQ0OGMzNDMyMTUxYWRkNg%26blend-x%3D242%26blend-y%3D480%26blend-w%3D838%26blend-h%3D46%26blend-fit%3Dcrop%26blend-crop%3Dleft%252Cbottom%26blend-mode%3Dnormal%26s%3Ddf48d522b110054448373d23f5ce36c8)
