3 files changed, 36 insertions, 14 deletions
diff --git a/hurd/translator/ext2fs.mdwn b/hurd/translator/ext2fs.mdwn
index 9be6c885..3baf6b03 100644
--- a/hurd/translator/ext2fs.mdwn
+++ b/hurd/translator/ext2fs.mdwn
@@ -617,18 +617,6 @@ That would be a nice improvement, but only after writeback throttling is impleme
       separate partitions is a way to alleviate them
 
 
-## `ext2fs: ../../libdiskfs/rdwr-internal.c:42: _diskfs_rdwr_internal: Assertion `!diskfs_readonly' failed.`
-
-### IRC, freenode, #hurd, 2014-02-22
-
-    <gg0> login: init: notifying pfinet of shutdown...init: notifying tmpfs
-      none of shutdown...init: notifying tmpfs none of shutdown...init:
-      notifyi.
-    <gg0> ext2fs: ../../libdiskfs/rdwr-internal.c:42: _diskfs_rdwr_internal:
-      Assertion `!diskfs_readonly' failed.
-    <gg0> In tight loop: hit ctl-alt-del to reboot
-
-
 # Documentation
 
   * <http://e2fsprogs.sourceforge.net/ext2.html>
diff --git a/hurd/translator/remap.mdwn b/hurd/translator/remap.mdwn
index a0544c7c..06e3c8c5 100644
--- a/hurd/translator/remap.mdwn
+++ b/hurd/translator/remap.mdwn
@@ -31,9 +31,12 @@ On Debian, `/bin/sh` points to `dash`.  Maybe you would rather it
 point to `bash`.
 
 	$ ls -lha /bin/sh
-	  lrwxr-xr-x 1 root root 4 Jun  5 04:08 /bin/sh -> dash
+	lrwxr-xr-x 1 root root 4 Jun  5 04:08 /bin/sh -> dash
 	$ remap /bin/sh /bin/bash -- ls -lha /bin/sh
-      -rwxr-xr-x 1 root root 1,2M 20 oct.  12:53 /bin/sh
+    -rwxr-xr-x 1 root root 1,2M 20 oct.  12:53 /bin/sh
+    /bin/settrans: fsys_goaway: (ipc/mig) server died
+
+(the warning is expected, it just tells that the exected command has finished)
 
 ## remapping python3
 
diff --git a/hurd/translator/rtc.mdwn b/hurd/translator/rtc.mdwn
new file mode 100644
index 00000000..7a917b46
--- /dev/null
+++ b/hurd/translator/rtc.mdwn
@@ -0,0 +1,31 @@
+[[!meta copyright="Copyright © 2025 Free Software Foundation, Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
+
+The *rtc* translator implements a real-time clock driver. It can be used to add
+the `rtc` device files, with those files, we can access the underlying
+real-time clock using `ioctl()`. The description of `ioctl()` can be found
+[here](https://www.gnu.org/software/libc/manual/html_node/IOCTLs.html).
+
+The operation macros are required to access the real-time clock. They are
+defined as `RTC_*` in `hurd/rtc.h`.
+
+The `hwclock` command from `util-linux` can use the `rtc` device files to
+access the real-time clock devices.
+
+# Usage Example
+Setup a `rtc` device file in `/tmp`:
+
+    settrans -c /tmp/rtc /hurd/rtc
+
+Read the time value through the `rtc` device file:
+ 
+    int fd = open("/tmp/rtc", O_RDONLY);
+    struct rtc_time time;
+    ioctl(fd, RTC_RD_TIME, &time);