doc_paragraphs_missing_punctuation: rename the lint

Author: AudaciousAxiom

CHANGELOG.md

@@ -6224,14 +6224,14 @@ Released 2018-09-13
 [`diverging_sub_expression`]: https://rust-lang.github.io/rust-clippy/master/index.html#diverging_sub_expression
 [`doc_broken_link`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_broken_link
 [`doc_comment_double_space_linebreaks`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_comment_double_space_linebreaks
-[`doc_comments_missing_terminal_punctuation`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_comments_missing_terminal_punctuation
 [`doc_include_without_cfg`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_include_without_cfg
 [`doc_lazy_continuation`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_lazy_continuation
 [`doc_link_code`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_link_code
 [`doc_link_with_quotes`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_link_with_quotes
 [`doc_markdown`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_markdown
 [`doc_nested_refdefs`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_nested_refdefs
 [`doc_overindented_list_items`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_overindented_list_items
+[`doc_paragraphs_missing_punctuation`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_paragraphs_missing_punctuation
 [`doc_suspicious_footnotes`]: https://rust-lang.github.io/rust-clippy/master/index.html#doc_suspicious_footnotes
 [`double_comparisons`]: https://rust-lang.github.io/rust-clippy/master/index.html#double_comparisons
 [`double_ended_iterator_last`]: https://rust-lang.github.io/rust-clippy/master/index.html#double_ended_iterator_last

clippy_lints/src/declared_lints.rs

@@ -110,7 +110,6 @@ pub static LINTS: &[&::declare_clippy_lint::LintInfo] = &[
     crate::disallowed_script_idents::DISALLOWED_SCRIPT_IDENTS_INFO,
     crate::disallowed_types::DISALLOWED_TYPES_INFO,
     crate::doc::DOC_BROKEN_LINK_INFO,
-    crate::doc::DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION_INFO,
     crate::doc::DOC_COMMENT_DOUBLE_SPACE_LINEBREAKS_INFO,
     crate::doc::DOC_INCLUDE_WITHOUT_CFG_INFO,
     crate::doc::DOC_LAZY_CONTINUATION_INFO,
@@ -119,6 +118,7 @@ pub static LINTS: &[&::declare_clippy_lint::LintInfo] = &[
     crate::doc::DOC_MARKDOWN_INFO,
     crate::doc::DOC_NESTED_REFDEFS_INFO,
     crate::doc::DOC_OVERINDENTED_LIST_ITEMS_INFO,
+    crate::doc::DOC_PARAGRAPHS_MISSING_PUNCTUATION_INFO,
     crate::doc::DOC_SUSPICIOUS_FOOTNOTES_INFO,
     crate::doc::EMPTY_DOCS_INFO,
     crate::doc::MISSING_ERRORS_DOC_INFO,

clippy_lints/src/doc/doc_comments_missing_terminal_punctuation.rs renamed to clippy_lints/src/doc/doc_paragraphs_missing_punctuation.rs

@@ -4,7 +4,7 @@ use rustc_resolve::rustdoc::main_body_opts;
 
 use rustc_resolve::rustdoc::pulldown_cmark::{Event, Options, Parser, Tag, TagEnd};
 
-use super::{DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION, Fragments};
+use super::{DOC_PARAGRAPHS_MISSING_PUNCTUATION, Fragments};
 
 const MSG: &str = "doc comments should end with a terminal punctuation mark";
 const PUNCTUATION_SUGGESTION: char = '.';
@@ -17,7 +17,7 @@ pub fn check(cx: &LateContext<'_>, doc: &str, fragments: Fragments<'_>) {
                 if let Some(span) = fragments.span(cx, offset..offset) {
                     clippy_utils::diagnostics::span_lint_and_sugg(
                         cx,
-                        DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION,
+                        DOC_PARAGRAPHS_MISSING_PUNCTUATION,
                         span,
                         MSG,
                         "end the doc comment with some punctuation",
@@ -31,7 +31,7 @@ pub fn check(cx: &LateContext<'_>, doc: &str, fragments: Fragments<'_>) {
                 if let Some(span) = fragments.span(cx, offset..offset) {
                     clippy_utils::diagnostics::span_lint_and_help(
                         cx,
-                        DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION,
+                        DOC_PARAGRAPHS_MISSING_PUNCTUATION,
                         span,
                         MSG,
                         None,

clippy_lints/src/doc/mod.rs

@@ -28,7 +28,7 @@ use url::Url;
 
 mod broken_link;
 mod doc_comment_double_space_linebreaks;
-mod doc_comments_missing_terminal_punctuation;
+mod doc_paragraphs_missing_punctuation;
 mod doc_suspicious_footnotes;
 mod include_in_doc_without_cfg;
 mod lazy_continuation;
@@ -693,7 +693,7 @@ declare_clippy_lint! {
     /// /// It was chosen by a fair dice roll.
     /// ```
     #[clippy::version = "1.92.0"]
-    pub DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION,
+    pub DOC_PARAGRAPHS_MISSING_PUNCTUATION,
     nursery,
     "missing terminal punctuation in doc comments"
 }
@@ -732,7 +732,7 @@ impl_lint_pass!(Documentation => [
     DOC_INCLUDE_WITHOUT_CFG,
     DOC_COMMENT_DOUBLE_SPACE_LINEBREAKS,
     DOC_SUSPICIOUS_FOOTNOTES,
-    DOC_COMMENTS_MISSING_TERMINAL_PUNCTUATION,
+    DOC_PARAGRAPHS_MISSING_PUNCTUATION,
 ]);
 
 impl EarlyLintPass for Documentation {
@@ -904,7 +904,7 @@ fn check_attrs(cx: &LateContext<'_>, valid_idents: &FxHashSet<String>, attrs: &[
         },
     );
 
-    doc_comments_missing_terminal_punctuation::check(
+    doc_paragraphs_missing_punctuation::check(
         cx,
         &doc,
         Fragments {

tests/ui/doc/doc_comments_missing_terminal_punctuation.fixed renamed to tests/ui/doc/doc_paragraphs_missing_punctuation.fixed

@@ -1,20 +1,20 @@
 #![feature(custom_inner_attributes)]
 #![rustfmt::skip]
-#![warn(clippy::doc_comments_missing_terminal_punctuation)]
+#![warn(clippy::doc_paragraphs_missing_punctuation)]
 
 /// Returns the Answer to the Ultimate Question of Life, the Universe, and Everything.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 fn answer() -> i32 {
     42
 }
 
 /// The `Option` type.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 // Triggers even in the presence of another attribute.
 #[derive(Debug)]
 enum MyOption<T> {
     /// No value.
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     None,
     /// Some value of type `T`.
     Some(T),
@@ -25,7 +25,7 @@ enum MyOption<T> {
 #[derive(Debug)]
 /// doc comment:
 /// only the last line triggers the lint.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 enum Exceptions {
     /// Question marks are fine?
     QuestionMark,
@@ -38,7 +38,7 @@ enum Exceptions {
     RawHtml,
     /// The raw HTML exception actually does the right thing to autolinks:
     /// <https://spec.commonmark.org/0.31.2/#autolinks>.
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     MarkdownAutolink,
     /// This table introduction ends with a colon:
     ///
@@ -47,7 +47,7 @@ enum Exceptions {
     /// | Markdown table | A-ok  |
     MarkdownTable,
     /// Here is a snippet.
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     ///
     /// ```
     /// // Code blocks are no issues.
@@ -56,7 +56,7 @@ enum Exceptions {
 }
 
 // Check the lint can be expected on a whole enum at once.
-#[expect(clippy::doc_comments_missing_terminal_punctuation)]
+#[expect(clippy::doc_paragraphs_missing_punctuation)]
 enum Char {
     /// U+0000
     Null,
@@ -66,18 +66,18 @@ enum Char {
 
 // Check the lint can be expected on a single variant without affecting others.
 enum Char2 {
-    #[expect(clippy::doc_comments_missing_terminal_punctuation)]
+    #[expect(clippy::doc_paragraphs_missing_punctuation)]
     /// U+0000
     Null,
     /// U+0001.
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     StartOfHeading,
 }
 
 mod module {
     //! Works on
     //! inner attributes too.
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
 }
 
 enum Trailers {
@@ -88,12 +88,12 @@ enum Trailers {
     /// **Sometimes the last sentence is in bold, and that's ok.**
     DoubleStarPassing,
     /// **But sometimes it is missing a period.**
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     DoubleStarFailing,
     /// _Sometimes the last sentence is in italics, and that's ok._
     UnderscorePassing,
     /// _But sometimes it is missing a period._
-    //~^ doc_comments_missing_terminal_punctuation
+    //~^ doc_paragraphs_missing_punctuation
     UnderscoreFailing,
     /// This comment ends with "a quote."
     AmericanStyleQuotePassing,
@@ -102,11 +102,11 @@ enum Trailers {
 }
 
 /// Doc comments can end with an [inline link](#anchor).
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 struct InlineLink;
 
 /// Some doc comments contain [link reference definitions][spec].
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 ///
 /// [spec]: https://spec.commonmark.org/0.31.2/#link-reference-definitions
 struct LinkRefDefinition;
@@ -131,27 +131,27 @@ enum OrderedLists {
 }
 
 /// Doc comments with trailing blank lines are supported.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 ///
 struct TrailingBlankLine;
 
 /// This doc comment has multiple paragraph.
 /// This first paragraph is missing punctuation.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 ///
 /// The second one as well
 /// And it has multiple sentences.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 ///
 /// Same for this third and last one.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 struct MultiParagraphDocComment;
 
 /// ```
 struct IncompleteBlockCode;
 
 /// This ends with a code `span`.
-//~^ doc_comments_missing_terminal_punctuation
+//~^ doc_paragraphs_missing_punctuation
 struct CodeSpan;
 
 #[expect(clippy::empty_docs)]
@@ -162,7 +162,7 @@ struct EmptyDocComment;
  * Block doc comments work.
  *
  */
-//~^^^ doc_comments_missing_terminal_punctuation
+//~^^^ doc_paragraphs_missing_punctuation
 struct BlockDocComment;
 
 /// Sometimes a doc attribute is used for concatenation