Re: [PATCH Web] Translator: Add the introduction to the rtc translator

[Samuel Thibault]

Hello,

Zhaoming Luo, le mer. 01 janv. 2025 15:38:52 +0800, a ecrit:
>  * hurd/translator.mdwn: Add an entry for the rtc translator
>  * hurd/translator/rtc.mdwn: Add the introduction to the rtc translator
> 
> Signed-off-by: Zhaoming Luo <zhmingluo@163.com>
> ---
>  hurd/translator.mdwn     |  1 +
>  hurd/translator/rtc.mdwn | 17 +++++++++++++++++
>  2 files changed, 18 insertions(+)
>  create mode 100644 hurd/translator/rtc.mdwn
> 
> diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn
> index 324c5f8c..fe669a12 100644
> --- a/hurd/translator.mdwn
> +++ b/hurd/translator.mdwn
> @@ -121,6 +121,7 @@ The [[concept|concepts]] of translators creates its own 
> problems, too:
>  * [[term]]
>  * [[checkperms]]
>  * [[usermux]]
> +* [[rtc]]
>  * ...
>  
>  
> diff --git a/hurd/translator/rtc.mdwn b/hurd/translator/rtc.mdwn
> new file mode 100644
> index 00000000..40fe8725
> --- /dev/null
> +++ b/hurd/translator/rtc.mdwn
> @@ -0,0 +1,17 @@
> +[[!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.

Thanks for thinking about the documentation! Too few people do :)

Please also mention the ioctl macro names and the hwclock tool from
util-linux.

Samuel

> +# Usage Example
> +Setup a `rtc` device file in `/tmp`:
> +
> +    settrans -c /tmp/rtc /hurd/rtc
> -- 
> 2.47.1