On Fri, Jan 11, 2013 at 09:00:44PM +0100, Lennart Poettering wrote: > On Fri, 11.01.13 11:23, Colin Guthrie (gm...@colin.guthr.ie) wrote: > > > >> List of all zsh's man pages appears on top of zshall(1) simply because > > >> it includes zsh(1) as well :) > > > > > > Uh, ah. I prefer having systemdall however as an index only. Not really > > > convinced such a merged page makes much sense for us. > > > > As Tollef said it can be quite useful. I often find myself > > half-remembering a directive and then going through each of systemd.unit > > systemd.service and systemd.exec trying to find it each time with > > variations on the name in case I'm remembering it slightly wrong. > > > > An index is useful but a single man page with everything in it what I > > can grep is really useful at times. > > Hmm, there is an item on the TODO list to have an explicit index > somewhere of all settings, with references to the various man pages we > have. I.e. something where all settings from the unit files, > logind.conf, system.conf, journal.conf and so on are listed, with > references to the actual man pages. > > I mean, we have a huge amount of docs now, I somehow think that merging > that all into one gigantic file doesn't really scale and just creates > noise (i.e. why would you want systemd-delta's man page in your data set > if you grep for a config setting?). So I'd rather vote for two index pages: > > systemd.index(1) as an index of all man pages we have (i.e. a man > version of the HTML index we already have) > > systemd.config(5) as index of all configuration settings, from all > configuration files. What about existing systemd.directives(5)?
Zbyszek _______________________________________________ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
