fix a few dead links and a missing sentence in documentation (#12387)

2 files changed, 4 insertions, 4 deletions

diff --git a/lib/pure/strscans.nim b/lib/pure/strscans.nim
index e517d8c78..0125a1926 100644
--- a/lib/pure/strscans.nim
+++ b/lib/pure/strscans.nim
@@ -76,7 +76,7 @@ One very nice advantage over regular expressions is that ``scanf`` is
 extensible with ordinary Nim procs. The proc is either enclosed in ``${}``
 or in ``$[]``. ``${}`` matches and binds the result
 to a variable (that was passed to the ``scanf`` macro) while ``$[]`` merely
-optional tokens.
+matches optional tokens without any result binding.
 
 
 In this example, we define a helper proc ``someSep`` that skips some separators
diff --git a/lib/system/io.nim b/lib/system/io.nim
index 888ff8e7f..89ceb4ea2 100644
--- a/lib/system/io.nim
+++ b/lib/system/io.nim
@@ -667,10 +667,10 @@ when defined(windows) and appType == "console" and
 
 proc readFile*(filename: string): TaintedString {.tags: [ReadIOEffect], benign.} =
   ## Opens a file named `filename` for reading, calls `readAll
-  ## <#readAll>`_ and closes the file afterwards. Returns the string.
-  ## Raises an IO exception in case of an error. If # you need to call
+  ## <#readAll,File>`_ and closes the file afterwards. Returns the string.
+  ## Raises an IO exception in case of an error. If you need to call
   ## this inside a compile time macro you can use `staticRead
-  ## <#staticRead>`_.
+  ## <system.html#staticRead,string>`_.
   var f: File
   if open(f, filename):
     try: