Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread Brian Buhrow
hello. As someone who regularly works on the kernel, yes, I have kernel sources, but having man pages that provide some explanation of various parts of the source is very helpful. So, I would support making man pages available as is proposed. Man pages are a great supplement to source

Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread Mouse
>> So to clarify: I'm proposing to convert the rst doc pages to man >> pages [...] > I wouldn't bother installing man pages for this, someone working on > the kernel already has the source tree. With vanishingly few exceptions (notable by their rarity), source code is not documentation. There's a

Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread tlaronde
On Tue, Oct 17, 2023 at 02:33:43PM +0100, Robert Swindells wrote: > > tlaro...@kergis.com wrote: > > So to clarify: I'm proposing to convert the rst doc pages to man > > pages (with for example the utility I cite), and to add the man pages, > > in man format, to the sources (in order for the sourc

Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread Robert Swindells
tlaro...@kergis.com wrote: > So to clarify: I'm proposing to convert the rst doc pages to man > pages (with for example the utility I cite), and to add the man pages, > in man format, to the sources (in order for the sources to not depend > on a supplementary external tool) and to install the man

Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread tlaronde
[I mean to reply to Mouse, but I have a hell of a time with majordomo or this mailing list: I'm subscribed but I don't get the messages! Can someone look at this, please. TIA.] So to clarify: I'm proposing to convert the rst doc pages to man pages (with for example the utility I cite), and to add

Re: drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread Mouse
> There is no man page for drmkms (the kernel part), but there are man > pages in the X sources, in the rst format [...] Would it maybe be worth creating a tiny manpage that just says "go look over there for docs"? I don't _like_ having manpages in yet _another_ markup language, but I prefer that

drm.4 man page and import of X11 drm-kms.7 and al.

2023-10-17 Thread tlaronde
I have modified drm.4 to state that the drivers are obsolete and to suppress a mention of viadrm that was removed long ago (now superseded by viadrmums, provided in drm2/ ---drmkms--- part). Patch can be retrieved from https://github.com/tlaronde/src There is no man page for drmkms (the kernel p