On Tue, 7 Mar 2017 16:25:29 -0500
Anton Aylward
On 07/03/17 03:16 PM, Carlos E. R. wrote:
If there are 150 man pages for systemd, then perhaps there should be a good written book, in html and pdf. Properly indexed and cross referenced.
Perhaps my google-fu is better than yours, then.
Clearly much, much better than mine. When I try to google how to do foo with systemd I usually find a page that actually tells how after going through a half dozen of rants that foo is broken .. so long as foo is a single well searchable keyword. For conceptual things like overriding service parameters in separate file it falls short.
Try O'Reilly. There's an on-line 'Safari" text.
How to find out that to learn about systemd I should read a "Safari" text is beyond my google-fu as well.
Depending on various, it may be available using your local on-line library. Otherwise, hit the o'Reilly site.
YMMV but there's a lot out there.
The man pages are ... well everyone complains about man pages not really telling you how to use things. I'm battling with NetWorkManager and finding the man pages aren't telling me what I want to know so I'm turning to Google. I would not put your faith in man pages if you want to understand and actually do things. The are the 'dictionary' of the commands, not the 'manual of style' or "how to write". That's where O'Reilly have always been wonderful!
You don't have such a pressing need to create comprehensive man pages for NM when STFW for 'how to do foo with NetworkManager' usually does return useful, complete discussion of the topic within first few results. At lest complete enough to actually accomplish said task in a reasonable, maintainable way.
Personally I think that https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.ref... is quite comprehensive. I'm amazed that doesn't end up in "/usr/share/doc/packages/systemd/" Maybe its a matter of using the right repository?
That's indeed quite nice. Thanks Michal -- To unsubscribe, e-mail: opensuse-factory+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-factory+owner@opensuse.org