[Nut-upsuser] UPS configuration issue?

[Sam Varshavchik]

Jim Klimov via Nut-upsuser writes:

> Alas, with NUT's long history starting when computers were tools of the  
> relatively few engineer nerd types, much of the documentation remains  
> "elitist".
>
> Partially due to this, I've started a new manual page (after release v2.8.3)  
> so people can get a reasonable overview of the NUT layering and some  
> practical caveats by uttering `man nut`.

It also doesn't help things that nroff has survived since ancient times,  
back when dinosaurs roamed the Earth.

nroff is long overdue for retirement. It served its purpose. But there are  
better tools out there, now. Sadly, Linux still insists on keeping this  
fossil.

> Surprisingly, there was no such  
> thing for over the quarter of a century that the project has been out there!

That's about the timeframe back when I started writing my manual pages in  
Docbook XML, and generating beautiful HTML documentation from it, as well as  
legacy man pages.

I even started a project that successfully converted all Linux manual pages  
from nroff into Docbook XML. Sadly it did not get any traction, and I shut  
it down a few years ago.

I humbly suggest that you use Docbook XML for your original source, and then  
just have it spew out nroff, and also have something nice that can be thrown  
onto a web server.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 228 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/nut-upsuser/attachments/20250512/fa7a5350/attachment.sig>