diff --git a/base/strings/unicode.jl b/base/strings/unicode.jl
index cb50e87f69f88..f2938ba6021f2 100644
--- a/base/strings/unicode.jl
+++ b/base/strings/unicode.jl
@@ -174,12 +174,14 @@ function utf8proc_map(str::Union{String,SubString{String}}, options::Integer, ch
     return String(resize!(buffer, nbytes))
 end
 
-# Array of {original codepoint, replacement codepoint} normalizations
-# to perform on Julia identifiers, to canonicalize characters that
-# are both easily confused and easily inputted by accident.
-#
-# Important: when this table is updated, also update the corresponding table
-#            in src/flisp/julia_charmap.h
+"""
+`Dict` of `original codepoint => replacement codepoint` normalizations
+to perform on Julia identifiers, to canonicalize characters that
+are both easily confused and easily inputted by accident.
+
+!!! warning
+    When this table is updated, also update the corresponding table in `src/flisp/julia_charmap.h`.
+"""
 const _julia_charmap = Dict{UInt32,UInt32}(
     0x025B => 0x03B5, # latin small letter open e -> greek small letter epsilon
     0x00B5 => 0x03BC, # micro sign -> greek small letter mu